主流 Agent 之「OpenClaw」与「Hermes-Agent」介绍

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 时效提示 |
| 本文所有版本号、价格、渠道数量、功能清单均以 2026 年 9 月 14 日当日抓取的官方站点、官方文档站、GitHub Releases 与 npm Registry 为准。开源 Agent 领域迭代极快，版本号按「年.月.序号」滚动发布，两个项目均保持每周多次发布节奏。请在实际操作前用文末「附录 C：自助核对清单」复核关键版本号与价格。文中标注「补充修正」的条目，均为本次核对中发现与常见网络说法不一致之处。 |

摘要

OpenClaw 与 Hermes Agent 是当前开源自托管 AI Agent 赛道中关注度最高的两个项目（GitHub 星标分别约 38.9 万与 24.5 万），二者都免费、都开源（MIT）、都能自托管、都能通过聊天软件远程指挥，但设计重心截然不同：

• OpenClaw 的定位是「多通道网关 + 可信控制平面」。它把聊天渠道接入、凭证、配置、审计全部收敛到一个 Gateway 进程，把代码执行外移到沙箱、配对节点或一次性云机器。它追求的是「可控、可审计、企业级可验证」。
• Hermes Agent 的定位是「会自我成长的自治体」。它把重心放在闭环学习------跨会话持久记忆、自动从经验中生成技能、技能在使用中自我改进、可调度自动化、可派生子 Agent。它追求的是「越用越聪明、随时随地可用」。

一句话选型：要治理与审计选 OpenClaw，要学习与自动化选 Hermes Agent 。二者并非互斥，官方都提供了双向迁移与记忆导入通道。

01第一章 为什么是这两款：定位速览

本章先用三句话建立两个项目的第一印象，再用一组可核对的关键事实速览把它们摆进同一张表，最后说明为什么二者并非直接竞品。

1.1 三句话认识它们

|--------------|---------------------------|----------------------------------------------------------------------------|------------------------------------------|
| 项目 | 一句话定义 | 官方自述 | 主导方 |
| OpenClaw | 任意操作系统上的多通道 AI Agent 网关中台 | 「 The AI that really does things. Any OS. Any Platform. The lobster way. 」 | OpenClaw Foundation （美国 501(c)(3) 非营利组织） |
| Hermes Agent | 带内置学习闭环的自我进化型 Agent | 「 The agent that grows with you 」 | Nous Research （开源大模型实验室） |

1.2 关键事实速览（2026-09-14 实测）

|------------|----------------------------------------------------------|-------------------------------------------------------|
| 维度 | OpenClaw | Hermes Agent |
| 开源协议 | MIT | MIT |
| GitHub 仓库 | openclaw/openclaw | NousResearch/hermes-agent |
| 仓库创建时间 | 2025-11-24 | 2025-07-22 |
| GitHub 星标数 | 约 389,745 | 约 245,724 |
| Fork 数 | 约 81,928 | 约 51,239 |
| 最新稳定版 | 2026.9.4 （ 2026-09-11 发布） | v2026.9.14 （ 2026-09-14 发布） |
| 保守版本通道 | extended-stable = 2026.6.35 | 无独立保守通道，按 release tag 固定 |
| 主运行时 | Node.js （推荐 26 ， 新版本最低 24.16.0+ ） | Python 3.11 （ uv 管理） + Node.js v26 |
| 配置文件 | ~/.openclaw/openclaw.json （ JSON5 ） | ~/.hermes/config.yaml （ YAML ） |
| 默认入口端口 | 18789 （ Control UI ） | 无默认常驻端口，按 Profile / 网关配置 |
| 桌面应用 | macOS / Windows / Linux （含 Windows Hub 、 macOS 菜单栏 App ） | Hermes Desktop （ macOS / Windows / Linux ， Electron ） |
| 移动端 | iOS / Android 配对节点 | Android （ Termux ， Tier 2 尽力支持） |
| 软件费用 | 完全免费，无企业版 | 完全免费，订阅为可选项 |

1.3 两者并非直接竞品

需要澄清一个常见误解：二者虽然都被归为「开源 Agent」，但设计目标不在同一条轴上 。

OpenClaw 官方在架构说明中明确把 Hermes Agent 作为对照对象引用，指出 Hermes 的安全文档主张「对抗性 LLM 的唯一安全边界是操作系统」，而 OpenClaw 的差异化在于能把「可信 Gateway」与「不可信执行」分离 ------即把策略以代码形式强制执行，而非依赖模型自律。同时 OpenClaw 也坦承：其沙箱与 exec 审批默认关闭 ，默认形态是「单操作员的个人助手」。

Hermes Agent 则在官方迁移文档中提供 hermes claw migrate，支持从 OpenClaw 一键导入；OpenClaw 的 Control UI 也内置了 Memory Import，支持导入 Hermes 的记忆文件。二者在实践中常被同一批用户并行使用。

02第二章 OpenClaw 详解

本章按「产品定位 → 官方链接 → 安装配置 → 界面功能 → 使用教程 → 费用 → 技巧 → 场景」的顺序展开。

2.1 产品定位与治理背景

OpenClaw 是一个自托管的网关（Gateway） ，运行在你自己的机器或服务器上，把 Discord、Telegram、WhatsApp、Slack、Signal、iMessage、Microsoft Teams、飞书、QQ 等聊天渠道与 AI 编码 Agent 连接起来。你发一条消息，就得到一个能真正动手干活的 Agent 回应。

治理结构 ：由 OpenClaw Foundation 管理，该基金会是一家独立的非营利组织，使命是「让 AI 变得个人化、有趣且有赋能感」。基金会与 30 多家捐赠方和合作伙伴协作，其中包括 Atlassian、GitHub、Microsoft、NVIDIA、OpenAI、Tencent，并设有全职团队，以基金会自身身份签署发布。

关键承诺 ：整个 OpenClaw 产品以 MIT 许可发布，不存在使用其他许可证的企业版 。这一点的实际含义是：个人版与企业版的功能差异仅来自配置，而非付费墙。

补一条历史线索（供辨真伪） ：OpenClaw 的官方「起源故事」页面完整记录了这条更名链------项目最早叫 Warelay （一个 WhatsApp 网关），随后是 Clawd / Clawdbot ；2026 年 1 月 27 日因 Anthropic 商标沟通（"Clawd" 与 "Claude" 过于接近）第一次更名，龙虾"蜕壳"（molt）为 Molty / Moltbot ；该名字"念起来总不顺口"，于是 2026 年 1 月 30 日 GMT 凌晨 4 点，团队在三小时内完成 The Great OpenClaw Migration ，最终定名 OpenClaw 。官方原话是「Clawd → Moltbot → OpenClaw，龙虾已蜕壳成最终形态」。

Hermes Agent 的官方迁移文档在描述数据来源时写作「OpenClaw (or legacy Clawdbot/Moltbot)」，并会自动检测 ~/.clawdbot/ 与 ~/.moltbot/ 历史目录、兼容历史配置文件名。当前官网与文档只使用 OpenClaw 这一名称 ；若遇到以 Clawdbot / Moltbot / Clawd / Molty 为名兜售软件或建站的，应视为非官方。

提示：拼写提示 ：正确写法是 Moltbot （molt，龙虾蜕壳），不是 "Moldbot"（mold，霉菌）。这一拼写错误在网络二手资料中相当常见，也是识别低质量转载的一个简易信号。

2.2 官方链接全集

以下为本次核对确认的官方地址，均为纯文本完整链接。

核心入口

|--------------|-------------------------------------------------------------------------------------------------------------------------|
| 用途 | 完整链接 |
| 主站 | https://openclaw.ai |
| 官方文档 | https://docs.openclaw.ai |
| GitHub 主仓库 | https://github.com/openclaw/openclaw |
| GitHub 发布页 | https://github.com/openclaw/openclaw/releases |
| GitHub Issue | https://github.com/openclaw/openclaw/issues |
| 基金会官网 | https://www.openclaw.org/ |
| 插件与技能注册中心 | https://clawhub.ai |
| npm 包 | https://www.npmjs.com/package/openclaw |

安装脚本

|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|
| 平台 | 完整链接 |
| macOS / Linux / WSL2 安装脚本 | https://openclaw.ai/install.sh |
| Windows PowerShell 安装脚本 | https://openclaw.ai/install.ps1 |
| 本地前缀安装脚本 | https://openclaw.ai/install-cli.sh |
| Windows Hub 发布页 | https://github.com/openclaw/openclaw-windows-node/releases/latest |

文档站主要分站

|----------------------|--------------------------------------------------------------------------------------------------------------------------|
| 主题 | 完整链接 |
| 快速开始 | https://docs.openclaw.ai/start/getting-started |
| 架构说明（ Why OpenClaw ） | https://docs.openclaw.ai/start/why-openclaw |
| 引导向导 | https://docs.openclaw.ai/start/wizard |
| 团队部署 | https://docs.openclaw.ai/start/teams |
| 安装总览 | https://docs.openclaw.ai/install |
| 更新与通道 | https://docs.openclaw.ai/install/updating |
| 卸载 | https://docs.openclaw.ai/install/uninstall |
| 备份与恢复 | https://docs.openclaw.ai/install/backups |
| Docker 部署 | https://docs.openclaw.ai/install/docker |
| Kubernetes 部署 | https://docs.openclaw.ai/install/kubernetes |
| Nix 安装 | https://docs.openclaw.ai/install/nix |
| VPS 选型 | https://docs.openclaw.ai/vps |
| 渠道总览 | https://docs.openclaw.ai/channels |
| 模型服务商目录 | https://docs.openclaw.ai/providers |
| 能力（工具）总览 | https://docs.openclaw.ai/tools |
| 插件机制 | https://docs.openclaw.ai/tools/plugin |
| 子 Agent | https://docs.openclaw.ai/tools/subagents |
| 自动化（ cron ） | https://docs.openclaw.ai/automation |
| ClawHub 注册中心 | https://docs.openclaw.ai/clawhub |
| Control UI 控制台 | https://docs.openclaw.ai/web/control-ui |
| 移动端节点 | https://docs.openclaw.ai/nodes |
| macOS 平台页 | https://docs.openclaw.ai/platforms/macos |
| Windows 平台页 | https://docs.openclaw.ai/platforms/windows |
| Linux 平台页 | https://docs.openclaw.ai/platforms/linux |
| Gateway 配置 | https://docs.openclaw.ai/gateway/configuration |
| 安全指南 | https://docs.openclaw.ai/gateway/security |
| 故障排查 | https://docs.openclaw.ai/help/troubleshooting |
| CLI 参考 | https://docs.openclaw.ai/cli |
| 项目致谢与许可 | https://docs.openclaw.ai/reference/credits |

2.3 安装与配置（当前最稳定版）

本节按「系统要求 → 安装路径 → 首次配置 → 验证 → 版本通道」的顺序逐步推进。

2.3.1 版本核对结论

|----------------------------------------|-----------------------------------------------------|--------------------------------------------------------------|
| 项目 | 数值 | 来源与核对时间 |
| npm latest dist-tag | 2026.9.4 | npm Registry ，发布时间 2026-09-11T02:44:59Z |
| GitHub 最新 Release | v2026.9.4 | GitHub Releases ， 2026-09-11 发布（非预发布） |
| npm extended-stable dist-tag | 2026.6.35 | npm Registry （保守轨道， 2026-09-10 发布） |
| npm beta dist-tag | 2026.9.4 | npm Registry （ 2026-09-14 复检： beta 已与 latest 同步指向 2026.9.4 ） |
| npm 协议声明 | MIT | npm Registry license 字段 |
| Node 引擎约束（ stable 2026.9.3+ ） | >=24.16.0 <25 || >=26.1.0 | npm engines 字段， 已收紧：不再支持 Node 22 与 Node 25 |
| Node 引擎约束（ stable 2026.9.2 及更早） | >=22.22.3 <23 || >=24.15.0 <25 || >=25.9.0 | npm engines 字段，历史值（供回退参考） |
| Node 引擎约束（ extended-stable 2026.6.35 ） | >=22.19.0 | npm engines 字段， 保守轨道未同步收紧------Node 22 环境可暂留此轨道 |

提示：补充修正（重要） ：OpenClaw 官网首页的桌面版下载直链在不同平台之间版本可能不一致 。2026-09-14 实测：macOS 为 v2026.9.4 （OpenClaw-2026.9.4.zip）、Linux 的 AppImage 与 deb 已同步为 v2026.9.4 、Windows 仍为 v2026.9.1 （OpenClawCompanion-Setup-x64.exe / -arm64.exe）；同期 npm latest 与 GitHub 最新 Release 为 2026.9.4 。当前仅 Windows 落后，但各平台按钮并不同步发布，点击首页按钮拿到的安装包并不保证是最新版 。以 npm latest / GitHub Releases 为准 。

2.3.2 系统要求

• Node.js ：自 2026.9.3 起，引擎约束收紧为 >=24.16.0 <25 || >=26.1.0 ------Node 22 与 Node 25 不再受支持 ；2026.9.2 及更早版本仍接受 22.22.3+ / 24.15+ / 25.9+。官方推荐 Node 26 。若你当前停留在 Node 22，需先升级 Node 再升级 OpenClaw。安装脚本在 Node 缺失时，会在 macOS 上配置 Node 26、在 Linux 上配置 Node 24 LTS。

• 操作系统 ：macOS、Linux、Windows（含 WSL2）。macOS 桌面版要求 macOS 15+，提供 Universal Binary。

• AI 访问凭据 ：一个模型服务商 API Key，或一个已登录的 Claude Code / Codex CLI 账号（引导时可复用）。

• pnpm ：仅从源码构建时需要。

  |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
  | ⚠ 破坏性变更 |
  | 破坏性变更（2026.9.3 起） ：OpenClaw 的 stable 轨道引擎约束已收紧为 >=24.16.0 <25 || >=26.1.0，不再支持 Node 22 与 Node 25 。若本机 Node 低于 24.16，升级到 2026.9.3+ 会因引擎校验失败而中断。两条可行路径：① 先把 Node 升到 24.16+ 或 26.1+（推荐 26）；② 留在未同步收紧 的 extended-stable 轨道（2026.6.35，其 engines 仍为 >=22.19.0）。 |

2.3.3 推荐安装路径

路径 A：官方安装脚本（最省事）

|--------------------------------------------------------------------------|
| 终端命令 |
| # macOS / Linux / WSL2 curl -fsSL https://openclaw.ai/install.sh | bash |
| Windows PowerShell |
| # Windows（PowerShell） iwr -useb https://openclaw.ai/install.ps1 | iex |

脚本会自动检测操作系统、按需安装 Node、安装 OpenClaw 并启动引导向导。若不想立即引导，追加 --no-onboard：

|----------------------------------------------------------------------|
| 终端命令 |
| curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard |

路径 B：包管理器（适合自己管理 Node 的用户）

|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| # npm 12 或 npm 11.16+ npm install -g openclaw@latest --allow-scripts=openclaw openclaw onboard --install-daemon # npm 11.15 及更早：去掉 --allow-scripts=openclaw |

注意： ⚠️ 注意：npm 12 默认阻止未批准的生命周期脚本。--allow-scripts=openclaw 显式允许 OpenClaw 的 preinstall / postinstall；不加的话 npm 会报 blocked because they are not covered by allowScripts。npm 11.16 接受该参数但只告警；npm 11.15 及更早既无该策略也无该参数，命令必须不带参数。npm 11.16 提示的 npm approve-scripts openclaw 对全局安装无效（会报 ENOMATCH）。

|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| # pnpm（需显式批准构建脚本） pnpm add -g --allow-build=openclaw openclaw@latest openclaw onboard --install-daemon # bun（--trust 允许生命周期脚本；Bun 1.4+ 可运行 CLI 与 Gateway） bun add -g --trust openclaw@latest bun run --bun openclaw onboard --install-daemon --daemon-runtime bun |

路径 C：桌面应用（不想碰命令行）

• macOS：从 GitHub Releases 下载 OpenClaw-<version>.dmg（首选）或 .zip，安装并启动 OpenClaw.app。
• Windows：下载 OpenClawCompanion-Setup-x64.exe 或 OpenClawCompanion-Setup-arm64.exe，即 Windows Hub 伴侣应用，含设置、托盘状态、聊天与节点模式。
• Linux：提供 AppImage 与 .deb 两种格式。

路径 D：从源码（贡献者）

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| git clone https://github.com/openclaw/openclaw.git cd openclaw corepack enable pnpm install && pnpm build && pnpm ui:build pnpm add --global "openclaw@link:$PWD" openclaw onboard --install-daemon |

2.3.4 首次配置（Onboarding）

引导有两种模式：

1. Quick start（推荐） ：OpenClaw 会检测已有的 Claude Code / Codex CLI 登录态或 API Key，用一次真实 completion 验证通过后保存配置并打开 Web 控制台。

2. Custom setup ：逐步走完全部选项，适合需要自定义 Provider、渠道、沙箱的场景。

   |-----------------------------------------------------------------------------------|
   | 终端命令 |
   | # 以后台守护方式安装 Gateway openclaw onboard --install-daemon # 以后再补配置 openclaw configure |

默认配置下：私聊共享 Agent 主会话，每个群聊拥有独立会话 。若要收紧权限，官方建议从 channels.whatsapp.allowFrom 与群聊 mention 规则开始：

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 配置文件（JSON5） |
| { channels: { whatsapp: { allowFrom: "+15555550123", groups: { "*": { requireMention: true } }, }, }, messages: { groupChat: { mentionPatterns: "@openclaw" } }, } |

2.3.5 安装完成后必做的三步验证

|-----------------------------------------------------------------------------------------------------------|
| 终端命令 |
| openclaw --version # 确认 CLI 可用 openclaw doctor # 检查配置问题 openclaw gateway status # 应显示 Gateway 监听 18789 端口 |

打开控制台：

|--------------------------------------------------------------------|
| 终端命令 |
| openclaw dashboard # 浏览器打开 Control UI，本地默认 http://127.0.0.1:18789/ |

装完出问题时的杀手锏：

|-----------------|
| 终端命令 |
| openclaw triage |

它会跑只读健康检查，生成一份脱敏的诊断描述，并询问是否交给本机检测到的编码 Agent（Claude Code / Codex CLI / OpenClaw 内置 Agent）。在用户选择 Agent 之前，任何数据都不会离开本机 ；密钥、Token、原始聊天负载与原始日志均被排除。

2.3.6 版本通道与固定版本（生产环境必读）

OpenClaw 有四个发布通道：

|-----------------|--------------|---------------------------------------------------------|
| 通道 | 安装形态 | 行为 |
| stable （默认） | 包安装 | 经过内置延迟 + 抖动后宣布更新活动 |
| beta | 包安装 | 有新版即宣布；优先 npm beta tag ，缺失则回退 stable |
| dev | Git checkout | 每小时检查，跟随 GitHub main |
| extended-stable | 仅包安装 | 只给只读更新提示， 永不自动应用 ；失败即关闭（ fail closed ），绝不回退到 latest |
| 终端命令 |||
| # 查看当前通道与可用更新 openclaw update status --json # 切换通道（建议先 --dry-run 预览） openclaw update --channel extended-stable --dry-run openclaw update --channel extended-stable # 固定到某个已知良好版本（首选方式） npm view openclaw versions --json openclaw update --tag 2026.9.4 --dry-run openclaw update --tag 2026.9.4 # 若当前通道是 extended-stable，回滚必须写成： openclaw update --channel stable --tag 2026.9.4 |||

更新前务必先建备份 ：

|-------------------------------------------------------------------------------------------|
| 终端命令 |
| mkdir -p ~/Backups/openclaw openclaw backup create --output ~/Backups/openclaw --verify |

提示： 归档可能包含凭据、auth profiles 与渠道状态，务必以仅所有者可访问的权限保存。

选型建议 ：个人日常使用跟踪 stable（即 2026.9.4）；团队 / 生产环境建议 extended-stable（当前指向 2026.6.35）并配合 openclaw security audit --deep 做配置漂移告警。

2.4 界面功能与设置

OpenClaw 的主界面是 Control UI ------一个由 Gateway 提供服务的 Vite + Lit 单页应用，默认地址 http://127.0.0.1:18789/。

2.4.1 侧边栏与主工作区

• 身份行 ：显示当前活动 Agent（头像 / emoji、名称、环境 pill、未读圆点），点击可切换多 Agent、新建 Agent、进入 Agent 设置。
• Pages 区 ：Home（Agent 主会话）、固定目的地（默认固定 Automations 与 Plugins，可自定义，Usage 也能固定）。
• 会话列表 ：分 Other / Groups / Coding 三大分区，另有 Custom groups（按 category）与 Pinned。全局工具栏支持按 Created / Last updated / Owners 过滤与排序，按 Custom groups / Project / Person / None 分组，以及 Active / Archived / All 三态过滤。
• 多行操作 ：Alt/Option-click 与 Shift-click 多选后可批量标记已读未读、移动分组、归档、删除。
• 快捷键 ：⌘B / Ctrl+B 折叠侧边栏，⌘K / Ctrl+K 命令面板。

2.4.2 主要页面

|-----------------------------|--------------------------------------------------------------------------------------------------|
| 页面 | 作用 |
| Home | Agent 主会话；可从 footer 以 dock 形式与当前页面并排打开 |
| Ask OpenClaw | 系统设置与修复代理，机器级单会话，可停靠右侧或底部 |
| Automations | cron 作业管理，含运行历史、 Run now 、内联编辑（ prompt / 频率 / 高级覆盖）、三种投递模式 |
| Plugins | 四个标签： Installed （含 MCP 服务器内联管理）、 Discover （ ClawHub 搜索）、 Skills （按 Agent 作用域）、 Workshop （技能提案审查） |
| Sessions | 会话线程列表，含 Worktrees 标签；可按会话覆盖 model / thinking / fast / verbose / trace / reasoning |
| Tasks | 后台任务账本，可取消、可查看 transcript 与输出 |
| Agents | Agent 身份、 Files 、 Tools 、 Skills 、 Channels 、 Automations 、 Memory 七个子标签 |
| Usage | 会话衍生 token 与估算成本分析，可按 provider / model / channel / tool 过滤 |
| MCP | MCP 服务器清单，支持 Streamable HTTP / SSE / stdio ，可增删启用禁用 |
| Devices | 配对设备清单、节点目录、实时在线状态、资源仪表 |
| Approvals | 近 30 天已裁决的 exec / plugin / system-agent 请求历史 |
| Activity / Logs / Debug | 会话活动、日志实时 tail 、系统繁忙度浮层、手动 RPC 调用 |

2.4.3 设置结构

Settings 侧边栏的分组为：

1. 顶部 ：Ask OpenClaw、Profile、Appearance、Notifications
2. Connections ：Connection、Channels、Communications、Talk、Devices
3. Agents & Tools ：Agents、Labs、Models、MCP、Memory、Automation
4. Privacy & Security ：Security、Secrets、Approvals
5. System ：Infrastructure、Advanced、Debug、Logs、About

外观可选项 ：内置 11 套主题（Claw 为默认，另有 Knot、Dash、Absolutely、Tide、Beacon、Phosphor、CRT、Manuscript、Rosé、Miami），每套自带自托管字体；Beacon 主题以 WCAG AAA（7:1）对比度为目标；Manuscript 是唯一以亮色为主的衬线主题。界面字体与聊天正文字体可分别设置，代码恒为等宽。界面语言支持 21 种 locale ，含 zh-CN 与 zh-TW。

权限作用域（Scopes） ：分为 operator.read、operator.write、operator.admin 三大类及更细的 pairing / approvals / questions / talk 作用域。安装或移除插件代码、改动 MCP 服务器、管理 Secrets、Import Memory 等均需 operator.admin。

2.5 使用教程

以下五步可在 30 分钟内跑通一个可用的 OpenClaw 实例，每一步都给出命令与预期结果。

Step 1：五分钟跑通第一个 Agent

|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| # 安装（macOS / Linux） curl -fsSL https://openclaw.ai/install.sh | bash # 引导：选 Quick start openclaw onboard --install-daemon # 打开控制台并发送第一条消息 openclaw dashboard |

预期结果 ：浏览器打开 http://127.0.0.1:18789/，在聊天框输入内容后能收到 AI 回复，即表示安装成功。

Step 2：接上手机（Telegram 最快）

官方明确：Telegram 是最快的渠道 ------只需要一个 bot token，且插件已内置（bundled），无需额外安装。

|------------------------------------------------------------------|
| 终端命令 |
| openclaw channels add telegram # 按提示填入从 @BotFather 获取的 bot token |

其它渠道分三类（另有 1 个电话类通信插件单独列出，不计入渠道数）：

• 核心 / 内置插件 ：WebChat（核心）、Telegram、A2A、Reef
• 官方插件（一条命令安装） ：Discord、飞书、Google Chat、iMessage、IRC、LINE、Matrix、Mattermost、Microsoft Teams、Nextcloud Talk、Nostr、QQ 机器人、Raft、Signal、Slack、SMS（Twilio）、Synology Chat、Tlon、Twitch、WhatsApp、Zalo、Zalo 个人号、Buzz、ClickClack
• 外部插件 ：微信、企业微信、元宝、Zalo ClawBot
• 相关通信插件（电话，非消息渠道） ：Voice Call，经 Plivo / Telnyx / Twilio 提供电话能力

提示： 官方渠道目录当前共列出 32 个渠道入口 = 核心内置 4 个（WebChat、Telegram、A2A、Reef）+ 官方插件 24 个 + 外部插件 4 个。安装官方插件的命令形如 openclaw plugins install @openclaw/<id>，安装后需要重启 Gateway 。另有 1 个电话类通信插件（Voice Call）单独列出，不计入渠道数。

Step 3：换模型

OpenClaw 官方 Provider 目录列出 67 个模型服务商 ，覆盖 Anthropic、OpenAI、Google Gemini、DeepSeek、Moonshot（Kimi）、智谱 GLM、MiniMax、月之暗面、阿里云百炼、腾讯（TokenHub / TokenPlan）、火山引擎（豆包）、小米、xAI、Groq、Mistral、Cohere、OpenRouter、LiteLLM、GitHub Copilot、NVIDIA、Together AI、Hugging Face、Cerebras、Fireworks、Perplexity 等云端厂商，同时原生支持 llama.cpp、LM Studio、Ollama（含 Ollama Cloud）、vLLM、SGLang、ds4、inferrs 等本地模型后端。

|--------------------------------------------------------------------------------------------------------------|
| 配置文件（JSON5） |
| // ~/.openclaw/openclaw.json { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } }, } |

Step 4：装技能与插件

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| openclaw skills search "calendar" openclaw skills install @openclaw/demo openclaw skills update --all openclaw plugins search "calendar" openclaw plugins install clawhub:<package> openclaw plugins update --all |

需要发布自己的技能 / 插件时，用独立的 ClawHub CLI：

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| npm i -g clawhub clawhub login clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 clawhub package publish your-org/your-plugin --dry-run |

Step 5：建自动化

Automations 页面可创建 cron 作业，三种投递模式：

• internal-only （默认）：隔离任务，仅内部可见
• announce ：公告到指定渠道（需显式目标）
• webhook ：delivery.mode = "webhook" 且 delivery.to 为有效 HTTP(S) URL，可用 cron.webhookToken 发送专用 bearer token

提示： 旧版 cron.webhook 已废弃，需运行 openclaw doctor --fix 迁移。

常用 CLI 速查

|--------------------------------------------------|---------------------|
| 命令 | 作用 |
| openclaw | 启动 TUI |
| openclaw dashboard | 打开 Web 控制台 |
| openclaw gateway status | 查看 Gateway 状态 |
| openclaw gateway install | 安装为后台服务 |
| openclaw gateway restart | 重启 Gateway |
| openclaw configure | 补跑配置 |
| openclaw doctor | 健康检查（ --fix 可修部分问题） |
| openclaw triage | 生成脱敏诊断并交接给编码 Agent |
| openclaw sandbox explain | 打印当前有效执行姿态 |
| openclaw security audit | 配置漂移审计（ --deep 深度） |
| openclaw secrets audit --check | 检查静态明文密钥 |
| openclaw memory forget | 清除可归因记忆条目 |
| openclaw backup create --output <dir> --verify | 创建已验证备份 |

2.6 费用

结论：OpenClaw 软件本身完全免费，且没有付费的企业版。

• 许可 ：整个产品以 MIT 发布，官方原话是「no enterprise edition under a different license」。
• 资金来源 ：OpenClaw Foundation（非营利组织）依靠捐赠方与合作伙伴支持，合作伙伴包括 Atlassian、GitHub、Microsoft、NVIDIA、OpenAI、Tencent 等 30 多家组织。
• 你的实际支出 ：自带凭据（BYO credentials） 模式。你向模型厂商直接按量付费，OpenClaw 不转售模型访问、不收取推理附加费。
• 凭证安全机制 ：所有凭证字段都支持 SecretRef（env / file / exec / 共享存储），exec 类型可对接 1Password、Vault、Bitwarden、sops。模型服务商凭证在支持的出口路径上使用 sentinel（哨兵值），真实值在出口边界才被替换，未识别的 sentinel 会被拒绝而非转发。
• 可选项 ：如需一次性云机器执行编码任务，可用 Cloud workers（在一次性云机器上跑，回连 Gateway，推理经 Gateway 代理，不持有常驻模型 / GitHub / 云凭证，每次调度铸造的凭证 TTL 为 10 分钟）。官方文档未在定价页明确其商业计费方式，实际云资源费用仍由你的云账号承担。

成本构成清单 ：

|-------------|--------|-------------------------------------------------|
| 成本项 | 谁收 | 说明 |
| OpenClaw 软件 | 无 | MIT ，免费 |
| 模型推理 | 模型厂商 | 按各厂商标准 token 计费 |
| 服务器 / VPS | 云厂商 | 可跑在树莓派到云端任意规格 |
| 渠道服务 | 各平台 | Telegram / Discord 等 bot 本身免费； Twilio SMS 等按量计费 |
| 可选工具服务 | 各工具商 | 联网搜索、图像生成、语音合成等按需自选 |

2.7 使用技巧

1. 先用 openclaw triage 再 Google 。它把当前安装状态转成可直接执行的诊断，并自动排除了密钥与原始日志，比人肉翻日志快得多。
2. 沙箱默认关闭，务必手动开启 。官方坦承默认形态是「受信任的单操作员助手」，exec 直接跑在 Gateway 主机上且不弹提示。加固最小集：

|-----------------------------------------------------------------------------------|
| 配置文件（JSON5） |
| { agents: { defaults: { sandbox: { mode: "all" } } }, // 后端用 openshell 或 docker } |

再用 openclaw sandbox explain 验证有效姿态，用 openclaw security audit --deep 建立漂移告警。

1. 不要把密钥写进配置文件 。用 SecretRef 走 env / file / exec，并在 CI 里跑 openclaw secrets audit --check。
2. 固定发布通道，别用浮动版本 。生产环境用 extended-stable，配合更新前备份。事故恢复期间设 OPENCLAW_NO_AUTO_UPDATE=1 防止自动更新器立刻把问题版本装回来。
3. 工具策略是「按名称过滤」而非「按副作用过滤」 。允许 exec 同时拒绝 write 不会 让 shell 命令变成只读------限制副作用是沙箱的职责，不是工具策略的职责。
4. 把 Prompt Cache 当钱看 。频繁切换模型、Provider 自动回退、凭证池轮转都会打断缓存前缀，下一轮要按全价重读整段对话。
5. 用 Talk 做实时语音 。OpenAI 走浏览器 WebRTC 或 Gateway 中继 WebSocket；Google Live 用受约束的一次性浏览器 Token。
6. 灰度用 beta 通道，但别订阅 。一次性的 beta 包用 --tag beta（保存通道仍是 stable）；--channel beta 才是长期订阅 beta。

2.8 典型使用场景

|----------------|-------------------------------------------------------------------|---------------------------------------------------------------|
| 场景 | 配置要点 | 为什么选 OpenClaw |
| 个人全能助理 | 一台常开机器 + Telegram / WhatsApp 渠道 + Automations | 一个 Gateway 同时服务所有渠道；手机发消息即可驱动 |
| 团队共享助手 | 团队部署 + gateway.roles + 每 Agent 独立会话 | 支持多用户会话、命名操作员角色、在线状态、群聊作为一等部署场景 |
| 企业合规试点 | 沙箱 mode: "all" + SecretRef + security audit --deep + OTel 导出 SIEM | 七项可验证的安全属性（分离信任边界、策略即代码、版本化状态、记录溯源、独立治理等）有据可查 |
| 移动端随身影院 | 配对 iOS / Android 节点 | 节点可提供相机、屏幕、语音能力； GPU 主机上还有 Cloud Worker Desktop 的 VNC 实时视图 |
| 多 Agent 编排 | Sub-agents / ACP agents / Agent send / Swarm | 支持隔离会话、按 Agent / 工作区 / 发送者路由、 Code Mode 与 Tool Search 压缩大工具目录 |
| 受控编码执行 | Cloud workers 或 Docker 沙箱 | 一次性云机器、 10 分钟 TTL 铸造凭证、 RPC 方法白名单、 transcript 只留在 Gateway |
| 桌面 + 移动双栖 | 桌面端（家中大屏操作） + 消息网关（外出手机指挥） | 见 2.10 节：同一会话跨入口无缝衔接，出门不用带电脑 |

2.9 桌面端详解（Desktop App）

OpenClaw 提供三种桌面端形态，与 CLI / 网关共用同一套 Gateway 与配置 ------桌面端只是同一 Agent 的图形外壳，不是独立产品。

|-------------|----------------------------------------------------|-------------------------------------------------------|
| 平台 | 安装包形态 | 安装命令 / 入口 |
| macOS | OpenClaw-<version>.dmg / .zip ， Universal Binary | 拖入 Applications → 双击启动；同时提供菜单栏 App |
| Windows | OpenClawCompanion-Setup-x64.exe / arm64.exe | 安装向导；运行后托盘常驻 |
| Linux | AppImage / .deb | AppImage 直接 chmod +x 运行； .deb 用 apt install ./xxx.deb |

官方下载入口 ：

• 主项目 GitHub Releases：https://github.com/openclaw/openclaw/releases
• Windows Hub 专属发布页：https://github.com/openclaw/openclaw-windows-node/releases/latest
• 桌面版安装包在上述 Release 的 Assets 区，与 CLI 版本号一致（如 v2026.9.4）

桌面端的核心职责 （不是独立产品）：

1. 启停 Gateway ：托盘/菜单栏一键启动、停止、重启 openclaw gateway；免去开终端输命令。
2. 实时状态 ：CPU / 内存 / 当前会话 / 最近一次 LLM 调用耗时 / 已连接渠道一览。
3. 对话窗口 ：嵌入一个轻量聊天面板，背后仍是 openclaw chat 同一套流式协议。
4. 节点模式（Node） ：在桌面端允许 OpenClaw Gateway 通过 openclaw nodes 拉起本地节点，获取本机摄像头、屏幕、麦克风、本地应用控制能力。
5. 配对与首次配置 ：通过桌面端的引导向导走 openclaw onboard，扫码配 WhatsApp 比手敲 CLI 更直观。

与 CLI / Web Control UI 的关系 ：三者始终共存 。Gateway 一启动，CLI（openclaw chat）、Control UI（浏览器 http://127.0.0.1:18789/）、桌面端、消息网关同时可用。桌面端关掉不会杀掉 Gateway，托盘的「Quit OpenClaw」才会。

macOS 注意事项 ：要求 macOS 15+ ，提供 Universal Binary （同时覆盖 Apple Silicon 与 Intel Mac）。若安装后系统提示「无法打开，因为来自身份不明的开发者」，到「系统设置 → 隐私与安全性」点「仍要打开」即可。

Windows 注意事项 ：托盘应用首次启动会请求「允许 OpenClaw 通过防火墙」，必须允许 ------否则 Gateway 监听 18789 端口后无法被本机浏览器外的其他入口发现。安装路径不要放到 Program Files，会触发 UAC 写入限制，建议 C:\Users\<you>\AppData\Local\Programs\OpenClaw\。

2.10 多入口并行与切换

OpenClaw 的设计哲学是「一个 Gateway，多个入口 」。生产部署完成后，下列入口同时可用、共享同一会话状态 ：

|----------------|----------------------------------------------------------|--------------------------|
| 入口 | 触发方式 | 适合场景 |
| CLI | openclaw chat | 自动化脚本、 CI 、 SSH 远程、容器内交互 |
| Control UI | 浏览器打开 http://127.0.0.1:18789/ | 大屏对话、查看历史会话与轨迹、调试插件 |
| 桌面端 | macOS / Windows / Linux 客户端 | 不熟命令行的用户、托盘状态总览、配对二维码 |
| 消息网关 | Telegram / Discord / WhatsApp / Slack / 飞书 / 企微 等 32 个渠道 | 手机端、群聊、跨网络远程指挥 |

关键事实 ：

• 同一份配置 ：所有入口读取 ~/.openclaw/openclaw.json，桌面端改完设置，CLI 立即生效。
• 同一会话存储 ：CLI 创建的会话 agentId，可在 Control UI 的会话列表里看到，反之亦然。
• 同一技能与插件库 ：通过 ClawHub 装的插件在所有入口都能调用。
• 入口切换无状态丢失 ：在 CLI 聊到一半，去 Telegram 发「继续刚才的话题」，Agent 会自动衔接当前会话上下文。

典型多入口组合 ：

|--------|-----------------------------------------------------------|
| 场景 | 推荐入口组合 |
| 家庭个人助理 | 桌面端（家中用） + Telegram （外出用） + CLI （脚本自动化） |
| 团队部署 | Control UI （管理员后台） + Telegram / 飞书 群（全员对话） + CLI （ CI 集成） |
| 移动办公 | iPhone 节点（让 Agent 拿相机 / 屏幕） + Telegram （语音指令） + 桌面端（家中查看） |
| 服务器场景 | CLI （主交互） + Telegram （手机紧急通知） |

路由与权限 ：

• 私聊与群聊走不同的会话空间。openclaw channels.<id>.accounts.<accountId>.route 可指定「哪个入口的会话归到哪个 Agent / 工作区」。
• 「入口级权限」可通过 gateway.roles 控制：管理员能用所有入口，普通操作员只能用 CLI 与 Telegram，不能打开 Control UI 改全局配置。

调试入口冲突 ：当某入口的回复明显落后或缺失，多半是 WebSocket 限流；用 openclaw gateway status 看每个入口的连接数与最近一次心跳。

03第三章 Hermes Agent 详解

本章沿用与第二章完全相同的结构，便于逐节对照阅读。

3.1 产品定位与背景

Hermes Agent 是 Nous Research 出品的自我进化型开源 Agent 。Nous Research 是 Hermes、Nomos、Psyche 等模型家族背后的实验室，这构成了 Hermes Agent 的一个差异化背景------它由做模型训练的人造的 。

它的核心卖点是闭环学习（closed learning loop） ：

1. Agent 自己策展记忆 ，并周期性自我提醒去沉淀知识；
2. 复杂任务后自动创建技能（Skill） ，技能在使用中自我改进；
3. FTS5 全文检索 + LLM 摘要 实现跨会话回忆；
4. Honcho 辩证式用户建模 ，跨会话建立关于「你是谁」的渐进模型。

它不绑定你的笔记本 ：可以跑在 5 美元的 VPS、GPU 集群，或 Daytona / Modal 这类闲置时几乎不花钱的 Serverless 基础设施上。你在 Telegram 上跟它说话，它在你从未 SSH 过的云虚拟机上干活。

模型层面完全中立：Nous Portal、OpenRouter、OpenAI、Anthropic、Google、自建端点、或本地 llama.cpp / MLX / vLLM 都行，用 hermes model 一条命令切换，无代码改动、无锁定。

3.2 官方链接全集

以下为本次核对确认的官方地址，均为纯文本完整链接。Hermes 的主站与文档同域（同为 hermes-agent.nousresearch.com），这一点可作为识别假冒站的依据。

核心入口

|------------------|---------------------------------------------------------------------------------------------------------------------------------|
| 用途 | 完整链接 |
| 主站 | https://hermes-agent.nousresearch.com/ |
| 官方文档 | https://hermes-agent.nousresearch.com/docs/ |
| GitHub 主仓库 | https://github.com/NousResearch/hermes-agent |
| GitHub 发布页 | https://github.com/NousResearch/hermes-agent/releases |
| GitHub Issue | https://github.com/NousResearch/hermes-agent/issues |
| Nous Research 官网 | https://nousresearch.com |
| Nous Portal | https://portal.nousresearch.com |
| 订阅管理 | https://portal.nousresearch.com/manage-subscription |
| 订阅产品页 | https://portal.nousresearch.com/products |
| Discord 社区 | https://discord.gg/NousResearch |
| 开放技能标准 | https://agentskills.io |
| 记忆建模（ Honcho ） | https://github.com/plastic-labs/honcho |

安装脚本与桌面端

|------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
| 用途 | 完整链接 |
| Linux / macOS / WSL2 / Termux 安装脚本 | https://hermes-agent.nousresearch.com/install.sh |
| Windows 原生安装脚本 | https://hermes-agent.nousresearch.com/install.ps1 |
| macOS 桌面端安装包 | https://hermes-assets.nousresearch.com/Hermes-Setup.dmg |
| Windows 桌面端安装包 | https://hermes-assets.nousresearch.com/Hermes-Setup.exe |
| OpenRouter （常用推理供应商） | https://openrouter.ai |
| 机器可读文档索引 | https://hermes-agent.nousresearch.com/docs/llms.txt |
| 全站文档合集（约 1.8 MB ） | https://hermes-agent.nousresearch.com/docs/llms-full.txt |

文档站主要分站

|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 主题 | 完整链接 |
| 安装指南 | https://hermes-agent.nousresearch.com/docs/getting-started/installation |
| 快速开始 | https://hermes-agent.nousresearch.com/docs/getting-started/quickstart |
| 学习路径 | https://hermes-agent.nousresearch.com/docs/getting-started/learning-path |
| 更新与卸载 | https://hermes-agent.nousresearch.com/docs/getting-started/updating |
| 平台支持矩阵 | https://hermes-agent.nousresearch.com/docs/getting-started/platform-support |
| Termux （ Android ） | https://hermes-agent.nousresearch.com/docs/getting-started/termux |
| Nix 与 NixOS | https://hermes-agent.nousresearch.com/docs/getting-started/nix-setup |
| CLI 指南 | https://hermes-agent.nousresearch.com/docs/user-guide/cli |
| TUI | https://hermes-agent.nousresearch.com/docs/user-guide/tui |
| 配置 | https://hermes-agent.nousresearch.com/docs/user-guide/configuration |
| 模型配置 | https://hermes-agent.nousresearch.com/docs/user-guide/configuring-models |
| 消息网关 | https://hermes-agent.nousresearch.com/docs/user-guide/messaging |
| Bot Mode （命名机器人） | https://hermes-agent.nousresearch.com/docs/user-guide/bot-mode |
| 安全 | https://hermes-agent.nousresearch.com/docs/user-guide/security |
| 检查点与回滚 | https://hermes-agent.nousresearch.com/docs/user-guide/checkpoints-and-rollback |
| 本地模型 | https://hermes-agent.nousresearch.com/docs/user-guide/local-models |
| 从其他 Agent 导入 | https://hermes-agent.nousresearch.com/docs/user-guide/import-from-other-agents |
| 从 OpenClaw 迁移 | https://hermes-agent.nousresearch.com/docs/guides/migrate-from-openclaw |
| 工具与工具集 | https://hermes-agent.nousresearch.com/docs/user-guide/features/tools |
| 技能系统 | https://hermes-agent.nousresearch.com/docs/user-guide/features/skills |
| 记忆系统 | https://hermes-agent.nousresearch.com/docs/user-guide/features/memory |
| 记忆供应商插件 | https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers |
| MCP 集成 | https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp |
| MCP 实战指南 | https://hermes-agent.nousresearch.com/docs/guides/use-mcp-with-hermes |
| Cron 调度 | https://hermes-agent.nousresearch.com/docs/user-guide/features/cron |
| 上下文文件 | https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files |
| 人格与 SOUL.md | https://hermes-agent.nousresearch.com/docs/user-guide/features/personality |
| 语音模式 | https://hermes-agent.nousresearch.com/docs/user-guide/features/voice-mode |
| 计算机操作（ Computer Use ） | https://hermes-agent.nousresearch.com/docs/user-guide/features/computer-use |
| Nous 工具网关 | https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-gateway |
| 订阅代理 | https://hermes-agent.nousresearch.com/docs/user-guide/features/subscription-proxy |
| Hermes 桌面应用 | https://hermes-agent.nousresearch.com/docs/user-guide/desktop |
| Google Workspace 集成 | https://hermes-agent.nousresearch.com/docs/user-guide/skills/google-workspace |
| Windows 原生指南 | https://hermes-agent.nousresearch.com/docs/user-guide/windows-native |
| WSL2 快速上手 | https://hermes-agent.nousresearch.com/docs/user-guide/windows-wsl-quickstart |
| Docker | https://hermes-agent.nousresearch.com/docs/user-guide/docker |
| 插件系统 | https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins |
| 技巧与最佳实践 | https://hermes-agent.nousresearch.com/docs/guides/tips |
| 架构说明 | https://hermes-agent.nousresearch.com/docs/developer-guide/architecture |
| FAQ 与故障排查 | https://hermes-agent.nousresearch.com/docs/reference/faq |

3.3 安装与配置（当前最稳定版）

本节结构与 2.3 对应，先确认版本，再依次讲系统要求、安装布局、安装命令、首次配置与验证。

3.3.1 版本核对结论

|-------------------|-----------------------------------------|---------------------------------------|
| 项目 | 数值 | 来源与核对时间 |
| GitHub 最新 Release | v2026.9.14 （ Hermes Agent v0.21.3 ） | GitHub Releases ， 2026-09-14 发布（非预发布） |
| 上一个 Release | v2026.9.11 （ v0.21.2 ） | 2026-09-11 |
| npm / PyPI 分发 | 官方不支持 | 官方平台支持页明确把 pypi 与 brew 列入 Unsupported |
| 开源协议 | MIT | GitHub API license.spdx_id |
| 桌面端 | macOS / Windows / Linux | 官网下载页 |

风险：补充修正（重要） ：Hermes Agent 不支持也不接受 通过 pip install hermes-agent、uv tool install hermes-agent、brew install hermes-agent、AUR 安装。官方平台支持页把这些明确列为 Unsupported ，并声明修复它们的 PR 不会被接受。唯一受支持的安装方式是官方 install.sh / install.ps1 脚本、Hermes Desktop 安装包、Docker 镜像，以及（Tier 2 尽力支持的）Nix flake 与 Android Termux。

3.3.2 系统要求与安装布局

安装脚本会自动处理依赖，你唯一需要预装的是 Git （Linux 上还需 curl 与 xz-utils）。脚本会自动安装：

• uv （Rust 编写的快速 Python 包管理器）
• Python 3.11 （经 uv 安装，无需 sudo）
• Node.js v26 （浏览器自动化与 WhatsApp 桥接用；系统已有的 Node 22.22+ / 24.11+ / 26+ 会被直接复用）
• ripgrep （快速文件搜索）
• ffmpeg （TTS 音频格式转换）
• Windows 额外安装便携版 Git Bash （MinGit，约 45 MB，解包到 %LOCALAPPDATA%\hermes\git，不需要管理员权限，与系统 Git 完全隔离）

安装位置取决于用普通用户还是 root：

|-------------------------------------|------------------------------|-----------------------------|-------------------------------|
| 安装方式 | 代码位置 | hermes 可执行文件 | 数据目录 |
| 普通用户（ git 安装器） | ~/.hermes/hermes-agent/ | ~/.local/bin/hermes （符号链接） | ~/.hermes/ |
| root （ sudo curl ... | sudo bash ） | /usr/local/lib/hermes-agent/ | /usr/local/bin/hermes | /root/.hermes/ 或 $HERMES_HOME |
| Windows 原生 | %LOCALAPPDATA%\hermes\ | 同左 | 同左 |

3.3.3 安装命令

|---------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| # Linux / macOS / WSL2 / Android (Termux) curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash |
| Windows PowerShell |
| # Windows（原生 PowerShell，非管理员亦可） iex (irm https://hermes-agent.nousresearch.com/install.ps1) |

装完：

|------------------------------------------------------|
| 终端命令 |
| source ~/.bashrc # 或 source ~/.zshrc hermes # 开始对话 |

无头部署可跳过浏览器依赖：

|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-computer-use |

3.3.4 首次配置

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| hermes setup # 全量向导，一次性配好所有东西 hermes setup --portal # 最快路径：一次 OAuth 打通模型 + 四个托管工具 hermes model # 只选模型与供应商 hermes tools # 只配工具开关 hermes gateway setup # 只配消息平台 hermes config set # 设置单个配置项 hermes config get # 读取单个配置项 |

hermes setup --portal 是官方推荐的最快路径 ：一次 OAuth 登录即把 Nous 设为推理供应商并打开 Tool Gateway（联网搜索、图像生成、TTS、云浏览器），无需分别申请 Firecrawl、FAL、OpenAI、Browser Use 的账号。随时用 hermes portal info 查看当前路由状态。

3.3.5 验证

|------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| hermes doctor # 诊断缺失项并给出修复命令 hermes status # 完整系统状态（Tool Gateway 是其中一个区块） hermes portal info # Portal 认证 + Tool Gateway 路由摘要 |

3.3.6 Windows Defender 误报处理（常见坑）

部分杀软（Bitdefender、Windows Defender）会把 %LOCALAPPDATA%\hermes\bin\uv.exe 判定为恶意软件。这是误报 ------它是 Astral 的 uv（Rust 编写的 Python 包管理器），基于 ML 的杀毒引擎常把会下载安装包的未签名 Rust 二进制误判。

处理方式：加白名单目录，不要加文件哈希 （uv 每次更新哈希都会变）。

|-----------------------------------------------------------------------------------------------------|
| Windows PowerShell |
| # Windows Defender（管理员 PowerShell） Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin" |

需要自行验证文件真实性时，可用 gh attestation verify 对照 astral-sh/uv 官方发布产物比对哈希，官方 README 给出了完整命令。

3.4 界面功能与设置

Hermes Agent 有四个界面入口（消息网关另计，见 3.10 节）：CLI 、TUI（Ink 终端 UI） 、Hermes Desktop 、Web Dashboard 。

3.4.1 CLI 与 TUI

CLI 是全功能终端界面：多行编辑、斜杠命令自动补全、对话历史、可中断并重定向、流式工具输出。输入 / 后按 Tab 即可列出所有命令（内置命令 + 所有已安装技能）。

|--------------|------------------------------------------|--------------------------------------------------------|
| 动作 | CLI | 消息平台 |
| 开始对话 | hermes | hermes gateway setup + hermes gateway start 后给 bot 发消息 |
| 新会话 | /new 或 /reset | /new 或 /reset |
| 换模型 | /model provider:model | /model provider:model |
| 设人格 | /personality name | /personality name |
| 重试 / 撤销 | /retry 、 /undo | /retry 、 /undo |
| 压缩 / 用量 / 洞察 | /compress 、 /usage 、 /insights --days N | /compress 、 /usage 、 /insights days |
| 浏览技能 | /skills 或 /<skill-name> | /<skill-name> |
| 中断当前工作 | Ctrl+C 或发新消息 | /stop 或发新消息 |
| 平台状态 | /platforms | /status 、 /sethome |
| 重载 MCP | /reload-mcp | /reload-mcp |
| 记忆星图 | /journey （别名 /learning 、 /memory-graph ） | 同左 |

3.4.2 Hermes Desktop

桌面端与 CLI / 网关共享同一套 Agent 核心 ------同样的 config、API key、会话、技能和记忆，它不是独立产品，只是同一 Agent 的图形外壳。支持 macOS、Windows、Linux（Wayland 下作为原生客户端运行，Hyprland / COSMIC / KDE 各有对应的置顶与键盘处理说明）。

核心 UI 区块 ：

• 左侧边栏 ：会话列表、项目（自动扫描本地 Git 仓库，可配置扫描根目录与排除路径）、Sessions \| Bots 标签条、Profile 切换轨道。
• 中央聊天区 ：流式响应、实时工具活动、结构化工具调用摘要；拖放文件附加；右侧预览栏并排渲染网页 / 文件 / 工具输出；Annotate 评论模式 （点击页面元素或拖框加批注，保存为编号 pin，携带 CSS selector、markup、computed styles，密码与疑似 token 会被脱敏）；撰写历史（空框按 ↑/↓）、队列消息编辑、对话时间线轨、Cmd/Ctrl+F 页内查找。
• 状态栏 ：每会话 YOLO 开关、上下文使用率表 （点击看 system prompt / 工具定义 / skills / memory / rules / MCP / 子 Agent 定义 / 对话本身的 token 细分）、缓存命中率、tokens/秒，显示项可右键自定义，Cmd/Ctrl+Shift+S 可整体隐藏。
• 右侧边栏 ：文件浏览器 + 真实终端（多标签、隐藏时进程仍存活、可把选中输出「Add to chat」）。Cmd/Ctrl+J 切换、Cmd/Ctrl+\ 换边。
• Artifacts 视图 ：会话生成的图片 / 文件 / 链接集中成可搜索画廊，可跳回产生它的会话。
• Git Review 与 Worktrees ：Cmd/Ctrl+G 打开，支持分支 ahead/behind、变更文件（列表或树）、diff 范围（Uncommitted / Branch / Last turn）、暂存还原、写或生成提交信息 、Commit / Commit & Push、通过 gh 创建 PR 或让 Hermes 开 PR、创建切换分支；Cmd/Ctrl+Shift+B 创建 Git worktree 让 Agent 在并行副本上工作。
• Memory Graph / Star Map ：可缩放节点图，展示学到的 skills 与 memories，带时间轴，按 All / Used / Learned 过滤，可直接在面板中编辑或删除节点。
• HUD 模式 ：⌘/Ctrl+Shift+H 把聊天分离成无边框、always-on-top 的浮动条，悬浮在任意应用之上；浮动条位置会告知 Hermes 你正在问的是哪个应用。
• Quick Entry ：全局系统热键（默认 Ctrl/Cmd+Shift+Space）从任意位置呼出小型常驻撰写框。

设置覆盖 ：Providers / 模型 / 工具集 / MCP 服务器 / 网关 / 会话管理 / 外观（终端字体、VS Code Marketplace 主题导入、亮暗模式）/ 高级（Quick Entry、保持唤醒）/ 工作区（仓库扫描）/ 快捷键（可重绑定）/ 插件 / 网关连接（本地、远程 hermes serve、Hermes Cloud、SSH）/ Profile 导入导出 / 卸载（三种粒度）。UI 语言支持 English、简体中文、繁体中文、Japanese、Arabic（RTL）、Russian 。

3.4.3 Bot Mode

桌面端侧边栏的 Bots 标签把每个 Hermes profile 呈现为一个命名 Bot，各有自己的头像、规范 Bot Chat 会话和 Routines （由 Hermes cron 支撑的周期任务）。可以创建 Agent（名称 / 标题 / 描述 + 模型、SOUL、skills、toolsets、MCP servers）、分组、开启群聊，并在任意聊天中用 @researcher have a look at this 让 Bot 之间互相移交消息。

3.5 使用教程

以下五步可在 30 分钟内跑通一个可用的 Hermes Agent 实例，每一步都给出命令与预期结果。

Step 1：两分钟跑通

|--------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc hermes setup --portal # 或 hermes model 自选供应商 hermes # 开始对话 |

预期结果 ：进入交互式会话，可正常收到回复。若提示 command not found，先 source ~/.bashrc；若提示 API key not set，跑 hermes model 或 hermes config set OPENROUTER_API_KEY your_key。

Step 2：接上消息平台

|--------------------------------------------------------------------------------------------------------|
| 终端命令 |
| hermes gateway setup # 交互式配置 Telegram / Discord / Slack / WhatsApp / Signal / 邮件等 hermes gateway start |

官方文档口径：21+ 平台 （llms.txt 更精确地表述为「21+ 消息平台 = 19 个网关原生平台 + IRC 与 Microsoft Teams 走插件」）。覆盖 Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost、邮件、SMS、钉钉、飞书、企业微信、微信、QQ 机器人、元宝、BlueBubbles、Home Assistant、Microsoft Teams、Google Chat 等，均从一个网关进程 发出。

Step 3：用上闭环学习

|-----------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| # 看到学到的技能 /skills # 查看记忆与用户画像（记忆图谱） /journey # 让 Agent 记住本次要点 "记住这个，下次用得上" # 把刚做的事固化成技能 "把你刚才做的这件事存成一个叫 deploy-staging 的技能" |

记忆与技能的分工 （官方口径）：记忆放「事实」（环境、偏好、项目位置），技能放「流程」（多步工作流、工具用法、可复用配方） 。记「是什么」，技能记「怎么做」。

记忆容量是有界的 ：MEMORY.md 约 2,200 字符，USER.md 约 1,375 字符。满了之后 Agent 会自行合并条目，你也可以说「清理一下你的记忆」。

注意： ⚠️ 注意：记忆是冻结尾照 。Agent 会立即写入磁盘，但会话中途系统提示的缓存不会失效------改动要到下一个会话 才生效。

Step 4：开自动化

|------------------------------------------------------------|
| 终端命令 |
| # 自然语言创建定时任务，结果投递到任意平台 "每天早上 8 点给我一份昨日服务器异常摘要，发到 Telegram" |

Cron 支持 create / list / update / pause / resume / run / remove，投递由 cron 自身的 delivery、hermes send CLI 与网关 notifier 完成。

Step 5：派生子 Agent 做并行

|----------------------------------------------------|
| 终端命令 |
| # 把多步流水线压成零上下文开销的单次调用 "并行分析这三个仓库的依赖风险，各派一个子 Agent" |

delegate_task 派生隔离子 Agent（各自拥有独立会话、终端），execute_code（Programmatic Tool Calling）可用 Python RPC 脚本把多步流水线折叠成单次推理调用。

常用 CLI 速查

|--------------------------------------|---------------------------------------------------------------|
| 命令 | 作用 |
| hermes | 启动交互式 CLI |
| hermes model | 选择供应商与模型 |
| hermes tools | 配置工具开关（交互式） |
| hermes gateway setup / start | 配置 / 启动消息网关 |
| hermes mcp / catalog / install <n> | MCP 目录、安装、配置 |
| hermes mcp login <server> | OAuth 登录远程 MCP |
| hermes mcp serve | 把 Hermes 自己暴露为 MCP 服务器 |
| hermes cron | 定时任务管理 |
| hermes claw migrate | 从 OpenClaw 迁移 |
| hermes import-agent claude-code | 从 Claude Code 导入 |
| hermes import-agent codex | 从 Codex CLI 导入 |
| hermes profile export / import | 导出 / 导入单个 Agent （ 不含密钥 ） |
| hermes backup | 完整备份（含密钥，用于整机迁移） |
| hermes update | 更新（会打印匹配当前安装方式的命令） |
| hermes doctor | 诊断 |
| hermes prompt-size | 离线查看固定每消息开销（ system prompt + skills 索引 + memory + 工具 schema ） |

3.6 费用

结论：Hermes Agent 软件完全免费（MIT），订阅是可选项。

3.6.1 三条可选付费路径

|--------|--------|-------------------|----------|---------------------|------------------------------------|
| 层级 | 月费 | 含月度额度 | 结转上限 | 速率上限 | 说明 |
| Free | 0 | 0 （仅免费模型 + 按量充值） | --- | 50 RPM / 500K TPM | 可用 Portal 推理，但 不含 Tool Gateway |
| Plus | 20 | 22 | 10 | 400 RPM / 4M TPM | 含 Tool Gateway ，推荐入门档 | | Super | 100 | 110 | 50 | 800 RPM / 8M TPM | 重度日常使用 |
| Ultra | 200 | 220 | $100 | 1,600 RPM / 16M TPM | 最高速率上限 |

提示：核对说明（2026-09-14 实测） ：上表「月费 / 含月度额度 / 结转上限」三列取自 Nous Portal 站点内嵌的官方订阅档位数据 （availableTiers 结构，含 Stripe price ID），属第一方权威数据 ，而非第三方转述。付费档权益的官方原文为「22 / 110 / 220 monthly credits ＋ 10 / 50 / 100 rollover cap ＋ 200+ Models ＋ Hosted tool usage」，Free 档为「Free models only ＋ Standard rate limits ＋ $0 monthly credits」。付费档额度为「实付 + 10% 赠送」，未用完的额度按档位上限结转；也可不订阅，直接用 Stripe 按自定义金额充值额度。

提示：关于「速率上限」一列 ：RPM / TPM 数值在 Portal 公开页面与官方文档中均未直接标示，来自第三方资料整理，可信度低于其余三列，请以 Portal 账户页当日实际显示为准 。另注：portal.nousresearch.com/products 等子页设有前端风控（访问频繁时返回 429），主站 portal.nousresearch.com 可正常查看。

3.6.2 Tool Gateway 包含什么

每个付费档都内含 Tool Gateway，按量从同一额度扣费 ，可逐工具混用（也可随时换回自己的 Key）：

|-----------|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 工具 | 后端 | 说明 |
| 联网搜索与页面抽取 | Firecrawl | Agent 级搜索 + 整页抽取，网关负责扩容，无需担心限流 |
| 图像生成 | FAL | 九个模型共用一个端点： FLUX 2 Klein 9B （默认，快）、 FLUX 2 Pro 、 Z-Image Turbo 、 Nano Banana Pro 、 GPT Image 1.5 、 GPT Image 2 、 Ideogram V3 、 Recraft V4 Pro 、 Qwen Image |
| 文本转语音 | OpenAI TTS | 接入 text_to_speech ，可往 Telegram 投语音条 |
| 云浏览器自动化 | Browser Use | 无头 Chromium ，提供 browser_navigate / click / type / vision |

提示：免费档有一个例外 ：部分账号会获得一个免费工具额度池（free tool pool） ，无需付费订阅即可覆盖少量网关工具调用。首次使用时网关会提示并可一键启用。

3.6.3 Hermes Cloud（预览中）

Nous 官方也提供托管实例，按小时从额度扣费（预览阶段）：

|--------|-----------------------------|-----------|-----------|
| 规格 | 资源 | 运行中 | 停止时 |
| Small | 1 GB RAM / 2 vCPU / 5 并发会话 | 约 0.29/天 | 约 0.03/天 |
| Medium | 2 GB RAM / 4 vCPU / 10 并发会话 | 约 0.56/天 | 约 0.03/天 |
| Large | 4 GB RAM / 8 vCPU / 20 并发会话 | 约 1.09/天 | 约 0.03/天 |

停止实例后只计存储费（约每月 $0.90），数据保留。推理与工具调用另计。

3.6.4 自建成本构成

|-----------|----------------------------------------------------------------------------------------------------------------------------|
| 成本项 | 说明 |
| Hermes 软件 | 免费（ MIT ） |
| 模型推理 | 走 Portal 则扣额度；走 OpenRouter / 直连厂商 / 本地模型则各按各的价 |
| 服务器 | 5 美元 VPS 即可；或 Serverless （ Daytona / Modal / Vercel Sandbox ）闲置时接近零 |
| 工具服务 | 不走 Portal 则需各自申请： Firecrawl / Tavily / Exa （搜索）、 Browser Use （浏览器）、 FAL （图像）、 ElevenLabs 或 OpenAI audio （语音）、 Modal （代码沙箱） |

3.7 使用技巧

1. 别破坏 Prompt Cache 。大多数厂商按「系统提示 + 历史」前缀缓存。保持上下文文件与记忆稳定，后续消息就能命中便宜的缓存。一次显式 /model 切换、一次 Provider 自动回退、一次凭证池轮转，都会让下一轮按全价重读整段对话 。长会话里频繁来回切，成本会成倍放大。
2. 用 /usage 看消耗，用 /insights 看 30 天趋势，用 hermes prompt-size 看固定开销 。后者可离线运行，能算出「还没开口就已经花掉多少 token」。
3. 5 步以上且会重复做的任务，就让它存成技能 。下次直接 /deploy-staging。
4. 危险命令审批别随便点「always」 。Hermes 对递归删除、SQL DROP、curl 管道进 shell 等有一套危险模式清单，触发时给你四个选项：once / session / always / deny。先用 session 起手 。
5. 容器后端下危险命令检查会跳过 。官方明确：跑在 Docker / Singularity / Modal / Daytona 时，容器本身就是安全边界，因此危险命令检查被跳过------请确保你的容器镜像已锁定加固。
6. 非交互式 shell 初始化是隐形杀手 。Agent 起 shell 没有 TTY 也没人看着：.bashrc 里的 nvm.sh 会给每一条 命令都加上延迟；tmux attach、read、菜单打印会把 shell 挂死到超时。标准修法是在 .bashrc 顶部加守卫：

|-------------------------------------------------------------|
| 终端命令 |
| case $- in *i*) ;; # 交互式：继续 *) return;; # 非交互式：到此为止 esac |

Zsh 用户把登录态配置放 .zprofile、交互式配置放 .zshrc，.zshenv 保持极简。

1. MCP 工具结果会被净化 。Hermes 在把 MCP 工具结果交给模型前，会剥离不可见的 Unicode TAG 字符（U+E0000--U+E007F）------这类字符在终端和聊天界面里不可见，但模型完全可见，是典型的提示词注入走私通道。合法的 emoji 旗帜序列会保留。
2. Docker 后端是「一个长驻容器」而非「每条命令一个新容器」 。首次使用时 docker run -d ... sleep infinity，之后所有 terminal / file / execute_code 都 docker exec 进同一个容器，pip install 的效果跨 /new、/reset 与子 Agent 都保留，直到 Hermes 进程退出。

3.8 典型使用场景

|----------------|---------------------------------------------------------------|----------------------------------------------------------------|
| 场景 | 配置要点 | 为什么选 Hermes Agent |
| 长期个人助理 | 一台 5 美元 VPS + Telegram + 记忆 + 技能 | 闭环学习让它在数周后真正「认识你」；不绑笔记本，随时远程指挥 |
| 无人值守自动化 | Cron + 平台投递 + Serverless 后端 | 自然语言建定时任务，日报 / 夜备 / 周审全自动，闲置时几乎不花钱 |
| 多角色 Bot 团队 | Bot Mode + 群聊 + @mention | 每个 Profile 是一个命名 Bot ，各有模型 / 记忆 / 技能 / 形象，可在群聊中互相移交任务 |
| 并行研发流水线 | delegate_task + execute_code + Git Worktrees | 隔离子 Agent 并行工作流， RPC 脚本把多步流水线压成零上下文开销的调用 |
| 高安全沙箱执行 | Docker / SSH / Singularity / Modal / Daytona / Vercel Sandbox | 七种终端后端 + 只读根文件系统、丢弃全部 capabilities 、禁止提权、 PID 上限 256 、完整命名空间隔离 |
| 研究与训练数据生产 | 批量轨迹生成 + 轨迹压缩 + Atropos RL | 官方主推「 research-ready 」：可批量产出工具调用轨迹用于训练下一代模型 |
| 离线 / 隐私优先 | 本地模型（ llama.cpp / MLX / vLLM ） | 完全本地推理，无账号无 Key ，数据不出本机 |

3.9 桌面端详解（Hermes Desktop）

Hermes Desktop 是 Hermes Agent 的原生图形客户端 ，与 CLI / TUI / Web Dashboard 共享同一 Agent 核心 ------同样的 config、API key、会话、技能、记忆，它不是独立产品，只是同一 Agent 的图形外壳。

3.9.1 安装形态与下载入口

|-------------|-------------------------|-----------------------------------------|-------------------------------------------------------------------|
| 平台 | 安装包 | 系统要求 | 备注 |
| macOS | Hermes-Setup.dmg | macOS 12+ | 官方下载页按钮标记为「 Mac OS 」； Apple Silicon 优先 ， Intel Mac 用户见下方兼容性提醒 |
| Windows | Hermes-Setup.exe | Windows 10 / 11 （ x86_64 / aarch64 ） | 官方安装包已签名；少数旧版可能触发 SmartScreen ，按 3.3.6 的方法处理 |
| Linux | 由 install.sh 装好 CLI 后启动 | 与 Hermes CLI 一致： Linux x86_64 / aarch64 | 桌面应用以 Hermes Agent 进程内置 Electron 形式运行， Wayland 下作为原生客户端 |

官方下载入口 ：

• 桌面版下载页：https://hermes-agent.nousresearch.com/（首页即下载入口，含 macOS / Windows / Linux 三个按钮）
• macOS 安装包：https://hermes-assets.nousresearch.com/Hermes-Setup.dmg
• Windows 安装包：https://hermes-assets.nousresearch.com/Hermes-Setup.exe
• 桌面端文档：https://hermes-agent.nousresearch.com/docs/user-guide/desktop
• 桌面插件 SDK：https://hermes-agent.nousresearch.com/docs/developer-guide/desktop-plugin-sdk

安装后桌面端会自动调用已装好的 Hermes CLI（含 ~/.hermes/config.yaml 与 ~/.hermes/hermes-agent/）。若先装桌面端再装 CLI，桌面端首次启动会引导你跑 hermes setup。

风险：Intel Mac 兼容性提醒 ：Hermes Agent 官方平台支持页把 macOS on x86 (Intel) processors 列入 Unsupported （与 Hermes CLI 同等待遇）。Hermes Desktop 下载页未单独排除 Intel Mac，但底层 Hermes core 受同一条不支持名单约束。若你只在 Intel Mac 上试用，建议先用 Tier 2 的 Nix flake 单独验证 CLI 可用，再决定是否装桌面端。

3.9.2 核心特性一览

|---------------------------|----------------------------------------------------------------------------------------|
| 特性 | 说明 |
| Bots 标签 | 侧边栏把每个 Hermes profile 呈现为命名 Bot ，各有头像、专属 Bot Chat 会话、 Routines （由 Hermes cron 支撑的周期任务） |
| Routines 可视化 | 桌面端把自然语言写的定时任务（ /cron ... ）渲染成可读时间线，失败 / 暂停 / 暂停原因一目了然 |
| SOUL 编辑 | 图形化个性设置页，直接编辑全局 ~/.hermes/SOUL.md 与每个 Bot 的独立 personality ；保存即生效，无需重启 |
| Skills 浏览器 | 已安装技能、官方 Skills Hub 可订阅技能、用户自建技能统一管理，支持热重载 |
| Voice Mode 切换 | 桌面端内置 Realtime Voice UI ： CLI 、 Telegram 、 Discord 、 Discord VC 各场景一键启用 |
| HUD / 星图 / Git Review | 三个内置可视化面板： HUD 看当前会话的工具调用与上下文，星图看记忆与技能拓扑， Git Review 看改动 diff |
| Web Dashboard 嵌入 | 桌面端把 ~/.hermes/ 下的 Web Dashboard 嵌进一个原生窗口，主题随系统亮暗自动切换 |

3.9.3 桌面插件系统（@hermes/plugin-sdk）

桌面端提供 Pane、Page、Sidebar nav、Status bar、Palette command、Keybind、Theme 等扩展点。第三方开发者可发布 ESM 模块，桌面端热重载导入。SDK 文档 ：https://hermes-agent.nousresearch.com/docs/developer-guide/desktop-plugin-sdk。

这是与 OpenClaw 桌面端最大的差异：Hermes Desktop 有正式的桌面插件 SDK ，扩展点清晰；OpenClaw 桌面端目前主要是 Gateway 的图形壳，桌面侧扩展以控制台主题为主。

3.9.4 Linux 说明

Linux 上的 Hermes Desktop 通过 Hermes CLI 的安装脚本内置，无需单独的桌面安装包。安装后用 hermes desktop 启动；或在终端里 hermes dashboard 拉起 Web Dashboard，再用浏览器访问（Wayland 下推荐把 Dashboard 作为 PWA 安装到 Chrome，效果接近独立客户端）。桌面通知通过浏览器原生通知 API 发出。

需要强调：Linux 上 Hermes Desktop 不需要 你额外装 GTK / Qt 等桌面库------它打包为独立 Electron 二进制，依赖与 CLI 共享同一个 Hermes 进程（hermes-agent daemon）。

3.10 多入口并行与切换

Hermes Agent 实际有 5 个入口 （比 OpenClaw 多一个 TUI）：

|--------------------|----------------------------------------------------------------------------------------------|-----------------------------------|
| 入口 | 触发方式 | 适合场景 |
| CLI | hermes chat | 脚本化、 CI 、 SSH 、容器内 |
| TUI | hermes chat --tui （ Ink 终端 UI ） | 纯终端下的交互式体验，无需图形 |
| Web Dashboard | 浏览器访问 http://127.0.0.1:<port>/ （随 CLI 自动启动） | 大屏查看会话、记忆、技能管理 |
| Hermes Desktop | macOS / Windows 客户端 | 桌面工作流、 SOUL / Routines / Bots 可视化 |
| 消息网关 | 21+ 平台： Telegram / Discord / Slack / WhatsApp / Signal / 飞书 / 企微 / 微信 / 元宝 / 钉钉 / 邮件 / SMS 等 | 手机端、群聊、跨网远程 |

关键事实 （与 OpenClaw 一致的设计哲学）：

• 同一份配置 ：所有入口读取 ~/.hermes/config.yaml，桌面端 / Web 改完设置，CLI / 消息网关立即生效。
• 同一会话存储 ：CLI 创建的会话，桌面端可继续；反之亦然。会话按 platform + 发送者维度隔离，私聊与群聊走不同会话。
• 同一记忆 / 技能 / Bot Profile ：跨入口共享。hermes memory、hermes skills、hermes bots 命令在任何入口之外的状态都能在桌面端看到。
• Bot Mode 跨入口生效 ：你定义的 researcher Bot 在 CLI、Telegram 群聊、桌面端 Bots 标签里是同一个 Bot ，都有相同的模型 / SOUL / skills / 记忆。

Bot Mode 在多入口下的协作示例 ：

1. 在桌面端 Bots 标签创建 @coder（Claude Sonnet + 编程 skills）与 @reviewer（GPT-5 + 代码审查 skills）。
2. CLI 中启动一个长任务：hermes chat --bot @coder "重构用户模块"。
3. @coder 完成后通过 @reviewer have a look at this 把代码丢给 reviewer，desktop Bots 标签会同时显示两个 Bot 都在工作。
4. 你用 Telegram 发「在干嘛」给 Hermes Gateway，自动回复会汇总两个 Bot 的进度。

调试入口冲突 ：用 hermes status --verbose 看每个入口的活跃会话数、最近一次活动时间、消息网关连接数；hermes gateway setup 可重新初始化多入口关系而不丢会话。

04第四章 外部第三方服务对接能力

结论先行：两者都能接外部第三方服务，且都支持 MCP（Model Context Protocol）。差异在于「接入方式」与「信任模型」。

4.1 OpenClaw 的四条接入路径

OpenClaw 把外部服务接入拆成四条互不重叠的路径，按「你需要什么能力」对号入座即可。

路径一：MCP 服务器（原生支持）

Control UI 有独立的 MCP 页面 （也可从 Plugins → Installed 内联管理）。

• 支持的传输：Streamable HTTP、SSE、stdio （stdio 命令行接受带引号的参数，便于含空格的路径）。
• 可编辑的环境变量、工作目录、headers、TLS / mTLS 路径、OAuth metadata、工具过滤器、Codex 投影 metadata。
• Save 写入配置，Save & Publish 让运行中的 Gateway 立即应用。
• OAuth 型 MCP 连接器添加后需运行一次性 openclaw mcp login <name>。
• 页面会脱敏含凭据的 URL 型值；实时探测用 openclaw mcp doctor --probe。

|---------------------------------------------------------------------------|
| 终端命令 |
| openclaw mcp login <name> # OAuth 登录 openclaw mcp doctor --probe # 实时探测 |

路径二：插件（ClawHub / npm / git / 本地目录 / 归档）

插件可以添加工具、技能、渠道、模型服务商、语音、实时语音、媒体生成、联网搜索、网页抓取、钩子 等运行时能力。

|---------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| openclaw plugins search "postgres" openclaw plugins install clawhub:<package> openclaw plugins update --all |

信任模型 ：ClawHub 默认开放（任何人可上传），但发布需要通过「账号年龄门槛」。公开详情页会在安装前展示最新扫描状态。登录用户可举报，管理员可隐藏 / 恢复内容或封禁账号。安装或移除插件代码需要 Gateway 重启 ，启用 / 禁用已安装插件在支持时无需重启。

注意： ⚠️ 官方明确列出的限制：原生插件在进程内运行且未被沙箱化 。缓解手段是白名单、安装策略钩子、版本固定、依赖锁定与 CI 强制 SDK 边界。OpenClaw 与 Hermes 都要求你信任自己安装的原生插件。

路径三：渠道插件

即前文 2.5 节列出的 32 个渠道入口，含 Discord、Slack、飞书、企业微信、微信、QQ 机器人、Twilio SMS、Signal、Matrix、Mattermost、Microsoft Teams 等，另有 Voice Call 插件支持 Plivo / Telnyx / Twilio 电话能力。

路径四：Webhook 与 A2A

• Webhook ：cron 作业支持 delivery.mode = "webhook" 投递到任意 HTTP(S) 端点，可配 cron.webhookToken 发送专用 bearer token。
• A2A ：内置 A2A 1.0 JSON-RPC 协议插件，可把外部 Agent 接入 OpenClaw。
• OpenAI 兼容 API ：Gateway 可对外提供 /v1/chat/completions、/v1/responses、/v1/models、/v1/embeddings（默认禁用，/v1/responses 需单独启用），让任何 OpenAI 客户端直连 Gateway------背后的仍是你配置的模型凭证。
• 凭证对接 ：SecretRef 的 exec 类型可对接 1Password、Vault、Bitwarden、sops 。

4.2 Hermes Agent 的四条接入路径

Hermes Agent 同样有四条接入路径，其中「反向把自己暴露为 MCP 服务器」是它与 OpenClaw 最大的结构差异。

路径一：MCP（含官方审核目录 + 一键安装）

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| hermes mcp # 交互式 picker hermes mcp catalog # 纯文本目录列表，可脚本化 hermes mcp install n8n # 按名称安装目录条目 hermes mcp configure linear # 重新勾选要暴露的工具 hermes mcp login <server> # OAuth 登录 / 重新认证 /reload-mcp # 会话内重载 |

支持的传输 ：

|--------------|--------------------------|---------------------------------------------------------------------------|
| 传输 | 配置键 | 适用 |
| stdio 本地子进程 | command 、 args 、 env | 已本地安装的服务器； env 会被过滤 ，只传显式配置 + 安全基线 |
| HTTP 远程 | url 、 headers | 托管端点、组织内部端点 |
| OAuth 2.1 远程 | auth: oauth | Cloudflare 、 Linear 、 Sentry 、 Atlassian 、 Asana 、 Figma 、 Stripe 等主流托管服务 |
| mTLS 客户端证书 | client_cert / client_key | 要求双向 TLS 的内部服务 |
| 身份头 | identity_header | 需要按调用者身份限流 / 审计 / 多租户路由的服务 |

信任模型 ：目录条目位于仓库 optional-mcps/ 即表示 Nous 员工已审核合并，没有社区提交层 （新增需提 PR）。安装时会执行 manifest 指定的 git clone、bootstrap 命令与服务器自身代码------仍应阅读 manifest 的 source:、install.bootstrap:、transport.command:。

工具过滤 支持 fnmatch 风格 glob（include 优先于 exclude），对 Cloudflare 这类约 3,300 个工具的超大集合尤其必要。

已知坑（官方文档列出） ：

• Figma 托管端点按精确 client_name 允许 DCR，裸 "Hermes Agent" 会 403；Hermes 已自动对 mcp.figma.com 设置 oauth.client_name: "Claude Code"。
• Google Drive、Atlassian 等拒绝自动注册的服务，需自建 OAuth client 并填入 oauth.client_id / client_secret。症状有迷惑性 ：无 auth 时也能列出工具，但每次真实调用都超时。
• 部分 WAF 会 403 拒绝查询串含字面 127.0.0.1 的 authorize 请求，需要设 oauth.redirect_host: localhost。
• 在运行中的会话内 改 config.yaml，CLI 自动重载只有 30 秒 超时，不够跑完交互式 OAuth------应新增条目后从全新终端 运行 hermes mcp login <server>（它会等满 5 分钟）。
• 远程 / 无头环境可用 SSH 端口转发、粘贴回调 URL，或设 oauth.redirect_uri + redirect_port 走 Tailscale Funnel 一类的公共 HTTPS 端点。

路径二：反向暴露------ hermes mcp serve

Hermes 自己也能作为 MCP 服务器 被 Claude Code、Cursor、Codex 等客户端连接：

|-------------------------------------------------------------------------------------|
| 终端命令 |
| hermes mcp serve # 正常模式（stdio-only） hermes mcp serve --verbose # stderr 输出调试日志 |
| 配置文件（JSON5） |
| { "mcpServers": { "hermes": { "command": "hermes", "args": "mcp", "serve" } } } |

暴露 10 个工具：conversations_list、conversation_get、messages_read、attachments_fetch、events_poll、events_wait、messages_send、channels_list、permissions_list_open、permissions_respond。

风险： 限制：hermes mcp serve 目前是 stdio-only （需 HTTP 服务器要另配 adapter，或改用 Hermes 自己的 MCP 客户端能力）。读操作不需要网关运行，发送操作需要网关处于活动连接；事件轮询约每 200 ms 一次；messages_send 不支持媒体 / 附件。

路径三：消息平台与内置集成

• 21+ 消息平台（前文 3.5 节）
• Google Workspace ：Gmail、Calendar、Drive、Sheets、Docs，走 OAuth2
• Home Assistant ：ha_* 工具集
• Spotify ：专用工具集
• 1Password / Bitwarden Secrets Manager / 命令助手 ：密钥来源插件
• 外部记忆供应商 ：Honcho、OpenViking、Mem0、Hindsight、Holographic、RetainDB、ByteRover、Supermemory

路径四：订阅代理（Subscription Proxy）

可把你的 Nous Portal 订阅（或其他 OAuth 供应商）当作 OpenAI 兼容端点供外部应用使用------即把订阅「借」给第三方 App。

4.3 第三方对接能力对照表

|--------------|---------------------------------------------------------|---------------------------------------------|
| 对接维度 | OpenClaw | Hermes Agent |
| MCP 客户端 | ✅ 原生，独立 MCP 页， stdio / HTTP / SSE | ✅ 原生， stdio / HTTP / OAuth 2.1 / mTLS / 身份头 |
| 作为 MCP 服务器 | ❌ （提供 OpenAI 兼容 API 供外部调用） | ✅ hermes mcp serve （ stdio-only ， 10 个工具） |
| MCP 目录 / 一键装 | ❌ 需手动或走 ClawHub 插件 | ✅ hermes mcp catalog + install （ Nous 审核） |
| 插件生态 | ✅ ClawHub （开放注册 + 自动扫描 + 举报机制） | ✅ 插件系统 + 桌面插件（ ESM 热重载） |
| 消息平台数 | 32 个渠道入口（核心内置 4 + 官方插件 24 + 外部插件 4 ） | 21+ 平台（ 19 网关原生 + IRC / Teams 走插件） |
| Webhook 出向 | ✅ cron 支持 webhook 投递 + bearer token | ✅ hermes webhook / 网关钩子 |
| Agent 间协议 | ✅ A2A 1.0 （内置插件） | ✅ Bot Mode @mention 移交 + 子 Agent 委派 |
| 密钥管理对接 | ✅ SecretRef exec → 1Password / Vault / Bitwarden / sops | ✅ 1Password / Bitwarden / 命令助手密钥源 |
| 办公套件 | 通过插件 / MCP | ✅ Google Workspace 原生 OAuth2 技能 |
| 智能家居 | 通过插件 / MCP | ✅ Home Assistant 原生工具集 |
| 对外 API | ✅ OpenAI 兼容（ /v1/chat/completions 等） | ✅ 订阅代理（ OpenAI 兼容端点） |
| 信任模型特点 | 插件进程内运行、未沙箱化；靠白名单 + 安装策略钩子 | 目录条目 Nous 审核；安装时执行 bootstrap 命令，需读 manifest |

4.4 实操对照：接入同一个第三方服务

以「接入 Linear（项目管理 SaaS）」为例：

OpenClaw 路径 （写配置 + CLI 登录）：

|-----------------------------------------------------------------------------------------------------------|
| 配置文件（JSON5） |
| // ~/.openclaw/openclaw.json { mcp: { servers: { linear: { url: "https://mcp.linear.app/mcp", }, }, }, } |
| 终端命令 |
| openclaw mcp login linear # Save & Publish 应用；实时探测用 openclaw mcp doctor --probe |

Hermes Agent 路径 （目录一键装 + OAuth）：

|--------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| hermes mcp install linear # 目录已审核，自动写入 auth: oauth hermes mcp login linear # 从全新终端跑，等待完整 5 分钟 OAuth hermes mcp configure linear # 勾选要暴露的工具 |
| 配置文件（YAML） |
| # ~/.hermes/config.yaml（等价手写形式） mcp_servers: linear: url: "https://mcp.linear.app/mcp" auth: oauth tools: exclude: delete_workspace |

差异小结 ：OpenClaw 给你更细的传输层控制（TLS / mTLS / 头部 / 工作目录 / 超时）与更强的权限门控（operator.admin）；Hermes 给你更快的起步（审核目录 + 一键安装 + 自动 DCR / PKCE）与更实用的工具过滤（glob 模式）。

05第五章 横向对比与选型建议

本章先用十六维对比表把差异摆平，再给出可直接执行的选型判据，最后如实列出两个项目各自必须知道的风险与局限。

5.1 十六维对比表

|---------------|---------------------------------------------|----------------------------------------------|----------------------------------|
| 维度 | OpenClaw | Hermes Agent | 优势方 |
| 核心定位 | 多通道网关 + 可信控制平面 | 自我进化的自治 Agent | 视需求 |
| 开源协议 | MIT ，无企业版 | MIT | 平 |
| 社区体量 | 约 38.9 万星 / 8.2 万 Fork | 约 24.5 万星 / 5.1 万 Fork | OpenClaw |
| 发布节奏 | 2026.9.4 （ 2026-09-11 ） | v2026.9.14 （ 2026-09-14 ） | 平 |
| 运行时栈 | Node.js （推荐 26 ） | Python 3.11 + Node v26 | 视团队栈 |
| 消息渠道 | 32 个渠道入口 | 21+ 平台 | OpenClaw |
| 模型服务商 | 官方目录 67 个，含大量本地后端 | 模型无关， Portal 200+ 或任意端点 | Hermes （数量） / 平（能力） |
| 执行隔离 | Sandbox / 配对节点 / Cloud workers （ 默认关闭 ） | 7 种终端后端（ local 为默认） | OpenClaw （架构） / Hermes （开箱隔离选项多） |
| 学习闭环 | Memory + Skill Workshop + dreaming 记忆合并 | 记忆 + 自动建技能 + 技能自我改进 + Honcho 用户建模 | Hermes |
| 自动化 | cron + heartbeat + hooks + 三种投递模式 | cron + 平台投递 + Heartbeats + Recurring Loops | 平 |
| 多 Agent | Sub-agents / ACP / Agent send / Swarm | delegate_task / execute_code / Bot Mode | 平 |
| 图形界面 | Control UI （浏览器 SPA ， 11 套主题， 21 种语言） | Hermes Desktop （原生，含 HUD / 星图 / Git Review ） | 视偏好 |
| 第三方对接 | MCP + ClawHub 插件 + 渠道插件 + Webhook + A2A | MCP 审核目录 + OAuth 2.1 + 反向 mcp serve + 订阅代理 | 平 |
| 费用 | 软件免费，无订阅 | 软件免费，订阅可选（ 0 / 20 / 100 / 200 ） | 平（都免费） |
| 治理结构 | 非营利基金会（ 501(c)(3) ）， 30+ 合作方 | 商业实验室（ Nous Research ）主导 | OpenClaw （中立性） |
| 明确的安全边界文档 | 七项可验证安全属性 + 公开安全公告 | 主张「操作系统是唯一安全边界」 | OpenClaw （可验证性） |

5.2 选型决策

选 OpenClaw，如果 ：

1. 你需要把 Agent 接进公司内部已有的协作工具 （Teams / Slack / 飞书 / 企微 / Mattermost），且渠道数量是硬指标；
2. 你需要可审计、可验证的安全姿态 ------SecretRef + sentinel + 版本化状态 + 审计账本 + 独立基金会治理，能拿去给安全团队过审；
3. 你的团队已经是 Node.js 技术栈 ，且想要一个浏览器里就能管一切的控制台；
4. 你需要多用户 / 团队共享 一个 Gateway，并为不同人设置角色上限；
5. 你关心供应链治理 ------插件注册中心有扫描、举报、下架机制与明确的信任裁决流程。

选 Hermes Agent，如果 ：

1. 你要的是**「越用越聪明」** ------闭环学习、自动建技能、跨会话记忆是它的第一性功能，不是附属品；
2. 你想在 Telegram 上跟一台从没 SSH 过的云主机对话 ，并让它跑无人值守的定时任务；
3. 你不想管一堆 API Key------hermes setup --portal 一次 OAuth 打通模型 + 搜索 + 图像 + 语音 + 浏览器；
4. 你需要多种执行后端 做安全隔离或弹性伸缩（Docker / SSH / Singularity / Modal / Daytona / Vercel Sandbox）；
5. 你的团队是 Python 技术栈 ，或者你需要把 Hermes 反过来作为 MCP 服务器接进 Claude Code / Cursor；
6. 你在做Agent 研究 ------批量轨迹生成、轨迹压缩、Atropos RL 训练是官方主推能力。

两者都装，如果 ：你想用 OpenClaw 做「可信网关 + 多渠道入口」，用 Hermes 做「后台执行 + 自我进化」------两者通过 MCP / A2A 可以互通，且官方都提供了迁移与记忆导入通道。

5.3 必须知道的风险与局限

|-----------------|-----------------------------------------------------|-------------------------------------------|
| 风险 | OpenClaw | Hermes Agent |
| 默认安全姿态 | 沙箱与 exec 审批 默认关闭 ；默认形态是「受信任的单操作员助手」 | 官方安全文档主张「对抗性 LLM 的唯一安全边界是操作系统」 |
| 容器后端下 | 沙箱默认 profile 为无网络、只读根、丢弃全部 capabilities 、非 root | 危险命令检查 在容器后端下被跳过 （容器即边界） |
| 插件信任 | 原生插件进程内运行、未沙箱化，需白名单 + 安装策略钩子 | 目录条目虽经审核，安装时仍会执行 git clone + bootstrap 命令 |
| 租户隔离 | 一个 Gateway 是一个信任域；多租户必须每租户一个 Gateway （ fleet 仍是实验性） | Profile 隔离为逻辑隔离，非强租户边界 |
| 数据擦除 | memory forget 只覆盖被跟踪工件， 不等同于物理 / 密码学擦除 | 记忆为冻结快照，会话中途改动不生效 |
| 成本失控 | 与模型选择强相关，需配合 Usage 页面监控 | Portal 200+ 模型价差可达 100 倍，需 /usage + 用量告警 |
| 平台支持 | Windows 原生部分功能受限（官方有 feature matrix ） | macOS Intel 、 pypi 、 brew 、 AUR 明确不支持 |
| Beta / 预览特性 | Code Mode 、 Swarm 、 Tool Search 为实验性 | Hermes Cloud 处于预览阶段 |

06第六章 迁移与共存

两个项目都提供了官方迁移通道。本章依次给出 OpenClaw → Hermes、Hermes → OpenClaw、Claude Code / Codex → Hermes 三条路径，以及两者长期共存的配置建议。

6.1 从 OpenClaw 迁到 Hermes： hermes claw migrate

|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| hermes claw migrate # 先预览，再确认 hermes claw migrate --dry-run # 只预览，不改磁盘 hermes claw migrate --preset full --migrate-secrets --yes hermes claw cleanup # 确认无误后，把遗留 OpenClaw 目录改名为 .pre-migration/ |

默认读取 ~/.openclaw/，并自动检测历史目录 ~/.clawdbot/ 与 ~/.moltbot/。默认会先写一份 ~/.hermes/backups/pre-migration-*.zip 快照。

迁移映射（节选） ：

|----------------|-------------------------------------------------------------------------------------------|-----------------------------------------------------------------|
| 类别 | OpenClaw 来源 | Hermes 目标 |
| 人格 | workspace/SOUL.md | ~/.hermes/SOUL.md |
| 长期记忆 | workspace/MEMORY.md | ~/.hermes/memories/MEMORY.md （按 § 分隔解析、去重合并） |
| 用户画像 | workspace/USER.md | ~/.hermes/memories/USER.md |
| 每日记忆 | workspace/memory/*.md | 合并进 MEMORY.md |
| 技能（ 4 个来源） | workspace/skills/ 、 ~/.openclaw/skills/ 、 ~/.agents/skills/ 、 workspace/.agents/skills/ | ~/.hermes/skills/openclaw-imports/ |
| 默认模型 | agents.defaults.model | config.yaml → model |
| 自定义供应商 | models.providers.* | config.yaml → custom_providers |
| MCP 服务器 | mcp.servers.* （ command / args / env / cwd / url / tools.include / exclude ） | mcp_servers.* （同构） |
| 最大轮次 | agents.defaults.timeoutSeconds | agent.max_turns （除以 10 ，上限 200 ） |
| 压缩 | agents.defaults.compaction.mode | compression.enabled |
| Docker 沙箱 | agents.defaults.sandbox.backend | terminal.backend |
| 审批模式 | approvals.exec.mode | approvals.mode （ auto → off 、 always → manual 、 smart → smart ） |
| Telegram Token | channels.telegram.botToken | .env → TELEGRAM_BOT_TOKEN |
| WhatsApp 白名单 | channels.whatsapp.allowFrom | .env → WHATSAPP_ALLOWED_USERS （ 仍需重新扫码配对 ） |

密钥迁移是显式 opted-in ：必须显式加 --migrate-secrets 才会带上，且只认白名单里的目标（OPENROUTER_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、DEEPSEEK_API_KEY、GEMINI_API_KEY、ZAI_API_KEY、MINIMAX_API_KEY、ELEVENLABS_API_KEY、TELEGRAM_BOT_TOKEN、VOICE_TOOLS_OPENAI_KEY）。source: "file" 与 source: "exec" 的 SecretRef 无法自动解析，会告警并要求手动 hermes config set。

无法直接映射、会被归档到 ~/.hermes/migration/openclaw/<timestamp>/archive/ 的项 ：IDENTITY.md（需并入 SOUL.md）、TOOLS.md、HEARTBEAT.md（改用 cron）、BOOTSTRAP.md（改用上下文文件或技能）、cron 作业、插件、钩子 / webhook、记忆后端、技能注册表、UI 身份、日志诊断配置、多 Agent 列表、渠道绑定、复杂渠道深度配置。

迁移后必做 8 件事 （官方文档清单）：查迁移报告 → 审阅归档文件 → 开新会话让技能与记忆生效 → hermes status 验密钥 → 重启网关测消息 → hermes config show 查 session_reset → hermes whatsapp 重新扫码配对 → hermes claw cleanup 清理遗留目录。

6.2 反向：从 Hermes 迁到 OpenClaw

OpenClaw 的 Control UI 提供了 Memory Import （/memory-import，从 Agents 页面的 Memory 标签进入），支持把本地 Codex、Claude Code 或 Hermes 的记忆 导入 OpenClaw Agent。

流程：选择目标 Agent → 审查检测到的来源集合与 Markdown 文件名（文件内容不在 plan 响应里传输或显示 ）→ 选择集合并确认 → 若文件已存在，启用 Replace existing imports 并刷新预览后确认替换。Planning 与 applying 需 operator.admin；每次 apply 会创建经过验证的 OpenClaw 备份、写入脱敏迁移报告，并在替换前保留条目级备份。

6.3 从 Claude Code / Codex 迁到 Hermes

|------------------------------------------------------------------------------------------------------------------------------------------------------|
| 终端命令 |
| hermes import-agent # 自动检测 ~/.claude 或 ~/.codex hermes import-agent claude-code --dry-run # 只预览 hermes import-agent codex --source /path/to/.codex |

导入内容：CLAUDE.md / AGENTS.md → 记忆条目；permissions.allow / deny → command_allowlist / approvals.deny；mcpServers → mcp_servers；技能目录 → ~/.hermes/skills/<源>-imports/。

永不导入 API 密钥与凭证 （~/.claude/.credentials.json、~/.codex/auth.json 根本不会被读取；MCP 服务器环境变量里名字像密钥的会被剥离并在报告中列出）。

6.4 共存建议

1. 不要在同一台机器上共用同一个 home 目录跑两个 Gateway ，容易状态混淆。用不同的用户或容器隔离。
2. 用 MCP 打通而非硬迁移 。Hermes 可以 hermes mcp serve 把自己暴露给外部 MCP 客户端；OpenClaw 可以直接配 MCP 服务器连过去。
3. 两边都有的能力（技能 / 记忆 / MCP 配置）保持单一事实来源 ，避免双写导致漂移。
4. 先 --dry-run 再落地 。两个项目的迁移命令都提供预览模式，且 Hermes 会强制先预览后确认。