Skip to content
feishu-setup logo

Feishu Auto Setup

feishu-setup

自动配置飞书机器人应用。当用户要求配置飞书、创建飞书机器人、接入 Lark/飞书、设置飞书 app_id/app_secret、或询问如何配置飞书 IM 时触发此 skill。该 skill 通过 sandbox 内置浏览器自动完成飞书开放平台上的应用创建、权限配置、事件订阅和发布,用户仅需扫码登录。

SKILL.md

Full skill instructions

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