- name
- feishu-quick-setup
- description
- |
- Note
- this skill creates a NEW Feishu app — it is different from feishu-auth (OAuth user authorization).
- inline
- true
feishu-quick-setup
Module compatibility: Scripts are provided in both.jsand.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) orlark(international)- On
error: false— you getverificationUrlanddeviceCode. 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 300The 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-authinstead. - Execute each step — do not skip steps or only describe them.
- Always show the
verificationUrlexactly as returned by the script.