1. 先搞清楚 OpenClaw 到底能帮你做什么
OpenClaw 是一个开源的 AI 助理框架,你可以把它理解成一个“空壳机器人”:它自己不会思考,但只要你给它接上大模型 API(相当于大脑),再装上技能插件(相当于双手),它就能读写文件、跑终端命令、浏览网页、对接外部服务。2026 年的版本把重点放在了 Agent Teams 多智能体协作上,多个独立实例可以分工干活,一个查资料、一个写代码、一个做审查,最后由团队领导汇总输出。
这套东西适合谁?如果你是开发者、运维、产品经理,或者只是想让日常重复工作自动化的人,OpenClaw 都能用。它支持本地部署(数据留在自己机器上)和云端部署(7x24 小时在线)两种模式。本地部署对内存有要求,单实例建议 4GB 起步,开 Agent Teams 的话 8GB 以上会更稳。
我这次用 TaoToken 作为统一 Key 来对接模型,好处是一个 Key 可以切换不同模型,不用在多个平台之间来回倒腾配置。下面从 Node.js 环境准备开始,一步步把助理搭起来,中间会给出可复制的 settings.json 和 config.toml 骨架,以及启动后的验证动作。
2. 前置准备:Node.js 环境与 TaoToken 统一 Key
2.1 Node.js 版本是硬门槛
OpenClaw 2026 版本要求 Node.js ≥ 22.0.0,Agent Teams 功能同样卡这个版本。低于 22 会直接报错,别想着绕过。先确认版本:
node -v # 期望输出:v22.x.x 或更高 npm -v如果版本不够,Windows 用 winget 升级,Mac/Linux 用 nvm:
# Windows PowerShell(管理员) winget install OpenJS.NodeJS.LTS --version 22.2.0 # Mac/Linux nvm install 22 nvm use 22装完顺手把 npm 镜像配一下,国内下载技能包会快很多:
npm config set registry https://registry.npmmirror.com2.2 拿到 TaoToken 统一 Key
TaoToken 的作用是给你一个统一的 API Key,背后可以对接多种模型。你不需要在每个模型平台单独注册、单独管 Key,一个 Key 走天下。获取路径是进控制台创建 API Key,创建后立即复制保存,页面只显示一次。
拿到 Key 之后,OpenClaw 里所有需要填模型凭证的地方都用它。这样后面切换模型时,只改模型名,不用换 Key。
注意:Key 不要写进代码仓库,用环境变量或本地配置文件管理。下面配置片段里我用占位符
sk-你的TaoTokenKey,你替换成自己的。
3. 可复制配置:settings.json 与 config.toml 骨架
3.1 安装 OpenClaw 并初始化
npm install -g openclaw@latest openclaw onboard --install-daemon交互过程里会问你交互渠道、端口、初始技能。端口默认 18789,初始技能可以先选 No,后面用 ClawHub 单独装。初始化完成后,配置目录在~/.openclaw/(Windows 是%USERPROFILE%\.openclaw\)。
3.2 settings.json 骨架
这个文件管的是模型接入和全局行为。把apiKey换成你的 TaoToken Key,baseUrl指向 TaoToken 的 API 地址:
{ "model": { "provider": "custom", "name": "claude-sonnet", "apiKey": "sk-你的TaoTokenKey", "baseUrl": "https://taotoken.net/api", "maxTokens": 8192, "temperature": 0.7 }, "agent": { "name": "my-assistant", "memory": { "userFile": "USER.md", "memoryFile": "MEMORY.md" } }, "server": { "port": 18789, "host": "0.0.0.0" }, "teams": { "enabled": false } }几个参数说明:provider选 custom 表示走自定义端点;baseUrl填 TaoToken 的 API 地址,注意不要带多余路径;teams.enabled先关着,等基础跑通再开。
3.3 config.toml 骨架
如果你更习惯 TOML 格式,或者某些技能包读取的是 config.toml,可以用这份:
[model] provider = "custom" name = "claude-sonnet" api_key = "sk-你的TaoTokenKey" base_url = "https://taotoken.net/api" max_tokens = 8192 temperature = 0.7 [agent] name = "my-assistant" [agent.memory] user_file = "USER.md" memory_file = "MEMORY.md" [server] port = 18789 host = "0.0.0.0" [teams] enabled = false两份配置二选一即可,不要同时改,否则容易互相覆盖。改完保存,重启服务生效。
3.4 安装 ClawHub CLI 并接入技能
ClawHub 是技能市场入口,装好才能搜索和安装技能:
npm install -g clawhub clawhub login clawhub --version登录按提示完成授权。装一个官方办公套件试试:
clawhub install anthropic-official-skills装完不用重启,直接在对话里调用。技能加载状态可以用clawhub list查看。
4. 启动与验证:确认助理响应和技能加载
4.1 启动服务
openclaw start # 或者前台运行看日志 openclaw start --foreground启动后浏览器访问http://localhost:18789/?token=你的Token。Token 用openclaw token generate生成,生成后保存好。
4.2 验证模型响应
进对话界面,发一句简单的话,比如“你好,帮我列一下当前目录的文件”。如果模型配置正确,它会返回文件列表。如果返回的是报错或空响应,先查 Key 和 baseUrl。
也可以用命令行直接测模型连通性:
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{"model":"claude-sonnet","messages":[{"role":"user","content":"ping"}]}'返回里有choices字段就说明 Key 和端点没问题。
4.3 验证技能加载
在对话里让助理调用技能,比如“用办公套件帮我生成一个简单的 PPT 大纲”。如果技能已加载,它会走技能逻辑返回结构化内容;如果没加载,它会说找不到对应能力。这时候回查clawhub list确认技能在列表里。
4.4 开启 Agent Teams(可选)
基础跑通后,把 settings.json 里的teams.enabled改成 true,重启服务。然后创建团队:
openclaw teams create --name "研发团队" --members "架构师,开发者,审查员"创建完对团队领导下指令,比如“设计一个高可用架构并完成核心代码审查”,多个实例会并行处理。本地部署开 Teams 建议内存 8GB 以上,云端建议 4vCPU+8GiB。
5. 本篇常见错排查
5.1 Node.js 版本过低报错
现象:启动时报Unsupported engine或 Agent Teams 功能直接不可用。原因就是版本低于 22。解决:升级 Node.js,升级失败先npm cache clean --force再重试。
5.2 模型返回 401 或 403
现象:对话无响应,日志里出现鉴权失败。原因通常是 Key 填错、Key 过期,或者 baseUrl 写成了带路径的地址。检查 settings.json 里的apiKey和baseUrl,baseUrl 只填https://taotoken.net/api,不要加/v1之类后缀。
5.3 技能安装超时
现象:clawhub install卡住或超时。国内网络下先确认 npm 镜像已配:npm config get registry应返回https://registry.npmmirror.com。没配的话重新执行镜像设置命令。
5.4 端口访问不了
现象:浏览器打不开 18789。云端部署要放行防火墙端口,本地部署检查服务是否真的在跑(openclaw status)。另外确认访问 URL 带了?token=参数,没带 Token 会被拒绝。
5.5 配置文件改了不生效
现象:改了 settings.json 但行为没变。原因可能是同时存在 config.toml,两者冲突。只保留一份配置文件,改完重启服务。另外确认改的是~/.openclaw/下的文件,不是项目目录里的副本。
6. 下一步:把 Key 和技能用起来
基础助理跑通之后,你可以做三件事。第一,去 TaoToken 控制台把 API Key 管好,后续切换模型只改配置里的模型名,Key 不用动。第二,进 ClawHub 技能市场按需装技能,优先选安全评级高、下载量大的,别装来路不明的第三方包。第三,如果要长期跑编码或 Agent 任务,可以了解 Coding Plan 的用法,把多智能体协作的额度规划好。
配置和验证过程中遇到接入问题,直接查接入文档;想先试试模型对话效果,进模型对话页面发几条指令感受一下;需要管理 Key 就去 API Keys 页面。把这几步走完,你的 OpenClaw 助理就算真正立起来了。