GoRoBot 直接对接飞书网页端协议,多账号托管、登录即监听、消息去重全部内置。 你只需要写几十行 Python,就能让飞书账号按你的规则收发消息。
7512049628787802140
7171061198375518212
—
我们不做「只能回一句话」的玩具。从 WebSocket 长连接、protobuf 网关到文件上传, 整条链路都在框架里跑通,插件只面对干净的 Python 方法。
一个客户端托管多个飞书账号,各自独立监听、独立插件实例、互不干扰。账号列表统一启停,插件无权登录。
文本、@人、表情、链接、图片、文件、视频、富文本混排,全部走同一条协议链路。上传 50MB 文件实测 7 秒。
飞书会把同一条消息经 WS 推送、会话同步、重连补投多路上报。框架用 LRU + SQLite 双层闸门拦截,日志不会重复。
86 个方法覆盖消息、群管、成员、搜索、通讯录、媒体。继承一个类、写几个回调就能跑,不用碰协议; 声明几个字段,框架自动给它生成设置弹窗。
开发态直接读 .py,交付时导出 .grbp 加固包,可选绑定机器码。换机不可用,源码不外流。
消息日志、去重统计、发送节流、回声熔断都在框架层。插件写得再糙,也很难在短时间内把账号刷成垃圾号。
下面的接口全部来自真实接口探测与调用验证,不是规划中的功能。标注「收费版」的项免费版不可用。
免费版不是试用倒计时,而是长期可用。它限制的是「多账号」与「富媒体」这两项成本最高的能力。
| 能力 | 免费版 ¥0 |
收费版 解锁全部 |
|---|---|---|
| 授权与账号 | ||
| 可同时登录的飞书账号 | 1 个 | 不限 |
| 授权有效期 | 长期可用 | 按购买周期 |
| 账号登录、扫码、Cookie 登录 | 支持 | 支持 |
| 断线重连与心跳保活 | 支持 | 支持 |
| 消息发送 | ||
| 发送文本消息 | 支持 | 支持 |
| @人 与 @所有人 | 支持 | 支持 |
| 发送飞书表情 | 支持 | 支持 |
| 富文本混排(文本 + @ + 表情 + 链接) | 不可用 | 支持 |
| 发送图片 | 不可用 | 支持 |
| 发送文件与视频 | 不可用 | 支持 |
| 上传文件到飞书文件域 | 不可用 | 支持 |
| 撤回消息 | 支持 | 支持 |
| 接收、会话与联系人 | ||
| 实时消息监听 | 支持 | 支持 |
| 消息日志与历史消息 | 支持 | 支持 |
| 图片与文件下载 | 支持 | 支持 |
| 群创建、拉人、踢人、退群 | 支持 | 支持 |
| 搜索陌生人、加好友 | 支持 | 支持 |
| 通讯录读取 | 支持 | 支持 |
| 插件与开发 | ||
| Python 插件 SDK(86 个方法) | 支持 | 支持 |
| 加载 .py 插件 / 开发者模式 | 支持 | 支持 |
| 插件设置弹窗(声明式表单) | 支持 | 支持 |
| 插件自定义设置页(iframe) | 支持 | 支持 |
| 导出 .grbp 加固包 / 绑定机器码 | 支持 | 支持 |
| 消息去重与发送节流保护 | 支持 | 支持 |
一次授权绑定一台机器。所有周期享受完全相同的收费版能力,只是时长不同。
所有能力都从飞书网页端逆向还原,并用真实账号验证过。下面是最容易被忽略、但决定稳定性的几个点。
实时消息走 wss://msg-frontier,业务请求走 /im/gateway 的 protobuf 包。
收到带 sid 的帧必须回 ACK,30 秒心跳,否则服务端会静默断流。
图片和文件不走 im/gateway,而是 internal-api-lark-file 的
/uni_api/upload/file。单次全量上传实测 50MB 稳定,无需分片。
飞书网页端 type=2 POST 会被网关直接拒。图文、@、链接、表情全部挂在
type=4 的 richText 元素里,@ 还需同时进 atIds 才渲染。
WS 推送、会话同步、重连补投是三套通道,图片尤其常被推 2 到 3 次。 去重必须在「落库」和「分发」两层都做,否则日志会重复。
飞书凭证本地加密落盘;授权走 X25519 握手加 AES-GCM 信封。 验证地址与 app_id 在代码里冻结,界面不可改,避免被指向假服务端。
断线按 5s 到 300s 指数退避重连,重连后自动补拉最近消息。 网关偶发 400 时会刷新 csrf 自动重试一次,不把偶发错误抛给插件。
文档包含插件基类、消息字段、86 个 SDK 方法、插件设置页、内置保护机制、 免费版兼容写法与加固分发流程。全部示例都可在框架内直接运行。
打开开发文档不会过期。免费版是你注册授权账号后的默认状态,没有激活天数时长期有效,没有倒计时也不会突然停止。
它限制的是两项成本最高的能力:只能登录 1 个飞书账号,以及不能发送富文本、图片、文件和视频。 文本消息、@人、表情、收消息、消息日志、群管理、搜索、通讯录和插件开发都完全开放。
联系 GoRoBot 管理员获取卡密,四种周期(月付 20 / 季付 45 / 半年 100 / 年付 180)对应的卡密使用方式相同, 没有功能差别,只是时长不同。
拿到卡密后有两种方式激活:① 客户端「授权验证」页 →「卡密充值」输入即可; ② 在授权账号后台直接充值,客户端下次心跳(约 40 秒内)会自动同步。 同一台机器多次充值时长叠加。
先在用户中心登录授权账号(没有就注册一个), 再在客户端「授权验证」页把卡密填进「卡密充值」即可。充值成功后授权立即生效, 免费版的限制同步解除,之前被停用的账号会自动恢复监听,不需要重启。同一台机器上多次充值时长会叠加。
一份授权绑定一台机器的机器码。换机器后原授权的剩余时长不会自动转移, 插件加固包若勾选了绑定机器码同样不可用。多机使用请分别购买授权。
不会丢。到期后自动回落到免费版:飞书账号配置、凭证、插件、消息日志全部保留, 只是超出 1 个的飞书账号会停止监听并标记为「免费版停用」,富媒体发送会被拦截。
续费后这些账号会立即恢复监听,标记自动清除。任何情况下都不会删除你的数据。
如果插件里调用了发图、发文件等方法,免费版会抛出 SDKError。
文档里给了标准写法:先读 sdk.edition()["tier"] 判断版本,或用 try/except SDKError 降级为纯文本。
建议所有分发的插件都这样处理。
能,而且不用写前端代码。插件只要声明一个 settings_schema 列表,
框架会在插件卡片上生成「设置」按钮,点开的弹窗里是自动渲染的表单 ——
支持文本、多行文本、数字、滑杆、开关、下拉、多选、密钥、取色器共 9 种控件。
保存时框架会逐字段校验(数字越界收敛到边界、下拉不在选项内回落默认),
配置原子写入磁盘,然后回调插件的 on_settings_changed(),热更新不用重启。
声明式表单不够用时(需要图表、二维码、多步骤向导),覆写 settings_page()
返回 HTML 即可,框架会用 iframe 展示,页面里可直接调 grb.get() / grb.save()。
两种方式在加固包(.grbp)里同样生效。
支持。账号可分别选择飞书或 Lark 区域,协议与区域配置相互隔离,同一客户端里可以混用。
GoRoBot 用的是与飞书网页端完全一致的请求链路(同一套网关指令、同一个文件域、同样的 UA 与请求头),不是模拟点击、也不是高频轮询,行为特征和真人使用网页版没有区别, 因此相比自写脚本或按键精灵一类方案,封号几率大幅降低。
框架层还内置了多重防护:同会话 20 秒最多 8 条的发送节流、回声熔断、重复消息拦截, 以及断线指数退避重连,避免异常流量特征。
但需要明确:任何第三方自动化工具都无法保证账号绝对安全。 封号判定取决于账号本身的发送频率、内容、被举报情况与平台策略, 这些不在工具可控范围内。建议控制发送节奏、避免群发营销内容, 先用小号验证再上主账号。