OpenClaw 接入

难度 ⌨️ 进阶　|　接口格式 OpenAI 兼容　|　base_url https://byesu.com/v1

接入信息 · 填这几样

接口地址https://byesu.com/v1

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 OpenAI 兼容 · 模型名以 控制台 实际为准

OpenClaw（🦞）是开源的个人 AI 助手，支持自定义模型服务商。把它指向 Byesu 即可，Windows / macOS / Linux 都一样。

开始之前

先到 控制台 → 令牌 创建一个令牌（见 选择分组）。

方式一：向导（最省事）

安装后运行内置向导，按提示选「自定义 / OpenAI 兼容」服务商：

openclaw onboard

依次填：

• 接口地址 / baseUrl：https://byesu.com/v1
• API key：你的 sk-xxxx
• 模型：填 Byesu 上的模型名（如 gpt-5.5、claude-opus-4-8）

方式二：手改配置文件

在 OpenClaw 的配置文件（~/.openclaw/openclaw.json，JSON5 格式）的 models.providers 下加一个自定义服务商：

{
  agents: {
    defaults: { model: { primary: "byesu/gpt-5.5" } },   // 默认用哪个模型
  },
  models: {
    mode: "merge",                   // 合并内置服务商，而非覆盖
    providers: {
      byesu: {
        baseUrl: "https://byesu.com/v1",
        apiKey: "${BYESU_API_KEY}",      // 建议用环境变量，避免明文
        api: "openai-completions",       // OpenAI 兼容
        models: [
          { id: "gpt-5.5", name: "Byesu GPT-5.5" },
          { id: "claude-opus-4-8", name: "Byesu Claude Opus 4.8" },
        ],
      },
    },
  },
}

几个要点

• baseUrl 带 /v1（OpenAI 兼容）。
• apiKey 建议用环境变量 ${BYESU_API_KEY}（把真 key 放环境变量里），别明文提交到 git：export BYESU_API_KEY="sk-xxxx"。
• Gateway 以后台服务 / 守护进程运行时，要确保服务进程的环境里也有这个变量（只在当前终端 export 是读不到的，会报 401）；仅本机使用且不入 git 时，也可以直接在配置里明文填 key。
• models 里的 id 要和 控制台 的模型名一致。
• 配置文件确切路径以 openclaw onboard 向导生成的为准（部分版本在 ~/.config/openclaw/）。

验证接入

openclaw models list     # 确认 byesu/ 前缀的模型出现在可选列表里

也可以 openclaw dashboard 打开 UI 直接发一句话测试。

卡住了？

报错看不懂时，先用 openclaw gateway --port 18789 在前台跑起来，直接观察日志与报错。

• 401 / 令牌无效 → key 填错，或后台服务读不到 BYESU_API_KEY 环境变量（见上方要点）（详情）
• 无可用渠道 → 模型不在你令牌的分组里（选择分组，详情）
• 其它见 常见错误 & 解决