OpenClaw使用教程 + 获取API + 踩坑

新手建议如果研究不下去直接用第三方的Oneclaw字节、阿里、腾讯出品的第三方。可以等一等国产有替代。别焦虑没用23年gpt24年sora25deepseek和agent26开年openclaw和seedance学会了也没用一个月甚至一两周就过时了。——————————————————目录一安装Openclaw1.下载 node.js2.下载Git 安装3.打开Powershell4.开始安装openclaw二 配置Openclaw三、常见问题1. 控制台 UI 上输入后出现 4012.权限问题 Mac上不让使用npm命令3.Clawhub的问题Clawhub安装使用clawhub install安装插件一直提示 Rate limit exceeded 解决办法如果在控制台中clawhub login 登录提示 missing state解决办法安装skil 命令clawhub install xxxxxxxxxxxx四、常用的Openclaw的命令1.开启2.关闭3.打开WebUI 面板 就是那个可以对话的网页。4.配置5.从新开始设置6.安装skill五、配置API一安装Openclaw1.下载 node.js安装 默认即可2.下载Git 安装默认即可3.打开Powershell这个步骤前最好保证你懂的网络环境windows开始菜单搜索Powershell 右键以管理员身份打开然后输入Set-Execution Policy -Execution Policy RemoteSigned -ScopeCurrentUser出现提示输入Y 回车4.开始安装openclaw输入iwr-useb https://openclaw.ai/install.ps1 | iex 然后回车iwr-useb https://openclaw.ai/install.ps1 | iex等待如果出现点允许没出现不管。等待出现 OpenClaw的红色字体说明安装成功二 配置Openclaw上下左右按键回车确认多选时按下空格键进行【选中/不选中】1.配置点Yes2.配置Quickstart 回车3.use exist models 回车4.选择你的模型上下选择然后回车。比如 我的是openrouter的就选到回车5.然后继续选择openrouter里的模型比如stepfun3.56.API进到里面后在 key后面把API 复制进去获取API方法在五、配置API 的部分然后回车7.配置通讯工具可以选择飞书、telegram等可以先忽略。8、一直忽略后面的忽略skip即可回车9 、最后配置成功。10、测试一下输入 openclaw dashboard自动打开网页进行对话——————————————————————————————————三、常见问题1. 控制台 UI 上输入后出现 4011查看你的API 是否正确尤其是不要带空格或者复制时带回车2找到 openclaw.json 不要随便修改如果改错了那么使用 docker --fix修复。3如果还不对或者不让你修改API了,那么,去删除C:\Users\xxxx\.openclaw\agents\main\agent 下面 的 models.json文件然后重新使用openclaw onboard重新设置一下。2.权限问题 Mac上不让使用npm命令权限不够让openclaw帮你解决3.Clawhub的问题Clawhub安装命令 npm i -g clawhub下载skill在clawhub中找到 browse skill进入找一个插件复制后面的实际插件文字安装这个插件在命令中输入 clawhub install xxxxxxxxx如 clawhub install self-improving-agent使用clawhub install安装插件一直提示 Rate limit exceeded 解决办法在 控制台中输入clauhub login然后跳转的网页就是clawhub的网页你用Github的账号登录就行了。如果在控制台中clawhub login 登录提示 missing state解决办法先 在 控制台中输入clauhub login 如果还是出现 missing state了那么1在clawhub里面创建token如图创建后复制token然后在控制台输入clawhub auth login --token xxxxxxxxxxxxxx然后就可以正常的下载clawhub的 skill了。安装skil 命令clawhub install xxxxxxxxxxxx4. 升级版本出现 npm error 报错3.8-3.11-3.12最主要是npm error fatal: unable to access https://github.com/whiskeysockets/libsignal-node.git/: Failed to connect to github.com port 443 after 21102 ms: Could not connect to server这个库没了然后就是报错。。。。服了完整报错Updating OpenClaw... o ✗ Updating via package manager (133.56s) npm error code 128 npm error An unknown git error occurred npm error command git --no-replace-objects ls-remote ssh://gitgithub.com/whiskeysockets/libsignal-node.git npm error fatal: unable to access https://github.com/whiskeysockets/libsignal-node.git/: Failed to connect to github.com port 443 after 21102 ms: Could not connect to server npm error A complete log of this run can be found in: C:\Users\*******\AppData\Local\npm-cache\_logs\2026-03-16T00_49_03_528Z-debug-0.log o ✓ Running doctor checks (8.4s) Update Result: ERROR解决方法彻底删除openclaw 然后再次安装。第一步卸载当前的全局 OpenClaw既然它的内部升级命令卡死了我们就用 npm 原生的方式卸载它PowerShellnpm uninstall -g openclaw第二步强制清理 npm 幽灵缓存这一步非常关键为了防止 npm 依然记着那个错误的whiskeysockets/libsignal-node链接强制清空缓存PowerShellnpm cache clean --force第三步手动清理残留文件确保万无一失从你的报错日志来看它的安装路径在C:\Users\******\AppData\Roaming\npm\node_modules\openclaw。 为了防止卸载不干净你可以直接在 PowerShell 里运行下面这行命令把残留文件夹强行删掉如果提示找不到文件说明上一步已经卸载干净了忽略即可PowerShellRemove-Item -Recurse -Force C:\Users\你的用户名\AppData\Roaming\npm\node_modules\openclaw -ErrorAction SilentlyContinue第四步重新全局安装 OpenClaw现在你的环境已经非常干净了直接重新拉取最新版本的 OpenClawPowerShellnpm install -g openclaw四、常用的Openclaw的命令1.开启openclaw gateway restart2.关闭openclaw gateway stop3.打开WebUI 面板 就是那个可以对话的网页。openclaw dashboard4.配置openclaw config5.从新开始设置openclaw onboard6.安装skillclawhub install xxxxxxxxxxxxxxxxxxxxxx就是你需要安装的插件名字网站上写什么就复制一下别吓自己写以上最常用的如果其他的还需要什么放到龙虾的页面直接问他。五、配置API1。如果就是玩一下就用step3.5的模型免费效果一般纯能用打开 openrouter的网直接就能开StepFun: Step 3.5 Flash (free) – API Quickstart | OpenRouterhttps://openrouter.ai/stepfun/step-3.5-flash:free/api点击 create api key新页面点击create 然后输入名字create最后复制一下你的API这个就是你的API key 去找步骤一跟着放入对应的位置就能用了。​______________________________先写到这后面在写遇到的Skill使用的方法。注意切记如果研究不下去直接用第三方的Oneclaw字节、阿里、腾讯出品的第三方。普通小白有风险