OpenClaw

OpenClaw（曾用名 Clawdbot / Moltbot）是面向 Telegram、Discord、Slack、Signal、iMessage、WhatsApp 等通道的开源 Agent 平台。通过注册自定义 provider，可以把推理流量接到 ApiGo，从而统一 Key、计费与日志。

安装

macOS / Linux：

curl -fsSL https://openclaw.bot/install.sh | bash

Windows：

iwr -useb https://openclaw.ai/install.ps1 | iex

老用户建议先用同一安装命令更新到最新版，再配置 ApiGo。

推荐：引导向导

openclaw onboard

当向导询问 provider 时，选择自定义 / OpenAI 兼容（或 Anthropic 兼容）端点，并填写：

字段	值
Base URL（OpenAI 路径）	`https://api.apigo.ai/v1`
Base URL（Anthropic 路径）	`https://api.apigo.ai`
API key	你的 `sk-apigo-...`
Model	Models 中的 slug

也可稍后执行：

openclaw configure

或在 Control UI 中完成相同配置。

手动配置

编辑 ~/.openclaw/openclaw.json（OpenClaw 支持 JSON5）。下面是 OpenAI 兼容路径示例：

{
  "env": {
    "APIGO_API_KEY": "sk-apigo-..."
  },
  "models": {
    "providers": {
      "apigo": {
        "baseUrl": "https://api.apigo.ai/v1",
        "apiKey": "${APIGO_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.8-max",
            "name": "Qwen 3.8 Max",
            "input": ["text"]
          },
          {
            "id": "gpt-5.6-sol",
            "name": "GPT-5.6 Sol",
            "input": ["text"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apigo/gpt-5.6-sol"
      },
      "models": {
        "apigo/qwen3.8-max": {},
        "apigo/gpt-5.6-sol": {}
      }
    }
  }
}

Anthropic 兼容路径

若希望走 Claude 原生 Messages：

{
  "models": {
    "providers": {
      "apigo": {
        "baseUrl": "https://api.apigo.ai",
        "apiKey": "sk-apigo-...",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-5",
            "name": "Claude Sonnet 5"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apigo/claude-sonnet-5"
      }
    }
  }
}

注意：

OpenAI 路径带 /v1，Anthropic 路径不带 /v1
api 枚举值可能随 OpenClaw 版本变化；若片段被拒绝，以 openclaw configure / Control UI 中的选项为准
模型引用格式是 provider/model-id，上例为 apigo/<model-slug>

在 Control UI 中配置

启动 gateway：

openclaw gateway run

浏览器打开 http://127.0.0.1:18789。
进入 Config → models。
添加或编辑 ApiGo provider：
- Base URL / API Key 按上表填写
- 若有 Auth Header 选项，保持开启
点击 Save，再点 Update 应用配置。
需要时在对话里用 /model 打开模型选择器，或在 models 区域改默认模型。

测试

openclaw tui

能正常发起对话即表示配置成功。再到 Call Logs 确认请求已到达。

故障排除

现象	处理
鉴权错误	检查 `apiKey` / `APIGO_API_KEY` 与工作空间 Key 状态
选择器没有模型	在 `models.providers.apigo.models[]` 中添加模型并重启 gateway
协议错误	对齐 `baseUrl` 与 `api`（OpenAI `/v1` vs Anthropic 根路径）
更新后仍用旧端点	确认已点 UI 的 Update，或重启 `openclaw gateway run`