让 OpenClaw 的模型调用走 Router One

在受支持的 Node.js 上安装 OpenClaw，并建一把有上限的 Key

OpenClaw 2026.9.6 自 2026-09-23 起是 npm latest 标签对应的版本，要求 Node.js 24.16+ 或 26.1+，推荐 Node 26；其他运行时（包括 Node 22 和 Node 25）都会被它提示为不受支持。官方安装脚本会自带受支持的 Node：macOS、Linux 和 WSL2 用 curl -fsSL https://openclaw.ai/install.sh | bash，Windows PowerShell 用 iwr -useb https://openclaw.ai/install.ps1 | iex。全新安装时，脚本结束后会打开交互式 onboarding 向导，里面同样可以选择自定义 provider，效果与下面的命令一致。如果 Node 由你自己管理，就用 npm 安装：OpenClaw 的 README 要求 npm 12 或 npm 11.16+ 加上 --allow-scripts=openclaw，npm 11.15 及更早版本不加。extended-stable 通道（2026.7.35）接受 Node 22.22.3+、24.15+ 或 25.9+，onboarding 参数的要求相同。然后为这台机器单独创建一把 Router One Key，并设置 maxSpend。OpenClaw 会在没人发消息时自己行动，Key 触到上限后，下一个请求会收到 HTTP 402，不会继续花钱，你的其他 Key 照常可用。Key 用量达到 maxSpend 的 80% 及触顶时，控制台还会发送站内通知。

# macOS / Linux / WSL2: the official installer provisions Node, then opens the onboarding wizard
curl -fsSL https://openclaw.ai/install.sh | bash
# Or, on Node 24.16+ / 26.1+ with npm 12 or npm 11.16+ (drop the flag on npm 11.15 or earlier):
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw --version

把 OpenClaw 配置到 Router One base URL

先把 Key 导出为 CUSTOM_API_KEY，再运行下面的命令。--non-interactive 必须同时带 --accept-risk：缺了它，onboarding 会在写入任何配置之前报 Non-interactive setup requires explicit risk acknowledgement 并退出，因为这个参数表示你已知悉 OpenClaw 的安全提示——拥有完整系统权限的 agent 存在风险。--auth-choice custom-api-key 选择自定义 provider，省略 --custom-api-key 时从 CUSTOM_API_KEY 读取 Key。--custom-base-url 填 OpenAI 兼容的 base URL，恰好一个 /v1。--custom-model-id 填目录里的精确 ID；OpenClaw 在第一个斜杠处切分模型引用，所以带厂商前缀的 openai/gpt-5.6-sol 会变成 router-one/openai/gpt-5.6-sol，照样能解析。--custom-provider-id 把 provider 名固定为 router-one；不写的话，OpenClaw 会按主机名生成一个，比如 custom-api-router-one。--custom-compatibility openai 选择 OpenAI Chat Completions，每一轮都是发往 /v1/chat/completions 的 POST，这个端点服务目录里的全部对话模型。--install-daemon 把 Gateway 安装成后台服务（launchd、systemd，Windows 上是计划任务）。保存之前，onboarding 会用一个很小的请求检查模型：消息内容是 Hi，输出上限 16 个 token。它会到达 Router One，所以控制台 → 日志里出现这条记录，就说明 Key、地址和模型 ID 都没问题。在 PowerShell 里，改用 $env:CUSTOM_API_KEY 设置 Key，并把每行末尾的反斜杠换成反引号：

export CUSTOM_API_KEY=sk-your-router-one-key

openclaw onboard --non-interactive --accept-risk \
  --auth-choice custom-api-key \
  --custom-base-url https://api.router.one/v1 \
  --custom-model-id openai/gpt-5.6-sol \
  --custom-provider-id router-one \
  --custom-compatibility openai \
  --install-daemon

onboarding 往 ~/.openclaw/openclaw.json 里写了什么

onboarding 把 provider 存在 models.providers.router-one 下，并把它的模型设为默认，models.mode 保持 merge，OpenClaw 内置的 provider 仍然可用。从 OpenClaw 2026.9.4 起，自定义 provider 必须显式列出模型；用相同的 provider ID 和 base URL、换一个 --custom-model-id 再跑一次 onboarding，会把新模型追加进列表并设为主模型。它写入的值里有三项只是占位，需要手动改，因为 OpenClaw 没法从 Router One 读到：上下文窗口、输出上限和价格。OpenClaw 会自动把常见的视觉模型 ID 标记为支持图片输入；如果模型详情页列出了图片输入，而 OpenClaw 对这个 ID 没有这样标记，就加上 --custom-image-input。

按端点选择 --custom-compatibility：openai、openai-responses 还是 anthropic

这个参数决定 OpenClaw 调用 Router One 的哪个端点，而每个端点服务的目录模型不一样。它按 provider 条目固定，所以要同时用两种协议，就用两个 provider ID 各跑一次 onboarding，比如 router-one 和 router-one-anthropic。用同一个 router-one 配一个不同的 base URL 并不会覆盖原条目，OpenClaw 会把新条目存成 router-one-2。选 anthropic 时，OpenClaw 2026.9.6 无论填 https://api.router.one 还是 https://api.router.one/v1 都能访问到 /v1/messages；建议填主机根地址，这也是 Router One 文档给出的 Anthropic 兼容 base URL。走 openai-completions 时，自定义端点被视为非官方端点，OpenClaw 会用 system 角色而不是 developer 角色发送系统提示词。onboarding 的检查请求也随协议变化：Chat Completions 上是 Hi 加 max_tokens 16，Responses 上是 input 为 Hi、max_output_tokens 16，Messages 上是 max_tokens 1。

无人值守时的费用从哪来：心跳、唤醒与回退

OpenClaw 的设计就是会自己行动，所以控制台 → 日志里可能出现没人输入过的请求。最大的来源是心跳（heartbeat）：主会话的定时轮次，默认每 30 分钟一次，会过一遍一份简短的检查清单，必要时给你发消息。定时心跳需要开启自动化（cron.enabled），并且要有可以汇报的主人：commands.ownerAllowFrom 的第一项，或某个渠道的 allowFrom。找不到可用的主人私信路由时，每次轮询都会在模型运行前以 reason=no-route 跳过，所以计费的心跳通常从你接入聊天渠道或指定主人之后才开始，而不是 onboarding 一完成就有。控制方法：把 agents.defaults.heartbeat.every 调长，或设为 0m 停掉周期心跳；用 activeHours 限定时间段；设置 isolatedSession: true，让每次心跳不带会话历史，再加 lightContext: true 跳过工作区的引导文件。按心跳文档的估算，独立会话能把每次心跳从约 100K tokens 降到 2–5K。0m 不会停掉事件触发的唤醒：后台命令执行完时，OpenClaw 可能再跑一轮来汇报结果，除非把 tools.exec.notifyOnExit 设为 false。另外还有两个来源值得知道。OpenClaw 自己的模型回退（fallbacks）可能把失败的一轮转到你配置的其他模型、provider 或 Key 上，这不属于 Router One 的同模型重试，所以回退要有意识地配置。记忆搜索需要一个 embeddings 服务，而 Router One 不提供（没有 /v1/embeddings），所以要么另配一个，要么接受只按关键词检索的结果。

核对第一轮对话，并切换模型

先运行 openclaw gateway status 确认守护进程在运行，再用 openclaw dashboard 打开 Control UI 发一条消息；openclaw models status 会显示实际生效的默认模型和凭据概况。每条消息在控制台 → 日志里至少对应一个请求，记在你创建的那把 Key 名下，带模型、tokens、费用、状态和总耗时；产生过输出的流式回复还会显示首字延迟（TTFT）。工具调用会在同一轮里追加后续请求，所以一轮对话可能对应好几个请求。只在当前对话里换模型，发送 /model router-one/<精确 ID> -s；要改默认模型，运行 openclaw models set router-one/<精确 ID>。由于自定义 provider 需要显式的模型列表，先把这个 ID 加进 models.providers.router-one.models，或者用它重新跑一次 onboarding。优先选模型详情页列出了工具调用的 ID，因为 OpenClaw 的工具依赖它；其他 ID 先测试一次工具调用。

OpenClaw 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 OpenClaw 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。

OpenClaw 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在请求日志里核对 OpenClaw 的调用

先在 OpenClaw 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、花费、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。

常见问题