Hermes Agent Profiles：多实例配置教程
Hermes Agent Profiles：多实例配置教程
一、什么是 Profiles（多配置）
你是否希望工作助手和个人助手"各过各的"，互不干扰？或者在同一个机器上同时运行飞书、钉钉、Telegram 三个机器人，彼此数据完全隔离？Profiles（配置文件） 就是 Hermes Agent 为此设计的核心隔离能力，允许在同一台机器上运行 多个完全独立的 Agent 实例，每个实例拥有专属配置、密钥、记忆、会话与技能，互不干扰。
简单来说：一个 Profile = 一个独立的 AI 助手，可分别用于工作、个人、开发、客户等不同场景，数据与权限完全隔离。
1.1 Profile 隔离核心
每个 Profile 对应独立目录（默认路径 ~/.hermes/profiles/[配置名]），包含：
独立配置：
config.yaml（模型、工具、网关设置）独立密钥：
.env（API Key、机器人令牌）独立会话：
state.db（SQLite 会话数据库）独立技能：
skills/（自动 / 手动技能）
图1：Profile 隔离概念图
1.2 核心价值
✅ 场景隔离：工作 / 个人 / 开发分开，数据不混淆
✅ 多机器人：同时运行飞书、钉钉、Telegram 独立机器人
✅ 权限隔离：不同 Profile 使用不同 API 密钥，避免权限泄露
✅ 快速切换：一键切换不同角色 / 场景，无需重新配置
了解了隔离原理与核心价值，接下来动手创建你的第一个 Profile。
二、快速上手：创建与使用 Profile
2.1 创建 Profile（3 种模式）
（1）空白 Profile（全新环境）
# 创建名为 "work" 的空白配置
hermes profile create work生成独立目录，默认配置，后续通过 work setup 配置模型与密钥。
（2）克隆配置（复用默认设置）
# 克隆默认 Profile 的配置/密钥，记忆/会话全新
hermes profile create personal --clone复用 config.yaml 与 .env，适合快速创建同模型、不同场景的 Profile。
（3）完整克隆（备份 / 复制实例）
# 克隆默认 Profile 的所有数据（配置+记忆+会话+技能）
hermes profile create backup --clone-all完整复制实例，适合备份或复制已有上下文的 Agent。
图2：Profile 创建流程
2.2 切换 Profile（3 种方式）
（1）临时切换（单次命令）
# 使用 "work" Profile 执行命令
hermes -p work chat
hermes --profile personal model（2）设为默认（全局生效）
# 设 "work" 为默认 Profile
hermes profile use work
# 后续命令默认使用 work
hermes chat
hermes gateway start（3）别名快捷切换（推荐）
创建别名后直接用简称操作：
# 为 work 创建别名 "w"
hermes profile alias work w
# 使用别名
w chat
w gateway start2.3 验证 Profile 状态
# 查看当前 Profile
hermes profile
# 列出所有 Profile
hermes profile list
# 查看 Profile 详情（配置/记忆/会话）
hermes profile show work掌握了创建和切换方法，日常使用中还需要对 Profile 进行各种管理操作。
三、核心操作：管理 Profile
3.1 列出与查看
# 列出所有 Profile（名称/别名/会话数/最后使用）
hermes profile list
# 查看 Profile 详细配置
hermes profile show work3.2 重命名与别名
# 重命名 Profile
hermes profile rename work dev-team
# 设置/修改别名
hermes profile alias dev-team dt3.3 导出与导入（备份 / 迁移）
（1）导出 Profile
# 导出 work 为压缩包（含配置+记忆+会话）
hermes profile export work --output ~/backup/work.tar.gz（2）导入 Profile
# 导入备份包（恢复实例）
hermes profile import ~/backup/work.tar.gz3.4 删除 Profile
# 删除指定 Profile（需确认）
hermes profile delete work
# 强制删除（无需确认）
hermes profile delete work --yes⚠️ 无法删除默认 Profile（~/.hermes）。
命令管理掌握之后，来看看几个真实场景下的多实例配置方案。
四、场景化配置：多实例实战
4.1 场景 1：工作 vs 个人隔离
- 工作 Profile：使用企业模型，接入公司飞书，存储工作记忆
hermes profile create work
work setup # 配置智谱/DeepSeek 企业密钥
work gateway setup # 接入公司飞书- 个人 Profile：使用个人模型，接入私人微信，存储生活记忆
hermes profile create personal --clone
personal setup # 配置 Kimi 个人密钥
personal gateway setup # 接入个人微信4.2 场景 2：多机器人并行
同时运行飞书、钉钉、Telegram 独立机器人，互不冲突：
# 飞书机器人
hermes profile create feishu
feishu gateway setup
# 钉钉机器人
hermes profile create ding
ding gateway setup
# Telegram 机器人
hermes profile create tg
tg gateway setup4.3 场景 3：开发 vs 生产
- 开发 Profile：本地模型（Ollama），调试工具，测试记忆
hermes profile create dev
dev config set model ollama/llama3- 生产 Profile：云端模型，正式网关，生产记忆
hermes profile create prod
prod config set model anthropic/claude-sonnet场景化配置展示了 Profile 的灵活运用，接下来深入看看每个 Profile 的配置文件细节。
五、Profile 配置详解
每个 Profile 拥有独立配置文件，可单独修改：
5.1 核心配置文件
配置：
~/.hermes/profiles/work/config.yaml密钥：
~/.hermes/profiles/work/.env个性：
~/.hermes/profiles/work/SOUL.md
5.2 常用配置修改
# 修改 work 的模型
work config set model deepseek/deepseek-chat
# 修改 work 的终端后端（Docker 沙箱）
work config set terminal.backend docker
# 编辑 work 的个性描述
echo "你是专业的开发助手" > ~/.hermes/profiles/work/SOUL.md5.3 网关独立配置
每个 Profile 可配置独立网关令牌，避免冲突：
# 编辑 work 的飞书密钥
nano ~/.hermes/profiles/work/.env
# 写入：FEISHU_APP_ID=xxx配置详解让你可以精细调整每个 Profile，最后总结一些最佳实践和注意事项。
六、最佳实践与注意事项
6.1 最佳实践
按场景命名：
work/personal/dev，清晰易识别合理克隆：同模型场景用
--clone，备份用--clone-all别名快捷化：为常用 Profile 设置短别名，提升效率
定期备份：重要 Profile 定期导出，防止数据丢失
权限隔离：不同场景使用不同 API 密钥，降低泄露风险
6.2 注意事项
完全隔离：Profile 间配置、记忆、会话互不共享
网关独立：每个 Profile 网关为独立进程，令牌不冲突
默认保护：默认 Profile 无法删除，避免误操作
更新同步：
hermes update会同步所有 Profile 的技能
七、总结
Profiles 是 Hermes Agent 的多实例核心能力，通过环境隔离实现场景化 AI 助手，兼顾数据安全与使用灵活性。无论是工作 / 个人隔离、多机器人并行，还是开发 / 生产分离，Profiles 都能一键创建、快速切换，让一个机器同时运行多个专属 AI 助手。
下一步可结合网关配置、技能定制，为每个 Profile 打造专属能力，充分释放多实例价值。