grok-wechat-plugin

中文 | English

Grok Bot 的微信 iLink 渠道。扫码绑定个人号后，私信经共享 webhook 唤醒对应专属助手，专属助手立刻回文字与媒体，并显示正在输入。

能力

• 扫码登录，一个连接器绑定多个微信个人号；每号一个专属 Grok Bot 助手
• 私信文字收发：Markdown 自动转纯文本，超长消息自动分段
• 语音：按转写文本处理
• 媒体：收发图片、视频、文件（入站媒体下载到本机）
• 正在输入：回复前打开，发完关闭
• allowlist：空则接收全部私信；写入后只处理名单内用户
• 全局 webhook：粘贴一次，覆盖当前及后续全部已绑定账号

一句话安装

在 Grok Bot 里发：

安装这个微信插件 https://github.com/little-thing/grok-wechat-plugin

绑定流程

按对话一步走完即可，整段过程如下：

1. 确认添加渠道
   对话里会出现「加」按钮，点一下，把微信渠道接到 Grok Bot。

2. 连接器与共用 Routine
   安装助手加上微信连接器，并创建两条 Routine：「微信入站唤醒」（Webhook）与 「微信监听保活」（每 5 分钟 wechat_start_monitor）。webhook Routine 创建后平台不把 url/key 返回给 agent；用户从该 Routine 面板复制地址与密钥发来一次，安装助手 wechat_set_wake 写入全局 wake.json，当前及后续绑定账号共用。

3. 扫码登录微信
   wechat_login_start 出码 → 立即 wechat_login_wait 至 logged_in=true。每次绑定成功后创建该号的专属 Grok Bot 助手，描述为：

   负责该微信号的入站私信。收到按 ilink_bot_id 转交的私信后，立刻用同一 ilink_bot_id 向该微信对端回复：先 wechat_typing（on），再 wechat_send 或 wechat_send_media，发完关闭正在输入。

   然后 wechat_set_dedicated_assistant 登记 id/名称。专属助手不建入站 Routine。绑定更多账号时重复出码与等待，无需再粘贴 webhook。

4. 绑定完成
   wechat_status 显示 global_wake_configured=true 与各账号 dedicated_assistant_name。入站由安装助手 wechat_inbox 后按 ilink_bot_id 转交专属助手，专属助手立刻向该微信对端 wechat_send。

对方发来一条微信私信，专属助手立刻在微信里回复。

绑定后的效果

在微信里直接说话即可，例如：

回复前显示「正在输入」，发完关闭。文字、语音转写、图片、视频、文件都可处理；回媒体时用本机文件路径。

要限制谁能对话，让助手把对方加入 allowlist。要解绑某个号，在对话里说登出该微信；不指定则登出全部。

多账号

一个连接器可绑定多个微信个人号。全局 webhook 覆盖全部账号；每个号独立扫码并创建专属助手。wechat_status 查看 global_wake_configured 与各账号专属助手名称。

链路

微信私信 → monitor 收件箱 → POST 共享 webhook → 安装助手醒来 → wechat_inbox → 按 ilink_bot_id 转交专属助手 → 立刻 wechat_send / wechat_send_media

专属助手收到转交后立刻向该微信对端回复。回复前 wechat_typing（on），发完关闭。bot_agent 为 Grokbot/1.0.0。

安装细节见 skills/wechat-channel/SKILL.md。

一句话卸载

在 Grok Bot 里发：

卸掉微信插件

安装助手会：

1. 调用 wechat_uninstall 清理本机，并读取 dedicated_assistants_sidebar_delete 中的专属助手名称。
2. 卸载 grok-wechat 连接器。
3. 删除安装助手上 Routine「微信入站唤醒」与「微信监听保活」，并删除其他助手上残留的同名 Routine。
4. 告知用户在侧栏右键删除返回列表中的专属助手（如「微信1」「微信2」）。

从 Settings 卸掉连接器后，本机 monitor 也会自动清理。完成后重装需重新粘贴 webhook 并扫码，wechat_status 为零账号。