如何进行Hermes Agent的数据导入与导出操作？

本文共计1113个文字，预计阅读时间需要5分钟。

如果您需要在不同的环境中同步Hermes Agent的个性化配置与运行状态，或为系统升级、迁移、备份做准备，则需要执行以下标准的数据导入导出操作：

一、导出 Hermes Agent 全量数据

导出操作用于生成可移植的压缩包，包含全部用户级配置、记忆、技能、会话历史及网关设置，确保跨环境还原一致性。所有导出内容均以结构化目录形式组织，便于校验与选择性恢复。

1、确认 Hermes Agent 当前处于停止状态，执行：hermes stop。

2、进入 Hermes Agent 主安装目录，通常为 /opt/hermes-agent 或 ~/hermes-agent。

3、执行全量备份命令，生成带时间戳的归档文件：hermes backup create --full。

4、查看输出路径，例如：backups/hermes-backup-20260419-113245.tar.gz，该文件即为完整导出包。

二、导出指定模块数据

当仅需迁移部分功能组件（如仅技能或仅记忆）时，可避免冗余数据传输，提升效率并降低安全风险。此方式支持按需粒度控制，适用于灰度迁移或权限隔离场景。

1、导出全部已安装技能：hermes backup create --only skills。

2、导出长期记忆（memories 目录）：hermes backup create --only memories。

3、导出对话会话历史（sessions 目录）：hermes backup create --only sessions。

4、导出网关配置与渠道绑定信息：hermes backup create --only gateways。

三、导入 Hermes Agent 数据

导入操作将校验归档包完整性与版本兼容性，在目标环境中重建对应数据结构，并自动处理路径映射与权限初始化，无需手动解压或修改文件属主。

1、将导出的 .tar.gz 文件复制至目标服务器 Hermes Agent 安装目录下。

2、执行导入命令，系统将自动识别包内模块并覆盖写入：hermes backup restore backups/hermes-backup-20260419-113245.tar.gz。

3、若仅导入技能子集，添加 --only skills 参数限定范围。

4、导入完成后，Hermes Agent 不会自动启动，需手动执行：hermes start。

四、使用 CLI 手动导出配置文件

对于轻量级配置同步（如仅迁移模型密钥、渠道参数等文本配置），可绕过归档机制，直接提取关键文件进行人工比对与部署，适用于 DevOps 流水线中的配置即代码（GitOps）实践。

1、导出当前生效的主配置文件：hermes config export > config.yaml。

2、导出环境变量配置（含 API Key）：hermes env export > .env。

3、导出人格设定文件：hermes personality export > SOUL.md。

4、导出已注册的消息网关列表：hermes gateway list --export > channel_directory.json。

五、导入单个配置文件

当仅需更新某一项配置（如更换模型 API Key 或调整人格设定）而不想触发全量恢复时，可采用文件级覆盖方式，操作后需重启服务使变更生效。

1、将本地编辑好的 config.yaml 复制到目标机 /opt/hermes-agent/conf/ 目录下。

2、覆盖环境变量文件：cp .env /opt/hermes-agent/.env。

3、替换人格设定：cp SOUL.md /opt/hermes-agent/SOUL.md。

4、执行重载命令使新配置立即生效：hermes config reload。