远控通道设置

远控通道用于为自主规划式智能体配置外部消息入口。启用并配置通道后，循环推理模式可通过控制台、钉钉、飞书、QQ、企业微信或微信接收用户消息，并将智能体回复发送回对应通道。

进入自主规划式智能体设置页面后，点击顶部导航栏中的循环推理->远控通道页签，即可查看和配置远控通道。配置流程如下：

在远控通道列表中选择需要配置的通道卡片，点击卡片打开右侧配置面板。
打开启用通道开关。
按需填写唤醒前缀，并按需完成通用设置。
根据通道类型填写对应平台的认证信息、附件保存位置和访问权限等设置项。
点击保存，使通道配置生效。

控制台通道

控制台通道用于在自主规划式智能体自身的控制台会话中接收和发送消息。该通道不需要填写第三方平台凭证，主要用于本地验证、日常调试和控制台主会话交互。

设置项	说明
启用通道	开启后，控制台可作为远控消息入口使用。
唤醒前缀	设置控制台通道中的机器人前缀或唤醒标识。

钉钉通道

钉钉通道用于将自主规划式智能体接入钉钉机器人。配置该通道前，需要先在钉钉开放平台准备机器人应用，并获取 Client ID 与 Client Secret。

平台侧配置步骤

打开钉钉开发者后台。
进入应用开发 > 企业内部应用 > 钉钉应用，创建应用。
在应用能力 > 添加应用能力中添加机器人。
配置机器人基础信息，将消息接收模式设置为Stream 模式，然后发布机器人能力。
进入应用发布 > 版本管理与发布，创建新版本，填写基础信息后保存。
进入基础信息 > 凭证与基础信息，记录 Client ID 和 Client Secret。
如需下载用户发送的图片和文件，可在安全设置 > 服务器出口 IP中添加 AgentX 所在服务器的公网 IP。

远控通道配置项

设置项	说明
钉钉授权二维码	可点击获取二维码，扫码授权后自动回填 Client ID 和 Client Secret；也可手动填写凭证。
Client ID	钉钉应用的 Client ID，即 AppKey。
Client Secret	钉钉应用的 Client Secret，即 AppSecret。
个性化设置	按需设置私聊权限、群聊权限、需@提及、授权用户列表。设置项说明请参见：通用设置项

飞书通道

飞书通道用于将自主规划式智能体接入飞书机器人。飞书侧通过 WebSocket 长连接接收消息，发送消息通过飞书开放平台 Open API 完成。

平台侧配置步骤

打开飞书开放平台，创建企业自建应用。
在凭证与基础信息中获取 App ID 和 App Secret。
先在 AgentX 飞书通道配置面板中填写 App ID 和 App Secret 并保存，使通道具备建立长连接所需的凭证。
回到飞书开放平台，在应用能力中启用机器人。
进入权限管理，使用批量导入/导出权限导入消息、群组、资源和文件相关权限，并申请开通。
批量导入权限时，将以下JSON代码复制进去：

{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"aily:message:read",
"aily:message:write",
"corehr:file:download",
"im:chat",
"im:message",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message.reactions:read",
"im:resource",
"contact:user.base:readonly"
],
"user": []
}
}
进入事件与回调 > 事件配置，将订阅方式设置为长连接（WebSocket）。
选择添加时间，搜索接收消息，订阅接收消息 v2.0。
进入事件与回调 > 回调配置，将回调订阅方式同样设置为长连接（WebSocket）。
选择添加回调，搜索卡片回传交互，订阅卡片回传交互
进入应用发布 > 版本管理与发布，创建版本，填写基础信息，保存并发布。

远控通道配置项

设置项	说明
App ID	飞书企业自建应用的 App ID。
App Secret	飞书企业自建应用的 App Secret。
加密 Key	用于消息加解密。长连接模式下可按实际平台配置选择是否填写。
校验 Token	用于校验事件来源。长连接模式下可按实际平台配置选择是否填写。
附件保存位置	设置飞书通道接收图片、文件等媒体内容的保存目录。
个性化设置	按需设置私聊权限、群聊权限、需@提及、授权用户列表。设置项说明请参见：通用设置项

QQ 通道

QQ 通道用于将自主规划式智能体接入 QQ 机器人。配置该通道前，需要先在 QQ 开放平台创建机器人应用，并获取 AppID 与 AppSecret。

平台侧配置步骤

打开 QQ 开放平台。
创建机器人应用，并进入机器人编辑页面。
进入回调配置，在单聊事件中勾选C2C 消息事件，在群事件中勾选群消息事件 AT 事件，然后确认配置。
进入沙箱配置中的消息列表配置项，点击添加成员，添加用于测试的 QQ 账号。
进入开发管理，获取 AppID 和 AppSecret。如平台要求配置 IP 白名单，请填写 AgentX 所在服务器的公网 IP。
在沙箱配置中使用 QQ 扫码，将机器人添加到消息列表。

远控通道配置项

设置项	说明
App ID	QQ 机器人应用的 AppID。
App Secret	QQ 机器人应用的 AppSecret，也称 Client Secret。

注意：

QQ 通道配置时需要分别填写 App ID 和 App Secret，不要将两项信息拼接为一个 Token。

企业微信通道

企业微信通道用于将自主规划式智能体接入企业微信智能机器人。配置该通道前，需要先在企业微信中创建 API 模式机器人，并获取 Bot ID 与 Secret。

平台侧配置步骤

如尚无企业微信企业，可先访问企业微信官网注册账号、创建企业，并绑定微信账号成为企业管理员；已有企业微信账号时，可直接在当前企业内创建机器人。
打开企业微信客户端，进入工作台，找到智能机器人。
点击创建机器人，选择API 模式创建。
在 API 配置中选择通过长连接配置或使用长连接。
填写机器人名称，并根据业务需要配置可使用成员范围。
记录页面生成的 Bot ID，并获取 Secret。

远控通道配置项

设置项	说明
企业微信授权二维码	可点击获取二维码，扫码授权后自动回填 Bot ID 和 Secret；也可手动填写凭证。
Bot ID	企业微信智能机器人的 Bot ID。
Secret	企业微信智能机器人的 Secret。
附件保存位置	设置企业微信通道接收图片、文件等媒体内容的保存目录。
欢迎语	设置用户首次收到机器人消息时发送的欢迎语。
个性化设置	按需设置私聊权限、群聊权限、需@提及、授权用户列表。设置项说明请参见：通用设置项

微信通道

微信通道用于通过微信个人 Bot 接入自主规划式智能体。微信个人 Bot 基于 iLink 接入，首次使用时可通过微信扫码授权获取 Bot Token；Token 可持久化到本地文件，后续启动时自动读取。该通道通过长轮询接收消息。

平台侧配置步骤

确认已具备微信个人 Bot（iLink 协议）接入资格。
在 AgentX 微信通道配置面板中点击获取二维码，等待二维码显示。
使用手机微信扫描二维码，并在手机端确认授权。
扫码成功后，Bot Token 会自动填入表单；如已有可用 Token，也可直接在配置面板中填写。
按需设置 Token 持久化路径、API 地址和附件保存位置，然后保存配置。

远控通道配置项

设置项	说明
微信登录二维码	可点击获取二维码，使用手机微信扫码授权并获取 Bot Token。
Bot Token	扫码登录后获取的访问令牌；已有可用 Token 时可直接填写。
Token 持久化路径	用于保存 Bot Token，便于后续启动时复用授权信息。
API 地址	微信个人 Bot 的 iLink API 地址；留空时使用默认地址。
附件保存位置	设置微信通道接收到的图片、文件等媒体内容保存目录。
个性化设置	按需设置私聊权限、群聊权限、需@提及、授权用户列表。设置项说明请参见：通用设置项

注意：

微信个人 Bot 基于 iLink 接入，使用前需具备对应接入资格。若当前环境无法获取授权二维码或 Token，请先确认微信个人 Bot 接入条件是否满足。

通用设置项

各远控通道均包含启用状态、唤醒前缀和消息展示类设置。部分外部消息通道还提供私聊、群聊访问控制相关设置。

设置项	说明
启用通道	控制当前通道是否参与消息接收和回复。关闭后，该通道不会作为远控入口使用。
唤醒前缀	设置机器人回复前缀或唤醒标识，例如 @bot。不同通道中可结合群聊习惯设置。
展示执行细节	控制是否在通道消息中展示工具调用、检索过程和执行过程信息。关闭后，通道侧主要展示最终回复。
展示推理思路	控制是否在通道消息中展示推理相关内容。关闭后，通道侧仅展示回复内容。
私聊权限	控制私聊场景的访问策略，可按界面选项设置为开放或白名单（授权用户）访问。
群聊权限	控制群聊场景的访问策略，可按界面选项设置为开放或白名单（授权用户）访问。
授权用户列表	填写允许访问该通道的用户标识。
需要 @ 提及	用于控制群聊中是否必须 @ 机器人后才触发智能体响应。