OpenClaw · 多渠道 AI 机器人
OpenClaw 是一个开源的 AI 助手网关,能把 Claude / GPT / Gemini 桥接到 Telegram / 飞书 / Slack / 钉钉 等 IM 工具,做成聊天机器人。
1. 安装(服务器或本机)
curl -fsSL https://openclaw.ai/install.sh | bash
按提示依次选:
| 提示 | 选择 |
|---|---|
| 确认安装 | yes |
| 启动模式 | QuickStart |
| 上游配置 | Skip for now(后面用脚本批量配) |
| 适配器 | anthropic(用 Claude)或 openai(用 GPT) |
| 模型 | claude-opus-4-7 或 gpt-5.5 |
| 社交平台 | Telegram / Lark / Slack 选一个 |
| Bot Token | 你的 IM 平台 bot token |
| Hook | 全选 |
| Shell 补全 | yes |
2. 接入 Miloapi
OpenClaw 默认会问 OpenAI 官方 endpoint,改成 Miloapi:
# 编辑配置
nano ~/.openclaw/openclaw.json
找到 providers 部分改成:
{
"providers": {
"miloapi-claude": {
"type": "anthropic",
"baseUrl": "https://www.miloapi.com",
"apiKey": "sk-你的claude-max-key"
},
"miloapi-gpt": {
"type": "openai",
"baseUrl": "https://www.miloapi.com/v1",
"apiKey": "sk-你的gpt-key"
}
},
"defaultProvider": "miloapi-claude"
}
重启:
openclaw gateway restart
3. 测试
openclaw tui
进入终端测试界面,跟它聊几句确认走通了。输入 /quit 退出。
4. 配置 Telegram Bot 访问
- 在 @BotFather 创建 bot,拿到 token
- 找你刚创建的 bot,点链接打开
- 输入
/pairing命令,bot 会回一个 pairing code - 在服务器上执行:
openclaw pairing approve telegram 你的pairing_code
然后就可以直接在 Telegram 里跟 bot 聊天。
5. 接入微信(个人微信)
⚠️ 个人微信对接走第三方插件,是"灰色协议"路径,账号有风险(极小概率被腾讯封)。建议专门注册一个小号用来跑机器人,不要拿主号试。
5.1 安装微信插件
OpenClaw 核心不内置微信支持,要装独立的 @tencent-weixin/openclaw-weixin 插件:
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
插件装好后会自动注册到 OpenClaw 的 channel 列表。
5.2 扫码登录
openclaw channels login --channel openclaw-weixin
终端会弹出二维码。用准备好的微信小号扫码(需要 iOS 8.0.70+ 版本,Android 版本支持很有限):
- 微信里点 设置 → 小程序 → ClawBot
- 选「扫一扫」
- 扫终端的二维码 → 确认登录
登录成功后,凭据存到 ~/.openclaw/state/wechat/,下次重启不用再扫。
5.3 配置 channel 跟 agent 关联
编辑 ~/.openclaw/openclaw.json,加上 channel 配置:
{
"channels": {
"wechat-main": {
"type": "openclaw-weixin",
"deviceType": "ipad",
"defaultProvider": "miloapi-claude"
}
}
}
deviceType 可选 "ipad"(默认,推荐)或 "mac"。
重启网关让配置生效:
openclaw gateway restart
5.4 测试聊天
直接在微信里给 bot(你刚登录的那个小号)发消息,bot 会用配置的 provider(Miloapi)回复。
你:你是谁?
Bot:我是 OpenClaw 的 AI 助手,由 Claude / Miloapi 驱动…
5.5 限制
- ✅ 支持:1 对 1 私聊、文本消息、媒体(图片)
- ❌ 不支持:群聊、AI 主动推消息、表情包识别
- ⚠️ 风险:协议属第三方逆向,腾讯不定期封号;不要拿主号
5.6 推荐替代:企业微信 WeCom
如果你是公司 / 团队场景,强烈推荐用 企业微信(WeCom) 而不是个人微信:
- 腾讯官方接口,不会被封
- 支持群聊、@机器人、富文本卡片
- 接入步骤大同小异,把 channel
type改成openclaw-wecom,再到企业微信管理后台拿到 corp_id / agent_id / secret 填到配置里
详细 WeCom 接入指南:OpenClaw 官方文档
6. 看仪表盘(服务器部署)
服务器版本默认仪表盘只允许本机访问,要外部访问加这行:
nano ~/.openclaw/openclaw.json
在 gateway 段加:
"gateway": {
"controlUi": {
"allowInsecureAuth": true
}
}
重启 + 获取地址:
openclaw gateway restart
openclaw gateway status # 看 Dashboard URL
7. 故障排查
| 现象 | 处理 |
|---|---|
provider not found | ~/.openclaw/openclaw.json 里 defaultProvider 写错或者 providers 块没注册 |
| Telegram bot 不响应 | pairing 没成功;再跑一次 openclaw pairing approve telegram <code> |
| 微信扫码无响应 | 微信版本太老(需 iOS 8.0.70+);或没装 @tencent-weixin/openclaw-weixin 插件 |
| 微信登录后掉线 | 服务器 IP 变了;删 ~/.openclaw/state/wechat/ 重新扫码 |
| 微信 bot 偶尔不回复 | 第三方协议偶尔抖动;看 openclaw gateway logs 查 channel 状态 |
| Dashboard 打不开 | 服务器部署没加 allowInsecureAuth,本机部署用 localhost:xxxx 而不是公网 IP |
| Gateway crash | 看日志 openclaw gateway logs,通常是上游 endpoint 写错 |
8. 关键差异 vs Claude Code
| 维度 | OpenClaw | Claude Code |
|---|---|---|
| 主要用途 | IM 聊天机器人(Telegram / 飞书) | 终端 AI 编程助手 |
| 部署方式 | 自托管服务器 | 桌面应用 / 终端 |
| 配置复杂度 | 高(命令行) | 低 |
| 模型支持 | 多家(Claude / GPT / Gemini) | 主要 Claude |
| 推荐场景 | 团队 AI bot、自动化 | 个人写代码 |
