🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
🦀 ClawHub

Feishu Chat Server API

by @wodenwang

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

Versionv0.1.3
Downloads839
TERMINAL
clawhub install feishu-chat-server-api

📖 About This Skill


name: feishu-chat-server-api description: Manage Feishu group chats through Feishu server APIs, including create, get details, list members, add members, remove members, and disband chats. metadata: {"openclaw":{"emoji":"💬","homepage":"https://github.com/wodenwang/feishu-extension-skills","os":["darwin","linux"],"requires":{"bins":["uv"]},"install":[{"id":"brew-uv","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)","os":["darwin"]}]}}

Feishu Chat Server API

这个 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
  • 调用命令

    统一调用入口:

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

    ClawHub 安装:

    clawhub install feishu-chat-server-api
    

    本地配置文件示例:

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

    示例:

    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"]}'
    

    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 当前还没有封装以下群治理接口:

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