OpenClaw(Clawdbot)— 配置与 API 对接
OpenClaw 是什么?
可在常见操作系统上运行的智能体网关,可对接 WhatsApp、Telegram、Discord、iMessage 等渠道;发消息即可让代理回复,更多渠道可通过插件扩展。
功能与最新说明请参考官方:OpenClaw。
1. 安装 OpenClaw
按操作系统选择方式。
脚本安装(推荐)
macOS / Linux
- 安装
curl -fsSL https://openclaw.ai/install.sh | bash
- 校验
openclaw --version
Windows(PowerShell)
说明: 建议在 WSL2 内执行安装。于 PowerShell 进入 WSL 后,在 Linux 环境中运行下列命令。
iwr -useb https://openclaw.ai/install.ps1 | iex
校验:
openclaw --version
2. 初始化配置
运行交互式向导:
openclaw onboard
常见流程(具体文案可能随版本变化):
- 选择 QuickStart
- 暂不需要的第三方密钥处可选 Skip for now
- 选择 All providers(或与你的计划一致的选项)
- 不确定时可 Keep current
- 可选的聊天工具、Skills 等步骤可 Skip,先完成向导
- 若向导推荐开启网关/隐私相关选项,可按建议勾选
完成后可能会自动打开 网关 Web 界面。
若网关未启动:
openclaw gateway
2. 将 OpenClaw 接到 mixgateway.io
1. 获取网关 API Key
- 打开 mixgateway.io 并登录。
- 进入 [控制台](/dashboard) 的 API 密钥(或同类入口)。
- 创建密钥并复制;请求时使用:
Authorization: Bearer <密钥>。
2. 编辑 openclaw.json
安装后配置一般在用户目录下的 OpenClaw 配置文件夹(常为 ~/.openclaw)。
打开目录
open ~/.openclaw
在 Windows + WSL 下,可在该目录执行:
explorer.exe .
编辑 openclaw.json:在保留你已有内容的前提下,增加或替换为指向 OpenAI 兼容 网关 https://api.mixgateway.io/v1 的 provider,并让 agents.defaults.model.primary 使用该 provider 下的模型名。
示例(请按你本机 OpenClaw 版本微调字段;结构参考 ApiSet OpenClaw 集成说明 一类文档):
{
"agents": {
"defaults": {
"model": {
"primary": "mixgateway/deepseek:deepseek-chat"
},
"models": {
"mixgateway/deepseek:deepseek-chat": {}
}
}
},
"models": {
"mode": "merge",
"providers": {
"mixgateway": {
"baseUrl": "https://api.mixgateway.io/v1",
"apiKey": "PASTE_YOUR_GATEWAY_API_KEY_HERE",
"api": "openai-completions",
"models": [
{
"id": "deepseek:deepseek-chat",
"name": "deepseek-chat",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
}
}
说明:
- 将
PASTE_YOUR_GATEWAY_API_KEY_HERE替换为控制台中的真实密钥。 - 将
deepseek:deepseek-chat改为网关支持的任意模型(见 模型与路由)。 mixgateway仅为示例中的 provider 键名,可自行改名,但须与agents.defaults.model.primary保持同步(providerKey/modelId)。
3. 重启网关
openclaw gateway restart
浏览器中的网关界面应能反映新 provider 与模型。
延伸阅读
- OpenClaw 概览 — 为何与 mixgateway.io 一起使用 OpenClaw。
- 快速开始 — 直接调用
https://api.mixgateway.io/v1/chat/completions。