---
title: "企业微信机器人进阶玩法：群聊、命令、文件和主动推送"
description: "接好企业微信机器人之后的用法：在群里 @ 它、用 /stop 和 /clear 控制它、互相收发图片和文件、长回复和忙碌时的表现，以及让数字人主动给群发消息。"
type: "how-to"
audience: ["office"]
prerequisites: ["digital-humans/wecom-bot"]
related: ["digital-humans/channels", "digital-humans/permissions", "digital-humans/notifications", "digital-humans/wecom-name-resolution"]
lang: "zh-CN"
canonical: "https://hello-halo.cc/docs/digital-humans/wecom-bot-features.html"
last_updated: "2026-10-19T00:11:17+08:00"
source: "Halo 3.0.4 docs"
---
# 企业微信机器人进阶

接好企业微信机器人之后的用法：在群里 @ 它、用 /stop 和 /clear 控制它、互相收发图片和文件、长回复和忙碌时的表现，以及让数字人主动给群发消息。

这一页的操作大多在企业微信里进行，相关设置在 Halo 的 **设置 › 消息通道** 里。

## 开始之前 {#before-you-start}

- 已经按 [企业微信智能机器人](https://hello-halo.cc/docs/digital-humans/wecom-bot.html) 接好机器人，你是它的主人。

## 在群里用 {#groups}

- 把机器人加进群，@ 它再说话。企业微信只把 @ 机器人的消息转给它，没 @ 的消息它看不到。
- 群里每条消息都带着发消息人的身份，数字人知道是谁说的。
- 回复默认引用你那条消息（**引用回复（群聊）**）。关掉后回复不带引用，**流式传输** 也会跟着关掉。
- 群里的人分主人和访客：访客默认只能聊天和使用记忆；主人和访客的消息被合在一起处理时，按访客的权限执行。见 [主人与访客权限](https://hello-halo.cc/docs/digital-humans/permissions.html)。
- 群在 Halo 里默认显示成一串 ID；配好 [姓名解析](https://hello-halo.cc/docs/digital-humans/wecom-name-resolution.html) 后会显示群名。也可以到数字人的 **能力与设置 › 消息与通知 › 可联系的联系人** 里给它 **重命名**，比如「销售群」，之后说「发到销售群」它就知道是哪个。

## 聊天里的命令 {#commands}

| 发送 | 作用 | 机器人回复 |
|---|---|---|
| `/stop`（也可以用 `/halo-stop`、`/halo-cancel`） | 停下正在做的事 | Generation stopped.（没有在做的事时是 No active generation to stop.） |
| `/clear`（也可以用 `/halo-clear`、`/halo-reset`） | 清空这个聊天的上下文，重新开始 | Context cleared. Starting a fresh conversation. |

- 命令不区分大小写；群里先 @ 机器人再发命令也行。机器人的回复只有英文。
- `/clear` 只清空聊天上下文，数字人的记忆和提醒都还在。

## 它忙的时候再发消息 {#while-busy}

它正在回复时你接着发的消息不会丢：

- 能马上用上的，会回「✏️ 已加入正在进行的处理」，它在这一轮里就会看到。
- 其余的会回「✏️ 已收到补充消息」（之后再发的会回「✏️ 又收到补充」），等这一轮做完，它先发一句「（上一轮回应已结束）」，再把这些补充合在一起处理。

## 收发图片和文件 {#files}

- 它能收文字、图片、图文混排、语音（企业微信转好的文字）、文件和视频。引用一条带图片或文件的消息再 @ 它，引用里的图片和文件也会交给它。
- 想要它发文件，直接说，比如「把报告发给我」。图片按图片发，其他按文件发。
- 图片最大 10 MB（更大的按文件发），文件最大 20 MB；超过上限时发送会失败，它会尝试压缩或拆分后再发。
- 它只能发自己工作区里或临时文件夹里的文件。

## 长回复和进度 {#long-replies}

- 一条企业微信消息最多约 2 万字节。更长的回复会拆成几条，标上 (1/3) 这样的序号，最多 10 条；再多的部分会提示「（内容过长，其余部分请在 Halo 里查看）」。
- **流式传输**（默认关）：打开后，回复会边写边显示在一条消息里；群里要同时开着 **引用回复（群聊）**。企业微信限制一条流式消息最长 10 分钟，超过后，这条消息会写明「任务仍在进行中，后续进度会以新消息推送」，之后的进度最多每 2 分钟发一条。
- **处理中提示**（默认开）：5 秒内还没回复时，先发「已收到，正在处理…」；开着 **流式传输** 时，这句话会马上出现在正在写的回复里，不另发一条。
- 对方最后一条消息后 24 小时内，回复会引用原消息；超过 24 小时，回复和文件改为直接发出，不带引用。群里关了 **引用回复（群聊）** 时，回复始终不引用。

## 让数字人主动给群发消息 {#push}

给机器人发过消息的人和群，会成为这位数字人的联系人，它可以主动给他们发消息，见 [主动发给联系人](https://hello-halo.cc/docs/digital-humans/notifications.html#push-to-contacts)。

常见用法：

- **每天定时汇报**：给数字人设运行计划，在它的 **系统提示词** 里写明「每次运行后，把结论发到销售群」。
- **结果自动同步**：在 **可联系的联系人** 里给群打开 **自动同步运行结果**，每次运行成功后把最终回复发到群里。
- **别的数字人也往这个群发**：在那位数字人的 **可联系的联系人** 里点 **从已有会话添加**，见 [借用别的数字人的机器人](https://hello-halo.cc/docs/digital-humans/notifications.html#from-existing-chats)。

网络短暂断开时，回复会先排队，最多等 2 分钟，连上后补发；这时主动推送会失败，数字人会收到连接已断开的提示，**自动同步运行结果** 也会跳过这一次。

## 用手机远程让它干活 {#remote-control}

主人可以在企业微信里随时让数字人在 Halo 所在的电脑上干活：写脚本并运行、操作浏览器、整理文件，再把结果发回来。

::: danger 主人的指令按完整权限执行
数字人会直接运行命令、修改和删除文件，中间不会逐步确认。只在私聊里这样用，确认 **权限控制** 已打开、**主人用户 ID** 里只有你，并在 **系统提示词** 里写明不能做的事。
:::

## 遇到问题 {#troubleshooting}

### 在群里说话，它没反应

1. 确认 @ 了机器人。
2. **回复范围** 不是 **仅私信**。
3. 机器人有主人。还没有时，先私聊它一句。

更多情况见 [机器人不回复](https://hello-halo.cc/docs/troubleshooting/channels.html)。

### 让它发文件，提示 File export denied

要发的文件不在它的工作区里，也不在临时文件夹里。先让它把文件存到自己的工作区，再发。

### 回复到一半就停了

发 `/stop` 让它停下，再重新发一次请求；也可以在 Halo 里打开数字人的 **IM 会话** 看它做到了哪一步。

## 下一步 {#next-steps}

- [主人与访客权限](https://hello-halo.cc/docs/digital-humans/permissions.html)：决定群里其他人能让它做什么。
- [企业微信显示真实姓名](https://hello-halo.cc/docs/digital-humans/wecom-name-resolution.html)：让联系人显示真名，而不是一串 ID。
- [通知与主动推送](https://hello-halo.cc/docs/digital-humans/notifications.html)：更多主动发消息的方式。