需执行标准导入导出操作：一、全量导出用hermes backup create --full；二、按模块导出支持skills/memories/sessions/gateways；三、导入用hermes backup restore；四、CLI手动导出config.yaml/.env/SOUL.md等；五、单文件覆盖后执行hermes config reload。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在不同环境间同步 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。
