#OpenClaw

OpenClaw 支持在 models.providers 中添加自定义 Provider。推荐优先使用 OpenAI Responses adapter；如果当前版本或模型不支持，再依据官方 Provider 文档选择 Chat Completions adapter。

#1. 准备

按 OpenClaw 官方文档安装，并确认版本：

openclaw --version
export GETROUTER_API_KEY="YOUR_API_KEY"

#2. 添加 Provider

将下面配置合并到 OpenClaw 配置文件：

{
  "models": {
    "mode": "merge",
    "providers": {
      "getrouter": {
        "baseUrl": "https://getrouter.ai/v1",
        "apiKey": "${GETROUTER_API_KEY}",
        "api": "openai-responses",
        "models": [
          {
            "id": "MODEL_ID",
            "name": "GetRouter Model"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "getrouter/MODEL_ID"
      }
    }
  }
}

保留已有渠道、Agent 和权限设置，不要用示例覆盖整个文件。

#最终请求路径

POST https://getrouter.ai/v1/responses

#3. 验证

1. 重启 OpenClaw；
2. 确认当前模型为 getrouter/MODEL_ID；
3. 先发送短文本；
4. 再测试工具调用和一个无副作用动作；
5. 最后再连接消息渠道或运行无人值守任务。

#常见问题

• Provider 或模型不存在： 检查两处 MODEL_ID 和 getrouter/ 前缀。
• 环境变量未读取： 确认启动 OpenClaw 的服务进程也能读取变量。
• /responses 404： Base URL 应为 https://getrouter.ai/v1。
• 当前版本没有 openai-responses： 只按该版本官方文档切换 adapter，并重新核对最终路径。
• 消息能回复但动作失败： 检查 Tool Calling、渠道权限和模型能力。

#安全建议

OpenClaw 可能连接真实消息渠道并执行动作。使用独立 Key、额度上限、最小工具权限和明确的人工确认策略。