OpenClaw 接入个人微信完整教程：从安装到聊天

你有没有想过——让你的 AI 助手直接出现在微信里，像朋友一样跟你聊天？现在这件事真的可以做到了。

OpenClaw 的微信渠道插件（OpenClaw-weixin）通过微信 ilink 协议，让你的 AI 助手直接登录微信，在微信中就能和它对话——消息互通、文件收发、语音输入，一切都在你每天刷无数次的 App 里完成。

本文将完整记录从零开始的配置过程，帮你把自己的 OpenClaw 连上个人微信。

一、工作原理

整体架构其实很简单：

插件通过微信官方的 ilink 协议（一种企业级即时通讯协议），用长轮询方式与微信服务器保持连接。登录方式采用二维码扫码授权，安全可靠。你扫一次码，凭证保存在本地，以后自动重连。

二、前提条件

• ✅ 已安装 OpenClaw，版本 ≥ 2026.3.22
• ✅ 终端可用，具备基本的命令行操作能力
• ✅ 一部手机（用于扫码登录）

查看 OpenClaw 版本：

三、安装方式

两种方式，选一个就行：

▎方式一：一键安装（推荐）

一行命令搞定全部：

这条命令会自动完成插件安装、启用、扫码登录、Gateway 重启，一气呵成，不需要你再手动走后面的步骤。

▎方式二：手动安装

如果想自己控制每一步：

第 1 步 — 安装插件

第 2 步 — 启用插件

第 3 步 — 扫码登录

终端会显示一个二维码👇 用手机微信扫码，在手机上确认授权。登录凭证会自动保存本地，以后不用再扫。

第 4 步 — 重启 Gateway

四、验证连接

重启后查看渠道状态：

如果 openclaw-weixin 的状态显示为 OK，说明连接成功！

五、多账号支持

想同时登录多个微信号？重复扫码即可：

每次扫码创建一个新账号条目。已登录的账号列表：

⚠️ 多账号时建议开启会话隔离，避免消息混淆：

六、自定义 BotAgent（可选）

每条出站消息会携带一个 bot_agent 字段（类似 HTTP 的 User-Agent），用于日志归因。默认值是 OpenClaw。

如需自定义，在 openclaw.json 中添加：

格式：Name/Version 风格，多个 token 用空格分隔，总长 ≤ 256 字节。

七、卸载插件

八、常见问题

九、实际体验

连接成功后，AI 助手就在你微信的聊天列表里了：

• 无需切换 App —— 微信里直接聊，和正常聊天一样自然
• 随时在线 —— 消息即发即回，就像给朋友发消息一样
• 多模态支持 —— 发图片、语音都能识别并回复
• AI 能力完整 —— 搜索、创作、分析、编程，全部能力通过微信就能调用

目前还是文字和图片交互阶段，视频通话和实时语音对话尚未支持。但对日常信息查询、内容创作、技术问答等场景，已经绰绰有余。

写在最后

把 AI 助手接入微信，本质上是在你最常用的通讯工具里植入了一个智能伙伴。不用打开网页、不用切换 App，在聊天列表里喊一声"帮我查个东西"，答案就来了。

如果你也在运行 OpenClaw，按本文步骤操作，十分钟就能搞定。