OpenClaw + Hermes 速查表

一、安装与初始配置

OpenClaw（v2026.8.1）
- openclaw config set gateway.bind loopback  
  将网关监听地址强制绑定到本地回环（127.0.0.1），防止端口暴露到公网，是装完后的第一道安全保险。
- openclaw doctor --fix  
  自动检测并修复常见配置错误、依赖缺失或权限问题，建议安装后立即执行一次。
- openclaw gateway restart  
  重启网关服务，让刚才改的配置（如绑定地址）生效。

Hermes（v0.20.0）
- curl -fsSL https://hermes.nousresearch.com/install | bash  
  一键下载并执行官方安装脚本，适用于 Linux/macOS。
- hermes setup  
  交互式引导你完成初始配置，包括选择默认模型、设置密钥等。
- hermes doctor  
  检查当前环境是否满足运行要求，比如依赖库、网络连通性、API密钥有效性。

OpenClaw
- openclaw gateway status  
  查看网关进程是否在正常运行，是排错的第一步。
- openclaw status --all  
  输出完整的系统状态报告，包括各个模块、连接渠道、会话计数等详细信息。
- openclaw logs --follow  
  实时滚动输出日志，用来观察运行过程或追踪故障现场。
- openclaw channels status --probe  
  主动探测所有已配置的通信渠道（Telegram、Slack 等），检查连接是否畅通。

Hermes
- hermes chat -q "hello"  
  以一次性问答方式运行，测试核心推理是否正常，不打开交互会话。
- hermes gateway status  
  查看 Hermes 网关（如有启用）的运行状态。
- hermes doctor  
  与 OpenClaw 的 doctor 类似，但只做诊断不自动修复（需手动处理）。

OpenClaw
- openclaw gateway restart  
  重启网关，是解决大多数网络消息延迟、Webhook 失效等问题的最常用手段。
- openclaw config set gateway.bind loopback  
  除了安装时设置，也用于后续将网关改回本地安全模式。

Hermes
- hermes gateway restart  
  重启网关，主要用于清除陈旧轮询（stale polling）导致的卡顿。
- hermes gateway status  
  检查网关是否存活，在排查连接故障时很有用。

两者通用
- /new  
  清空当前会话历史，但保留长期记忆（OpenClaw 保留 MEMORY.md，Hermes 保留三层记忆结构）。用于开始全新话题，不污染旧上下文。
- /compact（Hermes 还可用 /compress）  
  强制压缩当前上下文窗口，将较旧的对话摘要化，以释放 token 空间，避免超限。

OpenClaw 独有
- /btw  
  插入一个“顺便问一句”式问题，该问答不会写入主会话历史，适合临时查询。
- /model sonnet  
  在当前会话中直接切换模型提供商（如从 DeepSeek 换到 Claude Sonnet），无需退出重启。

Hermes 独有
- /learn  
  将当前对话中反复出现的工作流程自动提炼成可复用的技能（skill），并保存到本地。
- /moa  
  开启 Mixture-of-Agents 模式，让多个子模型协同回答复杂问题。
- hermes sessions list  
  列出所有已保存的会话记录，便于选择或清理。
- hermes sessions clean  
  删除旧会话，释放存储空间，避免数据库膨胀。

OpenClaw
- openclaw skills list  
  查看本地已安装的所有技能（skill）插件。
- openclaw skills install  
  从 ClawHub（拥有 13,700+ 技能）下载并安装指定技能。
- openclaw tools  
  列出当前激活的外部工具（如代码执行、浏览器、文件读写等），确认可用性。

Hermes
- hermes skills list  
  显示已安装或自动生成的技能列表。
- hermes skills install  
  从指定源（本地路径或仓库）安装一个新技能。
- hermes skills enable  
  激活某个已安装的技能，使其可以在会话中被调用。
- hermes curator  
  进入技能管理面板，查看、编辑或删除由 /learn 自动生成的技能。
- hermes memory setup  
  配置记忆后端（如本地文件、向量数据库等），用于长期存储情景和程序记忆。

OpenClaw
- ~/.openclaw/openclaw.json – 主配置文件（JSON 格式），包含模型、渠道、行为参数。
- ~/.openclaw/agents/main/SOUL.md – 定义智能体的“人格”和交互边界，用自然语言书写。
- ~/.openclaw/agents/main/MEMORY.md – 长期记忆文件，AI 会持续读写这里的信息。
- ~/.openclaw/agents/main/AGENTS.md – 编写自动化规则（如定时任务、触发条件）的地方。

Hermes
- ~/.hermes/config.yaml – 主配置文件（YAML 格式）。
- ~/.hermes/active_profile – 纯文本文件，记录当前激活的 profile 名称。
- ~/.hermes/souls/default.md – 人格定义（等同于 OpenClaw 的 SOUL.md）。
- ~/.hermes/state.db – SQLite 数据库，存储所有会话历史、记忆和技能元数据。
- ~/.hermes/skills/ – 存放自动生成及手动安装的技能脚本目录。

OpenClaw 五步修复法
1. openclaw status --all – 先看整体状态。
2. openclaw doctor --fix – 让系统自动修。
3. openclaw gateway restart – 硬重启网关。
4. rm ~/.openclaw/agents/main/sessions/*.lock – 删除会话残留锁文件（解决“卡死”问题）。
5. curl -sf http://127.0.0.1:18789/health – 手动探测健康检查端点，判断网关是否真的活着。

Hermes 六步排查法
1. hermes chat -q "hello" – 测试最基本的推理功能。
2. hermes gateway status – 检查网关是否运行。
3. hermes config show | grep -A3 allowed – 查看配置中是否允许当前请求（如 API 密钥、渠道白名单）。
4. cat ~/.hermes/active_profile – 确认当前使用的 profile 是否正确。
5. ps aux | grep -E 'hermes|openclaw' | grep -v grep – 查看是否有重复的轮询进程互相干扰。
6. dmesg | grep -i "killed process" – 检查操作系统是否因内存不足（OOM）杀掉了 Hermes 进程。

心跳、定时任务、简单分类：Gemini Flash（免费）或 Groq（免费） | 成本最低，适合高频低负载场景。 
日常对话、草稿、研究 ： Sonnet 5 或 GLM-5.2 | 输出质量稳定，适合需要人工阅读的结果。 
高难度任务 ：Opus 5 | 调用频率建议每周 2-3 次，贵但精准。 
超长上下文 ：Kimi K3（1M token 窗口） | 处理长文档或大批量数据处理。 
本地离线运行 ： Qwen3.6-35B-A3B 或 Gemma 4 12B | 16GB 显存可跑，完全免费无 API 依赖。 

无论用哪套工具，当遇到异常时，按以下顺序执行，能解决 90% 的日常故障：

1. 查状态 → openclaw status --all 或 hermes doctor  
2. 自动修复 → openclaw doctor --fix 或 hermes doctor  
3. 重启网关 → openclaw gateway restart 或 hermes gateway restart  
4. 清会话 → /new  
5. 锁定网关 → openclaw config set gateway.bind loopback（仅 OpenClaw，Hermes 默认安全）