用 BoostRail 跑 OpenClaw

OpenClaw 让 agent 长时间连续运行,这是开发者手上最耗 token 的一类负载,而模型访问要自己带。把 BoostRail 加成自定义 provider 之后,所有 agent 共用一把 Key、一张账单,整个目录随便选。

长跑的 agent 为什么适合走网关

连续运行的 agent 会不断重复上下文,这正是缓存与 agent 负载定价针对的流量形态:缓存读按输入价 10% 计,缓存写不加价,agent 负载按挂牌价 95% 计。

另一面是:上游一次故障或一堵速率墙,就能让 agent 在任务中间停住。走网关只有一个 OpenAI 兼容端点覆盖主流模型,换模型是改配置里的一个字符串,而不是重新开户、拿新 Key、再做一遍接入。

把 BoostRail 加为自定义 provider

OpenClaw 读 ~/.openclaw/openclaw.json(JSON5,可以写注释和尾逗号)。在 models.providers 下定义 provider,然后用 boostrail/<模型 id> 引用它的模型。

{
  models: {
    mode: "merge",
    providers: {
      boostrail: {
        baseUrl: "https://api.boostrail.com/v1",
        apiKey: "${BOOSTRAIL_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "claude-sonnet-5",
            name: "Claude Sonnet 5",
            input: ["text"],
            contextWindow: 200000,
            maxTokens: 64000,
          },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "boostrail/claude-sonnet-5" },
    },
  },
}

• 把 BOOSTRAIL_API_KEY 配在 OpenClaw 运行的环境变量里。Key 的值放环境变量,不要写进配置文件。
• 要用几个模型就加几条 model 条目,id 从模型页原样复制。目录 id 是稳定字符串,例如 claude-sonnet-5、deepseek-v4-pro、gpt-5.4。
• 如果你的配置用 agents.defaults.modelPolicy.allow 限制了可用模型,记得把 boostrail/* 或具体模型 ref 加进去——只定义 provider 不会让模型自动可选。
• contextWindow 与 maxTokens 描述的是你选的那个模型,不是网关。具体数值(含带上限标注的那几款)以模型页为准。

Anthropic 协议的另一种接法

OpenClaw 也带 anthropic-messages 适配器。如果你想让 Claude 系走 Anthropic 原生协议而不是 OpenAI 兼容面,把这个适配器指向网关根地址即可。

boostrail-anthropic: {
  baseUrl: "https://api.boostrail.com",
  apiKey: "${BOOSTRAIL_API_KEY}",
  api: "anthropic-messages",
  models: [
    { id: "claude-sonnet-5", name: "Claude Sonnet 5", input: ["text"] },
  ],
}

确认接通

放手让 agent 无人值守跑之前,先用同一把 Key 和同一个 base URL 打一次。如果 curl 通了而 OpenClaw 不通,问题在配置文件或模型 allowlist,不在网关。

curl https://api.boostrail.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"reply with OK"}]}'

接通的返回是一段 JSON,里面有 choices 数组和模型的回复。几秒后控制台就能看到这次调用的用量和实际计价。

OpenClaw 常见问题

一把 Key,跑你所有的 agent

建一把 Key、加上 provider 块,agent 就能指向目录里的任何模型。