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 统一 Key2.1 Node.js 版本是硬门槛OpenClaw 2026 版本要求 Node.js ≥ 22.0.0Agent 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 统一 KeyTaoToken 的作用是给你一个统一的 API Key背后可以对接多种模型。你不需要在每个模型平台单独注册、单独管 Key一个 Key 走天下。获取路径是进控制台创建 API Key创建后立即复制保存页面只显示一次。拿到 Key 之后OpenClaw 里所有需要填模型凭证的地方都用它。这样后面切换模型时只改模型名不用换 Key。注意Key 不要写进代码仓库用环境变量或本地配置文件管理。下面配置片段里我用占位符sk-你的TaoTokenKey你替换成自己的。3. 可复制配置settings.json 与 config.toml 骨架3.1 安装 OpenClaw 并初始化npm install -g openclawlatest openclaw onboard --install-daemon交互过程里会问你交互渠道、端口、初始技能。端口默认 18789初始技能可以先选 No后面用 ClawHub 单独装。初始化完成后配置目录在~/.openclaw/Windows 是%USERPROFILE%\.openclaw\。3.2 settings.json 骨架这个文件管的是模型接入和全局行为。把apiKey换成你的 TaoToken KeybaseUrl指向 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 以上云端建议 4vCPU8GiB。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和baseUrlbaseUrl 只填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 助理就算真正立起来了。
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 统一 Key2.1 Node.js 版本是硬门槛OpenClaw 2026 版本要求 Node.js ≥ 22.0.0Agent 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 统一 KeyTaoToken 的作用是给你一个统一的 API Key背后可以对接多种模型。你不需要在每个模型平台单独注册、单独管 Key一个 Key 走天下。获取路径是进控制台创建 API Key创建后立即复制保存页面只显示一次。拿到 Key 之后OpenClaw 里所有需要填模型凭证的地方都用它。这样后面切换模型时只改模型名不用换 Key。注意Key 不要写进代码仓库用环境变量或本地配置文件管理。下面配置片段里我用占位符sk-你的TaoTokenKey你替换成自己的。3. 可复制配置settings.json 与 config.toml 骨架3.1 安装 OpenClaw 并初始化npm install -g openclawlatest openclaw onboard --install-daemon交互过程里会问你交互渠道、端口、初始技能。端口默认 18789初始技能可以先选 No后面用 ClawHub 单独装。初始化完成后配置目录在~/.openclaw/Windows 是%USERPROFILE%\.openclaw\。3.2 settings.json 骨架这个文件管的是模型接入和全局行为。把apiKey换成你的 TaoToken KeybaseUrl指向 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 以上云端建议 4vCPU8GiB。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和baseUrlbaseUrl 只填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 助理就算真正立起来了。
