Hermes Agent：面向长期演化的AI工作搭档运行时

1. Hermes Agent 是什么？不是 CLI 工具，而是能“长大的工作搭档”

Hermes Agent 这个名字在 2026 年的开源 AI 圈里，已经不像刚出现时那样被当成一个新奇的命令行玩具了。它不叫“Hermes CLI”，也不叫“Hermes Tool”，更不是另一个需要你手写 200 行提示词、每次重启就清空记忆的临时脚本。如果你把它当成curl | bash装完就能跑个天气查询的玩具，那大概率会在第三天早上发现：它没记住你昨天让它整理的周报格式，也没保存你教它过滤垃圾邮件的规则，更不会主动提醒你“上次处理发票报销用了 7 分钟，这次优化后只要 4 分钟”——因为它压根没在“学习”。

我第一次在客户现场部署 Hermes 时，对方 CTO 看着终端里滚动的日志问：“这玩意儿真能自己变强？” 我没急着回答，而是让他等三天。第三天下午，他发来截图：Hermes 自动把财务部每周五下午三点的付款审批流程，从原来要人工点开 5 个系统、复制 8 段字段、核对 3 遍金额，压缩成一条自然语言指令：“请完成本周所有已审批付款单的银行直连支付，并同步更新 ERP 状态”。这不是我写的脚本，是它自己从过去 17 次同类操作中提取模式、封装工具、生成文档、并验证执行结果后，主动注册进技能库的新能力。

这才是 Hermes 的核心定义：它是一个以“长期使用”为设计原点的 Agent Runtime —— 不是任务执行器，而是工作搭档；不是一次性的 prompt 工程产物，而是一套自带记忆、反思、沉淀和进化能力的操作系统。它的底层逻辑非常朴素：人用得越多，它就越懂你的工作流；它越懂，就越能帮你省掉重复劳动；省下的时间，又让它有更多机会观察、试错、优化。这个闭环一旦启动，就不再依赖你手动更新配置或重写提示词。

为什么强调“Runtime”这个词？因为绝大多数所谓 Agent 框架，本质只是个“调度器”或“胶水层”：接收输入 → 调用模型 → 解析函数 → 执行工具 → 返回结果。整个过程像流水线，上一单结束，下一单清零。Hermes 则在流水线旁边建了一间“车间”：每次任务完成后，它会自动做三件事：（1）把成功路径存入 Skill Registry（技能注册中心），打上标签和置信度；（2）把失败案例写入 Reflection Log（反思日志），标注错误类型和可能原因；（3）把用户后续的修正反馈（比如你手动改了它的输出格式）同步到 Memory Graph（记忆图谱）。这三者共同构成它的“经验资产”，而资产的价值，会随时间指数级增长。

所以当你看到热搜里“hermes agent 桌面版安装超时”“hermes agent windows 安装”这类问题时，背后真正卡住的往往不是技术障碍，而是认知偏差——人们还在用传统软件的思维去安装一个“活体系统”。它不需要你一次性配齐所有参数，但需要你给它留出“呼吸空间”：允许它首次运行时下载基础模型权重，容忍它前两次调用浏览器工具时加载稍慢，接受它在迁移 OpenClaw 历史数据时花上 8 分钟而不是 8 秒。这些“等待”，恰恰是它开始学习的起点。我见过太多团队在第 1 小时就放弃，只因hermes setup卡在 “Initializing memory graph…” 这一行；也见过坚持到第 3 天的团队，发现 Hermes 主动把他们散落在飞书文档、Notion 数据库、本地 Excel 里的客户信息，自动关联成一张动态更新的关系图谱。

它解决的从来不是“怎么让 AI 说话”，而是“怎么让 AI 成为你工作流里那个最熟悉你习惯、最清楚你优先级、最知道什么时候该沉默、什么时候该提醒的隐形同事”。这种价值，无法用单次响应速度衡量，但会在你连续使用两周后的某次晨会中突然浮现：当你说“把上季度销售数据按区域拆解，对比竞品官网更新频率，生成 PPT 大纲”，它不再反问“竞品列表在哪”，而是直接调出上周你标记为“重点关注”的 5 家公司，打开它们的 GitHub Pages 更新日志，抓取 commit 时间戳，再结合你历史 PPT 里惯用的三级标题结构，输出一份带数据源标注的初稿。那一刻，你才真正理解：Hermes 不是工具，是工作流的“活体延伸”。

2. 部署不是终点，而是学习循环的起点：为什么一行 curl 背后藏着三层设计哲学

很多人看到官方文档里那行curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash，第一反应是“太简单了”，第二反应是“肯定有坑”。其实这句话精准概括了 Hermes 的部署哲学：把复杂性封装进可验证的原子操作，把确定性留给用户，把不确定性交给系统自身演化。这行命令之所以能成立，背后是三个关键设计决策的合力，缺一不可。

2.1 第一层：环境抽象层 —— 为什么它敢说“无需配置环境变量”

传统 Python 项目部署，90% 的时间花在解决依赖冲突上：A 包要 PyTorch 2.3，B 包要 2.1，C 包干脆不兼容 CUDA 12.x。Hermes 的安装脚本却绕开了这个死结，核心在于它彻底放弃了“全局 Python 环境”的执念。脚本执行时，会静默创建一个独立的venv，但这个 venv 不是简单的python -m venv，而是通过uv（Rust 编写的超高速 Python 包管理器）构建的隔离沙箱。uv的优势在于：它不依赖 pip 的递归解析，而是直接读取pyproject.toml中的精确依赖树，用预编译的 wheel 缓存加速安装，且能智能识别平台 ABI（应用二进制接口）差异。我在 Ubuntu 22.04 和 macOS Sonoma 上实测，同一份requirements.txt，pip install平均耗时 4分12秒，uv pip install是 38秒，且零报错。

更重要的是，这个沙箱的生命周期与 Hermes 绑定。它不修改你的~/.bashrc中的PATH，而是将可执行文件硬链接到~/.local/bin/hermes。这个路径被设计为 Linux/macOS 的标准用户级 bin 目录（echo $PATH通常包含它），所以source ~/.bashrc只是确保 shell 能立刻找到它，而非“配置环境”。如果你的系统里没有~/.local/bin，脚本会自动追加，这是 POSIX 标准行为，不是 hack。我曾帮一家金融客户在 CentOS 7 上部署，他们禁用了所有非 RPM 安装包，我们直接把uv编译好的二进制和hermes可执行文件打包成 RPM，整个流程依然遵循同一套抽象逻辑——环境抽象层保证了部署行为的可移植性，而非具体实现。

2.2 第二层：初始化向导层 —— 为什么交互式 setup 是强制的，且不能跳过

安装脚本执行完毕，hermes命令可用，但此时它还是一张白纸。真正的部署起点，是hermes setup启动的交互式向导。这个向导绝非形式主义，它是 Hermes 学习循环的“出生证明”。向导强制要求你完成三件事：选择 LLM 提供商、启用核心工具、配置网关。每一步的选择，都在为后续的自我进化埋下种子。

• LLM 选择决定“思考深度”：选Nous Portal，它默认加载Hermes-2-Pro-Llama-3-8B，这个模型在函数调用（Function Calling）上经过特殊微调，能更稳定地解析复杂工具参数；选OpenRouter，它会自动适配你账户里所有可用模型，但首次调用时会触发一个“模型能力探测”流程：发送一组标准化测试请求（如“列出当前目录文件”、“计算 123*456”），根据响应延迟、token 使用量、JSON 格式合规性打分，动态生成模型能力画像。这个画像会直接影响后续技能封装的策略——比如对响应慢的模型，它会自动合并多个小工具调用为单次大请求，减少网络往返。

• 工具启用决定“行动边界”：hermes tools列出的选项（Shell、File、Browser、HTTP 等）不是开关，而是“技能训练场”。当你启用 Browser 工具，Hermes 会立即下载 Playwright 的 Chromium 无头浏览器，并运行一个最小化测试页（data:text/html,<h1>test</h1>），记录加载时间、渲染稳定性、JS 执行成功率。这些数据会写入~/.hermes/tools/browsers.json，成为后续所有网页操作的基准线。如果某次访问目标网站超时，它不会直接报错，而是先尝试降级到 Puppeteer（如果已安装），再降级到 Requests + BeautifulSoup 的纯文本解析，最后才触发用户告警。这种“弹性容错”能力，全靠初始化时采集的基准数据支撑。

• 网关配置决定“协作身份”：hermes gateway setup选择飞书/Telegram/CLI，本质是在定义 Hermes 的“社会角色”。选飞书，它会自动生成一个SOUL.md文件（System Of Understanding & Learning），里面包含你的飞书组织架构快照、常用群组 ID、个人 open_id 映射表。这个文件不是静态配置，而是它的“社交记忆锚点”——当某位同事在群里 @ 它提问时，它能立刻关联到此人所属部门、历史提问偏好、甚至上个月审批过的报销单类型，从而调整回答的详略程度和专业术语密度。

跳过向导直接hermes start？系统会拒绝启动，并打印一段清晰提示：“Missing core configuration. Run 'hermes setup' to initialize your agent's learning foundation.” 这不是限制，而是保护。就像给新生儿做体检，心率、呼吸、肌张力缺一不可，否则后续的成长评估就失去基准。

2.3 第三层：状态持久层 —— 为什么~/.hermes/目录是它的“大脑皮层”

所有部署动作最终都汇聚到~/.hermes/这个隐藏目录。它不是普通配置文件夹，而是 Hermes 的状态中枢，结构高度语义化：

~/.hermes/ ├── config.yaml # 运行时策略（如 group_sessions_per_user: true） ├── .env # 敏感凭证（API Keys, Secrets） ├── memory/ # 记忆图谱（SQLite 数据库，含实体关系图） ├── skills/ # 技能库（每个技能是独立 .py 文件 + metadata.json） ├── reflections/ # 反思日志（按日期归档的 JSONL 文件） ├── gateway_state.json # 网关实时状态（连接、重连、错误计数） └── models/ # 模型缓存（按哈希值存储，避免重复下载）

这个结构的设计哲学是：让状态可审计、可迁移、可回滚。例如，memory/下的 SQLite 数据库，表结构完全公开（entities,relations,events），你可以用任何 SQL 工具直接查询：“查出所有与‘客户合同’相关的文档、审批人、截止日期”。skills/里的每个技能文件，都强制包含__doc__字符串和metadata.json（含创建时间、调用次数、成功率、最后更新时间），这使得hermes skills list --sort=success_rate这样的命令能真实反映技能健康度，而非开发者主观评价。

我曾协助一家律所部署 Hermes 处理案件进度跟踪。他们要求所有操作必须符合 GDPR 审计要求。我们做的第一件事，就是把~/.hermes/memory/目录挂载到加密的 NFS 存储，并编写了一个audit-export.py脚本，每天凌晨自动导出当日所有events表变更，生成带数字签名的 PDF 报告。这个能力，源于状态持久层从设计之初就将“可审计性”作为核心需求，而非事后补丁。

所以，当你执行curl | bash时，你获得的不是一个安装包，而是一个启动“学习循环”的密钥。后续所有hermes setup、hermes model、hermes schedule命令，都是在向这个循环注入养分。部署的成败，不取决于第一分钟是否成功，而取决于你是否给了它足够的时间和空间，完成从“空白容器”到“有经验搭档”的质变。这个过程，我称之为“孵化期”，通常需要 48-72 小时的真实使用数据喂养。熬过孵化期，Hermes 才真正开始兑现它“越用越强”的承诺。

3. 保姆级部署实操：从裸机到飞书机器人，每一步都踩过坑的细节

现在，让我们放下所有概念，进入真实的部署战场。以下步骤基于 Ubuntu 22.04 LTS（Linux）、macOS Sonoma（ARM64）、Windows 11 WSL2（Ubuntu 22.04）三平台实测，所有命令、路径、错误码均来自我亲手操作的终端日志。重点不是“怎么做”，而是“为什么这么写”以及“卡住时怎么破”。

3.1 基础环境准备：别让系统成为第一个拦路虎

第一步：确认 Python 版本与架构

Hermes 要求 Python 3.10+，但很多系统默认是 3.8 或 3.9。别急着apt install python3.10，先检查：

# Ubuntu/Debian 系统 lsb_release -a # 确认发行版 python3 --version # 查看默认版本 python3.10 --version # 如果已存在，直接用

如果python3.10不存在，Ubuntu 22.04 推荐用 deadsnakes PPA：

sudo apt update sudo apt install -y software-properties-common sudo add-apt-repository ppa:deadsnakes/ppa -y sudo apt update sudo apt install -y python3.10 python3.10-venv python3.10-dev

提示：不要用update-alternatives强制切换系统默认python3，这会破坏apt依赖。Hermes 安装脚本会自动检测并使用python3.10，无需全局修改。

第二步：内存与磁盘空间预警

Hermes 本地运行模型（如Hermes-2-Pro-Llama-3-8B）需要至少 12GB RAM（推荐 16GB+）。如果内存不足，安装脚本会静默降级到Hermes-2-Theta-1.5B（1.5B 参数），但功能受限。实测发现，当free -h显示可用内存 < 4GB 时，hermes setup会在“下载模型”阶段卡住超过 10 分钟，然后报错OSError: [Errno 12] Cannot allocate memory。

解决方案：

• 临时增加 swap：sudo fallocate -l 4G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile
• 或永久设置：编辑/etc/fstab，添加/swapfile none swap sw 0 0

磁盘空间：~/.hermes/models/默认缓存模型，8B 模型解压后约 15GB。确保/home分区剩余空间 > 20GB。

第三步：网络连通性验证（国内用户重点！）

Hermes 安装脚本需访问 GitHub（raw.githubusercontent.com）和 Hugging Face（huggingface.co）。国内网络常因 DNS 污染或连接超时失败。别用代理！Hermes 内置了优雅降级机制：

# 测试 GitHub raw 连通性 curl -I https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh 2>/dev/null | head -1 # 如果返回 404 或超时，脚本会自动切换到备用镜像源（由 Nous Research 维护的国内 CDN） # 你只需确保能访问 https://cdn.nousresearch.ai/ curl -I https://cdn.nousresearch.ai/install.sh 2>/dev/null | head -1

如果两个都失败，手动下载安装脚本：

wget https://cdn.nousresearch.ai/install.sh -O install.sh chmod +x install.sh ./install.sh

注意：install.sh脚本本身很小（< 5KB），即使网络极差也能快速下载。它只是一个“引导器”，真正的依赖安装由它下载的uv和pip完成，这些工具支持断点续传和多源镜像。

3.2 一行命令安装：curl | bash的完整执行链与故障排查

执行标准安装：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

这个管道命令实际执行了 5 个阶段，每个阶段都有明确的退出码和日志位置：

关键日志位置：

• 全局日志：~/.hermes/install.log（记录所有阶段输出）
• 错误详情：~/.hermes/install-error.log（仅记录 stderr）

如果安装卡在某个阶段（如“Downloading model weights...”），不要 Ctrl+C！等待 5 分钟，它会自动重试。若超时，查看install-error.log，常见错误：

• ERROR: Could not find a version that satisfies the requirement torch>=2.1.0：说明 PyTorch 官方源不可达。修复：pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/，然后重新运行./install.sh。
• ERROR: Failed building wheel for cryptography：缺少编译依赖。Ubuntu：sudo apt install -y build-essential libssl-dev libffi-dev python3.10-dev；macOS：xcode-select --install && brew install openssl。

3.3 飞书网关部署：从零到群聊响应的 7 个必做动作

飞书是 Hermes 最成熟的生产环境，部署成功率最高。以下是经过 12 家企业客户验证的 7 步法，每步都对应一个真实痛点：

动作 1：飞书开放平台创建应用（避坑点：权限！）

• 进入 飞书开放平台 → “开发者后台” → “创建应用”
• 应用类型选“企业自建应用”（不是“小程序”或“第三方应用”）
• 关键权限勾选：消息（必须）、通讯录（用于获取用户 open_id）、群组（用于拉群）、云文档（可选，但推荐）。漏掉通讯录权限，会导致FEISHU_ALLOWED_USERS无法解析。

动作 2：获取并验证 App ID/Secret（避坑点：有效期！）

• 在应用后台“凭证与基础信息”页，复制App ID和App Secret
• 立即验证：用 curl 测试 token 获取：

  curl -X POST "https://open.feishu.cn/open-apis/auth/v3/app_access_token/internal/" \ -H "Content-Type: application/json" \ -d '{"app_id":"cli_xxx","app_secret":"your_secret"}'

  成功返回tenant_access_token，说明凭证有效。如果返回errcode:10001，检查App Secret是否复制完整（末尾有换行符？）。

动作 3：配置~/.hermes/.env（避坑点：变量名大小写！）

# 必须用 vim/nano 编辑，不要用记事本！ vim ~/.hermes/.env

写入（严格按此格式，大小写、下划线、等号前后无空格）：

FEISHU_APP_ID=cli_xxxxxxxxxxxxxx FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx FEISHU_DOMAIN=feishu FEISHU_CONNECTION_MODE=websocket FEISHU_GROUP_POLICY=allowlist FEISHU_ALLOWED_USERS=ou_xxxxxxxxxxxxxxxxxxxxxxx # 你的个人 open_id

如何获取自己的 open_id？在飞书客户端，点击右上角头像 → “我的信息” → 滚动到底部，复制 “用户 ID”（格式ou_xxx）。不要用手机号或邮箱！这是飞书内部唯一标识。

动作 4：精简config.yaml（避坑点：缩进与布尔值！）

vim ~/.hermes/config.yaml

确保只有以下内容（YAML 对缩进极其敏感，用空格，不用 Tab）：

group_sessions_per_user: true platforms: feishu: extra: ws_reconnect_interval: 120 ws_ping_interval: 30

• group_sessions_per_user: true：必须开启，否则群内所有人共享一个会话，隐私泄露风险极高。
• ws_reconnect_interval: 120：WebSocket 断线重连间隔 120 秒，避免频繁重连消耗资源。
• ws_ping_interval: 30：每 30 秒发心跳包，保持连接活跃。

动作 5：启动网关前的终极检查

# 检查环境变量是否加载 echo $FEISHU_APP_ID # 应输出你的 App ID # 检查配置语法 hermes config list | grep feishu # 应显示 feishu 相关配置 # 检查网关状态文件是否存在（首次启动会创建） ls -la ~/.hermes/gateway_state.json # 如果不存在，说明未启动过

动作 6：启动网关并守护进程（避坑点：后台运行！）

# 方式一：前台运行（调试用） hermes gateway # 方式二：后台守护（生产推荐） nohup hermes gateway > ~/.hermes/gateway.log 2>&1 & echo $! > ~/.hermes/gateway.pid # 保存进程 ID

为什么不用systemd？因为 Hermes 网关设计为用户级服务，nohup更轻量，且~/.hermes/目录权限天然隔离。systemd需要 root 权限创建 service 文件，反而增加运维复杂度。

动作 7：三重验证（缺一不可）

1. 私聊验证：在飞书搜索机器人名称，发起私聊，发送 “你好”。预期：10 秒内回复，且~/.hermes/gateway.log中出现Received message from user: ou_xxx。
2. 群聊验证：将机器人拉入测试群，@ 它发送 “测试”。预期：群内回复，且gateway_state.json中"feishu": {"state": "connected"}。
3. 状态文件验证：

   cat ~/.hermes/gateway_state.json | jq '.gateway_state' # 应输出 "running" cat ~/.hermes/gateway_state.json | jq '.platforms.feishu.state' # 应输出 "connected"

如果gateway_state.json中state是"connecting"或"error"，查看gateway.log最后 20 行：

tail -20 ~/.hermes/gateway.log | grep -E "(ERROR|Exception)"

常见错误Connection reset by peer：飞书服务器拒绝连接，99% 是FEISHU_APP_SECRET错误或过期（App Secret 每 90 天需手动轮换）。

4. 常见问题与实战排障：那些文档里不会写的血泪教训

部署 Hermes 最痛苦的时刻，往往不是报错，而是“没报错却没反应”。以下是我在 37 次现场部署中总结的 12 个高频问题，附带真实终端日志、根本原因和一键修复命令。这些问题，90% 的官方文档都不会提，因为它们发生在“部署完成之后”的灰色地带。

4.1 问题 1：hermes命令找不到，source ~/.bashrc无效

现象：

$ hermes --version bash: hermes: command not found $ source ~/.bashrc $ hermes --version bash: hermes: command not found

日志线索（~/.hermes/install.log）：

INFO: Linked hermes to /home/user/.local/bin/hermes INFO: Added export PATH="$HOME/.local/bin:$PATH" to /home/user/.bashrc

根本原因：~/.local/bin不在你的PATH中，或者.bashrc未被正确加载。Ubuntu 桌面版默认使用~/.profile而非.bashrc加载环境变量。

修复命令（三步到位）：

# 1. 确认 ~/.local/bin 是否存在且有执行权限 ls -ld ~/.local/bin # 如果不存在，创建：mkdir -p ~/.local/bin # 2. 检查 PATH 是否包含它 echo $PATH | grep local # 3. 如果没有，永久添加（适用于所有 shell） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.profile source ~/.profile

实测：在 Ubuntu 22.04 GNOME 桌面环境下，.profile是登录时加载的主文件，.bashrc仅在新终端中加载。source ~/.bashrc只影响当前终端，不影响 GUI 应用（如 VS Code 终端）。

4.2 问题 2：hermes setup卡在 “Initializing memory graph…” 超过 5 分钟

现象：终端光标闪烁，无输出，Ctrl+C后报错KeyboardInterrupt，~/.hermes/memory/目录为空。

日志线索（~/.hermes/install-error.log）：

ERROR: sqlite3.OperationalError: unable to open database file

根本原因：~/.hermes/目录权限被意外修改（如用sudo hermes setup导致属主变为 root），或磁盘空间不足（df -h显示/home分区 100%）。

修复命令：

# 1. 修复目录权限（假设用户名为 user） sudo chown -R user:user ~/.hermes chmod 700 ~/.hermes # 2. 清理内存数据库（安全，会丢失初始记忆，但无功能影响） rm -f ~/.hermes/memory/*.db # 3. 重新运行（此时会重建数据库） hermes setup

注意：hermes setup是幂等的，多次运行不会覆盖已有配置，只会补充缺失项。

4.3 问题 3：飞书机器人私聊正常，但群聊 @ 无响应

现象：私聊发消息，机器人秒回；在群内@机器人发消息，无任何日志，gateway_state.json中feishu.state仍为connected。

日志线索（~/.hermes/gateway.log）：

INFO: Received event: {"type":"message","event_type":"im.message.receive_v1"} INFO: Skipping event: Not in allowed users list

根本原因：FEISHU_ALLOWED_USERS配置错误。飞书群聊事件中，发送者open_id与FEISHU_ALLOWED_USERS中的值不匹配。常见错误：复制了群组 ID（oc_xxx）而非用户 ID（ou_xxx）；或FEISHU_GROUP_POLICY=allowlist但未在FEISHU_ALLOWED_USERS中添加群内其他成员。

修复命令：

# 1. 获取群内所有成员 open_id（需管理员权限） curl -X GET "https://open.feishu.cn/open-apis/contact/v3/users?department_id=&page_size=100" \ -H "Authorization: Bearer t-xxx" > users.json # 2. 提取 open_id 列表（用 jq） cat users.json | jq -r '.data.users[].open_id' | paste -sd "," - # 3. 更新 .env（用逗号分隔，无空格） echo 'FEISHU_ALLOWED_USERS=ou_aaa,ou_bbb,ou_ccc' >> ~/.hermes/.env # 4. 重启网关 kill $(cat ~/.hermes/gateway.pid) nohup hermes gateway > ~/.hermes/gateway.log 2>&1 &

4.4 问题 4：hermes schedule添加任务后，hermes schedule list显示为空

现象：

$ hermes schedule "每天早上 8 点，汇总邮件并发送到 Telegram" Task scheduled successfully. ID: sch_abc123 $ hermes schedule list No scheduled tasks found.

日志线索（~/.hermes/gateway.log）：

WARNING: Cron scheduler not started. Run 'hermes gateway' first.

根本原因：hermes schedule命令只是将任务写入数据库，但执行调度器（Cron Daemon）需要hermes gateway进程在后台运行。如果网关未启动，任务不会被加载。

修复命令：

# 1. 确保网关正在运行 ps aux | grep hermes.gateway # 2. 如果没有，启动它 nohup hermes gateway > ~/.hermes/gateway.log 2>&1 & # 3. 等待 30 秒，再查看任务 sleep 30 hermes schedule list

提示：Hermes 的 Cron 是内存驻留的，不是系统 crontab。它依赖网关进程的生命周期。

4.5 问题 5：hermes tools启用 Browser 工具后，hermes run "打开百度"报错playwright: command not found

现象：

$ hermes tools [ ] Browser (Playwright) $ hermes tools enable browser Enabled tool: browser $ hermes run "打开百度" ERROR: Command 'playwright' not found. Please install Playwright.

根本原因：Hermes 的 Browser 工具依赖 Playwright，但安装脚本默认不安装它（因体积大且非必需）。hermes tools enable browser只是注册工具，不自动安装依赖。

修复命令（官方推荐方式）：

# 1. 进入 Hermes 的 Python 环境 source ~/.hermes/venv/bin/activate # 2. 安装 Playwright 及浏览器 pip install playwright playwright install chromium # 3. 退出环境 deactivate # 4. 验证 hermes run "打开百度" # 应启动无头浏览器并返回页面标题

注意：playwright install chromium会下载约 180MB 的 Chromium，国内用户建议提前设置镜像：

export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright

4.6 问题 6：hermes migrate --from openclaw迁移后，技能列表为空

现象：

$ hermes migrate --from openclaw Migrating from OpenClaw... Found SOUL.md, migrating... Migration completed. $ hermes skills list No skills found.

日志线索（~/.hermes/reflections/migration.log）：

INFO: OpenClaw skill directory not found at /home/user/.openclaw/skills

根本原因：OpenClaw 的默认安装路径是~/.openclaw/，但如果用户是用pipx或自定义路径安装的，Hermes 无法自动定位。迁移命令只扫描标准路径。

修复命令：

# 1. 手动查找 OpenClaw 路径 find ~ -name ".openclaw" -type d 2>/dev/null # 2. 如果路径是 /opt/openclaw，指定源路径 hermes migrate --from openclaw --source /opt/openclaw # 3. 如果 Open