企业微信机器人玩法指南
配置好机器人后，这篇文档告诉你能用它做什么。
机器人行为控制
在 设置 → 消息通道 → WeCom Intelligent Bot 卡片中，每个机器人实例有独立的行为控制选项。
回复范围
控制机器人响应哪类消息：
| 选项 | 说明 |
|---|---|
| 仅群聊（默认） | 只在被 @ 的群消息中回复，忽略所有私聊 |
| 全部消息 | 群聊和私聊都响应 |
| 仅私聊 | 只回复私信，忽略群消息 |
开启"全部消息"前请考虑
开启后，任意企业成员都可以直接与数字人私聊，请确保数字人的 system_prompt 和权限控制符合预期。
流式传输
控制数字人的思考过程是否实时推送到企业微信：
| 选项 | 说明 |
|---|---|
| 开启（默认） | 思考步骤、工具调用过程实时显示在聊天中 |
| 关闭 | 等待完整回复后才发出，用户看不到中间过程 |
部分场景下关闭流式传输体验更好——例如数字人需要调用多个工具、中间步骤信息量大、或接入方不希望展示 AI 的"思考"过程。
消息收发能力
私聊
员工直接给机器人发私信，数字人可以看到完整的对话历史，上下文连贯。适合：
- 一对一问答、查信息
- 长期跟进某个任务
- 私密的审批、汇报流程
群聊
群里的数字人遵循企业微信协议限制：
只有被 @ 才能看到消息。 没有 @ 机器人的消息，它完全看不到——这是企业微信协议层面的约束，不是 Halo 的限制。
因此群里的用法是：@ 机器人 + 问题/指令，机器人回复当前这条，不会"偷听"其他人的聊天。适合：
- 团队内公开查询（查数据、查状态）
- 群播报（见下方"主动通知"）
主动发起通知
机器人不只能被动回复，也可以主动给个人或群发消息。
前提：先 @ 一次建立关联
企业微信协议要求，机器人首次主动联系某个人或群，需要对方先 @ 过机器人一次（哪怕只说"你好"）。一次就够，之后机器人就能持续主动触达这个会话。
操作步骤：
- 在目标群或私聊中 @ 机器人随便发一条消息
- 之后在 Halo 中，该会话就会出现在可选列表中
- 数字人即可通过这个会话主动发通知
群名称说明
企业微信协议不提供群名称，Halo 里看到的是会话 ID。你可以在 Halo 中自己给这个会话设置一个好记的名字（如"前端组"、"项目X群"）。
定时通知场景
配合数字人的定时调度，机器人可以成为团队的自动化通知中枢：
| 场景 | 示例 |
|---|---|
| 需求跟进 | 每天早上从 JIRA/TAPD 拉取新需求，通知对应开发 |
| 会议提醒 | 开会前 15 分钟 @ 所有参与者 |
| 任务管理 | 截止日临近时主动催办 |
| 系统监控 | 服务异常时第一时间通知值班群 |
| 日报/周报 | 定时汇总数据，自动发到管理群 |
这些场景的实现方式：创建一个带定时调度的数字人，在 system_prompt 中指定要通知的会话，Skill 脚本完成数据拉取，最后通过企业微信机器人发出通知。
Bot 远程控制（高级）
高危功能，请谨慎使用
这个玩法给予 AI 极大的执行权限，操作不当可能导致数据丢失、文件损坏或误操作。仅建议在受控环境、由有技术能力的用户使用。
通过企业微信给机器人发指令，AI 可以在 Halo 所在的机器上执行任意操作：
- 写代码并运行：描述需求，AI 写脚本、执行、返回结果
- 操作浏览器：让 AI 打开网页、填表、截图、抓取数据
- 访问内部系统：触发数字人去操作企业内网的各类工具
- 文件操作：读取、生成、转换本地文件
使用场景举例：
- 出门在外，手机发一条消息让 AI 帮你跑一段脚本
- 紧急情况下远程触发自动化流程
- 把企业微信变成 AI 的"远程终端"
安全建议：
- 只在个人私聊中使用，不要在群里暴露这个能力
- system_prompt 中明确列出禁止操作的范围
- 敏感操作建议加二次确认步骤
快速对比
| 能力 | 私聊 | 群聊 |
|---|---|---|
| 收到消息 | ✅ 全部消息 | ✅ 仅被 @ 的消息 |
| 主动发通知 | ✅（对方 @ 过一次后） | ✅（有人 @ 过一次后） |
| 完整对话历史 | ✅ | ❌ 只有 @ 的那条 |
| 适合场景 | 个人助理、远程控制 | 群播报、公开查询 |