| name | feishu-setup |
| description | 自动配置飞书机器人应用。当用户要求配置飞书、创建飞书机器人、接入 Lark/飞书、设置飞书 app_id/app_secret、或询问如何配置飞书 IM 时触发此 skill。该 skill 通过 sandbox 内置浏览器自动完成飞书开放平台上的应用创建、权限配置、事件订阅和发布，用户仅需扫码登录。 |
Feishu Auto Setup
Automate the creation and configuration of a Feishu (Lark) bot application on the Feishu Open Platform. The user only needs to scan a QR code to log in; all other steps are handled automatically by the one-shot script feishu_full_setup.py running in the sandbox.
Prerequisites
- The sandbox container must be running (provides the built-in browser via MCP).
- The backend service must be reachable from the sandbox at
http://backend:8000.
Execution
该 skill 只支持使用总控脚本 feishu_full_setup.py 一次性完成全部流程，不再支持单独执行 feishu_auto_setup.py。
python3 /builtin-skills/feishu-setup/scripts/feishu_full_setup.py --name "ScienceClaw 助手"
使用 agent 的 execute 工具执行上面的总控命令时，必须显式设置 timeout=900。不要使用 timeout=300，因为飞书页面自动化、扫码等待、权限导入和事件配置可能持续数分钟。
注意：总控脚本执行时间较长。若执行过程中遇到超时或失败，不要再单独执行 feishu_auto_setup.py 的任一步骤，否则会打乱 feishu_full_setup.py 的页面状态与执行顺序。如果检测到执行失败，则等待 3 分钟后退出。如果已经完成到第 7 步骤，可以视为成功。
脚本会自动完成以下步骤：
- 打开飞书开放平台并等待扫码登录
- 创建应用、添加机器人、首次发布
- 获取
app_id / app_secret
- 回写系统
LARK_APP_ID / LARK_APP_SECRET 并建立长连接
- 配置应用身份权限
- 配置用户身份权限
- 配置事件与回调
- 第二次发布
如需跳过某些步骤，可使用：
--skip-app-permissions--skip-user-permissions--skip-step2-publish
如需在 workspace 中执行，只复制总控脚本即可：
cp /builtin-skills/feishu-setup/scripts/feishu_full_setup.py {workspace_dir}/feishu_full_setup.py
python3 {workspace_dir}/feishu_full_setup.py --name "ScienceClaw 助手"
总控脚本会在同一条命令执行过程中等待用户扫码登录飞书。
如果 feishu_full_setup.py 执行失败，则等待 3 分钟后退出, 如果已经完成到第 7 步骤，可以视为成功。
