集成

OpenClaw

OpenClaw 自托管 AI 助手接入 xAPI —— 在 ~/.openclaw/openclaw.json 中注册一个自定义 provider。

OpenClaw 是开源的本地 AI 助手 CLI(跨平台), 通过 JSON 配置注册任意 OpenAI 兼容 provider。xAPI 直接接受 Authorization: Bearer, 与 OpenClaw 的 openai-completions provider 完全兼容。

1

安装

参考 OpenClaw 官方安装指引: github.com/openclaw/openclaw。

2

创建 API Key

进入 xapi.to 控制台 → API Keys → 新建, 密钥形如 sk-xapi-...。

3

配置 ~/.openclaw/openclaw.json

在 models.providers 下注册 xAPI 作为自定义 provider:

1{
2  "models": {
3    "mode": "merge",
4    "providers": {
5      "xapi": {
6        "baseUrl": "https://ai.xapi.to/v1",
7        "apiKey": "${XAPI_KEY}",
8        "api": "openai-completions",
9        "timeoutSeconds": 300,
10        "models": [
11          {
12            "id": "claude-opus-4-7",
13            "name": "Claude Opus 4.7 (xAPI)",
14            "contextWindow": 200000,
15            "maxTokens": 8192
16          },
17          {
18            "id": "claude-sonnet-4-6",
19            "name": "Claude Sonnet 4.6 (xAPI)",
20            "contextWindow": 200000,
21            "maxTokens": 8192
22          },
23          {
24            "id": "gpt-5.5",
25            "name": "GPT-5.5 (xAPI)",
26            "contextWindow": 128000,
27            "maxTokens": 8192
28          }
29        ]
30      }
31    }
32  },
33  "agents": {
34    "defaults": {
35      "model": {
36        "primary": "xapi/claude-opus-4-7"
37      }
38    }
39  }
40}

环境变量 XAPI_KEY 在 shell 中导出:

$export XAPI_KEY="sk-xapi-..."

baseUrl 必须以 /v1 结尾(OpenClaw 对 OpenAI 兼容端点的强制要求)。 api: "openai-completions" 走 OpenAI Chat Completions 协议, 与 xAPI 子域端点对齐。模型 id 直接使用 xAPI 上游的原生命名 (见 模型与价格)。

锁定到特定上游(可选)

更换 baseUrl 即可:

上游baseUrl
SkyAPI(模型最全)https://skyapi.p.xapi.to/v1
SuperToken Max(官方源)https://supertoken-max.p.xapi.to/v1
SuperToken 逆向(成本最低)https://supertoken.p.xapi.to/v1

切换模型

修改 agents.defaults.model.primary 字段,或在 models[] 数组中追加新条目。 模型 id 格式为 provider-id/model-name,例如 xapi/claude-sonnet-4-6。

常见问题

baseUrl 缺少 /v1 后缀。完整格式:https://ai.xapi.to/v1。

  • XAPI_KEY 环境变量未导出,或 OpenClaw 没读到。通过 echo $XAPI_KEY 确认
  • 也可以直接在 apiKey 字段写明文(不推荐生产使用)

OpenClaw 持久化 provider 配置到 agent-scoped 的 ~/.openclaw/agents/<agent>/agent/models.json。 改完 openclaw.json 后,可能需要重新选择 agent 或重启 OpenClaw 让 merge 生效。