Profiles：运行多个 Agent

在同一台机器上运行多个独立的 Hermes agent——每个 agent 拥有各自的配置、API 密钥、记忆、会话、技能和 gateway 状态。

什么是 profile？

profile 是一个独立的 Hermes 主目录。每个 profile 拥有自己的目录，其中包含各自的 config.yaml、.env、SOUL.md、记忆、会话、技能、cron 任务和状态数据库。profile 让你可以为不同用途运行独立的 agent——编程助手、个人机器人、研究 agent——而不会混淆 Hermes 状态。

创建 profile 后，它会自动成为独立的命令。创建名为 coder 的 profile，你立即就拥有了 coder chat、coder setup、coder gateway start 等命令。

快速开始

就这些。coder 现在是拥有独立配置、记忆和状态的 Hermes profile。

创建 profile

空白 profile

创建一个预置了内置技能的全新 profile。运行 mybot setup 配置 API 密钥、模型和 gateway token。

如果你计划将此 profile 用作 kanban（看板）工作节点（或希望 kanban 编排器将任务路由到它），在创建时传入 --description "<角色>" 以便编排器了解其能力：

你也可以稍后通过 hermes profile describe 设置或自动生成描述——完整路由模型请参阅 Kanban 指南。

仅克隆配置（`--clone`）

将当前 profile 的 config.yaml、.env 和 SOUL.md 复制到新 profile。API 密钥和模型相同，但会话和记忆是全新的。编辑 ~/.hermes/profiles/work/.env 可使用不同的 API 密钥，编辑 ~/.hermes/profiles/work/SOUL.md 可设置不同的人格。

克隆全部内容（`--clone-all`）

复制所有内容——配置、API 密钥、人格、所有记忆、完整会话历史、技能、cron 任务、插件。完整快照。适用于备份或 fork 已有上下文的 agent。

从指定 profile 克隆

:::tip Honcho 记忆 + profiles
启用 Honcho 后，--clone 会自动为新 profile 创建专属 AI 对等体，同时共享同一用户工作区。每个 profile 构建各自的观察记录和身份标识。详见 Honcho——多 agent / Profiles。
:::

使用 profile

命令别名

每个 profile 在 ~/.local/bin/<name> 自动获得一个命令别名：

别名支持所有 hermes 子命令——底层实际上是 hermes -p <name>。

`-p` 标志

你也可以通过任意命令显式指定 profile：

粘性默认值（`hermes profile use`）

设置默认值后，普通 hermes 命令将指向该 profile。类似于 kubectl config use-context。

了解当前所在 profile

CLI 始终显示当前活跃的 profile：

提示符：显示 coder ❯ 而非 ❯

启动横幅：启动时显示 Profile: coder

hermes profile：显示当前 profile 名称、路径、模型、gateway 状态

Profile vs 工作区 vs 沙箱

profile 常与工作区或沙箱混淆，但它们是不同的概念：

profile 为 Hermes 提供独立的状态目录：config.yaml、.env、SOUL.md、会话、记忆、日志、cron 任务和 gateway 状态。

工作区或工作目录是终端命令的起始位置，由 terminal.cwd 单独控制。

沙箱用于限制文件系统访问。profile 不对 agent 进行沙箱隔离。

在默认的 local 终端后端，agent 仍拥有与你的用户账户相同的文件系统访问权限。profile 不会阻止其访问 profile 目录之外的文件夹。

如果你希望 profile 默认在特定项目文件夹中启动，请在该 profile 的 config.yaml 中设置绝对路径的 terminal.cwd：

在 local 后端使用 cwd: "." 表示"Hermes 启动时所在的目录"，而非"profile 目录"。

另请注意：

SOUL.md 可以引导模型，但不能强制限定工作区边界。

SOUL.md 的更改在新会话中会生效。现有会话可能仍在使用旧的 prompt（提示词）状态。

询问模型"你在哪个目录？"并不是可靠的隔离测试。如果你需要工具有可预测的起始目录，请显式设置 terminal.cwd。

运行 gateway

每个 profile 以独立进程运行各自的 gateway，使用各自的 bot token：

不同的 bot token

每个 profile 有各自的 .env 文件。在各文件中配置不同的 Telegram/Discord/Slack bot token：

安全性：token 锁

如果两个 profile 意外使用了相同的 bot token，第二个 gateway 将被阻止并显示明确的错误信息，指出冲突的 profile。支持 Telegram、Discord、Slack、WhatsApp 和 Signal。

持久化服务

每个 profile 拥有独立的服务名称，各自独立运行。

在官方 Docker 镜像中

各 profile 的 gateway 由 s6-overlay（容器中的 PID 1）监管，因此 hermes profile create <name> 会自动在 /run/service/gateway-<name>/ 注册 s6 服务槽。hermes -p <name> gateway start/stop/restart 会调度到 s6-svc 而非直接启动裸进程——崩溃后自动重启，docker restart 会保留之前运行的 gateway 集合。详见各 profile gateway 监管。

配置 profile

每个 profile 拥有各自的：

config.yaml — 模型、提供商、工具集及所有设置

.env — API 密钥、bot token

SOUL.md — 人格与指令

如果你希望此 profile 默认在特定项目中工作，还需设置其 terminal.cwd：

更新

hermes update 拉取一次代码（共享），并自动将新的内置技能同步到所有 profile：

用户修改过的技能不会被覆盖。

管理 profile

删除 profile

此操作将停止 gateway、移除 systemd/launchd 服务、移除命令别名并删除所有 profile 数据。系统会要求你输入 profile 名称以确认。

使用 --yes 跳过确认：hermes profile delete coder --yes

备注

你无法删除默认 profile（~/.hermes）。如需删除所有内容，请使用 hermes uninstall。

Tab 补全

将该行添加到 ~/.bashrc 或 ~/.zshrc 以启用持久补全。支持补全 -p 后的 profile 名称、profile 子命令及顶级命令。

工作原理

profile 使用 HERMES_HOME 环境变量。运行 coder chat 时，包装脚本在启动 hermes 前将 HERMES_HOME 设置为 ~/.hermes/profiles/coder。由于代码库中 119+ 个文件通过 get_hermes_home() 解析路径，Hermes 状态会自动限定在 profile 目录范围内——包括配置、会话、记忆、技能、状态数据库、gateway PID、日志和 cron 任务。

这与终端工作目录是分开的。工具执行从 terminal.cwd 开始（或在 local 后端使用 cwd: "." 时从启动目录开始），而非自动从 HERMES_HOME 开始。

默认 profile 就是 ~/.hermes 本身。无需迁移——现有安装的工作方式完全不变。

将 profile 作为发行版共享

你在一台机器上构建的 profile 可以打包为 git 仓库，并通过一条命令安装到另一台机器——你自己的工作站、团队成员的笔记本，或社区用户的环境。共享包包含 SOUL、配置、技能、cron 任务和 MCP 连接。凭据、记忆和会话保持各机器独立。

完整指南请参阅 Profile 发行版：共享完整 Agent——包括编写、发布、更新语义、安全模型和使用场景。

未命名文档

Profiles：运行多个 Agent#

什么是 profile？#

快速开始#

创建 profile#

空白 profile#

仅克隆配置（--clone）#

克隆全部内容（--clone-all）#

从指定 profile 克隆#

使用 profile#

命令别名#

-p 标志#

粘性默认值（hermes profile use）#

了解当前所在 profile#

Profile vs 工作区 vs 沙箱#

运行 gateway#

不同的 bot token#

安全性：token 锁#

持久化服务#

配置 profile#

更新#

管理 profile#

删除 profile#

Tab 补全#

工作原理#

将 profile 作为发行版共享#