1. 为什么我要把 OpenClaw 装成常驻服务OpenClaw 是一个能把大模型接到你本机、让 AI 助手直接读写文件、执行命令、操作浏览器的开源智能体框架。它适合谁适合每天要在电脑上处理大量文件、写代码、查资料又不想反复打开网页复制粘贴的开发者。我最初只是把它当玩具openclaw gateway start跑一次、聊两句就关掉结果每次重启电脑都要重新来一遍API Key 还要在好几个模型之间来回切烦得不行。真正的转折点是我决定让它常驻后台开机自启、统一走一个 Key、随时喊一声就能干活。这篇就按这个目标来写——先解决 OpenClaw 本地部署再解决多模型 Key 管理最后把常驻进程和启动验证做扎实。核心思路是OpenClaw 负责“手脚”本机操作能力TaoToken 负责“大脑入口”统一模型调用两者拼起来才是一个稳定的常驻 AI 助手。下面所有命令和配置我都实际跑过你可以直接复制。环境以 macOS / Linux 为主Windows 差异我会单独标注。2. 前置准备Node 环境与 TaoToken 统一 Key2.1 确认 Node 与 OpenClaw CLIOpenClaw 是 Node 写的先确认版本node -v # 需要 18低于这个版本先去 nodejs.org 升级安装 CLI国内网络建议先切镜像npm config set registry https://registry.npmmirror.com npm install -g openclaw openclaw --version能打印版本号就说明 CLI 到位了。这一步只是命令行工具真正干活的后台服务是 Gateway后面单独启动。2.2 为什么用 TaoToken 统一 KeyOpenClaw 默认让你在配置里给每个模型单独填api_key和base_url。问题在于你想用 Claude 写代码、用别的模型做总结就得维护好几套 Key换一次模型改一次配置还容易把 Key 写死在文件里。我试过把 Key 散落在config.yaml各个模型块里后来加模型时漏改一处排查了半天。TaoToken 的思路是提供一个统一的 API 入口OpenClaw 只认一个base_url和一个 Key具体调哪个模型由请求里的模型名决定。这样配置文件干净换模型不用动 Key。你需要先去控制台拿一个 Key注册/登录后进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建 API Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档字段说明、模型名列表https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址是https://taotoken.net/api这个地址不加 UTM 参数直接填进配置。拿到形如sk-xxxx的 Key 后先放一边下一步写进配置。注意Key 属于敏感信息别提交到 Git也别贴到公开聊天里。配置文件建议放在用户目录并限制权限。3. 可复制的 config.toml 骨架与接入步骤3.1 生成配置目录先跑一次初始化让它把目录结构建出来openclaw init交互里问“选择 AI 提供商”时选“自定义 API / Custom”因为我们要指向 TaoToken。工作目录保持默认即可。完成后配置在~/.openclaw/下。不同版本配置文件名可能是config.yaml或config.toml下面以config.toml为例字段含义一致。3.2 config.toml 骨架把下面这份骨架复制进~/.openclaw/config.toml把sk-你的TaoTokenKey换成你自己的# OpenClaw 主配置 default_model claude-sonnet # 统一走 TaoToken只维护一个 Key [providers.taotoken] base_url https://taotoken.net/api api_key sk-你的TaoTokenKey type openai-compatible # 模型别名请求时用左边的名字实际映射到 TaoToken 支持的模型 [models.claude-sonnet] provider taotoken model claude-sonnet-4-20250514 [models.gpt-4o] provider taotoken model gpt-4o [models.deepseek-chat] provider taotoken model deepseek-chat # 能力开关常驻助手建议按需开 [capabilities] file_access true web_search true code_execution true browser false # 不需要浏览器操作就先关掉减少常驻资源占用 # 工作目录白名单避免 AI 乱翻文件 [workspace] allow_paths [/Users/你的用户名/Documents, /Users/你的用户名/projects]几个关键点解释一下。type openai-compatible表示按 OpenAI 兼容协议发请求TaoToken 的/api入口兼容这套格式所以 OpenClaw 不需要为每个厂商写适配。default_model指向你在[models.*]里定义的别名想换默认模型只改这一行。allow_paths是安全边界常驻服务最怕权限过大先把范围收窄。3.3 用环境变量存 Key更稳把 Key 明文写在配置里有泄露风险可以用环境变量覆盖。在~/.zshrc或~/.bashrc里加export TAOTOKEN_API_KEYsk-你的TaoTokenKey然后配置里改成引用[providers.taotoken] base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} type openai-compatible改完执行source ~/.zshrc让变量生效。这样配置文件可以放心备份Key 留在环境里。4. 启动 Gateway 并验证请求成功4.1 启动后台服务OpenClaw 的常驻能力靠 Gatewayopenclaw gateway start正常会看到类似输出OpenClaw Gateway starting... Gateway started on http://localhost:3000 WebSocket server ready Plugin system initialized看到Gateway started就说明服务起来了。此时它已经在后台监听Web Chat 可以直接访问http://localhost:3000。4.2 验证模型请求真的通了光启动不够得确认 Key 和模型映射没问题。用 CLI 发一条测试请求openclaw chat --model claude-sonnet 用一句话说明你现在能做什么如果返回了模型回复说明 TaoToken 的 Key、base_url、模型别名三层都通了。想验证别的模型换--model gpt-4o再试一次即可不用改任何 Key。也可以直接看 Gateway 状态和日志openclaw gateway status openclaw logs日志里如果出现401或invalid api key就是 Key 没生效出现model not found就是[models.*]里的model字段名写错了对照接入文档里的模型名改一下。4.3 设置开机自启实现真正常驻手动start只是本次开机有效重启就没了。设置自启# macOS / Linux openclaw gateway setup-autostartWindows 用管理员身份打开终端再执行同一条命令。设置完可以重启一次电脑开机后直接跑openclaw gateway status显示 running 就说明常驻成功。如果你更习惯用进程管理器也可以用 pm2 托管npm install -g pm2 pm2 start openclaw -- gateway start pm2 save pm2 startuppm2 save记住当前进程列表pm2 startup生成开机自启脚本这样即使 Gateway 崩了也会被拉起来。5. 本篇常见错误排查5.1 端口 3000 被占用现象启动时报EADDRINUSE。解决换端口启动。openclaw gateway start --port 3001换端口后 Web Chat 地址也要跟着变成http://localhost:3001。5.2 Key 报错 Invalid API Key先确认环境变量有没有生效echo $TAOTOKEN_API_KEY如果为空说明source没执行或者写错了 shell 配置文件。如果变量正常但还报错检查 Key 前后有没有多余空格以及控制台里这个 Key 是否被禁用或额度耗尽。5.3 模型名不匹配现象请求返回model not found。原因是[models.xxx]里的model字段和 TaoToken 实际支持的模型名对不上。去接入文档核对准确名称注意有些模型名带日期后缀少一段就匹配不上。5.4 文件访问被拒绝现象AI 说无法访问某文件。检查allow_paths是否包含目标目录路径要写绝对路径别用~。改完配置后重启 Gateway 才生效openclaw gateway restart5.5 开机自启没生效macOS 上先确认setup-autostart执行时没有报权限错误Linux 下如果用 systemd检查服务状态systemctl --user status openclaw。用 pm2 的话pm2 startup会打印一行需要你手动执行的命令别漏掉。6. 常驻之后把 OpenClaw 用顺手的几个动作配置稳定后日常维护其实很轻。查看状态、重启、看日志三条命令记住就够openclaw gateway status openclaw gateway restart openclaw logs想升级版本用npm update -g openclaw升级后建议重启一次 Gateway。如果你要长期跑编码类任务、或者接 Agent 做多步骤自动化可以考虑用 Coding Plan 把额度规划得更清楚https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先在网页里直接试模型对话、确认哪个模型适合你的场景可以走模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要补 Key、换 Key 或者看用量回控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入字段和模型名有疑问直接查文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content我踩过最深的坑是把allow_paths设得太宽结果 AI 在整理文件时动到了不该动的目录。常驻助手的第一原则是权限收窄先只给它一两个工作目录用顺了再逐步放开。另一个经验是default_model别频繁换固定一个主力模型其他模型按需在请求里指定这样日志和排查都清爽。