OpenClaw 安装与自定义模型配置

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.

重点信息

字段	填写内容
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	YOUR_MODEL_ID

准备工作

• 安装最新版 OpenClaw
• 创建 BetterToken API Key
• 从模型广场或 Key 的 Setup 弹窗复制 Model ID

安装

macOS / Linux

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

Windows

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

命令行配置

BetterToken Automatic setup 脚本会写入 OpenClaw 配置。脚本需要 Node.js；如果没有通过参数提供 API Key 或 Model ID，运行时会提示你输入。

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-openclaw-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-openclaw-provider.ps1" -OutFile "$env:TEMP\install-openclaw-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-openclaw-provider.ps1"

运行后确认 agents.defaults.model.primary 使用 Setup 弹窗中的 YOUR_MODEL_ID，再执行下方的验证与 Gateway 重启命令。

手动配置

配置 OpenClaw

从模型广场复制准确的 Model ID。

示例使用 API Key 占位符以便阅读。保存配置时，OpenClaw 建议为 models.providers.bettertoken.apiKey 使用 SecretRef 或环境变量替换；请按官方凭据说明设置，避免在共享文件中保存真实 Key。

Responses API

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-responses",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bettertoken/YOUR_MODEL_ID"
      }
    }
  }
}

Chat Completions

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bettertoken/YOUR_MODEL_ID"
      }
    }
  }
}

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.

验证连接

依次执行：

openclaw config validate
openclaw gateway restart
openclaw models list
openclaw models status

配置校验通过、Gateway 重启成功，并且 bettertoken/YOUR_MODEL_ID 出现在模型列表和状态中，即表示配置生效。已有会话仍显示旧模型时，新建会话后再次检查状态。

切换模型

把新模型加入 models.providers.bettertoken.models，再将 agents.defaults.model.primary 改为 bettertoken/YOUR_MODEL_ID。保存后重新执行校验与 Gateway 重启命令。

常见错误

错误	处理方式
config validate 失败	检查 JSON 逗号、引号和括号。
401	重新复制 apiKey，确认没有空格。
404	openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.
模型未显示	检查模型是否同时存在于 provider 列表和 agents.defaults.model.primary。
旧会话仍用旧模型	执行 openclaw gateway restart 并新建会话。

进阶配置

相关 FAQ

• OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？

• MCP 和 API Key / Base URL 有什么区别？

• model_provider、base_url 和 wire_api 是什么？

• Cline 如何配置 OpenAI-compatible API？

• 对比所有支持的工具

• API 错误、状态码与限流

可选：使用 CC Switch 管理 provider

需要集中管理多个工具的 provider 时，可以查看 CC Switch 中的 OpenClaw 配置。

技术说明

Responses 与 Chat Completions

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.