本页目录
消息通道与集成
消息通道将外部平台请求送入数字员工，个人连接绑定用户的外部服务账号，OpenAPI 提供受控系统调用。三类连接分别维护凭据、身份和授权。
通道配置字段
| 字段 | 作用 |
|---|---|
| 通道类型 | 决定平台协议。 |
| 账号或机器人标识 | 确定接收入口。 |
| 平台凭据 | 支持认证。 |
| 连接状态 | 反映链路。 |
| 用户绑定 | 将外部发起者映射为平台身份。 |
数字员工控制台提供微信、钉钉、飞书、企业微信和 QQ 五个平台入口。用户从数字员工卡片的更多操作进入“设置 → 运行时 → IM机器人”。
各平台的应用审核、可见范围和权限仍然适用。具体配置流程见配置IM机器人。
通道实例、保存与测试
一个通道实例保存一组外部机器人的连接配置。通道实例、数字员工和运行副本分别维护。
| 项目 | 含义与边界 |
|---|---|
| 微信设置 | 扫码连接微信，使用专用账号状态面板。 |
| 添加实例 | 钉钉、飞书、企业微信和 QQ 支持添加多个独立通道实例，每个通道实例对应相应外部机器人。 |
| 实例名称 | 通道实例的管理名称，与外部平台应用标识分别维护。 |
| 启用 | 通道实例的启用状态，不代表平台认证、应用发布或消息收发已经完成。 |
| 保存并应用 | 提交手工修改并应用配置；仍需检查运行端接收与连接结果。 |
| 重置 / 删除 | 重置放弃未保存修改，删除移除所选通道实例；删除后的变更需要保存并应用。 |
| 测试连通性 | 检查所选平台凭据或状态，并刷新通道状态；需要Gateway已连接，不测试用户收发或业务工具权限。 |
| 扫码快捷配置 | 微信扫码连接，以及钉钉、飞书、企业微信的扫码授权成功后会保存配置并启用；QQ当前表单没有同样的扫码创建入口。 |
私聊与群聊策略
| 策略或字段 | 含义 |
|---|---|
| 私聊策略：开放 | 通道层允许开放私聊；平台可见范围与Tego资源权限仍适用。 |
| 私聊策略：配对 | 未准入账号先通过配对流程；有待处理请求时显示通道配对，提供批准、拒绝和刷新。 |
| 私聊策略：白名单 | 按允许来源中的平台用户ID限定私聊来源。 |
| 私聊策略：禁用 | 禁用私聊；当前钉钉表单不提供该取值。 |
| 允许来源（用户 ID） | 每行一个平台用户ID，不能使用显示姓名、应用ID或机器人ID代替。开放策略可留空。 |
| 群聊策略 | 钉钉、飞书、企业微信提供开放、白名单、禁用。QQ当前表单不提供此字段。 |
| 群聊允许来源 | 为支持该字段的平台限定群聊来源；使用对应平台与插件识别的稳定ID，不以群显示名称替代。 |
配对和白名单只限定通道接入，不授予管理员、知识库、设备、文件或外部系统权限。群聊准入还须符合平台侧的入群和消息范围设置。
微信通道
“扫码连接微信”生成本次登录二维码，系统在连接成功后保存账号并启用插件与通道。“测试连通性”检查微信状态。
微信使用专用状态面板，不提供其他四个平台的通道实例凭据与高级策略表单。
“微信登录成功，但保存配置失败”表示账号登录已完成，通道配置尚未保存。
用户在登录失败、超时或未获得二维码时，按页面错误重新发起连接。微信与已安装通道插件的实际要求决定版本兼容范围。
钉钉通道
| 字段 | 口径 |
|---|---|
| Client ID (AppKey) / Client Secret (AppSecret) | 企业内部应用的同一组应用凭据。 |
| 私聊策略 | 开放、配对、白名单。 |
| 群聊策略 | 开放、白名单、禁用，并有群聊允许来源。 |
| 按会话独立上下文 | 控制会话上下文的划分，启用前核对业务对话边界。 |
| 跨会话共享记忆 | 控制跨会话记忆使用，不能把共享范围默认为单聊范围。 |
| 调试 | 用于问题定位；输出按组织要求保管并脱敏。 |
当前接入提示使用“Stream模式”长连接。应用机器人能力、权限、版本发布与可见范围在钉钉开放平台维护。
卡片、文本等能力分别需要钉钉平台对应权限，凭据测试不会授予这些权限。
飞书通道
| 字段 | 口径 |
|---|---|
| App ID / App Secret | 企业自建应用的同一组凭据。 |
| 私聊策略 / 群聊策略 | 私聊提供开放、配对、白名单、禁用；群聊提供开放、白名单、禁用。两类允许来源分别维护。 |
| 域名 | 飞书或Lark，须与凭据所属平台匹配。 |
| 流式输出 | 控制逐步返回内容的方式；仍受平台与插件能力影响。 |
| 历史消息条数 | 控制通道采用的历史消息数量，不能当作Tego完整历史的保留期限。 |
| 媒体大小上限（MB） | 通道侧媒体处理配置；实际还受平台、插件和所需权限限制。 |
长连接的消息接入需订阅 im.message.receive_v1。事件说明见飞书接收消息。
应用可见范围、权限与发布版本分别影响谁能使用、能接收什么，以及更改何时可用。
企业微信通道
| 字段 | 口径 |
|---|---|
| Bot ID / Secret | 智能机器人API模式的机器人标识与长连接专用密钥。 |
| 私聊策略 / 群聊策略 | 私聊提供开放、配对、白名单、禁用；群聊提供开放、白名单、禁用，并分别维护允许来源。 |
| 发送思考中提示 | 控制处理期间的提示消息，不等于任务完成。 |
| 调试 | 用于连接与消息故障定位。 |
Secret 与企业 CorpID、普通应用 Secret、群 Webhook key、回调模式 Token 及 EncodingAESKey 不同。
同一智能机器人同时只能保持一个有效长连接，新连接可能使旧连接断开。长连接与回调地址模式不能同时作为该机器人的接入模式，主备切换须避免双端同时占用同一机器人。
连接规则见企业微信长连接说明。
QQ通道
| 字段 | 口径 |
|---|---|
| AppID / AppSecret | QQ机器人应用的同一组凭据。 |
| 私聊策略 / 允许来源（用户 ID） | 私聊提供开放、配对、白名单、禁用；允许来源填写平台用户标识。 |
| Markdown支持 | 控制消息格式，实际格式能力还受QQ侧设置和插件支持影响。 |
| 历史消息条数 | 控制通道采用的历史消息数量。 |
| 图片服务 Base URL | 已实际部署、可由QQ访问的图片服务入口；不能用本机地址或未部署域名替代。 |
| 调试 | 用于问题定位，输出需脱敏。 |
当前 QQ 表单没有群聊策略与群聊允许来源字段，群聊消息范围与发言权限在 QQ 侧核对。
个人主体、企业主体和体验用户的可用范围不同，创建成功不等于公开开放。具体范围见QQ官方常见问题。
QQ 官方接入教程中的独立 OpenClaw 安装命令不能直接用于替换 Tego 受管的运行时插件。版本问题由管理员按当前部署的插件管理流程处理。
身份与资源
系统依据实际发起身份与绑定规则，判定外部消息对数字员工、知识及工具的访问范围。未绑定身份不具有默认管理员权限。
群聊参与者可以看到群内内容。产物与引用需要符合相应接收范围。
对外发送
渠道配置提供发送链路，不授予数字员工任意外发权限。工作请求需要明确接收方、内容和必要确认。
发送成功表示渠道接受消息，不表示接收者已经阅读或业务已经完成。原消息的发送记录用于避免错误重试造成重复。
集成治理
集成凭据分别维护签发、到期、轮换与撤销。故障定位可沿平台应用、网络连接、数字员工运行实例、模型与工具查看对应错误；日志和工单中不应包含秘密值。
个人访问见个人连接与MCP访问，组织接口见开放接口与集成。