Grok Bot 粉皮书
Grok Bot 接入微信微02

微信实践 2:完成绑定,验收第一条消息

模块Grok Bot 接入微信预计学习16 分钟难度

我们把接入拆成三个可观察的动作:保存中转入口、确认微信绑定、发送第一条消息。每一步都要看到结果,才进入下一步。

找到 Routine 的 URL 与密钥

消息接入与任务完成分别验收。

在桌面端打开主 Bot 会话,点击头像或会话详情入口,在右侧详情中找到 Routines,再打开“微信下旨入口”。这里可能显示 Webhook URL 与密钥;有些配置还会直接展示 Authorization 头。我们使用实际生成的值,不从别人的截图抄地址或密钥。

保存 URL、密钥或认证头时,使用加密或私密凭证窗口。确认已经保存,再让中转程序读取对应凭证。客户端没有这样的入口时,先确认可用的保存方式,不把密钥发到普通群聊。

Webhook 是允许外部请求进入 Routine 的入口。换一个名字、写一段提示词,并不能证明这个入口已经能接受请求;我们要查看实际触发记录。

保存入口 URL 与密钥,分别核对

教学改绘示意;操作以实际界面为准。

URL 是入口地址,密钥用于认证

启用微信 ClawBot,再确认绑定

  1. 微信进入“我 → 设置 → 插件”,找到带红色龙虾标识的微信 ClawBot,启用。
  2. 回到自己的 Grok 主会话,告诉 Bot“微信 ClawBot 已启用,请开始这次绑定”。
  3. 使用本次会话生成的临时登录方式。在需要扫码的流程里,用手机微信“扫一扫”,按屏幕提示确认;如果实际界面提供在微信内打开的备用链接,确认它是当前生成且与本次登录对应的链接后再使用。
  4. 确认 Bot 已得到登录成功状态,并核对绑定的是我们预期的微信账号。

按当前登录会话的实际有效期完成扫码。客户端的活跃登录会话窗口约为五分钟;这不是对所有服务端二维码有效期的统一保证。显示过期、扫码后没有进展或绑定状态不明时,我们让 Bot 重新生成当前登录会话,不反复扫书里或别人发来的旧图。

在微信插件中找到 ClawBot 入口
绑定只在私密会话中完成,登录图不公开

第一条消息为什么重要

绑定后,我们打开微信里的 ClawBot 会话,先发一条不含敏感信息的测试消息:

text
你好,请告诉我们当前微信入口是否已连接,并把这次测试结果同步到 Grok 主会话。

收到的微信消息会提供该会话的 context_token。中转需要按当前消息上下文使用它回复;不能把“绑定成功”当成所有会话都已经有可用的回复令牌。官方类型中某字段是否标为可选,也不能证明服务端一定接受缺失的上下文。

我们检查四件事:微信收到了答复;Grok 主会话看到同一任务;Routine 运行记录能与这次消息对应;未授权用户不能通过同一入口调用我们的任务。

微信消息处理后同步回主会话
用第一条消息检查完整收发链路

再做一条真实小任务

先询问当前 Bot 身份,再安排一个已配置的岗位处理任务。可以从公开资讯摘要开始,检查回执、任务归属和产物。视频下载等能力需要另行确认,不在第一次消息验收时一起引入。

text
请让内容研究伙伴整理今天与我们主题有关的三个选题。每项给原始链接、发布时间、可核对的事实和我们可以采用的角度。查不到的数据写未知。只整理候选,不发帖。结果请在微信简洁回复,并同步到主会话。

如果测试视频,我们先要求确认下载与转写工具已配置、内容可合法访问,再给公开链接。成功回执至少包含处理对象、结果位置和缺失项目;只有“收到链接”不算完成转写。

验收项目通过表现未通过时下一步
正确绑定登录状态确认,账号符合预期停止任务,重新核对绑定
消息进入 Routine运行记录有本次任务检查 URL、认证头与中转日志
微信回复手机实际收到普通文本检查上下文令牌和发送结果
主会话同步有同一任务的结果记录检查回传环节
权限隔离仅确认的绑定用户可调用先修正用户限制,再做真实任务
重复消息同一消息没有被执行两次检查游标、消息标识与去重

练习交付:写下测试消息、两侧结果与未完成项。我们可以报告“课程流程已读懂”或“自己的账号已接通”;只有实际完成这些验收后,才写后一句。

学完后记得保存进度

完成标记保存在当前浏览器;登录后,会记住上次阅读的章节与位置。