Skip to content

little-thing/grok-wechat

v1.0.0

微信 iLink 渠道：扫码登录、私信收发、媒体、正在输入。入站经 webhook 唤醒。

GitHub

grok-wechat-plugin

中文 | English

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

能力

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

一句话安装

在 Grok Bot 里发：

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

绑定流程

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

在 Grok Bot 里安装、确认渠道、粘贴一次 webhook、扫码

  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 助手，wechat_set_dedicated_assistant 登记 id/名称；专属助手不建入站 Routine。绑定更多账号时重复出码与等待，无需再粘贴 webhook。

  4. 绑定完成
    wechat_status 显示 global_wake_configured=true 与各账号 dedicated_assistant_name。入站由安装助手 wechat_inbox 后按 ilink_bot_id 转交专属助手。

对方给你发一条微信私信，就能在微信里收到回复。

绑定后的效果

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

微信里发私信，助手立刻回复

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

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

多账号

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

链路

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

任务做完立刻回复。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 为零账号。