Hermes Agent 安装配置指南

在多平台环境下部署和配置 AI Agent，常面临操作系统兼容性差异、交互入口管理复杂以及从旧系统迁移数据的麻烦。Hermes Agent 的安装配置指南旨在系统化解决这些问题，提供清晰的路径来完成从环境准备到功能验证的全过程。

核心能力与关键步骤

该技能的核心是提供一套结构化的部署与迁移方案：

• 跨系统兼容：明确区分 Linux/macOS 与 Windows 的安装路径，支持 Git Bash、WSL 和 PowerShell 等多种方式，确保环境一致性。
• 双模交互入口：集成 CLI（命令行界面） 和 消息网关（Gateway）。CLI 用于本地快速调试，网关则对接 Telegram、Discord、Slack 等主流消息平台，实现无缝对话。
• 统一命令管理：设计了一套跨入口的命令体系（如 /model、/personality），用户可在终端或聊天窗口中执行相同操作，降低学习成本。
• 无缝数据迁移：针对从 OpenClaw 迁移的用户，提供了自动检测与导入机制，可一键转移设置、记忆、技能和 API 密钥，避免重复配置。

关键步骤围绕“确认”与“选择”展开：安装前需核对默认路径（如 ~/.hermes/hermes-agent）和 Python 版本；随后根据环境选择命令行部署（基于 uv 和虚拟环境）或 Docker 部署。迁移过程则在 hermes setup 向导中自动触发。

适用边界与注意事项

该指南主要服务于 Hermes Agent 的初始安装与特定场景迁移，使用时需注意：

• 硬性依赖：命令行部署强制要求 Python 3.11 及以上版本；Docker 方式则需提前安装 Docker 引擎。
• 配置隔离：所有配置与日志默认存放于 ~/.hermes 目录，卸载时可选择保留配置，便于升级或重装。
• 平台特定配置：消息网关的设置（hermes gateway setup）可能因平台而异（如 WhatsApp 需要额外验证），需参考对应文档。
• 迁移局限性：自动迁移功能仅针对 OpenClaw 设计。从其他系统迁移时，需手动处理 API 密钥和技能列表。

总而言之，该技能通过标准化的检查清单和分步骤指导，降低了部署复杂度，但用户仍需根据自身环境做好前置准备。