配置文件命令参考
> 📖 本文档翻译自 Hermes Agent 官方文档 > 最后更新：2026-04-16
配置文件命令参考
本页面涵盖所有与 Hermes 配置文件 相关的命令。通用 CLI 命令请参见 CLI 命令参考。
hermes profile
hermes profile <子命令>
管理配置文件的顶级命令。不带子命令运行 hermes profile 会显示帮助。
| 子命令 | 说明 |
|---|---|
list | 列出所有配置文件。 |
use | 设置活跃（默认）配置文件。 |
create | 创建新配置文件。 |
delete | 删除配置文件。 |
show | 显示配置文件详情。 |
alias | 重新生成配置文件的 Shell 别名。 |
rename | 重命名配置文件。 |
export | 将配置文件导出为 tar.gz 归档。 |
import | 从 tar.gz 归档导入配置文件。 |
hermes profile list
hermes profile list
列出所有配置文件。当前活跃的配置文件用 * 标记。
示例：
$ hermes profile list default
- work dev personal
无选项。
hermes profile use
hermes profile use <名称>
将 <名称> 设置为活跃配置文件。所有后续 hermes 命令（不带 -p）将使用此配置文件。
| 参数 | 说明 |
|---|---|
<名称> | 要激活的配置文件名称。使用 default 返回基础配置文件。 |
示例：
hermes profile use work hermes profile use default
hermes profile create
hermes profile create <名称> [选项]
创建新配置文件。
| 参数 / 选项 | 说明 |
|---|---|
<名称> | 新配置文件的名称。必须是有效的目录名（字母数字、连字符、下划线）。 |
--clone | 从当前配置文件复制 config.yaml、.env 和 SOUL.md。 |
--clone-all | 从当前配置文件复制所有内容（配置、记忆、技能、会话、状态）。 |
--clone-from <配置文件> | 从指定配置文件而非当前配置文件克隆。与 --clone 或 --clone-all 一起使用。 |
--no-alias | 跳过包装脚本创建。 |
示例：
空白配置文件——需要完整设置
hermes profile create mybot
仅从当前配置文件克隆配置
hermes profile create work --clone
从当前配置文件克隆所有内容
hermes profile create backup --clone-all
从指定配置文件克隆配置
hermes profile create work2 --clone --clone-from work
hermes profile delete
hermes profile delete <名称> [选项]
删除配置文件并移除其 Shell 别名。
| 参数 / 选项 | 说明 |
|---|---|
<名称> | 要删除的配置文件。 |
--yes、-y | 跳过确认提示。 |
示例：
hermes profile delete mybot hermes profile delete mybot --yes
⚠️ 警告
此操作会永久删除配置文件的整个目录，包括所有配置、记忆、会话和技能。不能删除当前活跃的配置文件。
hermes profile show
hermes profile show <名称>
显示配置文件的详情，包括主目录、配置的模型、网关状态、技能数量和配置文件状态。
| 参数 | 说明 |
|---|---|
<名称> | 要查看的配置文件。 |
示例：
$ hermes profile show work Profile: work Path: ~/.hermes/profiles/work Model: anthropic/claude-sonnet-4 (anthropic) Gateway: stopped Skills: 12 .env: exists SOUL.md: exists Alias: ~/.local/bin/work
hermes profile alias
hermes profile alias <名称> [选项]
重新生成 ~/.local/bin/<名称> 处的 Shell 别名脚本。如果别名被意外删除或在移动 Hermes 安装后需要更新，此命令很有用。
| 参数 / 选项 | 说明 |
|---|---|
<名称> | 要创建/更新别名的配置文件。 |
--remove | 移除包装脚本而非创建。 |
--name <别名> | 自定义别名名称（默认：配置文件名称）。 |
示例：
hermes profile alias work
创建/更新 ~/.local/bin/work
hermes profile alias work --name mywork
创建 ~/.local/bin/mywork
hermes profile alias work --remove
移除包装脚本
hermes profile rename
hermes profile rename <旧名称> <新名称>
重命名配置文件。更新目录和 Shell 别名。
| 参数 | 说明 |
|---|---|
<旧名称> | 当前配置文件名称。 |
<新名称> | 新配置文件名称。 |
示例：
hermes profile rename mybot assistant
~/.hermes/profiles/mybot → ~/.hermes/profiles/assistant
~/.local/bin/mybot → ~/.local/bin/assistant
hermes profile export
hermes profile export <名称> [选项]
将配置文件导出为压缩的 tar.gz 归档。
| 参数 / 选项 | 说明 |
|---|---|
<名称> | 要导出的配置文件。 |
-o、--output <路径> | 输出文件路径（默认：<名称>.tar.gz）。 |
示例：
hermes profile export work
在当前目录创建 work.tar.gz
hermes profile export work -o ./work-2026-03-29.tar.gz
hermes profile import
hermes profile import <归档> [选项]
从 tar.gz 归档导入配置文件。
| 参数 / 选项 | 说明 |
|---|---|
<归档> | 要导入的 tar.gz 归档路径。 |
--name <名称> | 导入配置文件的名称（默认：从归档推断）。 |
示例：
hermes profile import ./work-2026-03-29.tar.gz
从归档推断配置文件名称
hermes profile import ./work-2026-03-29.tar.gz --name work-restored
hermes -p / hermes --profile
hermes -p <名称> <命令> [选项] hermes --profile <名称> <命令> [选项]
全局标志，在指定配置文件下运行任何 Hermes 命令而不更改粘性默认值。这在命令执行期间覆盖活跃配置文件。
| 选项 | 说明 |
|---|---|
-p <名称>、--profile <名称> | 此命令使用的配置文件。 |
示例：
hermes -p work chat -q "Check the server status" hermes --profile dev gateway start hermes -p personal skills list hermes -p work config edit
hermes completion
hermes completion <shell>
生成 Shell 补全脚本。包含配置文件名称和配置文件子命令的补全。
| 参数 | 说明 |
|---|---|
<shell> | 要生成补全的 Shell：bash 或 zsh。 |
示例：
安装补全
hermes completion bash >> ~/.bashrc hermes completion zsh >> ~/.zshrc
重新加载 Shell
source ~/.bashrc
安装后，Tab 补全可用于：
hermes profile <TAB>——子命令（list、use、create 等）hermes profile use <TAB>——配置文件名称hermes -p <TAB>——配置文件名称