feishu-quick-setup — 飞书快速设置
v1.0.2One-命令行工具ck Feishu 机器人 creation. Uses the Feishu 应用 Registration API (Device Flow) to 创建 a new Feishu 机器人 and save 凭证s to the OpenClaw config file. Trigger when the user says "配置飞书", "安装飞书插件", "设置up feishu", "创建飞书应用", etc. For users who have not yet 配置d 应用Id/应用Secret. Note: this 技能 创建s a NEW Feishu 应用 — it is different from feishu-auth (OAuth user authorization).
运行时依赖
安装命令
点击复制技能文档
feishu-quick-setup 模块兼容性:脚本以 .js 和 .mjs 提供。优先使用 .mjs;如果遇到模块错误,回退到 .js。通过执行以下命令,步骤创建一个 Feishu Bot。所有脚本输出都是单行 JSON。运行命令:node 解析脚本路径相对于此 SKILL.md 目录的绝对路径,然后执行。步骤
步骤 1 — 检查现有配置 node "{script_dir}/quick-setup.mjs" --status 字段 行为 configured: true 告知用户 Feishu 已经配置(显示 appId),询问是否重新配置 configured: false 继续到步骤 2
步骤 2 — 开始注册 node "{script_dir}/quick-setup.mjs" --begin --domain "feishu" --domain:feishu(中国大陆, 默认)或 lark(国际) 错误:false — 获取 verificationUrl 和 deviceCode,继续到步骤 3。 错误:true — 显示错误消息给用户并停止。
步骤 3 — 显示链接 将步骤 2 中的 verificationUrl 显示给用户: 请点击以下链接完成飞书授权:{verificationUrl} 点击后在飞书中点击“确认创建”即可。 正确的链接格式为 https://open.feishu.cn/page/openclaw?user_code=.... 不修改或重构 URL。 此流程使用链接,而不是二维码。 显示链接后,直接继续到步骤 4(无需等待用户回复)。
步骤 4 — 轮询完成 node "{script_dir}/quick-setup.mjs" --poll --wait --timeout 300 脚本每 5 秒内部轮询,直到用户完成授权或超时(默认 5 分钟)到达。 结果 行为 status: "completed" 获取 appId 和 appSecret,从响应中继续到步骤 5 status: "error", expired_token 链接过期 — 重新开始步骤 2 status: "error", access_denied 用户拒绝请求 — 告知用户 status: "timeout" 超时 — 建议用户重试
步骤 5 — 保存配置 node "{script_dir}/quick-setup.mjs" --save --app-id "APP_ID" --app-secret "APP_SECRET" --domain "feishu" 用步骤 4 中的值替换 APP_ID 和 APP_SECRET。 结果 行为 success: true 显示响应中的消息字段给用户(包含下一步骤的指示和权限链接) success: false 显示失败原因给用户
注意 始终使用上述命令;不要直接调用 Feishu API 或手动构造 URL。 此技能创建一个新应用。 对于现有应用的用户级 OAuth,请使用 feishu-auth。 执行每个步骤 — 不要跳过步骤或仅描述它们。 始终显示 verificationUrl,正如脚本返回的那样。