sipeed · yinwm · Feb 21, 2026 · Feb 21, 2026
diff --git a/README.zh.md b/README.zh.md
diff --git a/docs/channels/dingtalk/README.zh.md b/docs/channels/dingtalk/README.zh.md
@@ -0,0 +1,33 @@
+# 钉钉
+
+钉钉是阿里巴巴的企业通讯平台，在中国职场中广受欢迎。它采用流式 SDK 来维持持久连接。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "dingtalk": {
+      "enabled": true,
+      "client_id": "YOUR_CLIENT_ID",
+      "client_secret": "YOUR_CLIENT_SECRET",
+      "allow_from": []
+    }
+  }
+}
+```
+
+| 字段          | 类型   | 必填 | 描述                             |
+| ------------- | ------ | ---- | -------------------------------- |
+| enabled       | bool   | 是   | 是否启用钉钉频道                 |
+| client_id     | string | 是   | 钉钉应用的 Client ID             |
+| client_secret | string | 是   | 钉钉应用的 Client Secret         |
+| allow_from    | array  | 否   | 用户ID白名单，空表示允许所有用户 |
+
+## 设置流程
+
+1. 前往 [钉钉开放平台](https://open.dingtalk.com/)
+2. 创建一个企业内部应用
+3. 从应用设置中获取 Client ID 和 Client Secret
+4. 配置OAuth和事件订阅(如需要)
+5. 将 Client ID 和 Client Secret 填入配置文件中
diff --git a/docs/channels/discord/README.zh.md b/docs/channels/discord/README.zh.md
@@ -0,0 +1,35 @@
+# Discord
+
+Discord 是一个专为社区设计的免费语音、视频和文本聊天应用。PicoClaw 通过 Discord Bot API 连接到 Discord 服务器，支持接收和发送消息。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "discord": {
+      "enabled": true,
+      "token": "YOUR_BOT_TOKEN",
+      "allow_from": ["YOUR_USER_ID"],
+      "mention_only": false
+    }
+  }
+}
+```
+
+| 字段         | 类型   | 必填 | 描述                             |
+| ------------ | ------ | ---- | -------------------------------- |
+| enabled      | bool   | 是   | 是否启用 Discord 频道            |
+| token        | string | 是   | Discord 机器人 Token             |
+| allow_from   | array  | 否   | 用户ID白名单，空表示允许所有用户 |
+| mention_only | bool   | 否   | 是否仅响应提及机器人的消息       |
+
+## 设置流程
+
+1. 前往 [Discord 开发者门户](https://discord.com/developers/applications) 创建一个新的应用
+2. 启用 Intents:
+   - Message Content Intent
+   - Server Members Intent
+3. 获取 Bot Token
+4. 将 Bot Token 填入配置文件中
+5. 邀请机器人加入服务器并授予必要权限(例如发送消息、读取消息历史等)
diff --git a/docs/channels/feishu/README.zh.md b/docs/channels/feishu/README.zh.md
@@ -0,0 +1,37 @@
+# 飞书
+
+飞书（国际版名称：Lark）是字节跳动旗下的企业协作平台。它通过事件驱动的 Webhook 同时支持中国和全球市场。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "feishu": {
+      "enabled": true,
+      "app_id": "cli_xxx",
+      "app_secret": "xxx",
+      "encrypt_key": "",
+      "verification_token": "",
+      "allow_from": []
+    }
+  }
+}
+```
+
+| 字段               | 类型   | 必填 | 描述                             |
+| ------------------ | ------ | ---- | -------------------------------- |
+| enabled            | bool   | 是   | 是否启用飞书频道                 |
+| app_id             | string | 是   | 飞书应用的 App ID(以cli\_开头)   |
+| app_secret         | string | 是   | 飞书应用的 App Secret            |
+| encrypt_key        | string | 否   | 事件回调加密密钥                 |
+| verification_token | string | 否   | 用于Webhook事件验证的Token       |
+| allow_from         | array  | 否   | 用户ID白名单，空表示允许所有用户 |
+
+## 设置流程
+
+1. 前往 [飞书开放平台](https://open.feishu.cn/)创建应用程序
+2. 获取 App ID 和 App Secret
+3. 配置事件订阅和Webhook URL
+4. 设置加密(可选,生产环境建议启用)
+5. 将 App ID、App Secret、Encrypt Key 和 Verification Token(如果启用加密) 填入配置文件中
diff --git a/docs/channels/line/README.zh.md b/docs/channels/line/README.zh.md
@@ -0,0 +1,41 @@
+# Line
+
+PicoClaw 通过 LINE Messaging API 配合 Webhook 回调功能实现对 LINE 的支持。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "line": {
+      "enabled": true,
+      "channel_secret": "YOUR_CHANNEL_SECRET",
+      "channel_access_token": "YOUR_CHANNEL_ACCESS_TOKEN",
+      "webhook_host": "0.0.0.0",
+      "webhook_port": 18791,
+      "webhook_path": "/webhook/line",
+      "allow_from": []
+    }
+  }
+}
+```
+
+| 字段                 | 类型   | 必填 | 描述                                       |
+| -------------------- | ------ | ---- | ------------------------------------------ |
+| enabled              | bool   | 是   | 是否启用 LINE Channel                      |
+| channel_secret       | string | 是   | LINE Messaging API 的 Channel Secret       |
+| channel_access_token | string | 是   | LINE Messaging API 的 Channel Access Token |
+| webhook_host         | string | 是   | Webhook 监听的主机地址 (通常为 0.0.0.0)    |
+| webhook_port         | int    | 是   | Webhook 监听的端口 (默认为 18791)          |
+| webhook_path         | string | 是   | Webhook 的路径 (默认为 /webhook/line)      |
+| allow_from           | array  | 否   | 用户ID白名单，空表示允许所有用户           |
+
+## 设置流程
+
+1. 前往 [LINE Developers Console](https://developers.line.biz/console/) 创建一个服务提供商和一个 Messaging API Channel
+2. 获取 Channel Secret 和 Channel Access Token
+3. 配置Webhook:
+   - Line要求Webhook必须使用HTTPS协议，因此需要部署一个支持HTTPS的服务器，或者使用反向代理工具如ngrok将本地服务器暴露到公网
+   - 将 Webhook URL 设置为 `https://your-domain.com/webhook/line`
+   - 启用 Webhook 并验证 URL
+4. 将 Channel Secret 和 Channel Access Token 填入配置文件中
diff --git a/docs/channels/maixcam/README.zh.md b/docs/channels/maixcam/README.zh.md
@@ -0,0 +1,31 @@
+# MaixCam
+
+MaixCam 是专用于连接矽速科技 MaixCAM 与 MaixCAM2 AI 摄像设备的通道。它采用 TCP 套接字实现双向通信，支持边缘 AI 部署场景。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "maixcam": {
+      "enabled": true,
+      "server_address": "0.0.0.0:8899",
+      "allow_from": []
+    }
+  }
+}
+```
+
+| 字段           | 类型   | 必填 | 描述                             |
+| -------------- | ------ | ---- | -------------------------------- |
+| enabled        | bool   | 是   | 是否启用 MaixCam 频道            |
+| server_address | string | 是   | TCP 服务器监听地址和端口         |
+| allow_from     | array  | 否   | 设备ID白名单，空表示允许所有设备 |
+
+## 使用场景
+
+MaixCam 通道使 PicoClaw 能够作为边缘设备的 AI 后端运行：
+
+- **智能监控** ：MaixCAM 发送图像帧，PicoClaw 通过视觉模型进行分析
+- **物联网控制** ：设备发送传感器数据，PicoClaw 协调响应
+- **离线AI** ：在本地网络部署 PicoClaw 实现低延迟推理
diff --git a/docs/channels/onebot/README.zh.md b/docs/channels/onebot/README.zh.md
@@ -0,0 +1,31 @@
+# OneBot
+
+OneBot 是一个面向 QQ 机器人的开放协议标准，为多种 QQ 机器人实现（例如 go-cqhttp、Mirai）提供了统一的接口。它使用 WebSocket 进行通信。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "onebot": {
+      "enabled": true,
+      "ws_url": "ws://localhost:8080",
+      "access_token": "",
+      "allow_from": []
+    }
+  }
+}
+```
+
+| 字段         | 类型   | 必填 | 描述                             |
+| ------------ | ------ | ---- | -------------------------------- |
+| enabled      | bool   | 是   | 是否启用 OneBot 频道             |
+| ws_url       | string | 是   | OneBot 服务器的 WebSocket URL    |
+| access_token | string | 否   | 连接 OneBot 服务器的访问令牌     |
+| allow_from   | array  | 否   | 用户ID白名单，空表示允许所有用户 |
+
+## 设置流程
+
+1. 部署一个 OneBot 兼容的实现(例如napcat)
+2. 配置 OneBot 实现以启用 WebSocket 服务并设置访问令牌(如果需要)
+3. 将 WebSocket URL 和访问令牌填入配置文件中
diff --git a/docs/channels/qq/README.zh.md b/docs/channels/qq/README.zh.md
@@ -0,0 +1,32 @@
+# QQ
+
+PicoClaw 通过 QQ 开放平台的官方机器人 API 提供对 QQ 的支持。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "qq": {
+      "enabled": true,
+      "app_id": "YOUR_APP_ID",
+      "app_secret": "YOUR_APP_SECRET",
+      "allow_from": []
+    }
+  }
+}
+```
+
+| 字段       | 类型   | 必填 | 描述                             |
+| ---------- | ------ | ---- | -------------------------------- |
+| enabled    | bool   | 是   | 是否启用 QQ Channel              |
+| app_id     | string | 是   | QQ 机器人应用的 App ID           |
+| app_secret | string | 是   | QQ 机器人应用的 App Secret       |
+| allow_from | array  | 否   | 用户ID白名单，空表示允许所有用户 |
+
+## 设置流程
+
+1. 前往 [QQ 开放平台](https://q.qq.com/) 创建一个机器人
+2. 通过仪表盘获取 App ID 和 App Secret
+3. 开启机器人沙箱模式, 将用户和群添加到沙箱中
+4. 将 App ID 和 App Secret 填入配置文件中
diff --git a/docs/channels/slack/README.zh.md b/docs/channels/slack/README.zh.md
@@ -0,0 +1,33 @@
+# Slack
+
+Slack 是全球领先的企业级即时通讯平台。PicoClaw 采用 Slack 的 Socket Mode 实现实时双向通信，无需配置公开的 Webhook 端点。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "slack": {
+      "enabled": true,
+      "bot_token": "xoxb-...",
+      "app_token": "xapp-...",
+      "allow_from": []
+    }
+  }
+}
+```
+
+| 字段       | 类型   | 必填 | 描述                                                     |
+| ---------- | ------ | ---- | -------------------------------------------------------- |
+| enabled    | bool   | 是   | 是否启用 Slack 频道                                      |
+| bot_token  | string | 是   | Slack 机器人的 Bot User OAuth Token (以 xoxb- 开头)      |
+| app_token  | string | 是   | Slack 应用的 Socket Mode App Level Token (以 xapp- 开头) |
+| allow_from | array  | 否   | 用户ID白名单，空表示允许所有用户                         |
+
+## 设置流程
+
+1. 前往 [Slack API](https://api.slack.com/) 创建一个新的 Slack 应用
+2. 启用 Socket Mode 并获取 App Level Token
+3. 添加 Bot Token Scopes(例如`chat:write`、`im:history`等)
+4. 安装应用到工作区并获取 Bot User OAuth Token
+5. 将 Bot Token 和 App Token 填入配置文件中
diff --git a/docs/channels/telegram/README.zh.md b/docs/channels/telegram/README.zh.md
@@ -0,0 +1,33 @@
+# Telegram
+
+Telegram Channel 通过 Telegram 机器人 API 使用长轮询实现基于机器人的通信。它支持文本消息、媒体附件（照片、语音、音频、文档）、通过 Groq Whisper 进行语音转录以及内置命令处理器。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "telegram": {
+      "enabled": true,
+      "token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
+      "allow_from": ["123456789"],
+      "proxy": ""
+    }
+  }
+}
+```
+
+| 字段       | 类型   | 必填 | 描述                                                      |
+| ---------- | ------ | ---- | --------------------------------------------------------- |
+| enabled    | bool   | 是   | 是否启用 Telegram 频道                                    |
+| token      | string | 是   | Telegram 机器人 API Token                                 |
+| allow_from | array  | 否   | 用户ID白名单，空表示允许所有用户                          |
+| proxy      | string | 否   | 连接 Telegram API 的代理 URL (例如 http://127.0.0.1:7890) |
+
+## 设置流程
+
+1. 在 Telegram 中搜索 `@BotFather`
+2. 发送 `/newbot` 命令并按照提示创建新机器人
+3. 获取 HTTP API Token
+4. 将 Token 填入配置文件中
+5. (可选) 配置 `allow_from` 以限制允许互动的用户 ID (可通过 `@userinfobot` 获取 ID)
diff --git a/docs/channels/wecom/wecom_app/README.zh.md b/docs/channels/wecom/wecom_app/README.zh.md
@@ -0,0 +1,47 @@
+# 企业微信自建应用
+
+企业微信自建应用是指企业在企业微信中创建的应用，主要用于企业内部使用。通过企业微信自建应用，企业可以实现与员工的高效沟通和协作，提高工作效率。
+
+## 配置
+
+```json
+{
+  "channels": {
+    "wecom_app": {
+      "enabled": true,
+      "corp_id": "wwxxxxxxxxxxxxxxxx",
+      "corp_secret": "YOUR_CORP_SECRET",
+      "agent_id": 1000002,
+      "token": "YOUR_TOKEN",
+      "encoding_aes_key": "YOUR_ENCODING_AES_KEY",
+      "webhook_host": "0.0.0.0",
+      "webhook_port": 18792,
+      "webhook_path": "/webhook/wecom-app",
+      "allow_from": [],
+      "reply_timeout": 5
+    }
+  }
+}
+```
+
+| 字段             | 类型   | 必填 | 描述                                     |
+| ---------------- | ------ | ---- | ---------------------------------------- |
+| corp_id          | string | 是   | 企业 ID                                  |
+| corp_secret      | string | 是   | 应用程序密钥                             |
+| agent_id         | int    | 是   | 应用程序代理 ID                          |
+| token            | string | 是   | 回调验证令牌                             |
+| encoding_aes_key | string | 是   | 43 字符 AES 密钥                         |
+| webhook_host     | string | 否   | HTTP 服务器绑定地址                      |
+| webhook_port     | int    | 否   | HTTP 服务器端口（默认：18792）           |
+| webhook_path     | string | 否   | Webhook 路径（默认：/webhook/wecom-app） |
+| allow_from       | array  | 否   | 用户 ID 白名单                           |
+| reply_timeout    | int    | 否   | 回复超时时间（秒）                       |
+
+## 设置流程
+
+1. 登录 [企业微信管理后台](https://work.weixin.qq.com/)
+2. 进入“应用管理” -> “创建应用”
+3. 获取企业 ID (CorpID) 和应用 Secret
+4. 在应用设置中配置“接收消息”，获取 Token 和 EncodingAESKey
+5. 设置回调 URL 为 `http://<your-server-ip>:<port>/webhook/wecom-app`
+6. 将 CorpID, Secret, AgentID 等信息填入配置文件