OpenClaw 接入微信一键绑定指南#
快速导览#
OpenClaw(原 Clawdbot)是一个开源、本地优先的 AI 代理网关,能让大模型在你的电脑或服务器上 24/7 运行,支持执行命令、浏览网页、操作文件,并能接入飞书、Telegram、Discord 及微信等聊天平台。本文重点演示如何将 OpenClaw 通过 ClawBot 插件接入个人微信(iOS),实现快速绑定与测试。适合已经部署好 OpenClaw 实例的用户。
安装 OpenClaw#
- 参考官方教程安装 OpenClaw:https://www.runoob.com/ai-agent/openclaw-clawdbot-tutorial.html
安装方式:
# 使用 npm 全局安装(推荐指定国内镜像)
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
# 或使用 pnpm
pnpm add -g openclaw@latest确认 OpenClaw 已部署并能访问(本地或服务器均可)。
个人微信接入教程#
前置条件#
| 项目 | 要求 |
|---|---|
| 微信版本 | iOS 8.0.70 及以上 |
| OpenClaw | 已部署并运行(本地或云端) |
操作步骤#
在微信中打开:我 → 设置 → 插件,找到并进入「ClawBot」卡片,可以看到安装命令提示。

复制终端安装命令(也可直接在设备上执行):
npx -y @tencent-weixin/openclaw-weixin-cli@latest install在运行 OpenClaw 的设备上打开终端,粘贴并执行上述命令:
终端执行后会自动下载并运行插件安装流程,随后在终端显示一个二维码。

打开微信扫码终端生成的二维码进行绑定:

- 扫码成功后,微信端会显示“连接成功”并自动重启插件/连接。

在 OpenClaw 后台管理界面查看频道,确认已添加微信渠道:

绑定成功后,可在微信聊天窗口直接与 OpenClaw 对话,支持文本交互、图片发送、文件接收等功能:




问题排查#
- 无法扫码/二维码过期:终端生成的二维码有有效期,若失效请重新运行安装命令生成新二维码。
- 插件无法连接或授权失败:检查运行 OpenClaw 的机器能否访问外网(如需要),并确保 OpenClaw 服务处于启动状态。
- 微信端未显示 ClawBot 卡片:确认微信版本 >= iOS 8.0.70,且插件已在微信“插件”列表中发布或更新。
- 后台看不到微信渠道:在 OpenClaw 控制台刷新或重启 OpenClaw 服务后再次检查日志以确认绑定流程是否成功。
调试建议:查看运行安装命令的终端输出和 OpenClaw 日志(通常包含 channel/connector 的注册信息),定位错误信息。
参考阅读#
- OpenClaw 官方教程(快速上手与插件说明):
- 相关:OpenClaw 接入飞书(参考多平台接入流程):
