快速结论
- 出现该错误后,Lark → Proma 方向不可用(无法通过 Lark 远程控制 Proma / 同步消息到群)
- Proma → Lark 方向正常(Agent 调用 Lark API / 操作 Lark CLI 相关功能均可使用)
- 使用手动创建自建应用方式配置,结果与扫码创建一致,同样复现
问题描述
在 Lark(飞书国际版,open.larksuite.com) 创建的企业自建应用,填入 Proma 飞书 Bot 设置后可以测试连接成功,但点启动时报错:
WebSocket connect failed: pullConnectConfig failed: code=1000040351, msg=Incorrect domain name
结果是:Lark → Proma 方向不可用(不能通过 Lark 远程控制 Proma / 同步消息到群)。
复现步骤
- 在 Lark 开放平台(open.larksuite.com)创建企业自建应用(手动创建自建应用与扫码创建两种方式都试过,均复现)
- 已确认完成:启用机器人能力、添加事件订阅
im.message.receive_v1(订阅方式:长连接)、添加回调 card.action.trigger、批量开通权限、发布版本
- Proma 设置 → 飞书 Bot → 填入该应用的 App ID / Secret
- 点「测试连接」→ 成功(返回连接成功)
- 点「启动」→ 报 1000040351 Incorrect domain name
预期行为
Lark(国际版)应用能正常建立长连接并接收消息,实现「Lark → Proma」的远程控制与同步(就像国内飞书一样)。
影响
| 方向 |
状态 |
| Proma → Lark(Agent 调用 Lark API / CLI) |
正常 |
| Lark → Proma(接收消息、远程控制、Session 镜像同步) |
无法启动长连接 |
排查到的原因(供参考)
apps/electron/src/main/lib/feishu-bridge.ts 硬编码了国内飞书域:
domain: lark.Domain.Feishu(= open.feishu.cn)
url: 'https://open.feishu.cn/open-apis/bot/v3/info/'(两处)
- Bot 配置类型(
packages/shared/src/types/feishu.ts 的 FeishuBotConfig)没有 domain 字段,无法选择飞书 / Lark
- 实测现象:同一个 Lark 应用的 REST API(tenant token / bot info)在 open.feishu.cn 和 open.larksuite.com 都能访问——这是「测试连接」能通过的原因;但 WebSocket 长连接(pullConnectConfig)按域隔离,Lark 域应用从 open.feishu.cn 拉取长连接配置就返回
1000040351 Incorrect domain name
建议
- 为 Bot 配置增加 domain(feishu / lark)选项,或根据租户自动检测
- Lark 国际版使用
lark.Domain.Lark(open.larksuite.com)建立长连接
- 参考:Lark 官方 SDK 文档「使用长连接接收事件」中 domain 参数示例为
Lark.Domain.Lark
环境
- Proma 版本:0.17.42
- 系统:Windows
- Lark 国际版(open.larksuite.com),租户 brand = lark
快速结论
问题描述
在 Lark(飞书国际版,open.larksuite.com) 创建的企业自建应用,填入 Proma 飞书 Bot 设置后可以测试连接成功,但点启动时报错:
结果是:Lark → Proma 方向不可用(不能通过 Lark 远程控制 Proma / 同步消息到群)。
复现步骤
im.message.receive_v1(订阅方式:长连接)、添加回调card.action.trigger、批量开通权限、发布版本预期行为
Lark(国际版)应用能正常建立长连接并接收消息,实现「Lark → Proma」的远程控制与同步(就像国内飞书一样)。
影响
排查到的原因(供参考)
apps/electron/src/main/lib/feishu-bridge.ts硬编码了国内飞书域:domain: lark.Domain.Feishu(= open.feishu.cn)url: 'https://open.feishu.cn/open-apis/bot/v3/info/'(两处)packages/shared/src/types/feishu.ts的FeishuBotConfig)没有 domain 字段,无法选择飞书 / Lark1000040351 Incorrect domain name建议
lark.Domain.Lark(open.larksuite.com)建立长连接Lark.Domain.Lark环境