hermes agent支持四种账号切换方式:一、修改.env文件并重启服务;二、编辑config.yaml中model/provider字段后执行hermes reload;三、通过hermes dashboard网页端keys页面图形化管理;四、利用hermes_env_file环境变量启动独立会话实现软切换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用 Hermes Agent 时需要在不同用户身份或 API 凭据之间切换,则可能是由于当前会话绑定的密钥、环境变量或配置文件未更新所致。以下是实现账号切换的具体操作步骤:
一、通过 .env 文件切换 API 账号凭证
该方法适用于更换模型服务提供商(如从 OpenAI 切换至阿里云百炼)或同一平台下的不同账户密钥。Hermes Agent 从 .env 文件读取 API Key 等认证信息,修改此文件即可完成账号级切换。
1、打开终端,进入 Hermes Agent 安装目录或项目根目录。
2、执行命令 nano .env 或使用其他编辑器打开该文件。
3、定位到类似 OPENAI_API_KEY=sk-xxx 或 DASHSCOPE_API_KEY=xxx 的行。
4、将等号右侧的旧密钥替换为新账号对应的 API Key。
5、保存并退出编辑器(nano 中按 Ctrl+O 回车保存,Ctrl+X 退出)。
6、重启 Hermes Agent 进程以加载新凭证:执行 hermes stop 后再运行 hermes start。
二、通过 config.yaml 切换默认模型与账号上下文
该方法用于在多模型接入场景下切换默认调用账户,例如为通义千问和百炼分别配置独立密钥,并设定某账号为当前会话默认模型源。配置项位于 config.yaml 中的 model 和 provider 字段。
1、在终端中执行 hermes config edit 打开配置文件。
2、找到 model: 区块,确认其值是否为待切换账号所关联的模型标识,例如 qwen-max 或 bailian-qwen-plus。
3、检查 provider: 字段是否匹配目标账号所属服务商,如 dashscope、bailian 或 openai。
4、若需为特定 provider 指定独立密钥路径,可设置 api_key_path: 指向另一个 .env 文件。
5、保存配置后,运行 hermes reload 使变更生效。
三、通过 hermes dashboard 网页界面切换 KEYS 管理项
该方法提供图形化方式管理多个 API 账号密钥,支持快速启用/禁用、编辑与测试连接状态,适用于频繁切换测试环境的用户。网页端 KEYS 页面直接映射至 .env 文件内容。
1、确保 Hermes Agent 已启动,执行 hermes dashboard 命令。
2、浏览器自动打开 http://127.0.0.1:9119,点击顶部导航栏的 KEYS 选项卡。
3、在密钥列表中找到目标账号条目,点击右侧 Edit 按钮。
4、修改 API Key、Base URL 或 Provider Name 字段内容。
5、勾选 Enable this key 并取消其他账号的启用状态。
6、点击 Save Changes,系统将自动重写 .env 文件并提示成功。
四、通过多会话隔离实现账号软切换
该方法不修改全局配置,而是利用 Hermes Agent 的会话隔离机制,在 CLI 中启动独立命名会话,每个会话可加载不同环境变量文件,从而实现账号逻辑分离。
1、为新账号创建专用环境文件,例如命名为 .env-account-b,其中包含新 API Key。
2、在终端中执行 HERMES_ENV_FILE=.env-account-b hermes chat --session my-session-b。
3、新会话将仅读取指定 .env 文件,不影响主配置或其他会话。
4、后续所有对该会话的操作(如发送消息、调用技能)均使用该账号凭证。
5、可通过 hermes session list 查看当前活跃会话及其绑定环境。











