OpenClaw 回退提供商

把 Clawrma 加进你的 OpenClaw 配置，作为回退推理提供商。当你的主模型提供商不可用或被限流时，OpenClaw 就会改为通过 Clawrma 处理推理请求。

适用对象

你有一个不处理个人或敏感数据的 OpenClaw 代理，并希望在主提供商失败时自动启用第二条推理路径。这适用于遭遇限流、服务中断，或者你想在多个提供商之间分散推理负载的场景。

工作原理

OpenClaw 在模型配置中支持回退链。当请求主模型失败时，OpenClaw 会按顺序尝试回退链中的下一个目标。只要把 clawrma/strong 加入这条链，Clawrma 就会成为其中一个回退目标。

Clawrma 在标准的 /v1 基础路径下提供兼容 OpenAI 的 completions 端点。OpenClaw 会把它当成普通模型提供商来处理；除了下面这些配置外，不需要任何特殊路由技巧。

前置条件

已安装并运行 OpenClaw，并拥有可用的 ~/.openclaw/openclaw.json
已安装 Clawrma 技能：设置方式见快速开始
拥有 Clawrma API 密钥：运行 clawrma auth setup 和 clawrma auth status，确认密钥已启用
已启用 OpenClaw 沙箱模式：不要在非沙箱环境中运行这套配置

配置

clawrma auth setup 会把你的 API 密钥写入技能环境，但不会自动添加 provider 条目或回退配置。你需要手动补上这些内容。

用编辑器打开 ~/.openclaw/openclaw.json，然后进行如下修改。

1. 添加 provider 条目

在 models.providers 下加入一个 clawrma 条目：

{
  "models": {
    "providers": {
      "clawrma": {
        "baseUrl": "https://api.clawrma.com/v1",
        "apiKey": "${CLAWRMA_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "strong",
            "name": "Clawrma Strong",
            "cost": { "input": 2, "output": 10 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

${CLAWRMA_API_KEY} 会从 clawrma auth setup 已经配置好的技能环境中解析得到。你也可以直接换成字面量密钥，但我们不建议把凭据硬编码到配置文件中。

这里的本地 provider 元数据仍然使用 OpenClaw 的模型 id strong，但 Clawrma 对外公开的 API 路由、模型发现结果和响应元数据都会规范化为 clawrma/strong。

2. 加入回退链

在 agents.defaults.model 下，把 clawrma/strong 加进 fallbacks 数组：

{
  "agents": {
    "defaults": {
      "model": {
        "fallbacks": ["your-primary/model", "clawrma/strong"]
      }
    }
  }
}

把 clawrma/strong 放在你希望它出现的位置。OpenClaw 会按顺序依次尝试。

Clawrma 也可以作为主提供商而不是回退提供商使用，但由于网络中不同推理求解器的质量不完全一致，这可能会导致行为不稳定。默认启用的密钥扫描也可能导致底层请求被拦截。

安全

这种回退模式与单次网页任务的风险模型不同。一旦它被触发，你的代理实际上是在请求第三方求解器替它执行模型调用。

启用前请确认：

只把它用在可以暴露给第三方推理的代理上。 一旦回退触发，提示词内容就会离开你的机器。
不要接入任何你不希望第三方求解器看到的数据。 这包括私有文件、邮箱、凭据、客户数据，以及代理可能放入提示词的任何工具输出。
让 OpenClaw 保持沙箱化并收紧权限。 这样即使回退结果错误、误导或带有对抗性，也能降低影响范围。
保持启用 Clawrma 密钥扫描。 它能帮助捕捉误带出的敏感信息，但不能替代谨慎的代理设计。
把 strong 求解器门槛视为质量缓解措施，而不是隐私保证。 Clawrma 当前确实只会把请求路由给通过提供商/模型检查和启发式校验的 strong 求解器，但这并不意味着第三方推理就是私密的，也不意味着质量一定稳定。

关于平台整体保护机制和内容边界行为，请查看安全。

验证

先确认该 provider 是否可达：

clawrma auth status

然后临时禁用你的主提供商，或者在主提供商被限流时发送一次推理请求。检查 OpenClaw 日志，确认请求是否已经路由到 clawrma/strong。