OpenClaw

在 BoostRail 上运行 OpenClaw

OpenClaw 让 agent 持续运行，是开发者手里消耗 token 很多的一种用法，而且模型访问要你自己提供。把 BoostRail 加为自定义 provider 后，所有 agent 共用一个 Key、一份账单，整个目录都可以选。

长时间运行的 agent 为什么适合用一个 API

持续运行的 agent 会不停重复上下文。模型所在线路支持提示词缓存时，命中缓存的输入按这款模型公布的缓存读取价计费；除 DeepSeek V4 Pro、DeepSeek V4.1 Flash 和 Kimi K3 外，不高于厂商官方的缓存读取价。缓存写入不加价。主流模型的价格不高于官方牌价。

持续运行也意味着，一家厂商出一次故障或碰上速率限制，agent 就会在任务中途停下。通过 BoostRail，你用一个 OpenAI 兼容端点调用主流模型，换模型只是改配置里的一个字符串，不用重新开账号、拿新 Key、再做一遍接入。

把 BoostRail 加为自定义 provider

OpenClaw 读取 ~/.openclaw/openclaw.json（JSON5 格式，可以写注释和尾逗号）。在 models.providers 下定义 provider，再用 boostrail/<模型 ID> 引用它的模型。

~/.openclaw/openclaw.json

{
  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" },
    },
  },
}

在 OpenClaw 运行的环境里设置 BOOSTRAIL_API_KEY。Key 的值放在环境变量里，不要写进配置文件。
要用几款模型，就加几条模型配置，ID 从模型页原样复制。目录里的 ID 是固定的字符串，例如 claude-sonnet-5、deepseek-v4.1-flash、gpt-5.4。
如果你的配置用 agents.defaults.modelPolicy.allow 限制了可用模型，要把 boostrail/* 或具体的模型引用加进去；只定义 provider，模型不会自动变成可选。
contextWindow 和 maxTokens 描述的是你选的模型，不是 BoostRail。具体数值以模型页为准，包括那几款有上下文上限的模型。

用 Anthropic 协议的另一种接法

OpenClaw 还带有 anthropic-messages 适配器。如果你想让 Claude 模型走 Anthropic 原生协议，而不是 OpenAI 兼容接口，就把这个适配器指向 API 根地址。

provider 配置（Anthropic 协议）

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 不通，问题在配置文件或模型白名单，不在 BoostRail。

直接调用 API 的一条命令

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

接通后会返回一段 JSON，里面有 choices 数组和模型的回复。几秒钟内，控制台就会显示这次请求的用量和实际适用的价格。

OpenClaw 常见问题

该选哪种协议？

openai-completions 用一段 provider 配置就能覆盖整个目录，作为默认选择更简单。只有想让 Claude 模型走 Anthropic 原生协议时，才用 anthropic-messages；两段 provider 配置可以同时存在。

这份配置做过端到端验证吗？

它按 OpenClaw 文档里的自定义 provider 格式写成，用的端点与本站其他编程工具配置相同。我们还没有用 OpenClaw 对 BoostRail 做过端到端运行；如果你的环境有不同，请告诉我们，我们会更正这一页。

长时间运行的 agent 怎么计费？

按 token 以美元计费，主流模型的价格不高于官方牌价。模型所在线路支持提示词缓存时，命中缓存的输入按这款模型公布的缓存读取价计费；除 DeepSeek V4 Pro、DeepSeek V4.1 Flash 和 Kimi K3 外，不高于厂商官方的缓存读取价。缓存写入不加价。没有按月的席位费，也没有订阅时间窗，agent 实际用多少就付多少。

能继续用我自己的厂商 Key 吗？

能。BYOK 让请求走你自己的厂商账号和合同价，同时只保留一套接入；每月有免费的 BYOK 额度，Key 用尽时由平台兜底。

你运行的所有 agent，共用一个 Key

创建一个 Key，加上 provider 配置，就能让 agent 使用目录里的任意模型。

获取 API Key 编程工具阅读文档

更新日期：2026-10-03