连接微信(WeChat)
通过 ClawBot 扫码连接个人微信,或联系 Buda 开通账号托管以参与私聊和微信群。
直接在微信里和你的智能体对话。Buda 默认通过 ClawBot 扫描二维码连接——不需要注册应用,不需要 App ID,也不需要复制密钥。扫一下就能开始。

扫描二维码会接管该账户。 连接微信会让 Buda 以该个人账户的身份登录——任何人给这个账户发消息都会收到自动回复,就好像账户主人本人在回复一样。请使用专用的微信账户,绝不要使用你的个人微信。
选择接入方式
在 频道 设置中点击 添加频道,选择 微信。接入方式 默认是 ClawBot,保留直接扫码连接的流程。若要使用托管个人微信账号参与私聊和微信群对话,选择 账号托管,按账号托管接入指南填写 App Key、App Secret 并选择账号实例。
通过 ClawBot 连接
在 Buda 中添加渠道
打开 Settings → Channels,点击 Add Channel,选择 微信,保留默认的 ClawBot 接入方式。这里没有任何凭据字段需要填写——可选地设置一个标签,然后点击 Connect。屏幕上会出现一个二维码。
扫描二维码
用专用的微信账户扫描屏幕上的二维码。在微信中确认登录后,对话框会显示已连接,渠道随即生效。
测试
用另一个微信账户向已连接的账户发送 Hi。一旦 Buda 回复,就大功告成了。
ClawBot 支持的能力
- 仅支持一对一私信。 已连接的账户只回复 1:1 会话,目前不支持群聊。
- 文本、图片、文件、语音和视频。 收到的媒体会上传到智能体的 Drive(云盘),智能体也可以回传文件、图片和视频。
/new—— 发送/new(后面可以跟一条消息)即可在该会话中开始一个全新的智能体会话。
ClawBot 故障排查
| 现象 | 解决办法 |
|---|---|
| 二维码已过期 | 二维码有时效(几分钟)。返回渠道设置重新开始扫码 |
| 会话过期 / 渠道变为未激活 | 微信会定期使登录会话失效。重新连接渠道并再次扫码即可 |
| 误用了个人账户 | 删除该渠道,然后用专用账户重新连接并扫码 |
通过账号托管连接
使用独立的个人微信账号,让 Agent 回复私聊,并在微信群内被 @ 时参与对话。先由你或有权限的群成员将账号邀请入群。
联系我们
联系我们,由 Buda 协助购买、开通托管服务,并提供连接所需的 App Key、App Secret 和账号实例。
发送邮件至 hi@buda.im,说明你希望接入微信账号,以及私聊或群聊的使用场景。
连接托管账号
- 打开空间的 频道 设置,点击 添加频道。
- 选择 微信,将默认的 ClawBot 接入方式切换为 账号托管。
- 填写 Buda 提供的 App Key 和 App Secret,点击 验证并获取账号,选择 账号实例 和目标 Agent。
- 点击 连接,打开 管理账号连接 检查状态。离线账号点击 生成登录二维码,用对应账号扫码并确认登录。
- 显示 账号已连接 后,从另一个账号发送一条私聊文字,确认收到 Agent 回复;测试群聊时,在群里明确 @ 已连接账号。
托管账号的群聊
在微信的 @ 选择器中选中该账号,再发送文字。Buda 会保留发言人身份,将 Agent 回复发回原群,不会自动 @ 发言人。
@ 所有人、@ 其他成员或手动输入普通昵称不会触发回复。未 @ 该账号的群消息会被忽略,不会进入 Buda 会话记录。不同群与私聊使用各自的会话。
当前支持私聊及群内 @ 文字对话,暂不支持图片、文件、语音、联系人管理或群发。
托管账号的状态与恢复
- 二维码过期或账号离线:在 管理账号连接 中重新生成二维码并确认登录。
- 没有账号实例、凭证验证失败或连接需要处理:联系我们,提供 Buda 中显示的错误信息。
- 显示已连接但没有回复:确认发送的是私聊文字或群内明确 @ 消息,再检查 Buda 会话记录。
- 解绑仅移除 Buda 连接,不会默认退出整个账号;如需恢复该账号的其他消息接收配置,请联系我们。
相关内容
- 渠道总览 —— 渠道如何把消息路由给智能体
- 连接 WhatsApp —— 同样是扫码即用的模式,适用于 WhatsApp