Private
Public Access
1
0

Merge branch 'main' of https://gitea.sususu.cf/sususu/xcodecli-shells
All checks were successful
Deploy to Cloudflare Pages / deploy (push) Successful in 51s

This commit is contained in:
zwang
2026-03-13 22:03:10 +08:00

View File

@@ -13,6 +13,7 @@ title: XCodeClaw 飞书机器人配置指南
XCodeClaw 是一个 AI 学术助手,通过飞书机器人与您交互。您需要在飞书开放平台创建一个机器人应用,并完成权限和事件订阅的配置。
:::tip 整体流程
1. 在飞书开放平台创建企业自建应用
2. 添加机器人能力
3. 导入权限配置
@@ -20,7 +21,7 @@ XCodeClaw 是一个 AI 学术助手,通过飞书机器人与您交互。您需
5. 等待管理员创建服务实例
6. 配置事件订阅与回调(需要服务实例已运行)
7. 发布应用
:::
:::
:::warning 流程顺序很重要
事件订阅和回调使用「长连接」模式,即由服务端主动与飞书建立 WebSocket 连接。因此必须先让管理员创建服务实例,待服务启动后再配置长连接,否则连接无法建立。
@@ -122,7 +123,7 @@ XCodeClaw 是一个 AI 学术助手,通过飞书机器人与您交互。您需
下表列出了主要权限的用途说明:
| 权限标识 | 用途 |
| :--- | :--- |
| :--------------------------------- | :----------------------------- |
| `im:message:send_as_bot` | 以机器人身份发送消息 |
| `im:message.p2p_msg:readonly` | 读取私聊消息 |
| `im:message.group_at_msg:readonly` | 读取群聊中 @机器人 的消息 |
@@ -179,7 +180,7 @@ App Secret 是应用的密钥,请妥善保管,不要在公开场合泄露。
3. 点击「**添加事件**」,搜索并添加以下事件:
| 事件名称 | 事件标识 |
| :--- | :--- |
| :----------- | :------------------------------- |
| 接收消息 | `im.message.receive_v1` |
| 添加表情回复 | `im.message.reaction.created_v1` |
| 删除表情回复 | `im.message.reaction.deleted_v1` |
@@ -206,6 +207,8 @@ App Secret 是应用的密钥,请妥善保管,不要在公开场合泄露。
在「**安全设置**」区域,如果看到「**user_access_token**」开关,请将其**开启**。
如果**没有**看到该开关,说明您的应用已默认启用用户凭证,**无需额外操作**。
![安全设置](../assets/feishu/11-security-token.png)
## 8. 发布应用
@@ -250,7 +253,7 @@ App Secret 是应用的密钥,请妥善保管,不要在公开场合泄露。
请对照以下清单确认所有配置已完成:
| | 检查项 | 说明 |
| :---: | :--- | :--- |
| :-: | :--------- | :----------------------------------------- |
| ☐ | 创建应用 | 已在飞书开放平台创建企业自建应用 |
| ☐ | 机器人能力 | 已启用机器人能力 |
| ☐ | 权限导入 | 已通过 JSON 批量导入全部权限 |