> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerone.run/llms.txt
> Use this file to discover all available pages before exploring further.

# 消息渠道（Beta）

> 通过 Telegram、飞书、Discord、QQ 或微信与桌面 Agent 对话。

消息渠道让你从手机上的即时通讯应用与 Zerone 对话。在桌面上启动 Zerone，配置好 Bot 后，你可以通过 `Telegram、Discord、飞书、QQ、微信` 随时随地与 Zerone 交互。

<img src="https://mintcdn.com/zerone/Sg-N27cdMGbTyTuO/images/app/channels-1.png?fit=max&auto=format&n=Sg-N27cdMGbTyTuO&q=85&s=c843b0c426da9fba218c6f8b70da64c5" alt="消息渠道（Beta）操作界面示例 1" width="2536" height="1794" data-path="images/app/channels-1.png" />

## 支持的平台

| 平台        | 特点                                      |
| --------- | --------------------------------------- |
| Telegram  | 长轮询模式，支持流式预览、权限按钮、丰富的 Markdown 渲染       |
| Discord   | WebSocket 模式，支持流式预览、频道/私聊双模式            |
| 飞书 / Lark | WebSocket 模式，支持国内/国际版切换、群组策略控制          |
| QQ        | REST API 模式，支持图片发送、私聊桥接                 |
| 微信        | 扫码关联账号；支持文本收发和媒体输入；无流式预览、无交互按钮，存在账号使用风险 |

## 基本设置

### 开启消息渠道

1. 点击侧边栏的 `工具 -> 消息渠道`

2. 在 `消息渠道` 总览页面打开 `消息渠道` 主开关

3. 分别启用你需要的渠道（Telegram / Discord / 飞书 / QQ / 微信）

4. 进入各渠道页面配置 Bot 凭据

5. 点击 `启动` 按钮

### 消息渠道全局设置

在消息渠道总览页面可以配置：

* 默认工作目录 — 新对话的默认项目路径

* 默认模型 — 消息渠道对话使用的模型

* 默认服务商 — 消息渠道对话使用的 API 服务商

* 自动启动 — Zerone 启动时自动开启消息渠道服务

### 消息渠道状态

消息渠道页面实时显示：

* 主服务状态（已连接 / 已断开）

* 各渠道适配器状态

* 活跃的会话绑定数量

* 最后一条消息时间

## 斜杠命令

在 IM 中可以使用斜杠命令控制 Zerone：

| 命令        | 参数                                         | 说明                       |
| --------- | ------------------------------------------ | ------------------------ |
| /new      | \[路径]                                      | 新建对话，可指定工作目录             |
| /bind     | 会话 ID                                      | 绑定当前 IM 聊天到已有的 Zerone 对话 |
| /cwd      | /path/to/dir                               | 切换当前对话的工作目录              |
| /mode     | `plan`、`code` 或 `ask`                      | 切换对话模式                   |
| /status   | —                                          | 查看当前对话状态（ID、工作目录、模式、模型）  |
| /sessions | —                                          | 列出当前渠道最近的对话（最多 10 个）     |
| /stop     | —                                          | 中止当前正在运行的任务              |
| /help     | —                                          | 查看可用命令                   |
| /perm     | `allow`、`allow_session` 或 `deny`，后接权限请求 ID | 响应指定的权限请求                |

## 使用建议

* 保持 Zerone 运行 — 消息渠道依赖桌面端作为中转，关闭后 Bot 无法响应

* 系统托盘模式 — 最小化到系统托盘，消息渠道保持活跃不占桌面空间

* 私聊优先 — 建议在私聊中使用，群聊中可能被其他消息干扰

* 限定访问者 — 根据渠道配置白名单和群聊策略，避免他人借助机器人访问你的电脑文件。

* 权限确认 — Zerone 需要执行敏感操作时会请求确认。Telegram、Discord 与飞书支持交互式确认按钮；QQ 和微信请通过 /perm allow 等文本命令确认。

## 各渠道配置

[飞书接入](/zh/app/feishu)
