feishu-app-create（飞书应用创建）

Feishu App Create

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

触发条件

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

前置条件

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

完整操作流程

第一阶段：创建应用

1. 打开开发者后台

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

2. 点击创建按钮

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

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

3. 填写应用信息

在弹出的对话框中填写：

重要：

• 使用 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. 举一反三：思考这个经验是否可以应用到其他类似场景

相关链接

• 飞书开放平台：https://open.feishu.cn/
• 开发者后台：https://open.feishu.cn/app