feishu-channel-configure
设置飞书频道 — 保存应用凭证、查看访问策略和频道状态。当用户提供飞书应用凭证、要求配置飞书、问"怎么设置"或"谁能联系我"、或想查看频道状态时使用。
- License 许可
- MIT
- 最近更新
- 2026-07-28
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- feishu-channel-configure
- description
- 设置飞书频道 — 保存应用凭证、查看访问策略和频道状态。当用户提供飞书应用凭证、要求配置飞书、问"怎么设置"或"谁能联系我"、或想查看频道状态时使用。
- allowed-tools
- [ "Read", "Write", "Bash(ls *)", "Bash(mkdir *)" ]
- user-invocable
- true
03 SKILL.md 正文
/feishu-channel-configure — 飞书频道配置
将应用凭证写入 ~/.claude/channels/feishu/.env,并引导用户了解访问策略。服务器在启动时读取这两个文件。
注意:.env 文件优先级高于 shell 环境变量。如果 .env 中配置了凭证,会覆盖 .zshenv 等设置的同名变量。
传入参数:$ARGUMENTS
根据参数分派
无参数 — 凭证状态
显示当前凭证配置:
-
凭证 — 先检查
~/.claude/channels/feishu/.env中的MY_LARK_APP_ID(优先)。如未设置,检查 shell 环境变量MY_LARK_APP_ID/MY_LARK_APP_SECRET。显示已设置/未设置及来源(.env / 环境变量);如已设置,显示前 8 位掩码(cli_a8e1...)。 -
下一步 — 根据凭证状态给出提示:
- 无凭证 → "在 .zshenv 中设置 MY_LARK_APP_ID 和 MY_LARK_APP_SECRET,或运行
/feishu-channel-configure <appId> <appSecret>。" - 凭证已设置 → "凭证已就绪。运行
/feishu-channel-access查看访问控制状态。"
- 无凭证 → "在 .zshenv 中设置 MY_LARK_APP_ID 和 MY_LARK_APP_SECRET,或运行
<appId> <appSecret> — 保存凭证
- 将
$ARGUMENTS解析为两个空格分隔的值。 mkdir -p ~/.claude/channels/feishu- 读取已有的
.env(如存在);更新/添加MY_LARK_APP_ID=和MY_LARK_APP_SECRET=行,保留其他配置。写回,不加引号。 - 可选设置
MY_LARK_BRAND=feishu(国际版用lark)。 - 确认,然后显示无参数状态,让用户了解当前情况。
- 提示用户:"凭证已保存。运行
/mcp重新连接 MCP 使配置生效(仅/reload-plugins不够,需要重连 MCP 以重启服务器进程)。"
clear — 清除凭证
从 .env 中删除 MY_LARK_APP_ID= 和 MY_LARK_APP_SECRET= 行。
飞书设置指南
当用户询问如何设置时,提供以下步骤:
- 前往飞书开放平台(国际版前往 Lark Developer)
- 创建自建应用
- 从凭证页面获取 App ID 和 App Secret
- 在事件与回调中:
- 启用长连接模式(WebSocket)
- 订阅事件:
im.message.receive_v1(接收消息)
- 在权限管理中,启用:
im:message— 接收消息im:message:send_as_bot— 以机器人身份发送消息im:resource— 下载消息资源(图片/文件)im:chat— 访问会话信息im:message.reactions:operate— 添加/移除表情回应(可选)
- 发布应用(或添加到测试群进行开发)
- 在 shell 环境变量中设置凭证,或通过
/feishu-channel-configure <appId> <appSecret>设置
实现注意事项
- channels 目录可能不存在(服务器尚未运行过)。文件不存在 = 未配置,不是错误。
- 服务器启动时读取一次
.env(先检查 shell 环境变量)。凭证变更需要/mcp重连 MCP(重启 bun 进程),仅/reload-plugins不会重启 MCP server。 access.json在每条入站消息时重新读取 — 通过/feishu-channel-access的策略变更立即生效,无需重启。
04 同仓库更多 Skills
ip-diagnosis
在 macOS + Chrome 上排查公网 IPv4/IPv6 出口、国家/地区、ASN/组织、DNS、默认路由、utun 状态,以及浏览器侧 Server Response 与 WebRTC 暴露情况。适用于用户要求检查 IP、地区一致性、VPN/代理接管情况、IPv6 问题或浏览器网络暴露,并输出详细运维报告与复查链接。
feishu-channel-doctor
诊断飞书频道健康状态 — 排查多进程冲突、WebSocket 连接问题、日志分析。当用户报告"没有回复""消息丢失""连接异常"或想查看飞书频道运行状态时使用。
feishu-channel-config
修改飞书频道体验配置 — 确认表情、引用回复、分块方式等。当飞书消息中用户请求更改频道显示/回复行为时使用。仅限体验配置,安全配置(策略、白名单、群组)必须拒绝。
feishu-channel-access
管理飞书频道访问控制 — 批准配对、编辑白名单、设置私聊/群组策略。当用户需要配对、批准某人、查看谁有权限、或更改飞书频道策略时使用。
hello
Greet the user with a friendly message
code-review
Review code for bugs, security issues, and performance