OpenClaw 的最佳 API：按任务选择提供商和模型

要为 OpenClaw 选择最佳 API，请从有文档说明的模型提供商开始。模型多样性方面选择 OpenRouter；专注的 Claude 配置方面选择直接使用 Anthropic；当模型费率是你的主要购买标准时，再比较 Kunavo。要获得最便宜且可持续的配置，请将例行检查与困难工作分开，而不是把每项任务都发送给一个昂贵模型。

本指南比较的是生成助手响应和工具调用的LLM API。搜索、浏览和图像服务是独立购买项。有关托管和完整运营账单，请参见OpenClaw 定价。

根据购买内容选择提供商

OpenClaw 发布了提供商目录、OpenRouter 设置指南以及单独的自定义提供商参考。价格表中列出的网关并不会自动成为 OpenClaw 的内置集成。

为不同工作使用不同模型

对于简短摘要、分类和有界心跳检查，请从Claude Haiku 4.5开始。对于普通编码和工具工作，请将Claude Sonnet 5列入候选。对于复杂的仓库变更和扩展推理，请将Claude Opus 5列入候选。这些起点遵循Anthropic 的模型选择指南；它们不是 OpenClaw 的基准测试结果。

明确升级规则。例行检查可以报告已知状态，或将未知情况交给更强的模型。它不应悄然扩大为大型调试任务。如果检查只需将一个值与阈值比较，就直接执行比较，并将模型保留用于解释异常。

能力层级和提供商价格是两个独立的决策。比较你想要的模型对应的实际行；网关费率不一定遵循提供商标价的相同排序。

具体价格比较

比较不同提供商提供的同一模型。表格显示每百万个标准未缓存输入和输出令牌的 USD 价格：Anthropic 直接 API 的价格（已于 2026 年 9 月 17 日检查），以及当前的Kunavo 目录费率。缓存费用、付费工具和税费另行计算。

假设你每月有 10 million 个未缓存输入令牌和 1 million 个输出令牌。按这些费率，将全部令牌放在 Claude Opus 5 上的成本为 $52.50。将 9 million 个输入令牌和 900,000 个输出令牌分配给 Claude Haiku 4.5，其余部分分配给 Claude Opus 5，成本为 $14.70。

这是基于假设工作负载分配的算术结果，不是承诺的节省金额。它不包括缓存费用、外部工具和基础设施，并假设较小的模型可以在不额外尝试的情况下完成分配给它的工作。最后这一条件决定较低费率是否会带来较低账单。

规划首次付款和持续上下文费用

Kunavo 从$10 的预付充值开始，不要求订阅，余额也不会过期。小任务会消耗部分余额；其令牌成本并不等于开通有资金账户所需的现金。计费指南还解释了为什么目录估算不是价格上限：当上游成本计费超过该估算时，最终收费可能更高。

OpenRouter 的额度条款规定最低购买金额为 $5。其标准按用量付费银行卡费用为 5.5%，每次充值最低 $0.80。因此，$5 的额度在税前需要支付 $5.80，$100 则需要支付 $105.50。该费用在账户充值时支付，不会再次加到每次 API 调用中。请比较你实际会消耗的已充值额度。

对于反复发送相同指令的助手，在根据新输入价格做选择前，请比较报告的缓存命中。直接使用 Sonnet 5 时，每百万个缓存读取令牌的成本为 $0.20，五分钟写入为 $2.50，一小时写入为 $4；Kunavo 对同一模型的目录缓存读取费率为 $0.14。其 Claude 缓存写入按输入费率的 1.25 倍计费。这些计费费率并不能证明每条 OpenClaw 路由都使用缓存：在将例行检查按缓存命中进行预算前，请验证返回的用量。

Anthropic 的定价以 Sonnet 5 和 Opus 5 的标准费率包含受支持的 1M 上下文窗口；Kunavo 对这些 Claude 模型也不收取长上下文附加费。更长的历史记录仍意味着更多计费令牌。限制例行检查的规模，并在月度估算中分别计入新输入、缓存写入、缓存读取和输出。

什么时候购买 OpenRouter、免费方案或本地方案更合适

当你需要比较模型系列或控制上游提供商偏好时，选择 OpenRouter。其路由文档支持价格、延迟和吞吐量等优先级。选择具体模型并查看其实时价格，不要假设自动路由总会选择可接受结果中最便宜的一个。

将免费端点用于初步探索或非紧急工作。OpenRouter 记录了免费模型的请求限制，因此零令牌价格并不能证明其容量足以支持全天候助手。不要让未经检查的额度依赖成为时间敏感例行工作的基础。

当硬件已经可用且你能够接受运营工作时，选择本地推理。OpenClaw 的Ollama 设置会检查模型能力，包括工具支持。一个聊天表现良好但无法执行所需工具工作流的模型，对于该工作而言并不是有用的便宜方案。

在增加故障转移复杂性前，先购买一条可用路由

首先选择模型角色和提供商。通过一个有界任务确认模型 ID、端点、流式传输、工具调用和用量报告。然后在明确预算的情况下添加故障转移路由；否则故障可能会悄然将工作转移到不同的价格或能力层级。

在 OpenClaw 中配置 Kunavo 路由

这是基于 OpenClaw自定义提供商架构和 Kunavo Messages 端点的纯文本起始配置。此处尚未通过付费 OpenClaw 任务进行验证。试用期间请保留当前可用的路由。

1. 在API 密钥中创建 Kunavo 密钥，并准备发送付费请求时在账单中为账户充值。
2. 在网关环境中设置 KUNAVO_API_KEY。OpenClaw 也会读取 ~/.openclaw/.env，你可以在那里添加 KUNAVO_API_KEY=your-key；已有的进程变量优先级更高。请参见环境参考。不要将真实密钥放入项目文件。
3. 备份你的配置，然后将以下字段合并到 ~/.openclaw/openclaw.json 中，同时保留其他提供商、代理和频道。配置指南介绍了非默认文件位置。

{
  "models": {
    "mode": "merge",
    "providers": {
      "kunavo": {
        "baseUrl": "https://api.kunavo.com",
        "apiKey": "${KUNAVO_API_KEY}",
        "api": "anthropic-messages",
        "authHeader": true,
        "models": [
          {
            "id": "claude-haiku-4-5",
            "name": "Claude Haiku 4.5",
            "input": [
              "text"
            ],
            "contextWindow": 200000,
            "maxTokens": 1024
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kunavo/claude-haiku-4-5"
      }
    }
  }
}

基础 URL 是源站地址：此适配器会追加 /v1/messages。kunavo/ 前缀用于标识 OpenClaw 提供商；请求中的模型 ID 仍为 claude-haiku-4-5。这里的 1024 是首次试用时刻意设置的较小输出上限，并非模型的原生最大值。该示例只声明文本输入。

openclaw config validate
openclaw gateway restart
openclaw models list --provider kunavo

配置验证会检查配置，而模型列表会检查已加载的目录；二者都不能证明付费任务可以正常运行。请在列出模型前重启，以便运行中的网关加载新的提供商。打开新会话并确认其当前模型：现有会话或代理可能仍保留默认模型的覆盖设置。

第一项任务：让它读取一个小型临时 README 并进行总结，然后针对该文件提出一个后续问题。在安排计划任务之前，检查 Kunavo 中的工具结果、响应流式传输以及记录的费用。401 错误需要检查网关环境中的密钥；模型未找到错误需要检查提供商前缀和模型 ID。本地费用元数据缺失时，即使提供商已为请求计费，也可能显示零估算费用。

常见问题

官方文档于 2026 年 9 月 17 日检查。Kunavo 的费率和示例总额根据实时模型目录计算。