本文介绍如何在 Agent 管理中心创建 Hermes Agent、配置模型,以及接入钉钉实现 IM 指令下发。
准备工作
账号与认证
已开通阿里云账号,并完善个人信息。
创建终端用户
创建 Hermes Agent
-
前往Agent 管理中心。
-
单击创建云端 Hermes Agent。
-
根据业务需求选择套餐版本:
套餐版本
积分额度
入门版
200 积分/月
标准版
1600 积分/月
高级版
4000 积分/月
-
选择购买数量、购买时长,以及是否开启自动续费。
-
单击立即购买,确认订购并完成支付。
为 Hermes Agent 配置模型
Hermes Agent 套餐包已预置模型,购买后即可直接使用。如套餐内月度积分使用完,需添加模型共享积分包的模型,按以下步骤操作。
创建模型分组
-
在 Hermes Agent 页面单击模型配置标签页。
-
单击创建模型分组,输入模型分组名称并完成创建。
添加模型
-
选择已创建的模型分组,单击添加模型。
说明每个模型分组下最多添加50个模型。
-
单击添加模型,在面板中选择模型接入方式。支持以下三种方式:
-
无影模型:提供多款主流大模型,高性价比。支持千问 Max、千问 Plus、千问 Coder、千问 Flash、DeepSeek、Kimi、GLM、MiniMax 等模型。
-
无影套餐包模型:消耗套餐中的积分,无需额外购买。
-
无影积分包模型:需要额外订阅无影共享积分包。
-
-
模型广场:接入阿里云百炼等模型服务供应商。
-
自定义模型配置:添加已有大模型接入点,支持 OpenAI API 和 Anthropic API 兼容模式。
各供应商的详细配置步骤,参见配置自定义模型。
-
-
(可选)选择一个模型,并单击卡片上设为默认模型按钮。
说明如果未设置默认模型,系统将以第一个添加的模型作为默认模型。
将 Hermes Agent 授权/分配给用户
-
在 Hermes Agent 页面,找到目标 Hermes Agent,单击操作列的更多 > 查看/添加用户。
-
在查看/添加用户面板中,单击添加用户,搜索并选择目标用户,完成添加。
一个 Hermes Agent 仅支持添加一个用户。如需更换用户,需要先移除当前用户后再添加新用户。
接入钉钉并与机器人聊天
Hermes Agent 支持接入 IM 平台,实现通过聊天向 Hermes Agent 下发指令。以下以钉钉为例,更多接入方式请参考更多频道接入。
-
前往Agent 管理中心。
-
单击通道配置。
-
单击目标 Agent 操作列中的查看/配置通道。
-
在钉钉卡片上,单击立即配置。
在弹出的页面,选择以下任一方式完成机器人接入:
极速配对
-
要求云电脑镜像版本满足:Linux 3.0.10 及以上。如需更新,可重启云电脑。
-
单击立即发送。系统会向授权用户下发包含访问链接的短信或邮件。
-
授权用户通过短信或邮件中的 URL 访问绑定页面获取二维码(您也可在控制台直接获取该 URL)。
-
使用钉钉扫描二维码,完成机器人绑定。
-
在钉钉中与机器人对话,验证连接成功。
如已绑定其他机器人,扫码后将被替换。
关联已有机器人
创建钉钉应用
您所在的钉钉组织需具备开发者权限。如所在组织暂无该权限,请参见获取开发者权限。如果没有合适的组织,可使用移动端钉钉扫描下方二维码,快速创建一个组织。
-
登录钉钉开放平台开发者后台。
-
在顶部导航栏单击应用开发,在应用开发页面单击立即创建,可一键创建 OpenClaw 机器人应用。
-
在创建 OpenClaw 页面,填写机器人名称、简介和图标等基本信息;如无特殊要求,也可保持默认配置,然后单击确定完成创建。
-
创建成功后,页面会自动展示该应用的 Client ID 和 Client Secret,请及时复制并妥善保存,后续在 Agent 管理中心配置钉钉通道时需要使用。
说明Client ID 与 Client Secret 是访问应用数据的核心凭证,请妥善保管,切勿泄露给他人。
填写凭证完成关联
-
回到 Agent 管理中心,输入钉钉应用的 Client ID 和 Client Secret,然后单击确认。
-
在钉钉中与机器人对话,验证连接成功。
与钉钉机器人聊天
-
打开钉钉,在顶部搜索框中输入创建的钉钉应用名称。
-
在搜索结果的功能栏目中单击该机器人,进入聊天对话。
-
输入问题或指令,与钉钉机器人聊天。
常见问题
购买 Hermes Agent 后,在无影客户端中找不到入口
Hermes Agent 当前不支持通过无影客户端直接使用,仅支持通过第三方通道接入。您可以将 Hermes Agent 接入钉钉等 IM 平台后,通过聊天方式与其交互。具体接入方式请参见更多频道接入。
添加模型时提示 API Key 无效或验证失败
-
前往阿里云百炼控制台的密钥管理页面,重新复制完整的 API Key(以
sk-开头),避免缺少前缀或末尾字符。 -
检查 API Key 状态,确认未被禁用或过期。如已过期,单击创建新的 API Key。
-
确认阿里云百炼账户余额充足,如有欠费请先充值。
通道配置后,钉钉机器人无响应或提示认证失败
前往钉钉开放平台,在凭证与基础信息中重新核对 Client ID 和 Client Secret,确保与通道配置中填写的一致。
与 Hermes Agent 聊天时提示模型调用异常或无回复
-
在模型配置标签页中确认模型分组已创建,并至少包含一个可用模型。
-
如使用手动添加的模型,确认 API Key 正确且对应的模型服务正常运行。可尝试在阿里云百炼控制台直接测试该 API Key。
-
在 Hermes Agent 页面查看积分用量详情,确认套餐包积分是否充足。如积分不足,请升级套餐版本或购买额外积分。
后续步骤
更多频道接入
配置自定义模型
通过模型广场或自定义模型配置添加自有模型。
百炼按量付费
在 Agent 管理中心,单击添加模型。
选择模型广场 > 阿里云百炼。
根据 API Key 所属的地域,在Base URL下拉菜单中选择:
华北2(北京):
https://dashscope.aliyuncs.com/compatible-mode/v1新加坡:
https://dashscope-intl.aliyuncs.com/compatible-mode/v1美国(弗吉尼亚):
https://dashscope-us.aliyuncs.com/compatible-mode/v1
填入 API Key。
百炼 Token Plan
前往Token Plan 团队版购买页面,选择坐席类型和数量,完成订阅。
API Key:在Token Plan 团队版页面复制专属 API Key。
在 Agent 管理中心,单击添加模型。
选择模型广场 > 百炼Token Plan。
参考下表选择兼容模式与对应的 Base URL:
兼容模式
Base URL
OpenAI 兼容
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1Anthropic 兼容
https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic填入 API Key。
阿里云百炼 Token Plan 支持的模型,请参见Token Plan(团队版)概述。
百炼 Coding Plan
订阅阿里云百炼 Coding Plan,生成并保存 API Key。
在 Agent 管理中心,单击添加模型。
选择自定义模型配置。
参考下表选择兼容模式与对应的 Base URL:
兼容模式
Base URL
OpenAI 兼容
https://coding-intl.dashscope.aliyuncs.com/v1Anthropic 兼容
https://coding-intl.dashscope.aliyuncs.com/apps/anthropic填入 API Key。
阿里云百炼 Coding Plan 支持的模型,请参见Coding Plan概述。
其他提供商
模型广场提供硅基流动、月之暗面、MiniMax、智谱 AI 等多家提供商,可直接在模型广场中选择并配置。如需使用的提供商不在模型广场中,可通过自定义模型配置接入。按以下步骤配置自定义模型:
从对应供应商处获取 Base URL 和 API Key。
在 Agent 管理中心,单击添加模型。
选择自定义模型配置。
自行填写模型厂商名称和模型厂商ID。
选择兼容模式(OpenAI 或 Anthropic),填入获取的 Base URL 和 API Key。