# 简介： **通用聊天界面，统一消息中枢**

JiuwenClaw 的​**频道**​，是您与不同聊天平台对话的**渠道**。JiuwenClaw 已经实现了**鸿蒙小艺、飞书**等channel的无缝接入，并持续拓展至更多元渠道。可以直接在通过 **飞书**、**鸿蒙生态终端的小艺app** 应用直接与JiuweClaw对话。

配置频道有两种方式：

* **网页配置**​（推荐）— 在 JiuwenClaw前端页面，点击 `智能体` / `频道`卡片，在频道管理模块，填写相关配置。

* **手动编辑 `config.yaml`** — 默认在 `~/.jiuwenclaw/config.yaml` （由首次 `jiuwenclaw-start` 启动时自动生成），将需要的频道设 `enabled: true` 并填好鉴权信息；保存后自动重载，无需重启。

  

# 小艺

[演示视频](../assets/xiaoyi_channel.mp4)

## 1. 创建小艺智能体

通过在 [小艺开放平台 ](https://developer.huawei.com/consumer/cn/hag/abilityportal/#/)创建JiuwenClaw模式的智能体，即可与JiuwenClaw服务无缝接入。

![image-20260303094225074](../assets/images/小艺开放平台.png)

第一步： 创建JiuwenClaw模式的智能体

![image-20260303094525671](../assets/images/小艺创建智能体.png)

第二步：创建凭证及添加白名单

点击新建凭证，并​**保存ak与sk信息**​。

![image-20260303095143009](../assets/images/小艺创建凭证_1.png)

![image-20260303095210412](../assets/images/小艺创建凭证_2.png)

![image-20260303100344836](../assets/images/小艺创建凭证_3.png)

小艺开放平台为开发者提供真机调试能力，通过配置白名单分组，添加用户账号，可以在鸿蒙终端与小艺智能体对话。添加成功并上架成功后，可在终端小艺应用中使用该智能体。

![image-20260303100045878](../assets/images/小艺创建白名单_1.png)

![image-20260303100109086](../assets/images/小艺创建白名单_2.png)

![image-20260303100143626](../assets/images/小艺创建白名单_3.png)

勾选新建的用户组

![image-20260303100252934](../assets/images/小艺创建白名单_4.png)

第三步：上架智能体

填写开场白对话，点击上架按钮

![image-20260303100240509](../assets/images/小艺智能体上架.png)

## 2. 绑定频道

方式一： 将小艺开放平台获取到的**ak、sk、agentId**信息，填写至JiuwenClaw的小艺频道，开启使用，点击保存即可开启对话了。

![image-20260303100428987](../assets/images/小艺频道开启.png)

方式二： 修改 `~/.jiuwenclaw/config/config.yaml`

``````
channels:
  xiaoyi:
    # 华为小艺 A2A 配置
    ak: "小艺平台凭证 ak"
    sk: "小艺平台凭证 sk"
    agent_id: "创建的agent ID"
    enable_streaming: true
    enabled: true
``````

保存后若服务已运行会自动重载，未运行可以执行 `jiuwenclaw-start` 启动服务。



## 3. 智能体对话

方式1： 直接在网页与智能体应用对话

![image-20260303100951506](../assets/images/小艺网页对话.png)

方式2：在鸿蒙终端小艺应用，找到已上架的应用，直接对话

![image-20260303101021686](../assets/images/小艺终端对话.png)



# 飞书


## 1. 创建飞书自建应用
1. 访问 [飞书开放平台](https://open.feishu.cn/) 并登录。

2. 进入**开发者后台**，点击**创建企业自建应用**。

3. 填写应用名称、描述，并上传图标，点击**创建**。

   ![image-20260312202028169](../assets/images/feishu.png)

## 2. 添加机器人能力
1. 在应用配置页面，左侧选择**添加应用能力**。

2. 点击**机器人**下的**添加**按钮。

   ![image-20260312202146446](../assets/images/feishu_add_robot.png)

## 3. 记录机器人应用凭证
1. 进入飞书机器人管理后台

2. 记录 App ID 与 App Secret配置到JiuwenClaw 飞书频道，点击enabled并保存生效

   ![image-20260312202356784](../assets/images/feishu_app_token.png)

   ![image-20260312202651317](../assets/images/feishu_channel_config.png)

## 4. 配置权限
1. 左侧选择**权限管理** -> **API权限**。
2. 搜索并开通以下关键权限（用于收发消息）：
   - `im:message` 相关：以应用的身份发消息、获取用户发给机器人的单聊消息、接收群聊中@机器人消息事件。
   - `contact:user.employee_id:readonly`：获取用户ID信息。
   - 也可以批量导入权限，参考火山引擎文档中的权限列表。

![image-20260312203059819](../assets/images/feishu_app_permission.png)

## 5. 配置事件订阅（接收消息）
1. 左侧选择**事件与回调**。
2. **添加事件**：
   -  `im.message.receive_v1`（接收消息事件） 。
   -  `im.message.message_read_v1`（消息已读） 。
3. （可选）**配置加密策略**：如果启用了加密，需要保存 `Encrypt Key`。

![image-20260312203514012](../assets/images/feishu_app_events.png)

## 6. 发布应用
1. 左侧选择**版本管理与发布**，点击**创建版本** 。
2. 填写版本号、更新说明，选择可用范围（通常选择**全体成员**或部分成员）。
3. 提交审核。如果企业开启了免审，版本会立即生效 。
4. 飞书APP中登陆提交应用的账号即可看到发布的聊天机器人

![image-20260312203730114](../assets/images/feishu_app_release.png)

## 7. 在群聊中添加机器人（可选）
1. 打开飞书客户端，进入需要添加机器人的群组。
2. 点击群设置 -> **群机器人** -> **添加机器人**，搜索你创建的应用名称并添加 。

![image-20260312205356059](../assets/images/feishu_chat.png)

## 8. 配置飞书Channel
1. 启动前端服务后，在“频道-飞书”中打开Enable开关并配置第三步记录的 App ID 与 App Secret

# 钉钉

## 1. 前提条件

- 你必须是**企业管理员**或**拥有开发者权限的成员**的帐号
- 企业已开通**钉钉开发者后台**

## 2. 创建企业内部应用机器人

### 步骤 1：进入钉钉开发者后台

- 访问 [https://open-dev.dingtalk.com](https://open-dev.dingtalk.com)
- 登录后选择 **应用开发 → 企业内部开发 → 创建应用**

![image-20260313090856290](../assets/images/dingding_start.png)

### 步骤 2：填写应用信息

- 应用名称：如 `JiuwenClaw`
- 应用类型：**机器人**

![image-20260313091100590](../assets/images/dingding_create_app.png)

### 步骤 3：添加机器人能力

- 创建成功后，进入应用详情页
- 点击 **应用能力 → 机器人 → 开启机器人配置**
- 填写机器人名称（如 `JiuwenClaw`）、机器人简介（≤10 字）等信息

![image-20260313091410676](../assets/images/dingding_robot_config.png)

### 步骤 4：配置消息接收模式

选择**Stream 模式**，使用WebSocket长连接，无需公网IP，适合云函数/本地调试。


## 3. 配置权限

在 **权限管理** 页面，开启以下权限（根据需求）：
- 送单聊/群聊消息：qyapi_robot_sendmsg
- 根据手机号查 userId（用于单聊）：topapi_v2_user_getbymobile
- 发送互动卡片：Card.Instance.Write
- 流式更新卡片（AI 场景必备）：Card.Streaming.Write

## 4. 发布应用 & 机器人

### 步骤 1：保存并发布机器人

- 在机器人配置页点击 **保存**
- 返回应用主页，点击 **版本管理与发布 → 发布**
- 填写版本号、更新日志、可见范围等信息

![image-20260313091956452](../assets/images/dingding_robot_publish.png)

### 步骤 2：确认发布
- 点击 **确认发布**
- 状态变为 **已发布** 即可使用

> 💡 发布后可在钉钉客户端搜索机器人名称添加到群聊或私聊


## 5. 配置钉钉Channel

从**凭证与基础信息**获取应用凭证 **Client ID**和 **Client Secret** 

**JiuwenClaw**服务页面，在“频道-钉钉”中打开Enabled开关，并配置client_id与client_secret并保存

![image-20260313092328435](../assets/images/dingding_channel_enable.png)