1. 为什么要在 Node.js 里跑 OpenClawOpenClaw 是一个能真正“动手做事”的开源 AI Agent 项目不是只会聊天的机器人。你让它整理桌面文件它会直接归类完成并告诉你结果你让它查日程、发邮件、跑脚本它会调用对应技能去执行。它适合想在本地或服务器上搭建自动化助手的开发者尤其是已经熟悉 Node.js 生态、希望把 AI 能力接进自己工作流的人。但真正落地时大多数人卡在同一个地方模型通道。OpenClaw 需要调用大模型来理解指令、规划步骤而每个模型供应商的 Key、地址、计费方式都不一样。如果你同时用 Claude、GPT 或者国产模型就要维护多套配置切换起来很麻烦。我这次的做法是用 TaoToken 统一 Key 和 API 通道把模型接入收敛成一个入口OpenClaw 只认一个地址和一把 Key后面换模型、加模型都不用改 Agent 逻辑。这篇教程按“从零搭建到进阶编排”的顺序走先装 Node.js 环境和 OpenClaw再配好 TaoToken 通道然后给出可复制的 config.toml 与 settings.json 骨架接着用 Docker 部署并做连通性验证最后把常见报错逐个排掉。你跟着做能完成从本地调试到自动化任务跑通的闭环。2. TaoToken 前置统一 Key 与 API 通道OpenClaw 的模型调用走的是 OpenAI 兼容协议所以只要有一个兼容的 base_url 和 api_key就能接上。TaoToken 提供的正是这个统一入口你注册后拿到一把 Key把请求地址指向它的 API 端点OpenClaw 就能通过它调用后端模型。这样做的好处是Agent 侧配置只写一次后面换模型只改模型名不用动 Key 和地址。先拿到 Key。打开官网注册并登录进入控制台创建 API Key官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台创建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建后复制那串以sk-开头的 Key先存到环境变量里不要直接写进代码仓库。API 基础地址用https://taotoken.net/api注意这个地址不带任何查询参数配置里原样填即可。注意Key 只显示一次复制后妥善保存。如果泄露去 API Keys 页面吊销重建。模型名怎么填TaoToken 的模型列表在文档里有对照表你可以先选一个通用对话模型做验证比如claude-sonnet或gpt-4o这类命名。具体可用模型以文档为准接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你后面要长期跑编码类 Agent 任务可以了解 Coding Plan它更适合高频调用场景Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite3. 环境准备与 OpenClaw 安装系统要求不复杂macOS、Linux 都行Windows 建议用 WSL。Node.js 版本要 ≥ v18这是硬门槛低于这个版本 OpenClaw 的依赖装不上。先检查node --version npm --version如果 Node 低于 v18用 nvm 升级nvm install 18 nvm use 18 nvm alias default 18Windows 用户直接在官网下载新版 Node 安装包覆盖安装即可。确认版本没问题后安装 OpenClaw。推荐用 npm 全局安装npm install -g openclaw openclaw --version如果你更喜欢容器化也可以直接用 Docker 镜像后面第 5 节会专门讲 Docker 部署。源码方式适合想改代码的人git clone https://github.com/openclaw/openclaw.git cd openclaw npm install npm run start安装完成后先别急着跑配置还没写。OpenClaw 的配置分两层config.toml管运行时行为settings.json管模型和通道。下一节给出可直接复制的骨架。4. 可复制的 config.toml 与 settings.json 骨架OpenClaw 的配置目录默认在~/.openclaw/。先建目录再写两个文件。config.toml控制 Agent 的运行模式、沙箱、日志和并发# ~/.openclaw/config.toml [agent] name my-agent language zh-CN sandbox true # 先用沙箱模式安全 max_steps 20 # 单次任务最大执行步数 [ai] provider openai-compatible base_url https://taotoken.net/api model claude-sonnet max_concurrent_requests 3 daily_limit 1000 cache_enabled true [logging] level info # 排障时改成 debug [memory] enabled true path ~/.openclaw/memorysettings.json放敏感信息和通道细节。Key 从环境变量读避免明文{ ai: { api_key_env: TAOTOKEN_API_KEY, base_url: https://taotoken.net/api, default_model: claude-sonnet, timeout_ms: 60000, retry: { max_attempts: 3, backoff_ms: 1000 } }, gateway: { enabled: true, port: 8787 }, skills: { auto_load: true, path: ~/.openclaw/skills } }设置环境变量把前面拿到的 Key 填进去export TAOTOKEN_API_KEYsk-你的Key想让它永久生效写进~/.bashrc或~/.zshrcecho export TAOTOKEN_API_KEYsk-你的Key ~/.zshrc source ~/.zshrc两个文件写完后跑一次初始化引导让 OpenClaw 校验配置openclaw onboard引导里选择“OpenAI 兼容”作为模型供应商地址填https://taotoken.net/apiKey 它会自动读环境变量。完成后启动openclaw或者打开可视化面板openclaw dashboard5. Docker 部署与连通性验证生产环境建议用 Docker 跑隔离性好重启方便。先拉镜像docker pull openclaw/openclaw:latest启动容器把配置目录和 Key 挂进去docker run -d --name openclaw \ -v ~/.openclaw:/root/.openclaw \ -e TAOTOKEN_API_KEYsk-你的Key \ -p 8787:8787 \ openclaw/openclaw:latest-p 8787:8787把网关端口映射出来方便本地访问 dashboard。启动后看日志确认没有报错docker logs -f openclaw连通性验证分三步。第一步确认容器在跑docker ps | grep openclaw第二步直接测 API 通道是否通。用 curl 打一次 TaoToken 的接口确认 Key 和地址有效curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [{role: user, content: 回复 ok}] }返回里能看到choices字段和内容说明通道正常。第三步让 OpenClaw 自己发一次请求。进容器执行docker exec -it openclaw openclaw chat 你好你能做什么如果 Agent 正常回复说明从 OpenClaw 到 TaoToken 再到模型的整条链路打通了。这一步过了后面装技能、配定时任务才有意义。6. 进阶编排技能、定时任务与多 Agent链路通了之后开始加能力。OpenClaw 的技能系统类似插件装一个就多一类能力openclaw skills install openclaw/file-organizer openclaw skills install openclaw/calendar openclaw skills install openclaw/tavily-search openclaw skills list装完重载openclaw skills reload定时任务是自动化的核心。比如每天早上 8 点推送天气、日程和未读邮件统计用 cron 配置openclaw cron add --name morning-brief \ --schedule 0 8 * * * \ --prompt 汇总今天的天气、日程和未读邮件数量用简洁中文输出 openclaw cron list多 Agent 适合把工作和个人事务分开。创建两个 Agentopenclaw create-agent work openclaw create-agent personal openclaw switch-agent work每个 Agent 有独立的记忆和技能集互不干扰。工作 Agent 可以装日历和邮件技能个人 Agent 装文件整理和搜索技能。自定义技能用 YAML 描述放在~/.openclaw/skills/下。比如一个每日科技摘要技能name: 每日科技摘要 description: 获取科技新闻并总结 triggers: - 今日科技 steps: - action: web_search query: latest tech news max_results: 5 - action: summarize content: {{search_results}} - action: respond message: 今日新闻{{summary}}保存后openclaw skills reload即可生效。成本控制也别忘设个日限额和并发上限openclaw config set ai.dailyLimit 1000 openclaw config set ai.maxConcurrentRequests 3 openclaw stats usage openclaw stats cost7. 本篇常见报错排查报错一401 Unauthorized。九成是 Key 没读到或写错了。先确认环境变量在容器里可见docker exec -it openclaw env | grep TAOTOKEN。如果为空说明启动时-e没传对或者 Key 里有空格。重新用引号包住 Key 启动。报错二ECONNREFUSED或连接超时。检查base_url是不是写成了带路径的地址。正确写法是https://taotoken.net/api不要在后面加/v1或斜杠。另外确认容器网络能出站docker exec -it openclaw curl -I https://taotoken.net/api看是否返回。报错三model not found。模型名拼错了或者该模型在你的账户下不可用。去接入文档核对模型列表先用一个确定可用的通用模型验证再换其他。报错四技能装了但触发不了。检查settings.json里skills.auto_load是否为 true以及技能文件是否在~/.openclaw/skills/下。改完必须openclaw skills reload不重载不生效。报错五定时任务不执行。容器时区默认 UTC你按本地时间写的 cron 会差几个小时。启动时加-e TZAsia/Shanghai统一时区再openclaw cron list确认任务已注册。报错六日志里一堆重试。多半是并发太高被限流。把max_concurrent_requests降到 2 或 1同时开启缓存cache_enabled true重复请求会命中缓存不再打接口。排障时把日志级别调到 debug能看到每次请求的完整链路openclaw config set logging.level debug openclaw logs8. 继续深入的方向链路跑通后你可以往几个方向扩展。一是把 Gateway 接到 Telegram 或 Slack这样在聊天窗口里就能指挥 Agent 干活不用开终端。二是给 Agent 加浏览器控制技能让它能打开网页、抓取内容、填表单适合做信息采集类任务。三是把常用流程固化成自定义技能比如周报生成、竞品监控、日志巡检一次编写反复使用。模型侧如果调用量上来了可以对比不同模型在具体任务上的表现通过 TaoToken 换模型名即可切换不用改 Agent 代码。想快速试模型效果直接用模型对话页面测模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite如果你在 Claude Code 或类似编码环境里也想复用同一套 Key参考这份接入说明ClaudeCodeAnthropic 接入https://taotoken.net/doc/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite配置这件事第一次写骨架最费时间写完之后就是复制粘贴改模型名。把config.toml和settings.json存进你的 dotfiles 仓库换机器时几分钟就能恢复整套 Agent 环境。
