Skip to main content
OpenClaw 通过腾讯的外部 @tencent-weixin/openclaw-weixin 渠道插件连接到微信。 状态：外部插件，由腾讯微信团队维护。支持私信和 媒体。该插件的能力元数据未声明支持群聊 （仅声明支持私信）。

​
命名

  • 微信是这些文档中面向用户的名称。
  • 微信是腾讯的软件包和插件 id 使用的名称。
  • openclaw-weixin 是 OpenClaw 渠道 id（weixin 和 wechat 可用作别名）。
  • @tencent-weixin/openclaw-weixin 是 npm 软件包。
在 CLI 命令和配置路径中使用 openclaw-weixin。

​
工作原理

微信代码不在 OpenClaw 核心仓库中。OpenClaw 提供 通用渠道插件契约，外部插件提供 微信专用运行时：
  1. openclaw plugins install 安装 @tencent-weixin/openclaw-weixin。
  2. Gateway 网关发现插件清单并加载插件入口点。
  3. 插件注册渠道 id openclaw-weixin。
  4. openclaw channels login --channel openclaw-weixin 启动二维码登录。
  5. 插件将账户凭据存储在 OpenClaw 状态目录下 （默认为 ~/.openclaw）。
  6. Gateway 网关启动时，插件会为每个 已配置账户启动微信监控器。
  7. 入站微信消息通过渠道契约进行规范化，路由到 选定的 OpenClaw 智能体，并通过插件出站路径发回。
这种分离很重要：OpenClaw 核心保持与渠道无关。微信登录、 腾讯 iLink API 调用、媒体上传/下载、上下文令牌和账户 监控均由外部插件负责。

​
安装

快速安装：
手动安装：
安装后重启 Gateway 网关：

​
登录

在运行 Gateway 网关的同一台机器上运行二维码登录：
使用手机微信扫描二维码并确认登录。扫描成功后，插件会将 账户令牌保存在本地。 要添加另一个微信账户，请再次运行相同的登录命令。对于多个 账户，请按账户、渠道和发送者隔离私信会话：

​
访问控制

私信使用渠道插件的常规 OpenClaw 配对和允许列表模型。 批准新的发送者：
有关完整的访问控制模型，请参阅配对。

​
兼容性

插件在启动时检查宿主 OpenClaw 版本。 如果插件报告你的 OpenClaw 版本过旧，请更新 OpenClaw 或安装旧版插件版本线：

​
Sidecar 进程

微信插件在监控腾讯 iLink API 时，可以在 Gateway 网关旁运行辅助 工作。在 issue #68451 中，该辅助路径暴露了 OpenClaw 通用过期 Gateway 网关清理中的一个错误：子进程可能会尝试清理父 Gateway 网关进程，从而在 systemd 等进程管理器下导致重启循环。 当前 OpenClaw 启动清理会排除当前进程及其祖先进程， 因此渠道辅助进程无法终止启动它的 Gateway 网关。此修复 是通用的；它不是核心中的微信专用路径。

​
故障排查

检查安装和状态：
如果渠道显示为已安装但无法连接，请确认插件 已启用并重启：
如果启用微信后 Gateway 网关反复重启，请同时更新 OpenClaw 和 插件：
如果启动时报告已安装的插件软件包 requires compiled runtime output for TypeScript entry，则表示发布的 npm 软件包缺少 OpenClaw 所需的已编译 JavaScript 运行时文件。请在插件 发布者发布修复后的软件包后更新/重新安装，或暂时禁用/卸载该插件。 临时禁用：

​
相关文档