docs: init docs

docs/zh/channels/dingtalk.mdx

@@ -0,0 +1,40 @@
+---
+title: 钉钉
+description: 将 CowAgent 接入钉钉应用
+---
+
+# 钉钉
+
+通过钉钉开放平台创建智能机器人应用，将 CowAgent 接入钉钉。
+
+## 一、创建应用
+
+1. 进入 [钉钉开发者后台](https://open-dev.dingtalk.com/fe/app#/corp/app)，点击 **创建应用**，填写应用信息
+2. 点击添加应用能力，选择 **机器人** 能力并添加
+3. 配置机器人信息后点击 **发布**
+
+## 二、项目配置
+
+1. 在 **凭证与基础信息** 中获取 `Client ID` 和 `Client Secret`
+
+2. 填入 `config.json`：
+
+```json
+{
+  "channel_type": "dingtalk",
+  "dingtalk_client_id": "YOUR_CLIENT_ID",
+  "dingtalk_client_secret": "YOUR_CLIENT_SECRET"
+}
+```
+
+3. 安装依赖：
+
+```bash
+pip3 install dingtalk_stream
+```
+
+4. 启动项目后，在钉钉开发者后台点击 **事件订阅**，点击 **已完成接入，验证连接通道**，显示"连接接入成功"即表示配置完成
+
+## 三、使用
+
+与机器人私聊或将机器人拉入企业群中均可开启对话。

docs/zh/channels/feishu.mdx

@@ -0,0 +1,69 @@
+---
+title: 飞书
+description: 将 CowAgent 接入飞书应用
+---
+
+# 飞书
+
+通过自建应用将 CowAgent 接入飞书，支持 WebSocket 长连接（推荐）和 Webhook 两种事件接收模式。
+
+## 一、创建企业自建应用
+
+### 1. 创建应用
+
+进入 [飞书开发平台](https://open.feishu.cn/app/)，点击 **创建企业自建应用**，填写必要信息后创建。
+
+### 2. 添加机器人能力
+
+在 **添加应用能力** 菜单中，为应用添加 **机器人** 能力。
+
+### 3. 配置应用权限
+
+点击 **权限管理**，粘贴以下权限配置，全选并批量开通：
+
+```
+im:message,im:message.group_at_msg,im:message.group_at_msg:readonly,im:message.p2p_msg,im:message.p2p_msg:readonly,im:message:send_as_bot,im:resource
+```
+
+## 二、项目配置
+
+在 **凭证与基础信息** 中获取 `App ID` 和 `App Secret`，填入 `config.json`：
+
+<Tabs>
+  <Tab title="WebSocket 模式（推荐）">
+    无需公网 IP，配置如下：
+
+    ```json
+    {
+      "channel_type": "feishu",
+      "feishu_app_id": "YOUR_APP_ID",
+      "feishu_app_secret": "YOUR_APP_SECRET",
+      "feishu_event_mode": "websocket"
+    }
+    ```
+
+    需安装依赖：`pip3 install lark-oapi`
+  </Tab>
+  <Tab title="Webhook 模式">
+    需要公网 IP，配置如下：
+
+    ```json
+    {
+      "channel_type": "feishu",
+      "feishu_app_id": "YOUR_APP_ID",
+      "feishu_app_secret": "YOUR_APP_SECRET",
+      "feishu_token": "VERIFICATION_TOKEN",
+      "feishu_event_mode": "webhook",
+      "feishu_port": 9891
+    }
+    ```
+  </Tab>
+</Tabs>
+
+## 三、配置事件订阅
+
+1. 启动项目后，在飞书开放平台点击 **事件与回调**，选择 **长连接** 方式并保存
+2. 点击 **添加事件**，搜索 "接收消息"，选择 "接收消息v2.0"，确认添加
+3. 点击 **版本管理与发布**，创建版本并申请线上发布，审核通过后即可使用
+
+完成后在飞书中搜索机器人名称，即可开始对话。

docs/zh/channels/web.mdx

@@ -0,0 +1,33 @@
+---
+title: Web 网页
+description: 通过 Web 网页端使用 CowAgent
+---
+
+# Web 网页
+
+Web 是 CowAgent 的默认通道，启动后会自动运行 Web 控制台，通过浏览器即可与 Agent 对话。
+
+## 配置
+
+```json
+{
+  "channel_type": "web",
+  "web_port": 9899
+}
+```
+
+| 参数 | 说明 | 默认值 |
+| --- | --- | --- |
+| `channel_type` | 设为 `web` | `web` |
+| `web_port` | Web 服务监听端口 | `9899` |
+
+## 使用
+
+启动项目后访问：
+
+- 本地运行：`http://localhost:9899/chat`
+- 服务器运行：`http://<server-ip>:9899/chat`
+
+<Note>
+  请确保服务器防火墙和安全组已放行对应端口。
+</Note>

docs/zh/channels/wechatmp.mdx

@@ -0,0 +1,58 @@
+---
+title: 微信公众号
+description: 将 CowAgent 接入微信公众号
+---
+
+# 微信公众号
+
+CowAgent 支持接入个人订阅号和企业服务号两种公众号类型。
+
+| 类型 | 要求 | 特点 |
+| --- | --- | --- |
+| **个人订阅号** | 个人可申请 | 回复生成后需用户主动发消息获取 |
+| **企业服务号** | 企业申请，需通过微信认证开通客服接口 | 回复生成后可主动推送给用户 |
+
+<Note>
+  公众号仅支持服务器和 Docker 部署，需额外安装扩展依赖：`pip3 install -r requirements-optional.txt`
+</Note>
+
+## 一、个人订阅号
+
+在 `config.json` 中配置：
+
+```json
+{
+  "channel_type": "wechatmp",
+  "wechatmp_app_id": "YOUR_APP_ID",
+  "wechatmp_app_secret": "YOUR_APP_SECRET",
+  "wechatmp_aes_key": "",
+  "wechatmp_token": "YOUR_TOKEN",
+  "wechatmp_port": 80
+}
+```
+
+### 配置步骤
+
+1. 在 [微信公众平台](https://mp.weixin.qq.com/) 的 **设置与开发 → 基本配置 → 服务器配置** 中获取参数
+2. 启用开发者密码，将服务器 IP 加入白名单
+3. 启动程序（监听 80 端口）
+4. 在公众号后台 **启用服务器配置**，URL 格式为 `http://{HOST}/wx`
+
+## 二、企业服务号
+
+与个人订阅号流程基本相同，差异如下：
+
+1. 在公众平台申请企业服务号并完成微信认证，确认已获得 **客服接口** 权限
+2. 在 `config.json` 中设置 `"channel_type": "wechatmp_service"`
+3. 即使是较长耗时的回复，也可以主动推送给用户
+
+```json
+{
+  "channel_type": "wechatmp_service",
+  "wechatmp_app_id": "YOUR_APP_ID",
+  "wechatmp_app_secret": "YOUR_APP_SECRET",
+  "wechatmp_aes_key": "",
+  "wechatmp_token": "YOUR_TOKEN",
+  "wechatmp_port": 80
+}
+```

docs/zh/channels/wecom.mdx

@@ -0,0 +1,61 @@
+---
+title: 企业微信
+description: 将 CowAgent 接入企业微信自建应用
+---
+
+# 企业微信
+
+通过企业微信自建应用接入 CowAgent，支持企业内部人员单聊使用。
+
+<Note>
+  企业微信只能使用 Docker 部署或服务器 Python 部署，不支持本地运行模式。
+</Note>
+
+## 一、准备
+
+需要的资源：
+
+1. 一台服务器（有公网 IP）
+2. 注册一个企业微信（个人也可注册，但无法认证）
+3. 认证企业微信还需要对应主体备案的域名
+
+## 二、创建企业微信应用
+
+1. 在 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/frame#profile) **我的企业** 中获取 **企业ID**
+2. 切换到 **应用管理**，点击创建应用，记录 `AgentId` 和 `Secret`
+3. 点击 **设置API接收**，配置应用接口：
+   - URL 格式为 `http://ip:port/wxcomapp`（认证企业需使用备案域名）
+   - 随机获取 `Token` 和 `EncodingAESKey` 并保存
+
+## 三、配置和运行
+
+```json
+{
+  "channel_type": "wechatcom_app",
+  "wechatcom_corp_id": "YOUR_CORP_ID",
+  "wechatcomapp_token": "YOUR_TOKEN",
+  "wechatcomapp_secret": "YOUR_SECRET",
+  "wechatcomapp_agent_id": "YOUR_AGENT_ID",
+  "wechatcomapp_aes_key": "YOUR_AES_KEY",
+  "wechatcomapp_port": 9898
+}
+```
+
+| 参数 | 说明 |
+| --- | --- |
+| `wechatcom_corp_id` | 企业 ID |
+| `wechatcomapp_token` | API 接收配置中的 Token |
+| `wechatcomapp_secret` | 应用的 Secret |
+| `wechatcomapp_agent_id` | 应用的 AgentId |
+| `wechatcomapp_aes_key` | API 接收配置中的 EncodingAESKey |
+| `wechatcomapp_port` | 监听端口，默认 9898 |
+
+启动程序后，回到企业微信后台保存 **消息服务器配置**，并将服务器 IP 添加到 **企业可信IP** 中。
+
+<Warning>
+  如遇到配置失败：1. 确保防火墙和安全组已放行端口；2. 检查各参数配置是否一致；3. 认证企业需配置备案域名。
+</Warning>
+
+## 四、使用
+
+在企业微信中搜索应用名称即可直接对话。如需让外部微信用户使用，可在 **我的企业 → 微信插件** 中分享邀请关注二维码。