====== OpenClaw (小龙虾) 安装配置指南 ======

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

----

===== 第一部分：安装 OpenClaw =====

==== 系统要求 ====

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

==== 安装方式 ====

**NPM 安装（推荐）：**

<code bash>
npm install -g openclaw
</code>

安装完成后验证：

<code bash>
openclaw --version
</code>

----

===== 第二部分：手动配置 =====

==== 准备工作 ====

你需要一个本站的 API Key。在 [[https://huanyuf.top/|本站控制台]] 的令牌页面创建 API Key（以 ''sk-'' 开头）。

==== 第一步：找到配置文件 ====

配置文件路径：

^ 系统 ^ 路径 ^
| Windows | ''C:\Users\<用户名>\.openclaw\openclaw.json'' |
| macOS / Linux | ''~/.openclaw/openclaw.json'' |

**快速打开：**

<code bash>
# macOS / Linux
open ~/.openclaw

# Windows（资源管理器地址栏输入）
%USERPROFILE%\.openclaw
</code>

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

==== 第二步：填入配置 ====

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

<code 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" }
        ]
      }
    }
  }
}
</code>

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

==== 配置字段说明 ====

^ 字段 ^ 说明 ^
| ''model.primary'' | 默认使用的模型，格式为 ''provider名/模型id'' |
| ''models''（agents 下） | 可选模型列表，决定 ''/model'' 命令里显示哪些 |
| ''alias'' | 模型在界面上显示的名称，可以随便改 |
| ''models.providers.huanyu'' | 自定义 provider，告诉 OpenClaw 去哪里请求、用什么 Key |
| ''baseUrl'' | 本站 API 地址 |
| ''apiKey'' | 你的 API 密钥（在令牌页面生成） |
| ''api'' | 接口协议，本站兼容 OpenAI 格式，填 ''openai-completions'' |

==== 第三步：切换模型 ====

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

在聊天界面发送：

<code>
/model
</code>

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

----

===== 本站可用模型 =====

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

^ 模型 id ^ 说明 ^
| ''claude-opus-4-6'' | Opus 最新版 |
| ''claude-opus-4-6-thinking'' | Opus 最新版（带思考链） |
| ''claude-sonnet-4-6'' | 推荐，性价比高 |
| ''claude-sonnet-4-6-thinking'' | Sonnet（带思考链） |
| ''gemini-3.1-pro'' | Google Gemini 3.1 Pro |
| ''gemini-3-flash'' | Google Gemini 3 Flash，最快最便宜 |

----

===== 验证配置 =====

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

<code bash>
openclaw doctor
</code>

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

----

===== 常见问题 =====

**Q: 提示 401 错误？**

A: API Key 填错了。去 [[https://huanyuf.top/|令牌页面]] 重新生成一个。

----

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

A: ''openclaw.json'' 格式有误。用 [[https://jsonlint.com/|在线 JSON 校验工具]] 检查一下语法，然后重启 OpenClaw。

----

**Q: 提示 400 错误？**

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

----

**Q: 连接超时或 fetch failed？**

A: 可能是网络问题，请检查：
  * 确认能访问 ''https://api.huanyuf.top''
  * 如使用代理，请正确配置 HTTP_PROXY 环境变量

----

===== 官方资源 =====

  * [[https://github.com/anthropics/openclaw|OpenClaw GitHub]]
  * [[https://docs.anthropic.com/|Anthropic 官方文档]]
  * [[https://huanyuf.top/|本站 API 控制台（令牌页面）]]