配置通道 - 钉钉

摘要

国内站可通过扫码授权，或填写已有钉钉机器人的 Client ID 与 Client Secret，将钉钉接入 Hermes Agent。 首次接入建议使用管理台提供的扫码方式；连接后发送一条测试消息，确认 Agent 能回复。

接入前准备

• 已开通 LightVela 套餐并完成首个 Agent 的创建。
• 已登录钉钉，且有权使用要连接的钉钉账号或组织。
• Agent 有可用模型：使用套餐内模型积分，或在配置模型中完成自有模型配置。

方式一：扫码连接

1. 打开「我的 Hermes」，选择要接入钉钉的 Bot。
2. 在「通道」中选择「钉钉」，点击连接。
3. 在「选择钉钉连接方式」中选择扫码，按页面提示用钉钉扫描二维码并完成授权。
4. 返回管理台，确认钉钉显示为已连接；随后在钉钉向对应机器人发送「你好」，确认收到回复。

二维码过期时，关闭弹窗并重新发起连接。若组织限制了授权，请联系钉钉组织管理员核对授权策略。

方式二：填写已有机器人的凭证

如果你已拥有可用于该连接方式的钉钉机器人，在连接方式中选择「Client ID / Secret 绑定」，按管理台提示填写 Client ID 和 Client Secret，完成后测试消息收发。凭证属于敏感信息，请勿贴到聊天、工单公开内容或代码仓库。

钉钉开放平台的应用类型、权限与回调配置可能随接入方案变化。本页不指定这些参数；需要创建应用时，请以钉钉开放平台当前要求及管理台的即时提示为准。

无法收到回复时

1. 确认管理台显示钉钉已连接，并检查是否在正确的钉钉会话中发消息。
2. 确认套餐模型积分或自有模型额度可用。
3. 对于手动绑定，核对 Client ID 与 Client Secret；凭证失效时在钉钉侧更新后重新绑定。
4. 查看诊断中心的近期日志；扫码授权异常时重新连接。

下一步

• 配置总览：了解管理台其他能力。
• 配置模型：添加或切换模型。