AGENT SKILL

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


根据参数分派

无参数 — 凭证状态

显示当前凭证配置:

  1. 凭证 — 先检查 ~/.claude/channels/feishu/.env 中的 MY_LARK_APP_ID(优先)。如未设置,检查 shell 环境变量 MY_LARK_APP_ID / MY_LARK_APP_SECRET。显示已设置/未设置及来源(.env / 环境变量);如已设置,显示前 8 位掩码(cli_a8e1...)。

  2. 下一步 — 根据凭证状态给出提示:

    • 无凭证 → "在 .zshenv 中设置 MY_LARK_APP_ID 和 MY_LARK_APP_SECRET,或运行 /feishu-channel-configure <appId> <appSecret>。"
    • 凭证已设置 → "凭证已就绪。运行 /feishu-channel-access 查看访问控制状态。"

<appId> <appSecret> — 保存凭证

  1. 将 $ARGUMENTS 解析为两个空格分隔的值。
  2. mkdir -p ~/.claude/channels/feishu
  3. 读取已有的 .env(如存在);更新/添加 MY_LARK_APP_ID= 和 MY_LARK_APP_SECRET= 行,保留其他配置。写回,不加引号。
  4. 可选设置 MY_LARK_BRAND=feishu(国际版用 lark)。
  5. 确认,然后显示无参数状态,让用户了解当前情况。
  6. 提示用户:"凭证已保存。运行 /mcp 重新连接 MCP 使配置生效(仅 /reload-plugins 不够,需要重连 MCP 以重启服务器进程)。"

clear — 清除凭证

从 .env 中删除 MY_LARK_APP_ID= 和 MY_LARK_APP_SECRET= 行。


飞书设置指南

当用户询问如何设置时,提供以下步骤:

  1. 前往飞书开放平台(国际版前往 Lark Developer)
  2. 创建自建应用
  3. 从凭证页面获取 App ID 和 App Secret
  4. 在事件与回调中:
    • 启用长连接模式(WebSocket)
    • 订阅事件:im.message.receive_v1(接收消息)
  5. 在权限管理中,启用:
    • im:message — 接收消息
    • im:message:send_as_bot — 以机器人身份发送消息
    • im:resource — 下载消息资源(图片/文件)
    • im:chat — 访问会话信息
    • im:message.reactions:operate — 添加/移除表情回应(可选)
  6. 发布应用(或添加到测试群进行开发)
  7. 在 shell 环境变量中设置凭证,或通过 /feishu-channel-configure <appId> <appSecret> 设置

实现注意事项

  • channels 目录可能不存在(服务器尚未运行过)。文件不存在 = 未配置,不是错误。
  • 服务器启动时读取一次 .env(先检查 shell 环境变量)。凭证变更需要 /mcp 重连 MCP(重启 bun 进程),仅 /reload-plugins 不会重启 MCP server。
  • access.json 在每条入站消息时重新读取 — 通过 /feishu-channel-access 的策略变更立即生效,无需重启。

04 同仓库更多 Skills