Featured image of post Hermes + OpenClaw 新手部署与配置指南(2026)
自动化

Hermes + OpenClaw 新手部署与配置指南(2026)

把本站五篇 Hermes/OpenClaw 实测教程串成一条新手动线:怎么选、怎么装、怎么配模型、skills 互通、常见问题速查。对照活实例核验。

这份指南把本站上五篇 Hermes / OpenClaw 实测文章串成了一条完整的动线:选哪个 → 怎么装 → 怎么配模型 → skills 怎么用。所有命令都于 2026-07-31 对着真实运行的实例核验过,不是抄官方文档凑数。两个项目迭代都很快,动手前建议重新核对官方文档。

〇、这俩是干嘛的?

Hermes 和 OpenClaw 都是开源、可自托管的 AI agent(智能体)框架,都是 MIT 协议、免费、装在你自己机器上。

“AI agent"和普通聊天机器人的区别:它不只是回话,还能调工具、跑脚本、记状态、跨多个聊天软件同时在线。核心循环都一样:

你在某个聊天软件(Telegram/微信/飞书/Discord……)里给它发消息 → agent 思考、调用工具 → 把结果回复给你。

两者的出身和性格不同:

  • Hermes(Python 写的,Nous Research 出品):主打”会自我进化的 agent"——它有个 skills 系统,能从使用经验里自动创建和改进 skill,越用越强。对国内聊天软件(微信/飞书/钉钉/企微/QQ)支持最全。
  • OpenClaw(Node.js/TypeScript 写的):主打"多渠道网关"——支持的聊天软件最广(24+ 个,包括 iMessage、Nostr、Teams、Line、Twitch 这些冷门渠道),还有个成熟的社区 skills 市场。

新手怎么选,一句话:

  • 想要一个"越用越聪明"的 agent、或者你要接微信/飞书 → 选 Hermes。
  • 想要渠道覆盖最广、喜欢 Node/TS 技术栈、想逛 skills 市场 → 选 OpenClaw。
  • 拿不定主意 → 两个可以装在同一台机器上共存,互不影响(配置目录分别是 ~/.hermes 和 ~/.openclaw)。实际上很多人(包括我)就是两个都跑。

名词解释:MCP(Model Context Protocol)是给 agent 接外部工具的通用协议,两个框架都支持;skill 是教 agent 干某类活的"技能包"(一个 SKILL.md 说明文件 + 配套脚本);provider 是模型供应商(你的 agent 背后用哪个大模型,比如 GPT、Claude、Kimi)。

两者在链路里的角色:

一、装前准备

系统要求:

  • 一台 Linux 机器,或者 Windows 上的 WSL2(Windows Subsystem for Linux,Windows 里的 Linux 子系统)。两个框架在 WSL2 上的装法和纯 Linux 完全一致。macOS 也可以(OpenClaw 在 macOS 用 launchd 管理服务)。
  • 装 Hermes:不用提前准备任何东西,官方安装脚本会自带全部依赖(uv、Python 3.11、Node.js、ripgrep、ffmpeg)。
  • 装 OpenClaw:需要先有 Node.js 20 或更高版本(node --version 检查)。
  • 一个模型 API key(第四章细讲)——agent 没有模型就是空壳。

全程大概 15-30 分钟,大部分是等下载。

二、安装 Hermes(Python,自我进化派)

第 1 步:一键安装

1

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

装完所有东西都在 ~/.hermes 目录里,和你系统的 Python 完全隔离(不会搞坏系统环境)。

验证装好了:

1

hermes --version

如果提示找不到 hermes 命令:安装器把命令软链到了 ~/.local/bin,检查这个目录在不在你的 PATH 里(WSL2 默认一般都在)。

第 2 步:跑配置向导

1

hermes setup

交互式问答,一次性走完:选模型 provider、配聊天渠道、装 skills。喜欢网页界面的话用 hermes setup --portal。

第 3 步:启动网关并聊天

1
2

hermes gateway setup    # 配置消息渠道(Telegram 等)
hermes gateway start    # 启动网关

然后去你配好的聊天软件里给 bot 发条消息,通了。

第 4 步(强烈建议):让它开机自启、关掉终端也不停

hermes gateway start 是跑在你当前终端里的——终端一关它就停。要让它 7×24 常驻,用 systemd user 服务(Linux 的用户级后台服务管理机制)。

新建文件 ~/.config/systemd/user/hermes-gateway.service,内容如下(照抄即可,%h 会自动展开成你的 home 目录):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

[Unit]
Description=Hermes Agent Gateway - Messaging Platform Integration
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=%h/.hermes/hermes-agent/venv/bin/python -m hermes_cli.main gateway run
WorkingDirectory=%h/.hermes
Environment="HERMES_HOME=%h/.hermes"
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

然后执行:

1
2
3
4

systemctl --user daemon-reload
loginctl enable-linger $USER          # 关键:让你注销/没登录时服务也照跑
systemctl --user enable --now hermes-gateway.service
systemctl --user status hermes-gateway.service   # 看到 active (running) 就对了

名词解释:linger 是 systemd 的一个开关。默认情况下,你的用户服务只在你登录期间运行;开了 linger,机器重启后不等任何人登录,你的服务就会自动起来。WSL2 里同样适用。

Hermes 排坑速查:

  • 服务起不来 → journalctl --user -u hermes-gateway.service -f 看日志。九成是第 2 步 hermes setup 没走完(缺模型或渠道配置),回去补完再启。
  • 服务日志里 PATH 混着 Windows 路径 → 这是 WSL2 的正常现象,纯外观问题,不用管。

三、安装 OpenClaw(Node.js,多渠道网关派)

第 1 步:npm 全局安装

先确认 Node.js ≥ 20(node --version),然后:

1
2

npm install -g openclaw
openclaw --version

第 2 步:交互式配置

1

openclaw configure

一次性走完:凭据、渠道、网关、agent 默认值。配置文件在 ~/.openclaw/openclaw.json,密钥单独放在 ~/.openclaw/.env(密钥绝不写进配置文件,这个设计两家一样)。

非交互校验配置是否合法:

1

openclaw config validate

第 3 步:装成系统服务并启动

这是 OpenClaw 比 Hermes 省心的地方:它自己生成 systemd 服务,不用你手写 unit 文件:

1
2
3
4

openclaw gateway install    # 自动创建 systemd user 服务
openclaw gateway start      # 启动
openclaw gateway status     # 确认在跑
loginctl enable-linger $USER   # 同样建议开 linger(开机自启+注销后仍运行)

想前台调试就跑 openclaw gateway run。

第 4 步:加聊天渠道

1

openclaw channels

按提示添加并登录渠道(Telegram/WhatsApp/Discord/飞书……24+ 个可选),然后去对应软件里发消息测试。

OpenClaw 专属坑:版本滞后警告(真实踩过)

如果 OpenClaw 每次运行都报警:“你的 config 由 2026.7.1-2 写,但当前命令跑的是 2026.6.8”——别慌,你的配置没丢。原因是 npm 全局装的二进制版本,比当初写配置文件的版本旧(比如你装过更新的 dev 版又回退了)。修法:

  1. 让 openclaw 命令指向你要的那个版本(调 PATH 或你的 node 版本管理器);
  2. openclaw gateway uninstall && openclaw gateway install 用同一个版本重装服务;
  3. openclaw gateway status --deep 确认服务和版本一致。

四、配置模型 Provider(两家通用思路)

agent 框架本身不带模型,必须接一个大模型供应商(provider)才有"脑子"。

Hermes:一条命令交互式选模型

1

hermes model

它会列出可用 provider、自动拉取每个 provider 的模型列表(/v1/models),让你选默认模型。Nous 托管的 provider 支持 OAuth 登录;在没有浏览器的纯命令行机器上,加 --no-browser 或 --manual-paste。刷新 provider 列表用 hermes model --refresh。

配置落在 ~/.hermes/config.yaml,长这样(只示意结构):

1
2
3
4
5
6
7
8

model:               # 默认模型
  provider: <名字>
  api_mode: <模式>
providers:           # 各个命名 provider
  <名字>:
    base_url: <https://...>
    api_mode: <模式>
    models: [...]

OpenClaw:configure 或精确到字段的命令

openclaw configure 的向导里就包含模型配置。想脚本化精确改某个字段:

1
2
3
4
5

openclaw config file                    # 看配置文件路径
openclaw config schema                  # 看配置结构的 JSON schema
openclaw config get providers.models    # 按路径读值
openclaw config set <path> <value>      # 按路径改值
openclaw config patch --file ./patch.json5   # 批量写入(带校验)

密钥放 ~/.openclaw/.env,配置里引用对应的环境变量名(如 NEWAPI_KEY、CPAMC_KEY)。

进阶:接自建代理(CPA / NewAPI)

两家都认 OpenAI 兼容接口(base_url + API key 那一套)。所以如果你自建了模型代理(比如 CPA 跑在 :8317,或 NewAPI),接法完全一样:

  1. 把代理跑起来;
  2. 在 agent 配置里加一个 provider,base_url 指向代理地址;
  3. 代理的 API key 放进环境变量;
  4. 用 hermes model 或 openclaw configure 把它选成默认模型。

好处:一个本地代理后面挂多个上游模型/key,agent 只认代理——以后换上游模型,agent 这边的配置一行都不用动。

五、Skills:两边通用,一次装好两处使

好消息:Hermes 和 OpenClaw 的 skill 包是同一种格式(标准 agent-skill 格式:一个 SKILL.md + YAML 头部 + 配套的 examples/、scripts/ 等目录),而且从同一批 registry(skills.sh、ClawHub、GitHub 等)下载。实测同一个 skill 在两边装出来逐字节相同。

各自的管理命令:

1
2
3
4
5
6
7

# Hermes(功能更全)
hermes skills browse / search / install / list / update / uninstall ...
hermes bundles        # 多 skill 组合包
hermes curator        # 独门:后台进程从使用经验里自动改进 skill(自我进化)

# OpenClaw(精简)
openclaw skills list / inspect / install

唯一的兼容性坑:skill 的说明文档是通用的,但 skill 里带的脚本可能是特定语言的。如果一个 skill 的脚本是 Python 写的,Hermes 天生能跑;OpenClaw 那边就得机器上装了 Python 才行。这是按 skill 逐个看的,不是框架级的问题。

六、常见问题速查

症状解法
hermes: command not found确认 ~/.local/bin 在 PATH 里
Hermes 服务起不来journalctl --user -u hermes-gateway.service -f 看日志;多半是 hermes setup 没走完
重启后 agent 没自动起来漏了 loginctl enable-linger $USER
OpenClaw 报"config 由更新版本写的"版本滞后坑,见第三章末尾:对齐版本后重装 gateway 服务
不知道配置合不合法OpenClaw:openclaw config validate
换模型要改一堆配置用自建代理(CPA/NewAPI)挡在前面,换上游不动 agent 配置

七、延伸阅读(各专题的完整实测细节)

时效声明

本指南所有命令与配置结构于 2026-07-31 对照活实例核验(Hermes v0.16.0、OpenClaw 2026.7.1-2)。两个项目迭代都快,如果你读到这份指南时日期已经差了几个月,请以官方文档为准: