微信接入怎么比？WorkBuddy 扫码即用，OpenClaw 走腾讯维护的外部插件

2026-08-16

两边都能接微信，但路径完全不同——而且有个挺有意思的事实：OpenClaw 那边的微信插件，官方标注是由腾讯微信团队维护的外部插件。

这篇并列双方官方文档写明的接入机制、能力边界与限制。不做优劣判断——形态不同（商业闭源桌面产品 vs 开源自托管网关），比较「谁更好」没有意义。

依据：WorkBuddy 官方文档《接入微信助理指南》（Platform-Integration/WeixinBot-Guide）与官方 FAQ；OpenClaw 官方中文文档 zh-CN/channels/wechat。核对日均为 2026-08-16。我们没有安装任何一方，本文不含实测数据。

一、接入路径并列

	WorkBuddy 微信助理	OpenClaw 微信渠道
实现方式	产品内置的集成能力	外部渠道插件 `@tencent-weixin/openclaw-weixin`
维护方	腾讯云 CodeBuddy 团队	官方标注：外部插件，由腾讯微信团队维护
要不要开发凭证	官方明确：无需填写 App ID、App Secret 等开发凭证，只需扫码	不需要开发凭证，但需要装插件
前提	WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70	需运行中的 Gateway 网关；插件与 OpenClaw 有版本兼容性要求
怎么配	助理栏齿轮图标 → 助理设置 → 微信助理集成 → 配置 → 扫码	装插件 → 启用 → 重启 Gateway → 命令行发起二维码登录

二、WorkBuddy 侧的流程

官方给的三步：

打开 WorkBuddy，在左侧「助理」栏点齿轮图标进入「助理设置」，集成列表中找到「微信助理集成」，点「配置」；
等二维码生成（按钮会短暂显示「绑定中…」）；
手机微信扫码，卡片状态变为「已绑定」。

需要换账号的话点「解绑」后重新绑定。官方提醒二维码有时效限制，过期或失败就重新点「配置」生成新的。

这是九个平台里唯一不需要任何开发凭证的一个——对照 QQ（要 AppID + AppSecret 且需实名）、钉钉（四个凭证 + 三个权限 + 必须发布应用）、飞书（四个凭证 + 一百多条权限 JSON + 必须发布），差距很明显。

三、OpenClaw 侧的流程

官方文档把架构讲得很清楚：

微信代码不在 OpenClaw 核心仓库中。OpenClaw 提供通用渠道插件契约，外部插件提供微信专用运行时。

工作流程（官方原文口径）：

openclaw plugins install 安装 @tencent-weixin/openclaw-weixin；
Gateway 网关发现插件清单并加载插件入口点；
插件注册渠道 id openclaw-weixin；
openclaw channels login --channel openclaw-weixin 启动二维码登录；
插件将账户凭据存储在 OpenClaw 状态目录下（默认为 ~/.openclaw）；
Gateway 网关启动时，插件会为每个已配置账户启动微信监控器。

快速安装：npx -y @tencent-weixin/openclaw-weixin-cli install

手动安装：

openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart

登录有一条位置要求：官方写明要在运行 Gateway 网关的同一台机器上运行二维码登录。

官方还专门说明了这种分离的意义：OpenClaw 核心保持与渠道无关——微信登录、腾讯 iLink API 调用、媒体上传/下载、上下文令牌和账户监控均由外部插件负责。

四、★ 一处能力边界差异

OpenClaw 官方对该插件的状态标注里有一句：

状态：外部插件，由腾讯微信团队维护。支持私信和媒体。该插件的能力元数据未声明支持群聊（仅声明支持私信）。

WorkBuddy 侧官方文档没有对微信助理做群聊/私信的能力区分说明，我们不推断。

这条对选型是实打实的信息：如果你的用法需要在微信群里 @ 它，OpenClaw 那边的插件能力元数据未声明支持这一点值得先确认。

五、访问控制的机制不同

OpenClaw：官方写明私信使用渠道插件的常规 OpenClaw 配对和允许列表模型——批准新的发送者要用：

openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>

多账户场景下，官方还给了会话隔离的配置：openclaw config set session.dmScope per-account-channel-peer（按账户、渠道和发送者隔离私信会话）。

WorkBuddy：微信助理这边官方文档未提供对应的「谁能给它发消息」的准入配置说明。九个平台里，只有企业微信有官方明确的「可见范围」（选择哪些员工、部门或标签可以使用这个机器人）。

六、两边各自的已知问题

WorkBuddy 侧（官方 FAQ）：

鸿蒙 6 的微信扫码当前存在不兼容情况，已知鸿蒙 4 可正常连接；临时方案是先用安卓手机完成首次扫码连接，再切回鸿蒙微信；
三条通用排查：确认电脑上的 WorkBuddy 仍在运行且助理服务未关闭；检查集成状态是否仍为「已绑定」；必要时先解绑后重新扫码。

OpenClaw 侧（官方文档「Sidecar 进程」与故障排查）：

官方说明插件在监控腾讯 iLink API 时可在 Gateway 旁运行辅助工作；并记录了一个已修复的问题——子进程可能会尝试清理父 Gateway 网关进程，从而在 systemd 等进程管理器下导致重启循环；官方说明当前启动清理会排除当前进程及其祖先进程；
版本兼容性：插件启动时检查宿主 OpenClaw 版本，官方给了 2.x 与 1.x 两条版本线对应的 OpenClaw 版本要求与 npm 标签；
若报 requires compiled runtime output for TypeScript entry，官方说明是发布的 npm 包缺少所需的已编译 JavaScript 运行时文件，需等发布者修复。

两边的问题类型也反映了形态差异：一个是手机端兼容性，一个是进程管理与包发布。

七、两边共同的前提

都要求宿主活着：

WorkBuddy：官方在助理文档「注意事项」里明写 电脑需要保持开机并运行 Tencent WorkBuddy；
OpenClaw：Gateway 网关必须运行（登录也要在运行 Gateway 的同一台机器上做）。

八、按官方自述定位的场景归因

强调：这是按双方官方自述做的归因，不是评测结论。

你想最快接上微信、不碰命令行 → WorkBuddy 的微信助理：无需任何开发凭证，只需扫码（前提是版本达标）；
你已经在跑 OpenClaw 网关，想把微信接进已有的多渠道体系 → OpenClaw 的插件路径；
你需要在微信群里用 → 先确认这一点：OpenClaw 那边插件的能力元数据未声明支持群聊；
你需要细粒度的准入控制（谁能给它发消息） → OpenClaw 有配对与允许列表模型；WorkBuddy 侧的准入管控在企业微信（可见范围），微信助理这边官方未提供对应说明；
你是鸿蒙 6 用户 → WorkBuddy 侧官方记录了扫码不兼容，需借安卓机完成首次扫码。

九、我们不写的东西

不写谁的微信接入更好、更稳定——需实测，我们没做；
不写 WorkBuddy 微信助理是否支持群聊——官方文档未做能力区分说明，不推断；
不解释为什么腾讯会维护 OpenClaw 的微信插件——这属于商业动机的推测，不在官方文档里；
不搬社区的绕过方案（比如群聊限制的变通做法）——无从核实。

小结

WorkBuddy：微信助理是产品内置能力，官方明确无需 App ID / App Secret 等开发凭证，只需扫码；前提是 WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70；二维码有时效。
OpenClaw：微信走外部渠道插件 @tencent-weixin/openclaw-weixin，官方标注由腾讯微信团队维护；微信代码不在 OpenClaw 核心仓库中；要装插件、启用、重启 Gateway、命令行二维码登录（须在运行 Gateway 的同一台机器上），凭据存 ~/.openclaw。
★ 能力边界：OpenClaw 官方写明该插件支持私信和媒体，但能力元数据未声明支持群聊。WorkBuddy 侧未做此区分说明。
准入控制：OpenClaw 有配对与允许列表模型（openclaw pairing list/approve）；WorkBuddy 侧的准入管控在企业微信的「可见范围」。
已知问题的类型不同：WorkBuddy 侧是鸿蒙 6 扫码不兼容（临时方案借安卓机）；OpenClaw 侧是版本兼容性与 Sidecar 进程相关。
共同前提：宿主得活着——一个是电脑保持开机并运行客户端，一个是 Gateway 网关必须运行。

双方功能与文档表述均以各自官方为准，核对日 2026-08-16。