configure 是 claude-code-feishu-channel 中负责飞书频道初始配置的命令。它把飞书应用凭证写入 ~/.claude/channels/feishu/.env,并引导用户理解与收敛访问策略。服务端在启动时读取凭证文件。
用途与调用方式
- 无参数:读取并展示状态。检查 .env 中 FEISHU_APP_ID 与 FEISHU_APP_SECRET 是否已设置,已设置时显示 APP_ID 前 6 位并遮蔽其余部分;读取 access.json,展示私聊策略及其含义、允许发送者数量与 open_id 列表、待批准配对数量及配对码、已加入的群聊数量,并给出下一步建议。
- 传入 <app_id> <app_secret>:按空格拆分参数,第一项为 APP_ID,第二项为 APP_SECRET。创建目录后读取已有 .env,更新或新增对应行,保留其他键(如 FEISHU_DOMAIN),写入时不加引号,并将文件权限设为 600。保存后提示用户需重启会话或执行 /reload-plugins 使凭证生效。
- domain <url>:为 Lark 国际版用户设置 FEISHU_DOMAIN=https://open.larksuite.com,默认域名为 https://open.feishu.cn。
- clear:删除 FEISHU_APP_ID 与 FEISHU_APP_SECRET 行,若文件仅剩这些内容则删除文件。
访问策略引导 命令会主动推动访问权限收敛:读取允许列表并向用户确认名单是否完整;若仍为 pairing 策略且名单完整,则建议执行 /feishu:access policy allowlist 锁定;若有人员缺失,则让对方给机器人发私信并用 /feishu:access pair <code> 批准,或直接用 /feishu:access allow <open_id> 添加;名单为空时先自行私信机器人捕获自己的 ID。pairing 仅用于获取未知的 open_id,不是长期策略。
实现说明
- channels 目录可能尚未存在,文件缺失表示未配置而非错误。
- .env 仅在启动时读取一次,凭证变更需重启会话或 /reload-plugins;access.json 在每条入站消息时重新读取,策略变更立即生效,无需重启。
飞书开放平台准备步骤(用户询问如何创建机器人时提供)
- 前往飞书开放平台创建应用。
- 在“凭证与基础信息”页面获取 App ID 和 App Secret。
- 在“添加应用能力”中启用“机器人”能力。
- 在“事件与回调”中选择“使用长连接接收事件”(WebSocket),添加事件 im.message.receive_v1(接收消息)。
- 在“权限管理”中添加权限:im:message(获取与发送单聊、群组消息)、im:message:send_as_bot(以应用身份发送消息)、im:resource(获取与上传图片或文件资源)、im:chat(获取群组信息)、im:message.reactions:write(添加消息表情回复)。
- 发布应用版本并等待审核通过。
- 在 Claude Code 中运行 /feishu:configure <app_id> <app_secret>。
适用场景 需要在 Claude Code 中接入飞书或 Lark 机器人、保存应用凭证并管理谁可以通过机器人对话时使用。
限制 命令依赖已创建的飞书应用与审核通过;凭证变更需重启;具体计费、配额等未提供。