1. 先搞清楚 OpenClaw 部署到底花不花钱
OpenClaw 是一个开源的自主 AI 智能体框架,能接管你的电脑帮你整理文件、收发邮件、写代码,甚至远程操控设备。它跟普通聊天机器人的区别在于:普通机器人只“动嘴”,OpenClaw 会“动手”。很多人第一次接触它,最关心的两个问题就是——怎么装,以及要不要钱。
先把结论说清楚:OpenClaw 软件本身 100% 免费开源,GitHub 上可以自由下载、修改、使用。市面上那些几十到几百块的“代安装服务”全是第三方行为,官方从没收过费。真正产生费用的是运行环节——它需要调用大模型来“思考”,每次任务执行都在消耗 Token。另外如果你选云服务器部署,还要付服务器租金;本地部署则只花电费。
这篇教程聚焦本地部署这条链路:从 Node.js 环境检查开始,到 API Key 配置、settings.json 骨架搭建,最后用一次真实调用验证连通性。全程可复制,跟着做就能跑通。适合想零成本试水、又希望数据留在本地的开发者。
2. 部署前的环境准备与 TaoToken 接入前置
2.1 Node.js 版本与依赖检查
OpenClaw 要求 Node.js 22 或更高版本。先确认你机器上的版本:
node -v npm -v如果版本低于 22,去 Node.js 官网下载 LTS 版本覆盖安装。装完后重新开一个终端窗口再验证一次,避免 PATH 没刷新。
接着检查几个常用工具是否就位:
git --version curl --version这两个在后续拉取仓库和下载依赖时会用到。macOS 和主流 Linux 发行版一般自带,Windows 建议用 Git Bash 或 WSL2 执行后续命令,避免路径分隔符带来的奇怪报错。
2.2 为什么选 TaoToken 作为模型接入层
OpenClaw 本身没有智能,它是个“调度员”,需要接一个大模型来驱动。你可以把它理解成:OpenClaw 负责决定“做什么”,模型负责“怎么想”。所以配置的核心就是给 OpenClaw 一个能调用的模型接口。
TaoToken 提供统一的 API 接入层,兼容主流模型调用格式,配置简单,适合用来跑 OpenClaw 这类需要频繁调用模型的 Agent 框架。它的 API 地址是https://taotoken.net/api,你需要在控制台创建一个 API Key,后面写进配置文件。
注意:API Key 相当于一张没有上限的信用卡,一旦泄露,别人可以盗用你的额度疯狂消费。配置文件不要随意分享,也不要提交到公开仓库。
2.3 安装 OpenClaw
环境确认无误后,执行官方安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash安装完成后,运行配置向导:
openclaw onboard向导会引导你选择模型提供商、填入 API Key、配置消息通道。如果你不想用向导,也可以手动编辑配置文件,下一节会给出完整骨架。
3. 可复制的 settings.json 配置骨架
3.1 配置文件位置
OpenClaw 的配置文件默认放在用户目录下的.openclaw文件夹里:
~/.openclaw/settings.json如果目录不存在,手动创建:
mkdir -p ~/.openclaw touch ~/.openclaw/settings.json3.2 完整配置骨架
下面是一份可直接复制修改的settings.json骨架,把YOUR_API_KEY_HERE替换成你在 TaoToken 控制台创建的真实 Key:
{ "model": { "provider": "taotoken", "baseUrl": "https://taotoken.net/api", "apiKey": "YOUR_API_KEY_HERE", "modelName": "claude-sonnet-4-20250514", "maxTokens": 4096, "temperature": 0.7 }, "agent": { "name": "my-claw", "workspace": "~/openclaw-workspace", "heartbeatInterval": 300, "maxConcurrentTasks": 2 }, "channels": { "terminal": { "enabled": true } }, "security": { "allowedPaths": [ "~/openclaw-workspace" ], "requireConfirmation": true } }几个关键参数说明:
| 参数 | 作用 | 建议值 |
|---|---|---|
baseUrl | 模型接口地址 | https://taotoken.net/api |
apiKey | 你的调用凭证 | 从控制台复制 |
modelName | 调用的模型名称 | 按需选择 |
heartbeatInterval | 心跳检查间隔(秒) | 300 起步,别设太小 |
maxConcurrentTasks | 最大并发任务数 | 2 足够,调高会加速消耗 |
requireConfirmation | 危险操作是否需确认 | 建议true |
注意:
heartbeatInterval是成本陷阱的重灾区。设得太小,OpenClaw 会频繁唤醒模型做检查,一晚可能烧掉大量 Token。300 秒是相对安全的起点,跑顺了再按需调整。
3.3 工作目录准备
配置里指定的workspace目录需要提前建好:
mkdir -p ~/openclaw-workspace这个目录是 OpenClaw 的操作沙箱,allowedPaths里只放这个路径,能有效降低权限过大带来的风险。别把整个用户目录或系统根目录加进去。
4. 验证请求:跑通第一次真实调用
4.1 启动 OpenClaw
配置写好后,启动服务:
openclaw start如果一切正常,终端会输出类似下面的日志:
[INFO] OpenClaw agent "my-claw" starting... [INFO] Model provider: taotoken (claude-sonnet-4-20250514) [INFO] Workspace: /Users/you/openclaw-workspace [INFO] Terminal channel enabled [INFO] Agent ready. Waiting for input...看到Agent ready就说明配置加载成功了。
4.2 发一条测试指令
在终端里直接输入一条简单任务:
帮我在工作目录下创建一个 hello.txt,内容写 "OpenClaw is running"OpenClaw 会调用模型解析意图,然后在~/openclaw-workspace下创建文件。如果开启了requireConfirmation,它会先问你确认,输入y继续。
执行完成后检查文件:
cat ~/openclaw-workspace/hello.txt输出应该是:
OpenClaw is running4.3 用 curl 单独验证 API 连通性
如果 OpenClaw 启动报错,想确认是不是 API Key 或网络的问题,可以绕过 OpenClaw 直接用 curl 测一下 TaoToken 接口:
curl -X POST https://taotoken.net/api/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY_HERE" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 100, "messages": [ {"role": "user", "content": "回复一个字:好"} ] }'如果返回 JSON 里包含模型回复内容,说明 Key 和网络都没问题,问题出在 OpenClaw 配置层。如果返回 401,检查 Key 是否复制完整;返回 404,检查baseUrl有没有多写或少写路径。
5. 本篇常见报错排查
5.1 Node.js 版本不满足
报错特征:
Error: OpenClaw requires Node.js >= 22.0.0解决:升级 Node.js。用 nvm 的话:
nvm install 22 nvm use 22升级后重新执行openclaw start。
5.2 API Key 无效或额度不足
报错特征:
401 Unauthorized或
insufficient_quota解决:去 TaoToken 控制台确认 Key 是否有效、额度是否充足。如果 Key 刚创建,等一两分钟再试,有时候有缓存延迟。
5.3 配置文件 JSON 格式错误
报错特征:
Failed to parse settings.json: Unexpected token解决:用 JSON 校验工具检查一遍,常见问题是多了一个逗号、少了引号、或者用了中文引号。可以直接把上面的骨架复制到编辑器里,只改apiKey字段,避免手写出错。
5.4 工作目录权限不足
报错特征:
EACCES: permission denied解决:确认workspace目录存在且当前用户有读写权限:
ls -la ~/openclaw-workspace chmod 755 ~/openclaw-workspace5.5 心跳消耗过快
现象:没怎么用,额度却掉得很快。
解决:把heartbeatInterval从默认值调大,比如从 60 改成 300 甚至 600。同时检查maxConcurrentTasks是否设得过高。另外可以在 TaoToken 控制台设置支出硬性限制,防止意外烧穿。
6. 部署成本边界与后续接入建议
回到最初的问题:OpenClaw 部署要不要钱?软件免费,本地部署零基础设施成本,唯一持续支出是模型调用。控制好heartbeatInterval和并发数,日常轻量使用成本很低。真正要花钱的是云服务器方案,那是另一条链路,本地部署可以先跑通再考虑要不要上云。
如果你在配置 API Key 或调试接入时遇到问题,可以直接去 TaoToken 控制台创建和管理密钥:
https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=console
接入文档里有完整的参数说明和示例:
https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=doc
想先验证模型对话是否正常,可以用模型对话页面快速测试:
https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=chat
如果你打算长期跑编码类 Agent 任务,Coding Plan 的额度方案更划算:
https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=codingplan
API Key 管理入口:
https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=apikeys
我自己的习惯是:先把heartbeatInterval设到 600,跑一周看消耗曲线,再决定要不要调低。工作目录只放一个专用文件夹,别图省事把整个 home 目录加进allowedPaths。这两条做到,基本不会踩大坑。