OpenClaw

通过 OpenAI-compatible Provider 接入。

接入前准备

  • 安装并启动对应工具。
  • 在控制台创建 API Key,并保存仅展示一次的明文密钥。
  • 从模型广场选择协议和能力匹配的模型 ID。

最小配置

优先运行 onboard 并选择 Custom Provider / OpenAI-compatible;已有配置时只替换 Provider、地址、密钥和模型。

命令 + JSON
openclaw onboard

// ~/.openclaw/openclaw.json
{
  "agents": { "defaults": { "model": { "primary": "nox-gate/YOUR_MODEL_ID" } } },
  "models": {
    "mode": "merge",
    "providers": {
      "nox-gate": {
        "baseUrl": "https://api.noxgate.net/v1",
        "api": "openai-completions",
        "apiKey": "sk-your-api-key",
        "models": [{ "id": "YOUR_MODEL_ID", "name": "YOUR_MODEL_ID" }]
      }
    }
  }
}
  • 不同版本字段可能变化,优先保留当前版本自动生成的结构。

验证接入

  1. 执行 openclaw gateway restart。
  2. 确认 Provider 和模型出现后发送最小请求。

能力限制与常见问题

  • 不要猜测 contextWindow、maxTokens 或价格字段。
  • 404 通常表示 Base URL 或模型 ID 不正确。