在 OpenClaw 中通过 连连智枢 网关调用模型目录里的任意模型。
OpenClaw 是本地运行的个人 AI 助手,可对接多种通讯渠道远程操控。网关提供 OpenAI 兼容 Chat Completions,适合作为 OpenClaw 的自定义模型提供商。
前置条件
| 项 | 值 |
|---|---|
| Base URL | https://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
按提示选择:
- Where will the Gateway run? → Local (this machine)
- Select sections to configure → Model
- 选择 Custom / OpenAI-compatible 类 provider(具体文案以 OpenClaw 版本为准)
- Base URL 填
https://51kik.com/v1(须含/v1) - API Key 填 连连智枢 推理 Key
- 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 / 403 | Key 错误或模型无权限 |
| 404 / path 错误 | baseUrl 是否含 /v1,避免 /v1/v1 |
| 改配置不生效 | 执行 openclaw gateway restart |
| 模型列表为空 | id 是否与 GET /models 返回一致 |