feishu-app-create

Installation
SKILL.md

Feishu App Create

创建飞书企业自建应用的自动化 skill。

触发条件

当用户要求创建飞书应用、企业自建应用时使用此 skill。

前置条件

  1. 使用 OpenClaw 浏览器(profile=openclaw)
  2. 已登录飞书开发者后台

完整操作流程

第一阶段:创建应用

1. 打开开发者后台

URL: https://open.feishu.cn/app

2. 点击创建按钮

在页面中找到"创建企业自建应用"按钮并点击。

注意:ref 每次页面加载会变化,需要通过 snapshot 获取最新的 ref。

3. 填写应用信息

在弹出的对话框中填写:

字段 说明 示例
应用名称 中文名称 产品部
应用描述 应用功能描述 拆解 CEO 的产品概念,生成需求文档、线框图与系统架构蓝图

重要

  • 使用 type 命令输入文字比 fill 命令更可靠
  • 每个应用创建完成后必须刷新页面才能创建下一个

4. 提交创建

点击"创建"按钮。

5. 刷新页面

创建后需要刷新页面(navigate 到 https://open.feishu.cn/app)才能看到新创建的应用。


第二阶段:添加机器人能力

6. 进入应用详情页

URL 格式:https://open.feishu.cn/app/{app_id}/capability

7. 添加机器人

  1. 点击左侧菜单"添加应用能力"
  2. 找到"机器人"能力,点击"配置"或"添加"按钮
  3. 机器人添加成功后会在页面显示"机器人"能力卡片

第三阶段:版本发布

8. 进入版本管理页面

URL 格式:https://open.feishu.cn/app/{app_id}/version

9. 创建版本

  1. 点击"创建版本"按钮
  2. 填写应用版本号:1.0.0
  3. 填写更新说明:初始版本发布
  4. 点击"保存"按钮

10. 确认发布

  1. 弹出确认对话框后,点击"确认发布"
  2. 发布成功后,应用状态会变为"已启用"

第四阶段:配置权限

11. 进入权限管理

URL 格式:https://open.feishu.cn/app/{app_id}/auth

  1. 点击"批量导入/导出权限"
  2. 粘贴权限 JSON 并保存

权限配置 JSON

{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:chat",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": []
  }
}

第五阶段:获取凭证

12. 获取 App ID 和 App Secret

进入应用详情页的"凭证与基础信息":

  • URL 格式:https://open.feishu.cn/app/{app_id}/baseinfo
  • App ID:直接可见
  • App Secret:默认隐藏(显示为 *******)

获取 App Secret 步骤:

  1. 在 App Secret 右侧找到"查看"按钮(眼睛图标)
  2. 点击"查看"按钮,Secret 会显示出来
  3. 可以直接复制使用

重要提示

  • 不要点击"重置"按钮:点击重置会使现有 Secret 失效,导致已发布的应用无法使用
  • "查看"按钮是安全的:不会影响现有凭证

批量获取多个应用的凭证

  1. 逐个访问每个应用的 baseinfo 页面
  2. 每次都需要点击"查看"按钮才能看到 Secret
  3. 获取后记录到 agents.json 配置文件中

第六阶段:事件与回调配置

13. 进入事件与回调页面

URL 格式:https://open.feishu.cn/app/{app_id}/event

14. 配置事件(接收消息)

步骤:

  1. 在"事件配置"标签页,点击"订阅方式"按钮
  2. 选择"长连接(推荐)"
  3. 点击"保存"按钮
  4. 点击"添加事件"按钮
  5. 在左侧菜单选择"消息与群组"
  6. 找到"接收消息"事件,勾选复选框
  7. 点击"添加"按钮确认
  8. 等待一会,页面会弹出"确认开通权限"对话框
  9. 点击"确认开通权限"按钮

必须添加的事件

  • im.message.receive_v1 - 接收消息(用户发送消息给机器人时推送)

15. 配置回调

步骤:

  1. URL 添加 ?tab=callback 或点击"回调配置"标签页
  2. 点击"订阅方式"按钮
  3. 选择"长连接(推荐)"
  4. 点击"保存"按钮

16. 发布新版本

配置完成后,页面会提示"版本发布后,当前修改方可生效",需要:

  1. 进入"版本管理与发布"页面
  2. 创建新版本(如 1.0.1)
  3. 填写更新说明(如:添加事件与回调配置)
  4. 确认发布

17. 批量配置多个应用

对于多个应用批量配置事件与回调:

  1. 逐个应用配置事件(订阅方式→保存→添加事件→消息与群组→接收消息→添加→确认开通权限)
  2. 逐个应用配置回调(切换到回调配置→订阅方式→保存)
  3. 页面提示"版本发布后,当前修改方可生效",每个应用都需要发布新版本

经验总结

成功的操作流程

  1. navigate 到 https://open.feishu.cn/app
  2. snapshot 获取页面
  3. 点击创建按钮
  4. snapshot 获取对话框
  5. type 填写应用名称
  6. type 填写应用描述
  7. 点击创建按钮
  8. navigate 刷新页面
  9. 确认应用创建成功

关键注意事项

  • 必须使用 type 命令:实测 type 比 fill 更可靠
  • 每次创建后必须刷新页面:否则创建按钮可能无响应
  • 批量创建可行:逐个创建,不要同时创建多个
  • ref 每次变化:每次 snapshot 后 ref 会变化,需要重新获取

多 subagent 不可行

  • 多个 subagent 共享同一浏览器会导致资源冲突
  • 建议使用单个会话逐个操作

主动沉淀 Skill 的观念

每次完成任务后,必须主动总结经验并更新 skill

  1. 记录成功流程:把实际成功的操作步骤写下来
  2. 补充注意事项:把遇到的坑和解决方案记录下来
  3. 更新文档:把新学到的东西补充到 skill 文件中
  4. 举一反三:思考这个经验是否可以应用到其他类似场景

相关链接

Installs
15
GitHub Stars
1
First Seen
Mar 22, 2026