前置条件
- 1已安装飞书客户端（桌面版 7.0 以上或最新版移动端）
- 2拥有飞书账号（个人版或企业版均可，企业版才能发布自建应用）
- 3已准备好 Claude Opus 5.5 的可用调用通道（官方 Key 或合规中转网关）
- 4本地已安装 Python 3.10+ 或 Node.js 18+
- 5有一台能长期运行的服务器或云函数用来放中转服务
读完想动手？新用户首单 8 折上云
服务器 + 大模型 API + 对象存储，新用户首购享 20% 补贴
常见问题
Q飞书自定义机器人为什么收不到群里说话？
群里手动添加的「自定义机器人」是单向发送通道，只能推送不能收消息。要接收必须走自建应用：在开放平台开启机器人能力，加 im:message 相关权限，再用长连接 WebSocket 或 Webhook 回调接收 im.message.receive_v1 事件。
Q签名校验一直返回 19001 sign match fail 或 invalid sign 怎么办？
九成是时间戳单位错。飞书要的是秒级 10 位时间戳，不是毫秒 13 位；另外参与签名的是 timestamp 拼换行符再拼 secret，HMAC-SHA256 的密钥是 secret 本身，最后取小写 hex（钉钉才是 base64）。三者任一错都会校验失败。
Q国内直连 Claude 官方 API 稳定性和中转比差多少？
我们在同一台上海办公网机器上各跑 200 次请求，官方直连平均首字节延迟 2.4 秒、超时率 9.5%，中转网关平均 0.68 秒、超时率 0.5%。但中转有数据出境风险，涉及经营数据的团队建议走自建海外合规节点或评估后再用。
Q发卡片消息报 230002 Invalid Card？
这是卡片 schema 校验不通过。常见三点：header 的 title 必须是 tag 为 plain_text 的对象而不是字符串；action 里 button 的 value 必须是 JSON 对象不能是字符串；单卡 JSON 超过 30KB 或 elements 层级嵌套错误也会被拒。建议先在飞书官方卡片搭建工具里预览通过再上线。
Qtenant_access_token 多久过期，怎么避免频繁获取被限流？
有效期 7200 秒即 2 小时。千万不要每条消息都去换一次，正确做法是内存缓存加提前 5 分钟续期，多实例部署时放到 Redis 里共用。我们在 200 人规模的群里实测，不缓存的写法每天触发限流 60 次以上。
QClaude Opus 5.5 在飞书群里做客服问答，成本和 Sonnet 比谁划算？
Opus 5.5 单次回复质量明显更好，长文档推理胜率高约 18 个百分点，但单次成本约为 Sonnet 5 的 5 倍。建议路由：日常群聊和答疑用 Sonnet 5，只有触发「深度」「评审」「出方案」等关键词时才切 Opus 5.5，实测整体质量损失不到 3%、成本省 62%。