夜雨聆风今天刚打通的，实测可用，踩坑记录全在这了。
● ● ●
开篇
下午两点，我盯着终端里那个二维码，手机微信扫了一下——"已连接"。
就这么简单，我的AI助手阿飞，从飞书搬到了微信上。
说实话，之前一直觉得把AI接入微信很复杂，要搞企业微信、要申请接口、要备案。结果今天发现，OpenClaw官方已经出了微信插件，扫码就能用。
这事儿值得记一下，因为整个过程我踩了3个坑，花了差不多20分钟。如果你也想把OpenClaw接进微信，照着这篇来，5分钟搞定。
● ● ●
为什么要把AI接进微信？
飞书好用是好用，但有个问题——不是所有人都用飞书。
我爸妈不用飞书，我朋友不用飞书，我那个做小生意的表哥更不用飞书。他们有问题想问我的AI助手，我只能说"你下载个飞书吧"，然后就没有然后了。
微信不一样。12亿用户，人人都有。把AI接进微信，等于把助手塞进了每个人的口袋。
而且OpenClaw的微信插件支持文字和语音，发条语音过去，AI也能听懂。这对不习惯打字的长辈来说太友好了。
● ● ●
准备工作
在开始之前，你需要确认两件事：
1. OpenClaw版本 >= 2026.3.22
跑一下 openclaw --version 看看。我的是 2026.4.26，没问题。如果你的版本太旧，先更新：
npm update -g openclaw
2. 微信版本 >= 8.0.70
去微信「我 → 设置 → 关于微信」检查一下。太旧的版本不支持。
就这两个。不需要企业微信，不需要备案，不需要申请接口。
● ● ●
安装插件
OpenClaw的微信功能是通过一个外部插件实现的，叫 @tencent-weixin/openclaw-weixin。
安装命令就一行：
npx -y @tencent-weixin/openclaw-weixin-cli install
跑完之后，插件会自动进入登录流程，终端里弹出一个二维码。
注意：这个二维码是给你用微信扫的，不是让你截图发别人的。
● ● ●
扫码登录
打开手机微信，右上角「+」→「扫一扫」，对准终端里的二维码。
扫完之后，手机上会弹出一个页面，点「继续连接」。
终端显示"已将此 OpenClaw 连接到微信"，就成功了。
我踩的第一个坑：二维码有有效期，大概2-3分钟。我第一次扫的时候去倒了杯水回来就过期了，得重新跑 openclaw channels login --channel openclaw-weixin 生成新的。
所以，先准备好手机，再生成二维码，别倒水。
● ● ●
重启Gateway
登录成功后，需要重启一下Gateway才能激活微信渠道：
openclaw gateway restart
等几秒钟，然后检查状态：
openclaw channels status --probe
如果看到 openclaw-weixin ... enabled, configured, running，就说明一切正常。
我踩的第二个坑：重启Gateway后，飞书渠道会短暂断开几秒。别慌，它会自动重连。如果你正在飞书上和AI对话，等它回来就行。
● ● ●
测试通信
在微信里找到你的AI助手（它应该出现在最近聊天列表里），发条消息试试。
我发了个"你好"，秒回。
然后我问了句"今天大盘怎么样"，它把早上的盘前分析给我复述了一遍。数据和飞书那边完全同步，因为底层是同一个OpenClaw实例，只是多了个微信通道。
我踩的第三个坑：微信消息有时候会延迟几秒，特别是AI在处理复杂任务的时候。这是正常的，不是断了。如果你发了消息没反应，等10-15秒再看。
● ● ●
飞书+微信双渠道
接好之后，我的阿飞同时在飞书和微信上运行。
飞书那边继续干重活——信息采集、内容创作、股票分析、工作汇报，该cron跑的cron跑，该子agent派的子agent派。
微信这边主要用来日常聊天——问个问题、查个数据、让AI帮写个文案，随时随地发条消息就行。
两边的数据是通的。你在飞书上问AI"今天写了什么文章"，它知道；你在微信上问同样的问题，它也知道。
● ● ●
技术细节（给想深挖的人）
OpenClaw的微信插件架构是这样的：
- 插件名：
@tencent-weixin/openclaw-weixin - 渠道ID：
openclaw-weixin - 工作原理：通过腾讯iLink API连接微信，消息经OpenClaw channel contract标准化后路由到agent
- 支持功能：文字、语音、图片（群聊暂不支持）
- 凭证管理：扫码后token存在OpenClaw state目录下，Gateway启动时自动加载
插件和OpenClaw核心是分离的——OpenClaw负责消息路由和agent调度，插件负责微信协议和API调用。这种设计让渠道插件可以独立更新，不影响核心。
● ● ●
常见问题
Q：需要企业微信吗？
A：不需要。个人微信就行。
Q：会封号吗？
A：正常使用不会。但别拿它群发广告，那是找封。
Q：支持群聊吗？
A：目前不支持，只能私聊。
Q：能同时接多个微信号吗？
A：可以。再跑一次 openclaw channels login --channel openclaw-weixin 扫另一个号就行。
Q：消息延迟怎么办？
A：正常情况下秒回，复杂任务可能延迟几秒。如果超过30秒没反应，检查一下Gateway状态。
● ● ●
写在最后
今天打通微信渠道，算是给阿飞开了一个新窗口。
之前它只活在飞书里，现在它能直接和微信上的任何人对话。这个变化看起来不大，但实际影响挺深——AI助手的可达性，决定了它的实用性。
如果你也在用OpenClaw，强烈建议接一下微信。5分钟的事，但体验提升是实实在在的。
有问题可以公众号后台留言，我看到了会回。
