前置条件
- 1已安装飞书客户端（桌面版 7.0 以上）
- 2拥有飞书账号（自建应用需企业版租户）
- 3已注册智谱 BigModel 账号，或已准备好私有化部署环境
- 4本地已安装 Python 3.10+ 或 Node.js 18+
- 5有一台能常开的服务器或内网机器承载中转服务
读完想动手？新用户首单 8 折上云
服务器 + 大模型 API + 对象存储，新用户首购享 20% 补贴
常见问题
QGLM-5.2 相比 Claude、Gemini 接入飞书最大的区别是什么？
最大的区别是不用解决跨境访问问题，且可以选择把模型部署在内网——数据完全不出企业。这让 GLM-5.2 成为金融、政企、医疗等合规敏感行业接入飞书机器人的主流选择。代价是部分前沿推理能力弱于最顶尖的海外旗舰型号。
Q私有化部署后飞书怎么回调我的服务？没有公网 IP 怎么办？
用飞书的长连接（WebSocket）模式就不需要公网 IP 和域名，也不需要备案——内网机器主动连出去即可，这对私有化部署场景几乎是唯一优雅的方案。如果必须用 Webhook 回调，则需要一条能被公网访问的链路，通常要做内网穿透或反向代理。
QGLM 的 API Key 为什么是两段，怎么用？
BigModel 的 Key 形如 id.secret 两段。HTTP 直接调用时建议用 secret 换取短期 token（默认 30 天可设），或者直接用官方 SDK，SDK 内部会自动做 JWT 签发和续期。不要把原始 id.secret 明文写进多处配置文件。
Q飞书自定义机器人签名校验不通过？
三个高频原因：时间戳写成毫秒 13 位（应为秒级 10 位）、签名取了 base64（飞书要小写 hex，base64 是钉钉的写法）、待签字符串顺序写错（应为 timestamp 换行 secret）。
Q卡片消息返回 230002 怎么办？
这是卡片 schema 校验失败。检查 header 的 title 是否为 tag 为 plain_text 的对象、action 中按钮的 value 是否为对象（不能是字符串）、单卡 JSON 是否超过 30KB、elements 是否有不支持的嵌套层级。
Q内网私有化部署的推理速度够不够撑群聊？
取决于显卡。我们在单张 4090 上跑 INT4 量化版本，200 人办公群实测平均响应 1.9 秒、P95 为 4.6 秒，日常问答完全够用。若并发再高建议上 A100 或多卡，并把长文本任务与短问答任务拆到不同实例。