Feishu Chat Server API

Manage Feishu group chats through Feishu server APIs, including create, get details, list members, add members, remove members, and disband chats.

这个 skill 负责飞书群组管理相关能力，当前覆盖以下 action：

• feishu-chat-create
• feishu-chat-get
• feishu-chat-members-list
• feishu-chat-member-add
• feishu-chat-member-remove
• feishu-chat-disband

何时使用

当用户请求与飞书群组本身相关的操作时使用这个 skill，例如：

• 创建一个新群
• 查看某个群的详情
• 列出群成员
• 往群里加人
• 从群里移人
• 解散群

如果用户请求的是消息发送、卡片、文档、多维表格、审批等能力，不要用这个 skill，应该路由到对应模块级 skill。

路由规则

根据用户意图选择具体 action：

• 创建群：feishu-chat-create
• 获取群详情：feishu-chat-get
• 获取群成员列表：feishu-chat-members-list
• 拉人入群：feishu-chat-member-add
• 移出群成员：feishu-chat-member-remove
• 解散群：feishu-chat-disband

不要把“移除一个成员”和“解散整个群”混淆。

通用输入

凭证优先级如下：

1. action 显式传入 app_id / app_secret
2. 当前工作目录下的 .local/feishu-extension-skills.json
3. 环境变量 FEISHU_APP_ID / FEISHU_APP_SECRET

如果这 3 层都没有命中，调用会失败。

也可以在调用命令里通过 --config-file /path/to/file.json 显式指定本地配置文件路径。

群相关 action 还需要按场景提供：

• chat_id
• name
• user_id_list
• member_id

约束：

• 只接受飞书 user_id 或 open_id
• 不要自行猜测邮箱、手机号、姓名对应的用户 ID

调用命令

统一调用入口：

bash

uvx --from git+https://github.com/wodenwang/feishu-extension-skills.git feishu-extension-skills invoke <action> --args-json '<json>'

ClawHub 安装：

bash

clawhub install feishu-chat-server-api

本地配置文件示例：

json

{
  "app_id": "cli_xxx",
  "app_secret": "sec_xxx"
}

示例：

bash

uvx --from git+https://github.com/wodenwang/feishu-extension-skills.git feishu-extension-skills invoke feishu-chat-create --args-json '{"app_id":"cli_xxx","app_secret":"sec_xxx","name":"项目临时群","user_id_list":["ou_xxx","ou_yyy"]}'

bash

uvx --from git+https://github.com/wodenwang/feishu-extension-skills.git feishu-extension-skills invoke feishu-chat-member-add --args-json '{"app_id":"cli_xxx","app_secret":"sec_xxx","chat_id":"oc_xxx","user_id_list":["ou_xxx"]}'

当前未覆盖

这个 skill 当前还没有封装以下群治理接口：

• 更新群信息
• 更新群发言权限
• 获取群成员发言权限
• 更新群置顶 / 撤销群置顶
• 获取用户或机器人所在的群列表
• 搜索可见群列表
• 获取群分享链接