WeChat-AI 用户手册
说明如何登录、绑定微信机器人、和好友角色扮演对话，以及通过
@站内用户名 与其他用户私聊。面向普通用户，无需写代码。
1 简介
WeChat-AI 是一个自托管微信角色扮演服务：你用 邮箱和密码登录网页，扫码绑定自己的微信 ClawBot， 批准好友后即可在微信里和 AI 角色聊天。系统还会支持已绑定用户之间的 用户对话（机器人中继，不经过 AI）。
网页端
用户中心 /app：机器人、用户对话、人设、表情、绑定码、黑名单。
微信端
给机器人发文字即可聊天；可用 /绑定、@用户名 等命令。
2 快速开始
登录
打开 用户中心，使用邮箱和密码注册或登录。
扫码添加机器人
在「我的机器人」点击扫码添加，用微信扫码完成 ClawBot 绑定。
让好友私聊机器人
好友在微信中找到该机器人并发一条消息；你在用户中心批准后即可对话。
（可选）分配人设
从人设广场添加角色，在用户列表中为人设分配给具体好友。
默认仅已批准的微信用户可以和 AI 聊天。未批准时机器人会提示联系主人开通。
3 管理机器人
- 扫码添加：创建新的微信机器人账号。
- 重新扫码：token 失效时刷新凭证；会保留已批准用户、人设分配与记忆。
- 改名 / 删除：在机器人卡片或列表中操作。
请遵守腾讯微信 / ClawBot 相关使用条款。个人 Bot 可能有限流与风控；建议控制开放范围（白名单批准）。
4 批准微信好友
- 对方给机器人发任意消息后，会出现在「微信用户」列表。
- 点击批准，可选同时分配人设。
- 对方即可开始角色扮演对话（AI 可能分多条气泡回复）。
可在列表中查看记忆、清空记忆，或开启「允许主动」（见下文主动联系）。
5 人设
- 人设广场：按热度浏览公开角色；可试聊（网页限量体验，不写入微信）、加入库或改编（复制为你的私有草稿，可自由改写）。
- 我的人设：创建 / 编辑自己的角色提示词；可设为公开或私有；改编来的人设会标注「改编自」。
- 分配：在微信用户行选择人设，仅对应该用户生效；分配次数会提升广场热度。
微信内发送 /角色 不会切换角色——角色只能由主人在后台分配。
试聊有每日与单会话条数上限，计入 Token 用量；管理员可通过环境变量关闭。
6 表情包
- 在表情包广场浏览、加入自己的库；也可上传投稿（公开需管理员审核）。
- 对话中 AI 可能引用库中的 slug 以图片表情回复（需主人库中可用）。
7 用户对话（@LINUX DO 用户名）
两个都完成「微信身份绑定」的用户，可以在微信里通过机器人
互相发消息（中继，不调用 AI）。用户名即 LINUX DO 的
username。
7.1 绑定身份
生成绑定码
用户中心 → 用户对话 → 微信身份绑定 → 生成绑定码（约 10 分钟有效）。
微信确认
给任意已绑定的机器人发送：/绑定 ABC123（替换为你的码）。
先聊一句
绑定后请给机器人发过至少一条消息，系统才有推送凭证；否则别人 @ 你时会提示「不可达」。
微信发送 /我的身份 可查看当前绑定的 LINUX DO 用户名与会话状态。
7.2 发起与聊天
- 整条消息只发：
@对方用户名（例如@alice）。 - 对方收到「对话请求」，回复
/同意或/拒绝。 - 同意后双方直接发文字；对方会看到类似
[alice] 你好的前缀。 - 任一方发送
/断开结束；长时间无消息（默认约 30 分钟）也会自动结束，并恢复与 AI 角色扮演。
- 会话中仅支持文字；图片 / 语音会提示不支持。
hello @alice这类夹在句子里的写法不会发起请求。- 每个账号同一时间通常只能有一个进行中的请求或会话。
8 黑名单
不想被某人 @ 时可以拉黑（双向无法再建立用户对话）。
- 网页：用户中心 → 用户对话 → 黑名单 → 输入用户名拉黑 / 取消拉黑。
- 微信：
/拉黑 用户名、/取消拉黑 用户名、/黑名单。
拉黑会结束与对方进行中的用户对话请求或会话。
9 微信命令一览
| 命令 | 说明 |
|---|---|
/绑定 CODE | 认领用户中心生成的绑定码 |
/解绑 | 解除微信与 LINUX DO 的绑定 |
/我的身份 | 查看绑定用户名与当前状态 |
@用户名 | 整条消息：向对方发起对话请求 |
/同意 | 同意入站对话请求 |
/拒绝 | 拒绝入站对话请求 |
/取消请求 | 取消自己发出的请求 |
/断开 | 结束当前用户对话，恢复 AI |
/拉黑 用户名 | 拉黑（可选前缀 @） |
/取消拉黑 用户名 | 移出黑名单 |
/黑名单 | 查看黑名单列表 |
/角色 … | 不支持自助切换；由主人在后台分配 |
未匹配上述命令、且不在用户会话中时，消息会交给 AI 角色扮演回复（需已批准）。
10 主动联系（可选）
若站点开启了主动联系，空闲一段时间后角色可能主动给用户发消息。
- 机器人卡片中打开「主动找用户聊天」并保存参数。
- 对具体微信用户勾选「允许主动」。
- 对方须曾经聊过机器人（有会话凭证）。
具体是否开启由站点管理员配置；个人用户仅能控制自己的机器人与好友开关。
11 常见问题
对方收不到我的 @ 请求？
- 双方是否都完成了
/绑定？ - 对方是否用绑定的微信给机器人发过消息（可达）？
- 是否在黑名单中？用户名是否拼写正确（不区分大小写）？
- 对方是否正忙（已有请求 / 会话）？
AI 不回复？
- 是否已在用户中心批准该微信用户？
- 是否在用户对话会话中？会话内不会走 AI，需先
/断开。 - 发得太快会触发限流提示。
能发图片 / 语音吗？
- 语音：微信自带的语音转文字会一并送到机器人，所以带转写的语音就当文字聊。
- 图片：站点开启「图片理解」后，机器人能看图并据实描述；未开启时会直接告诉你看不了。
- 视频 / 文件：暂时看不了，机器人会说明并请你用文字描述。
绑定码无效？
绑定码有时效且只能用一次。请在用户中心重新生成，再发 /绑定 新码。
机器人突然不回？
可能是微信会话过期。在用户中心对该机器人使用重新扫码刷新凭证（数据会保留）。