How do I install the Feishu Quick Setup skill?

Run npx skillmds@latest add hashstacs-global/feishu-quick-setup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Feishu Quick Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Feishu Quick Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Feishu Quick Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Feishu Quick Setup?

hashSTACS-Global (@hashstacs-global) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Feishu Quick Setup by hashstacs-global

Name: Feishu Quick Setup
Rating: 4.2 (5 reviews)
Author: hashSTACS-Global

Feishu Quick Setup

One-click Feishu bot creation. Uses the Feishu App Registration API (Device Flow) to create a new Feishu Bot and save credentials to the OpenClaw config file. Trigger when the user says "配置飞书", "安装飞书插件", "setup feishu", "创建飞书应用", etc. For users who have not yet configured appId/appSecret. Note: this skill creates a NEW Feishu app — it is different from feishu-auth (OAuth user authorization).

File contents

feishu-quick-setup

Module compatibility: Scripts are provided in both .js and .mjs. Prefer .mjs; if you get a module error, fall back to .js.

Create a Feishu Bot for the user by executing the commands below step by step. All script output is single-line JSON.

Runtime

Command: node
Resolve script paths relative to this SKILL.md directory to absolute paths before execution.

Steps

Step 1 — Check existing config

node "{script_dir}/quick-setup.mjs" --status

Field	Action
`configured: true`	Tell the user Feishu is already configured (show `appId`), ask if they want to reconfigure
`configured: false`	Proceed to Step 2

Step 2 — Start registration

node "{script_dir}/quick-setup.mjs" --begin --domain "feishu"

--domain: feishu (mainland China, default) or lark (international)
On error: false — you get verificationUrl and deviceCode. Proceed to Step 3.
On error: true — show the error message to the user and stop.

Step 3 — Show the link

Display the verificationUrl from Step 2 to the user as-is:

请点击以下链接完成飞书授权： {verificationUrl}

点击后在飞书中点击"确认创建"即可。

The correct link format is https://open.feishu.cn/page/openclaw?user_code=.... Do not modify or reconstruct the URL. This flow uses a link, not a QR code.

After showing the link, proceed directly to Step 4 (no need to wait for user reply).

Step 4 — Poll for completion

node "{script_dir}/quick-setup.mjs" --poll --wait --timeout 300

The script polls internally every 5 seconds until the user completes authorization or the timeout (default 5 min) is reached.

Result	Action
`status: "completed"`	Take `appId` and `appSecret` from the response, proceed to Step 5
`status: "error"`, `expired_token`	Link expired — restart from Step 2
`status: "error"`, `access_denied`	User denied the request — inform the user
`status: "timeout"`	Timed out — suggest the user retry

Step 5 — Save config

node "{script_dir}/quick-setup.mjs" --save --app-id "APP_ID" --app-secret "APP_SECRET" --domain "feishu"

Replace APP_ID and APP_SECRET with the values from Step 4.

Result	Action
`success: true`	Show the `message` field from the response to the user (it contains next-step instructions and a permissions link)
`success: false`	Show the failure reason to the user

Notes

Always use the commands above; do not call Feishu APIs directly or construct URLs manually.
This skill creates a new app. For user-level OAuth on an existing app, use feishu-auth instead.
Execute each step — do not skip steps or only describe them.
Always show the verificationUrl exactly as returned by the script.

---name: feishu-quick-setupdescription: One-click Feishu bot creation. Uses the Feishu App Registration API (Device Flow) to create a new Feishu Bot and save credentials to the OpenClaw config file. Trigger when the user says "配置飞书", "安装飞书插件", "setup feishu", "创建飞书应用", etc. For users who have not yet configured appId/appSecret. Note: this skill creates a NEW Feishu app — it is different from feishu-auth (OAuth user authorization).---# feishu-quick-setup> **Module compatibility**: Scripts are provided in both `.js` and `.mjs`. Prefer `.mjs`; if you get a module error, fall back to `.js`.Create a Feishu Bot for the user by executing the commands below step by step. All script output is single-line JSON.## Runtime- **Command**: `node`- Resolve script paths relative to this SKILL.md directory to absolute paths before execution.## Steps### Step 1 — Check existing config```bashnode "{script_dir}/quick-setup.mjs" --status```| Field | Action ||-------|--------|| `configured: true` | Tell the user Feishu is already configured (show `appId`), ask if they want to reconfigure || `configured: false` | Proceed to Step 2 |### Step 2 — Start registration```bashnode "{script_dir}/quick-setup.mjs" --begin --domain "feishu"```- `--domain`: `feishu` (mainland China, default) or `lark` (international)- On `error: false` — you get `verificationUrl` and `deviceCode`. Proceed to Step 3.- On `error: true` — show the error message to the user and stop.### Step 3 — Show the linkDisplay the `verificationUrl` from Step 2 to the user **as-is**:> 请点击以下链接完成飞书授权：> {verificationUrl}>> 点击后在飞书中点击"确认创建"即可。The correct link format is `https://open.feishu.cn/page/openclaw?user_code=...`. Do not modify or reconstruct the URL.This flow uses a link, not a QR code.After showing the link, proceed directly to Step 4 (no need to wait for user reply).### Step 4 — Poll for completion```bashnode "{script_dir}/quick-setup.mjs" --poll --wait --timeout 300```The script polls internally every 5 seconds until the user completes authorization or the timeout (default 5 min) is reached.| Result | Action ||--------|--------|| `status: "completed"` | Take `appId` and `appSecret` from the response, proceed to Step 5 || `status: "error"`, `expired_token` | Link expired — restart from Step 2 || `status: "error"`, `access_denied` | User denied the request — inform the user || `status: "timeout"` | Timed out — suggest the user retry |### Step 5 — Save config```bashnode "{script_dir}/quick-setup.mjs" --save --app-id "APP_ID" --app-secret "APP_SECRET" --domain "feishu"```Replace `APP_ID` and `APP_SECRET` with the values from Step 4.| Result | Action ||--------|--------|| `success: true` | Show the `message` field from the response to the user (it contains next-step instructions and a permissions link) || `success: false` | Show the failure reason to the user |## Notes- Always use the commands above; do not call Feishu APIs directly or construct URLs manually.- This skill creates a new app. For user-level OAuth on an existing app, use `feishu-auth` instead.- Execute each step — do not skip steps or only describe them.- Always show the `verificationUrl` exactly as returned by the script.

Frequently asked questions