本教程教你如何在已安装的 OpenClaw 中，配置并切换到本站的模型。

• 支持的操作系统：macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或 Windows 10+
• Node.js 18+（NPM 安装需要）

NPM 安装（推荐）：

npm install -g openclaw

安装完成后验证：

openclaw --version

你需要一个本站的 API Key。在 本站控制台 的令牌页面创建 API Key（以 sk- 开头）。

配置文件路径：

快速打开：

# macOS / Linux
open ~/.openclaw
 
# Windows（资源管理器地址栏输入）
%USERPROFILE%\.openclaw

如果 openclaw.json 不存在，手动创建即可。

用文本编辑器打开 openclaw.json，加入以下内容：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "huanyu/claude-opus-4-6-thinking"
      },
      "models": {
        "huanyu/claude-opus-4-6":          { "alias": "Opus 4.6 [huanyu]" },
        "huanyu/claude-opus-4-6-thinking":  { "alias": "Opus 4.6 Thinking [huanyu]" },
        "huanyu/claude-sonnet-4-6":         { "alias": "Sonnet 4.6 [huanyu]" },
        "huanyu/claude-sonnet-4-6-thinking":{ "alias": "Sonnet 4.6 Thinking [huanyu]" },
        "huanyu/gemini-3.1-pro":            { "alias": "Gemini 3.1 Pro [huanyu]" },
        "huanyu/gemini-3-flash":            { "alias": "Gemini 3 Flash [huanyu]" }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "huanyu": {
        "baseUrl": "https://api.huanyuf.top/v1",
        "apiKey": "your-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-6",           "name": "Claude Opus 4.6" },
          { "id": "claude-opus-4-6-thinking",   "name": "Claude Opus 4.6 Thinking" },
          { "id": "claude-sonnet-4-6",          "name": "Claude Sonnet 4.6" },
          { "id": "claude-sonnet-4-6-thinking", "name": "Claude Sonnet 4.6 Thinking" },
          { "id": "gemini-3.1-pro",             "name": "Gemini 3.1 Pro" },
          { "id": "gemini-3-flash",             "name": "Gemini 3 Flash" }
        ]
      }
    }
  }
}

把 your-api-key 替换成你在令牌页面生成的 Key。

配置保存后 OpenClaw 会自动热重载，无需重启。

在聊天界面发送：

/model

从弹出的列表里选择你配置的模型即可。

在 models 里可以按需添加以下模型：

如果配置后模型不出现，运行：

openclaw doctor

会告诉你配置文件哪里有问题。

Q: 提示 401 错误？

A: API Key 填错了。去 令牌页面 重新生成一个。

Q: /model 列表里看不到配置的模型？

A: openclaw.json 格式有误。用 在线 JSON 校验工具 检查一下语法，然后重启 OpenClaw。

Q: 提示 400 错误？

A: 模型 id 写错了，检查 models.providers.huanyu.models 里的 id 是否和上面表格一致。

Q: 连接超时或 fetch failed？

A: 可能是网络问题，请检查：

• 确认能访问 https://api.huanyuf.top
• 如使用代理，请正确配置 HTTP_PROXY 环境变量

• OpenClaw GitHub
• Anthropic 官方文档
• 本站 API 控制台（令牌页面）