Feishu Setup
Apps & Automationfeishu-setupFeishu Setup is an Agent Skill for apps & automation published in the AgentTeam-TaichuAI/ScienceClaw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
自动配置飞书机器人应用。当用户要求配置飞书、创建飞书机器人、接入 Lark/飞书、设置飞书 app_id/app_secret、或询问如何配置飞书 IM 时触发此 skill。该 skill 通过 sandbox 内置浏览器自动完成飞书开放平台上的应用创建、权限配置、事件订阅和发布,用户仅需扫码登录。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/AgentTeam-TaichuAI/ScienceClaw/blob/HEAD/ScienceClaw/backend/builtin_skills/feishu-setup/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/feishu-setup, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 步骤,可以视为成功。