feishu-setup

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 步骤，可以视为成功。