Hermes Remote Deploy 是一个通过 SSH 在远程 Linux/macOS 服务器上快速部署 Hermes Agent 的技能。Hermes Agent 是 Nous Research 出品的自进化 AI Agent，内置学习循环、多平台网关、技能系统。它不是绑在 IDE 里的编程副驾驶，也不是单个 API 的聊天壳，而是一个运行在服务器上的自主 Agent，记住所学，越用越强。支持 Docker / SSH / Modal / Daytona / Vercel Sandbox 等多种终端后端，通过 Telegram / Discord / Slack / WhatsApp / Signal 等多平台接入。
适用场景：当用户要求在远程服务器上部署 Hermes Agent、远程搭建 Hermes 运行环境、或配置 Hermes 模型提供商和 API Key 时使用。
前提条件：控制端已通过 ssh-copy-id 将公钥添加到目标机器；目标机器为 Linux (Ubuntu/Debian/CentOS) 或 macOS，SSH 服务已开启；目标机器已安装 curl、git；持有至少一个模型提供商的 API Key（如 DeepSeek / OpenAI / Anthropic / OpenRouter 等）；目标机器可访问 GitHub（github.com）和 PyPI（pypi.org）。安装脚本会自动安装 Python 3.11、Node.js 22、uv、ripgrep、ffmpeg 等全部依赖，无需手动预装。
自动部署工作流共 5 步，由 scripts/deploy.sh 完成：1) 连通性检查，验证 SSH 可达并检测目标系统类型；2) 安装 Hermes，执行 curl 一键安装脚本并自动处理所有依赖；3) 配置模型，用 hermes config set 配置 Provider 和 API Key；4) 配置身份，可选部署 SOUL.md 和 AGENTS.md；5) 验证，运行 hermes doctor 诊断与 hermes --version。
使用方式：执行 bash scripts/deploy.sh user@host <provider> <api-key>。例如 DeepSeek：bash scripts/deploy.sh daniel@my-vps-01 deepseek sk-2312xxxx；OpenAI：bash scripts/deploy.sh daniel@my-vps-01 openai sk-proj-xxxx --model openai/gpt-4o；Anthropic：bash scripts/deploy.sh daniel@192.168.1.100 anthropic sk-ant-xxxx；OpenRouter（支持 200+ 模型）：bash scripts/deploy.sh daniel@my-vps-01 openrouter sk-or-v1-xxxx --model openrouter/anthropic/claude-sonnet-4；预览模式：bash scripts/deploy.sh daniel@my-vps-01 deepseek sk-xxxx --dry-run；跳过 Gateway 配置（纯 CLI 模式）：bash scripts/deploy.sh daniel@my-vps-01 deepseek sk-xxxx --skip-gateway。
参数说明：user@host 必填，SSH 目标，如 root@my-vps 或 user@192.168.1.100；<provider> 必填，Provider 名称：deepseek / openai / anthropic / openrouter / nous；<api-key> 必填，对应 Provider 的 API Key；--model 可选，默认 Provider 默认模型，指定模型 ID（如 deepseek/deepseek-v4-pro）；--skip-gateway 可选，默认 false，跳过 Gateway 配置仅部署 CLI；--soul-path 可选，本地 SOUL.md 路径，部署到远程；--branch 可选，默认 main，Hermes 安装分支；--dry-run 可选，默认 false，仅打印命令不实际执行。Provider 默认模型对应关系：deepseek 默认 deepseek/deepseek-v4-pro，环境变量 DEEPSEEK_API_KEY；openai 默认 openai/gpt-4o，环境变量 OPENAI_API_KEY；anthropic 默认 anthropic/claude-sonnet-4，环境变量 ANTHROPIC_API_KEY；openrouter 默认 openrouter/anthropic/claude-sonnet-4，环境变量 OPENROUTER_API_KEY；nous 默认 nous/hermes-3-70b，环境变量 NOUS_API_KEY。
手动分步执行：若自动脚本不适用，可按以下步骤操作。Step 1 连接目标机器：ssh user@target-host，验证 echo SSH_OK && uname -a。Step 2 安装 Hermes：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash；或指定分支 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --branch main；安装完成后重载 Shell：source ~/.bashrc 或 source ~/.zshrc，然后 hermes --version。国内网络提示：如果 GitHub 访问慢，可先设置代理 export https_proxy=http://proxy:port，或在有代理的机器上下载后 scp 传输。Step 3 配置模型 Provider：hermes config set model deepseek/deepseek-v4-pro；hermes config set DEEPSEEK_API_KEY sk-xxxx；查看当前配置 hermes config。Step 4 运行交互式设置（可选但推荐）：hermes setup，向导会引导完成模型提供商选择、工具启用/禁用、Gateway 平台连接（Telegram / Discord / Slack 等）、记忆系统偏好。Step 5 配置身份和上下文文件（可选）：部署 SOUL.md（Agent 人格）到 ~/.hermes/SOUL.md，部署 MEMORY.md（跨会话记忆）到 ~/.hermes/memories/MEMORY.md。Step 6 启动和验证：hermes doctor 诊断检查、hermes 启动 CLI 聊天、hermes gateway setup 首次配置 Gateway、hermes gateway start 启动 Gateway。
从 OpenClaw 迁移：如果目标机器已有 OpenClaw，Hermes 支持一键迁移。hermes claw migrate（交互式迁移，自动检测 ~/.openclaw）；hermes claw migrate --dry-run（预览模式）；hermes claw migrate --preset user-data（仅迁移用户数据，不含密钥）。迁移内容包括：SOUL.md、MEMORY.md、USER.md、Skills、API Keys。
部署后检查清单：hermes --version 输出版本号；hermes doctor 无严重报错；hermes config 显示正确的模型配置；可正常启动 CLI 对话 hermes；（可选）Gateway 平台连接正常；（可选）SOUL.md / MEMORY.md 内容正确。
故障排查：SSH 连接失败时，检查连通性 ssh -v user@host，确认目标机器 SSH 服务已开（Linux: systemctl status sshd；macOS: 系统设置 → 通用 → 共享 → 远程登录），确认公钥已复制 ssh-copy-id user@host。安装脚本下载失败时，国内网络可尝试 export https_proxy=http://your-proxy:port 后重新执行，或手动克隆 git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent，进入目录后 uv sync --extra all。hermes 命令找不到时，重载 shell 配置 source ~/.bashrc 或 source ~/.zshrc，检查 PATH：echo $PATH | grep hermes，或手动添加 export PATH="$HOME/.hermes/hermes-agent/.venv/bin:$PATH"。模型 API 调用失败时，检查 API Key 配置 hermes config | grep -i key，测试连接 hermes doctor，手动设置 API Key hermes config set DEEPSEEK_API_KEY sk-xxxx，或直接编辑 .env：vim ~/.hermes/.env。国内环境特殊处理：设置 uv 镜像 export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple；设置 npm 镜像 export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com；或在安装脚本前设置，例如 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | env UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple bash。
部署后目录结构：~/.hermes/ 下包含 config.yaml（主配置文件）、.env（API Keys 和密钥）、auth.json（OAuth 凭证）、SOUL.md（Agent 人格定义）、memories/（跨会话记忆，含 MEMORY.md 和 USER.md）、skills/（Agent 自创技能）、cron/（定时任务）、sessions/（Gateway 会话）、logs/（日志）。
与 OpenClaw 部署的对比：语言栈方面 Hermes 为 Python 3.11 + Node.js 22，OpenClaw 为 Node.js；包管理方面 Hermes 为 uv (Python) + npm (Node)，OpenClaw 为 npm；安装方式方面 Hermes 为 curl pipe bash，OpenClaw 为 npm install -g；配置方式方面 Hermes 为 hermes config set，OpenClaw 为 openclaw config set；配置目录方面 Hermes 为 ~/.hermes/，OpenClaw 为 ~/.openclaw/；Gateway 方面两者均内置；终端后端方面 Hermes 支持 7 种（local/docker/ssh/modal/daytona/vercel/singularity），OpenClaw 为 local；学习循环方面 Hermes 内置技能系统 + 记忆系统，OpenClaw 为 Skills 系统；迁移支持方面 Hermes 提供 hermes claw migrate，OpenClaw 暂无。