在 OpenClaw 中通过 连连智枢 网关调用模型目录里的任意模型。

OpenClaw 是本地运行的个人 AI 助手,可对接多种通讯渠道远程操控。网关提供 OpenAI 兼容 Chat Completions,适合作为 OpenClaw 的自定义模型提供商。

前置条件

  1. 在控制台创建推理 API Key(见 API 密钥)。
  2. 模型列表 选取 id 作为 OpenClaw 中的模型名。
Base URLhttps://51kik.com/v1
API Key控制台推理 Key
协议OpenAI 兼容(openai-completions

安装 OpenClaw

macOS / Linux:

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

Windows(PowerShell):

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

安装完成后可执行 openclaw --version 确认。

配置 连连智枢

方式一:交互式向导(推荐)

openclaw configure

按提示选择:

  1. Where will the Gateway run?Local (this machine)
  2. Select sections to configureModel
  3. 选择 Custom / OpenAI-compatible 类 provider(具体文案以 OpenClaw 版本为准)
  4. Base URLhttps://51kik.com/v1(须含 /v1
  5. API Key 填 连连智枢 推理 Key
  6. Model id 填目录中的 id

方式二:编辑配置文件

配置文件通常为 ~/.openclaw/openclaw.json~/.config/openclaw/openclaw.json5(以本机 OpenClaw 版本为准)。

YOUR_MODEL_ID 替换为模型列表中的 id

{
  env: {
    ROUTERBRAIN_API_KEY: "YOUR_ROUTERBRAIN_KEY",
  },
  agents: {
    defaults: {
      model: { primary: "routerbrain/YOUR_MODEL_ID" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      routerbrain: {
        baseUrl: "https://51kik.com/v1",
        apiKey: "${ROUTERBRAIN_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "YOUR_MODEL_ID",
            name: "RouterBrain Model",
          },
        ],
      },
    },
  },
}

注意: OpenAI 兼容端点的 baseUrl 必须包含 /v1。若写成网关根地址且不带 /v1,会出现 404 或路径重复。详见 Base URL 与环境

保存后重启 Gateway:

openclaw gateway restart

验证

openclaw models list --provider routerbrain
openclaw tui

在 TUI 中发送一条消息,能正常回复即表示配置成功。

若失败,可先在本机用 curl 验证 Key 与模型(见 首次请求),再检查 OpenClaw 日志。

工具调用与流式

  • 网关支持 OpenAI 形态 tools / tool_calls(见 Chat Completions)。
  • 流式对话见 流式响应
  • 修改 provider 或模型后若仍走旧配置,可重启 Gateway 并清理对应 agent 会话缓存。

常见问题

现象排查
401 / 403Key 错误或模型无权限
404 / path 错误baseUrl 是否含 /v1,避免 /v1/v1
改配置不生效执行 openclaw gateway restart
模型列表为空id 是否与 GET /models 返回一致

相关