接入飞书
10 分钟配完。之后在飞书(手机/桌面)里:发 BP 自动入档、@机器人出初评、回复报告直接提修改意见、发纪要说「消项」回灌初评。
一、创建企业自建应用(唯一需要人工的部分)
- 打开 open.feishu.cn → 开发者后台 → 创建企业自建应用(名称建议
ProspectClaw)。 - 左侧「添加应用能力」→ 添加机器人。
- 左侧「权限管理」→ 开通以下三个权限(搜索勾选 → 申请开通):
权限 用途 im:message接收消息事件 im:message:send_as_bot以机器人身份发消息/卡片 im:resource下载你发来的 BP 文件、上传报告文件 - 左侧「事件与回调」→ 订阅方式选「使用长连接接收事件」(你的电脑没有公网地址,长连接免内网穿透)→ 添加事件 接收消息 im.message.receive_v1。
- 左侧「版本管理与发布」→ 创建版本 → 申请发布(企业内自建一般秒过)。
- 「凭证与基础信息」页复制 App ID 与 App Secret。
二、填入 ProspectClaw
桌面端 → 设置 → 飞书 Bot,粘贴 App ID / App Secret,保存(自动重启并建立长连接)。
凭证只存你本机(0600 权限原子写入),不上传任何服务器。
三、一键诊断
桌面端「飞书」页点「一键诊断」,自动逐项验证:凭证已配置 → 凭证有效且机器人已启用 → 长连接已建立 → 已收到过消息事件。任何一项不过都给出修复指引。
四、日常用法
- 私聊机器人直接说话;群聊先把机器人拉进群,然后 @ProspectClaw。
- 发 BP/纪要文件 → 自动归档到对应公司项目档案(回执告知位置),文本进档案检索。
- 「出个锐鹰传感的初评」→ 进度卡实时更新 → 主报告 + 核验底稿 PDF 投回 + 结论摘要(verdict / 推荐指数 / 核验状态)。
- 回复机器人投递的报告消息,直接写修改意见(如「估值部分展开」)→ 修订版投回。
- 发访谈纪要后说「消项」→ 消项对照表 + 初评 v2 投回。
- 「我们看过哪些做编码器的?」→ 查机构档案,带出处作答。
- 命令:
帮助能力清单 ·状态当前进度 ·取消中止任务(任务跑着时也可用)。
五、上线前建议配置(权限护栏)
| 配置(.env) | 作用 |
|---|---|
FEISHU_ALLOWED_OPEN_IDS | 允许使用的用户白名单(逗号分隔);谁能让机器人花钱、查机构档案,必须可收口 |
FEISHU_ALLOWED_CHAT_IDS | 允许的群白名单 |
FEISHU_DAILY_RUN_LIMIT | 每人每日任务数(默认 20;0 不限) |
FEISHU_OPS_CHAT_ID | 运维群:每工作日 8:30 自动晨报(昨日运行/成本/待办问题/停滞项目) |
常见问题
- 机器人不回话:跑一键诊断。最常见是事件订阅没选「长连接」或版本没发布。
- 群里 @ 了没反应:确认机器人已被拉进该群;应用刚发布后生效可能有 1-2 分钟延迟。
- 文件没入档:看诊断「已收到过消息事件」是否点亮;
im:resource权限是否开通。失败会回执原因,不会静默。 - 想 7×24 在线(机器人不随桌面 App 关闭):见使用指南 · 运维的守护进程配置。