---
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`。

```bash
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 中执行，只复制总控脚本即可：

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


---
Source attribution: AgentTeam-TaichuAI
Original project: https://github.com/AgentTeam-TaichuAI/ScienceClaw
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 Gabriel Moreira

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: AgentTeam-TaichuAI
Original project: https://github.com/AgentTeam-TaichuAI/ScienceClaw
Attribution basis: Upstream repository explicitly recorded in package mirror path

Fields of work: Product Management, Sales, Customer Support
Roles: Customer Success Manager, Product Manager, Technical Support
Specialties: API
Tools: Feishu
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 47868820b76ad469c43cf4fe832bf71c10be2ee7d7a181f13509a6142952c528