mirror of
https://github.com/zhayujie/chatgpt-on-wechat.git
synced 2026-06-02 00:57:41 +08:00
b80c3fe5a8
- rewrite streaming reply to official cardkit v2.0 API (default on, auto-fallback) - fix Whisper hallucination: bump ASR sample rate to 16k, pass language=zh - fix lock-over-IO and tmp file cleanup from #2791 - drop deprecated feishu_bot_name; quiet unknown-key warnings - docs: cardkit permission and feishu_stream_reply usage
72 lines
2.7 KiB
Plaintext
72 lines
2.7 KiB
Plaintext
---
|
||
title: 飞书
|
||
description: 将 CowAgent 接入飞书应用
|
||
---
|
||
|
||
通过自建应用将 CowAgent 接入飞书，需要是飞书企业用户且具有企业管理权限。
|
||
|
||
## 一、创建企业自建应用
|
||
|
||
### 1. 创建应用
|
||
|
||
进入 [飞书开发平台](https://open.feishu.cn/app/)，点击 **创建企业自建应用**，填写必要信息后点击 **创建**：
|
||
|
||
<img src="https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/feishu-hosting-create-app.jpg" width="500"/>
|
||
|
||
### 2. 添加机器人能力
|
||
|
||
在 **添加应用能力** 菜单中，为应用添加 **机器人** 能力：
|
||
|
||
<img src="https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/feishu-hosting-add-bot.jpg" width="800"/>
|
||
|
||
### 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,cardkit:card:write
|
||
```
|
||
|
||
<img src="https://cdn.link-ai.tech/doc/feishu-hosting-add-auth2.png" width="800"/>
|
||
|
||
## 二、项目配置
|
||
|
||
1. 在 **凭证与基础信息** 中获取 `App ID` 和 `App Secret`：
|
||
|
||
<img src="https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/feishu-hosting-appid-secret.jpg" width="800"/>
|
||
|
||
2. 将以下配置加入项目根目录的 `config.json` 文件：
|
||
|
||
```json
|
||
{
|
||
"channel_type": "feishu",
|
||
"feishu_app_id": "YOUR_APP_ID",
|
||
"feishu_app_secret": "YOUR_APP_SECRET",
|
||
"feishu_stream_reply": true
|
||
}
|
||
```
|
||
|
||
| 参数 | 说明 | 默认值 |
|
||
| --- | --- | --- |
|
||
| `feishu_app_id` | 飞书机器人应用 App ID | - |
|
||
| `feishu_app_secret` | 飞书机器人 App Secret | - |
|
||
| `feishu_stream_reply` | 是否开启流式打字机回复，关闭则一次性返回完整文本 | `true` |
|
||
|
||
> **流式回复要求**：需要为机器人开通 `cardkit:card:write` 权限，且接收方飞书客户端版本 ≥ 7.20。低版本客户端会显示 "请升级客户端" 占位提示；权限未开通时会自动降级为普通文本回复。
|
||
|
||
配置完成后启动项目。
|
||
|
||
## 三、配置事件订阅
|
||
|
||
1. 成功运行项目后，在飞书开放平台点击 **事件与回调**，选择 **长连接** 方式，点击保存：
|
||
|
||
<img src="https://cdn.link-ai.tech/doc/202601311731183.png" width="600"/>
|
||
|
||
2. 点击下方的 **添加事件**，搜索 "接收消息"，选择 "**接收消息v2.0**"，确认添加。
|
||
|
||
3. 点击 **版本管理与发布**，创建版本并申请 **线上发布**，在飞书客户端查看审批消息并审核通过：
|
||
|
||
<img src="https://cdn.link-ai.tech/doc/202601311807356.png" width="600"/>
|
||
|
||
完成后在飞书中搜索机器人名称，即可开始对话。
|