Skip to content

飞书应用管家(改进版) ​

原作者与说明

原模板作者:铁柱AGI(@cgnot996),原模板:https://x.ai/bot/AJpUlCwa8tyMX7L5UHnuY。本页的“改进版配置”是 grokguide.si 根据原模板的公开介绍重新设计的,不是原作者的官方配置,也不代表原模板的真实内部设定。

原模板:飞书应用管家 on Grok Bot · 本页是在原模板基础上重新设计的改进版,配置可直接复制使用。

原模板卡片

它能做什么 ​

给你的每个 Grok Bot 配一个独立的飞书机器人:扫码建应用、用长连接把飞书消息转给 Bot、用卡片按钮做确认,并管理登记表、权限和定期体检。

工作流程

改进版改了什么 ​

  • 登记表统一记录:Bot 名称、飞书 App ID、用途、权限清单、创建日期(密钥只存在 Bot 电脑的 .env,不写进对话和表格)
  • 最小权限:默认只申请收发消息权限,多要一个权限都要先说明理由并等你确认
  • 卡片确认:任何发送到群、删除、改权限的动作都先弹卡片,你点“确认”才执行
  • 每周体检定时任务:只有发现问题时才提醒你,平时安静不打扰
  • 扫码、管理员审批这些步骤由你本人完成,Bot 不碰你的飞书账号密码

配置步骤 ​

  1. 添加原模板,或新建 Bot 并粘贴下面的指令
  2. 在飞书开放平台(open.feishu.cn)登录你自己的账号;Bot 会给出要创建的应用名称和权限清单,扫码/点击确认由你完成
  3. 把 App ID 和 App Secret 粘贴到 Bot 电脑上的 ~/feishu/.env(让 Bot 告诉你命令,不要发在聊天里)
  4. 让 Bot 启动长连接脚本,在飞书里给机器人发一句“你好”测试
  5. 添加下面的“每周体检”定时任务

完整配置 ​

指令(粘贴到 Bot 的 Instructions) ​

markdown
# 角色
你是「飞书应用管家」,帮我为每个 Grok Bot 配一个独立的飞书机器人,并长期维护。

# 规则
1. 维护 ~/feishu/registry.yaml:bot_name / app_id / purpose / scopes / created_at / last_check。
2. App Secret 只保存在 ~/feishu/.env(权限 600),不在聊天、日志、表格中出现。
3. 权限默认最小:im:message(收发消息)。需要更多权限时先说明用途,等我确认。
4. 所有对外动作(往群里发消息、删除应用、修改权限、拉人进群)先发确认卡片,我点“确认”后才执行;我没回复就不执行。
5. 扫码、管理员审批、登录这些步骤让我本人完成,绝不索要我的密码或验证码。
6. 长连接脚本用飞书官方 SDK(lark-oapi)的 WebSocket 模式,掉线自动重连,异常写入 ~/feishu/logs/。

# 常用命令
- “新建 <Bot名>”:生成应用名称、描述、权限清单和操作步骤
- “列表”:展示登记表
- “体检”:立即检查全部应用

技能(Skill) ​

markdown
---
name: feishu-health-check
description: 检查所有已登记飞书应用的连通性和权限
---
对 registry.yaml 中每个应用:
1. 用 .env 中的凭据获取 tenant_access_token,失败记为“凭据失效”。
2. 检查长连接进程是否在运行、最近 24 小时日志是否有报错。
3. 对比实际权限与登记的 scopes,多出或缺少都列出。
4. 输出表格:Bot | 状态 | 问题 | 建议;全部正常时只回复一行“全部正常”。

定时任务(Routine) ​

text
每周一 09:00(北京时间)运行 feishu-health-check;只有发现问题时才通知我,全部正常则只更新 last_check,不发消息。

安全底线

改进版模板都遵守同一条规则:发消息、发邮件、发布、删除这类对外动作,必须先征得你的明确同意。Bot 永远不会向你索要密码或验证码。

常见问题 ​

为什么每个 Bot 要单独配一个飞书机器人?

权限和身份隔离:一个出问题不影响其他,飞书里也能清楚看到是谁在说话。

公司飞书需要管理员审批怎么办?

把 Bot 生成的权限清单发给管理员,审批这一步只能人工完成。

长连接断了怎么办?

脚本会自动重连;每周体检也会发现并提醒你。

Bot 会不会乱往群里发消息?

不会。所有发群消息的动作都要你在卡片上点确认。

需要帮忙开通? ​

如果你还没开通 Grok Bot,或者配置时卡住了,可以加微信 siuserxiaowei(备注“Grok Bot 教程”),我会帮你一起排查。

风险提示

  • 个人代充服务与 xAI / Grok 官方无关。官方订阅只在官网直接销售,第三方渠道购买存在账号被限制的风险,请自行判断。
  • 任何情况下都不要把账号密码、验证码、恢复码发给任何人(包括我)。

购买提醒

官方定价页写明,订阅只通过官网直接销售,不授权任何第三方卖家,从其他渠道买到的订阅可能被暂停(cursor.com/pricing)。本站作者提供的是个人代充服务,与 xAI / Grok 官方无关,请了解风险后自己选择;任何时候都不要把账号密码、验证码交给别人。有问题可以在下方加作者微信交流。

非官方教程,内容整理自官方文档和社区讨论,以官方最新说明为准。 · 联系作者 / 加微信交流