feishu-app-create
Installation
SKILL.md
Feishu App Create
创建飞书企业自建应用的自动化 skill。
触发条件
当用户要求创建飞书应用、企业自建应用时使用此 skill。
前置条件
- 使用 OpenClaw 浏览器(profile=openclaw)
- 已登录飞书开发者后台
完整操作流程
第一阶段:创建应用
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. 添加机器人
- 点击左侧菜单"添加应用能力"
- 找到"机器人"能力,点击"配置"或"添加"按钮
- 机器人添加成功后会在页面显示"机器人"能力卡片
第三阶段:版本发布
8. 进入版本管理页面
URL 格式:https://open.feishu.cn/app/{app_id}/version
9. 创建版本
- 点击"创建版本"按钮
- 填写应用版本号:
1.0.0 - 填写更新说明:
初始版本发布 - 点击"保存"按钮
10. 确认发布
- 弹出确认对话框后,点击"确认发布"
- 发布成功后,应用状态会变为"已启用"
第四阶段:配置权限
11. 进入权限管理
URL 格式:https://open.feishu.cn/app/{app_id}/auth
- 点击"批量导入/导出权限"
- 粘贴权限 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 步骤:
- 在 App Secret 右侧找到"查看"按钮(眼睛图标)
- 点击"查看"按钮,Secret 会显示出来
- 可以直接复制使用
重要提示:
- 不要点击"重置"按钮:点击重置会使现有 Secret 失效,导致已发布的应用无法使用
- "查看"按钮是安全的:不会影响现有凭证
批量获取多个应用的凭证:
- 逐个访问每个应用的 baseinfo 页面
- 每次都需要点击"查看"按钮才能看到 Secret
- 获取后记录到 agents.json 配置文件中
第六阶段:事件与回调配置
13. 进入事件与回调页面
URL 格式:https://open.feishu.cn/app/{app_id}/event
14. 配置事件(接收消息)
步骤:
- 在"事件配置"标签页,点击"订阅方式"按钮
- 选择"长连接(推荐)"
- 点击"保存"按钮
- 点击"添加事件"按钮
- 在左侧菜单选择"消息与群组"
- 找到"接收消息"事件,勾选复选框
- 点击"添加"按钮确认
- 等待一会,页面会弹出"确认开通权限"对话框
- 点击"确认开通权限"按钮
必须添加的事件:
im.message.receive_v1- 接收消息(用户发送消息给机器人时推送)
15. 配置回调
步骤:
- URL 添加
?tab=callback或点击"回调配置"标签页 - 点击"订阅方式"按钮
- 选择"长连接(推荐)"
- 点击"保存"按钮
16. 发布新版本
配置完成后,页面会提示"版本发布后,当前修改方可生效",需要:
- 进入"版本管理与发布"页面
- 创建新版本(如 1.0.1)
- 填写更新说明(如:添加事件与回调配置)
- 确认发布
17. 批量配置多个应用
对于多个应用批量配置事件与回调:
- 逐个应用配置事件(订阅方式→保存→添加事件→消息与群组→接收消息→添加→确认开通权限)
- 逐个应用配置回调(切换到回调配置→订阅方式→保存)
- 页面提示"版本发布后,当前修改方可生效",每个应用都需要发布新版本
经验总结
成功的操作流程
- navigate 到 https://open.feishu.cn/app
- snapshot 获取页面
- 点击创建按钮
- snapshot 获取对话框
- type 填写应用名称
- type 填写应用描述
- 点击创建按钮
- navigate 刷新页面
- 确认应用创建成功
关键注意事项
- 必须使用 type 命令:实测 type 比 fill 更可靠
- 每次创建后必须刷新页面:否则创建按钮可能无响应
- 批量创建可行:逐个创建,不要同时创建多个
- ref 每次变化:每次 snapshot 后 ref 会变化,需要重新获取
多 subagent 不可行
- 多个 subagent 共享同一浏览器会导致资源冲突
- 建议使用单个会话逐个操作
主动沉淀 Skill 的观念
每次完成任务后,必须主动总结经验并更新 skill:
- 记录成功流程:把实际成功的操作步骤写下来
- 补充注意事项:把遇到的坑和解决方案记录下来
- 更新文档:把新学到的东西补充到 skill 文件中
- 举一反三:思考这个经验是否可以应用到其他类似场景
相关链接
- 飞书开放平台:https://open.feishu.cn/
- 开发者后台:https://open.feishu.cn/app