OpenClaw

1. 准备 API Key 和模型

1. 1在 API Key 页面创建密钥。
2. 2在模型定价页面复制准确的模型 ID。
3. 3根据模型支持的接口选择 OpenClaw api 值和 Base URL，不要只根据模型名称猜测接口。

2. 保存 API Key

OpenClaw 会读取父进程环境变量、当前目录的 .env，以及 ~/.openclaw/.env。Gateway 以服务方式运行时，使用全局 .env 最稳定。

macOS / Linux 先创建配置目录：

mkdir -p ~/.openclaw

~/.openclaw/.env

%USERPROFILE%\.openclaw\.env

ALLTOKEN_API_KEY=此处替换为 API Key

也可以临时设置环境变量：

export ALLTOKEN_API_KEY="此处替换为 API Key"

$env:ALLTOKEN_API_KEY = "此处替换为 API Key"

3. 编辑 openclaw.json

先运行下面的命令查看当前实际生效的配置文件，再把示例合并到该文件。示例按 Responses 接口编写；如果所选模型只支持 Chat Completions，请把 api 改为 openai-completions。

openclaw config file

{
  models: {
    mode: "merge",
    providers: {
      alltokenapi: {
        baseUrl: "https://ikun.love/v1",
        apiKey: "${ALLTOKEN_API_KEY}",
        api: "openai-responses",
        models: [
          {
            id: "此处替换为准确的模型 ID",
            name: "此处替换为准确的模型 ID",
          },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "alltokenapi/此处替换为准确的模型 ID",
      },
    },
  },
}

需要替换三处模型 ID，且大小写必须一致。models.mode 默认为 merge，显式写出是为了避免误用 replace 后隐藏内置模型目录。

4. 验证配置

先执行只读检查，确认配置、服务商模型和默认模型都已生效。

openclaw config validate
openclaw models list --provider alltokenapi
openclaw models status

• config validate 成功。
• 模型列表中出现 alltokenapi/模型ID。
• models status 的默认模型与认证状态正确。

需要真实发起一次最小模型请求时，可以运行以下探测命令。它会消耗少量 Token 并可能触发限流。

openclaw models status --probe --probe-provider alltokenapi

完成后启动一个简短 Agent 任务，并在使用日志中确认请求模型、接口和状态。

5. 配置何时生效

OpenClaw 默认使用 gateway.reload.mode: hybrid。models 和 agents 的修改可热加载，通常不需要手动重启 Gateway。

如果已将热加载设为 off，或运行中的会话仍保留旧模型，请按当前部署方式重启 Gateway。已有会话可能继续使用创建时的模型，新会话会读取新默认值。

6. 常见问题

openclaw config validate
openclaw doctor

7. 官方参考

• OpenClaw 配置指南
• 自定义服务商与 Base URL
• OpenClaw config 命令
• OpenClaw models 命令