Solon v3.10.7

如何使用 web 绑定钉钉、飞书、微信

</> markdown
2026年5月14日 上午9:08:50

SolonCode Web 内置了强大的 IM 连接通道。启动 Web 模式后，通过简单的绑定操作，即可在飞书、钉钉或微信的私聊窗口中直接与 SolonCode AI 交互。

核心特性

  • 多端同步：消息在 IM 窗口与 Web 界面实时流转，确保上下文始终一致。
  • 一会话多通道：（以会话为单位）支持一个 SolonCode 会话同时绑定多个 IM 应用，实现多端协同。
  • 持久化连接：系统自动保存凭据，重启 SolonCode 后通道自动恢复，无需重复配置。
  • 双向流转：IM 端发送指令，AI Agent 实时响应；AI 的回复也会精准分发至所有绑定通道。

平台功能对比：

平台连接方式绑定方式备注
飞书WebSocket + ProtobufApp ID + App Secret可流式输出（推荐）
钉钉WebSocketAppKey + AppSecret可流式输出（推荐）
微信HTTP 长轮询扫码登录一问一答为好

1、绑定飞书

基于飞书开放平台的应用凭证（App ID + App Secret）连接，需要先在 飞书开放平台 创建一个应用机器人。

前置准备

  1. 登录飞书开放平台，创建一个企业自建应用
  2. 开启应用的 机器人 能力
  3. 记录应用的 App ID 和 App Secret
  4. 配置应用的事件订阅方式为 WebSocket 长连接

操作步骤

  1. 点击飞书连接按钮
  2. 填写 App ID 和 App Secret，点击绑定。
  3. 在飞书中找到机器人，发送一条消息。【重要】

收到第一条消息后，系统自动提取用户身份完成绑定。绑定成功后，前端界面会同步更新状态。

示意图：

2、绑定钉钉

基于钉钉开放平台的应用凭证（AppKey + AppSecret）进行连接，需要先在 钉钉开放平台 创建一个机器人应用。

前置准备

  1. 登录钉钉开放平台，创建一个企业内部应用
  2. 开启应用的 机器人 能力
  3. 记录应用的 AppKey 和 AppSecret
  4. 配置消息接收模式为 Stream 模式

操作步骤

  1. 点击钉钉连接按钮
  2. 填写 AppKey 和 AppSecret，点击绑定
  3. 在钉钉中找到机器人，发送一条消息。【重要】

收到第一条消息后，系统自动提取用户身份完成绑定。绑定成功后，前端界面会同步更新状态。

示意图：

3、绑定微信

微信通道采用扫码绑定方式，无需任何开发者配置，打开即用。

操作步骤

  1. 点击微信连接按钮
  2. 用微信扫码（成功后，即绑定当前会话）

微信二维码有时效性，如过期请重新点击连接按钮获取。Token 过期后系统会自动解绑并通知前端。

示意图：

常见问题

Q: 一个 Web 会话可以同时绑定多个 IM 吗？

是的。同一个会话可以同时绑定微信、飞书、钉钉，AI 的回复会分发到所有已绑定的通道。

Q: 重启 SolonCode 后需要重新绑定吗？

不需要。所有通道的凭据都会持久化到本地，重启后自动恢复。

Q: 如何解绑？

在各通道的连接面板中点击「解绑」按钮即可。也可以随时重新绑定新的会话。

Q: 微信 Token 过期了怎么办？

系统会自动检测 Token 过期并解绑，前端会收到通知。重新点击连接按钮扫码即可。