常见问题与故障排查

针对最常见问题的快速解答与修复方案。

常见问题

Hermes 支持哪些 LLM 提供商？

Hermes Agent 兼容任何 OpenAI 兼容的 API。支持的提供商包括：

OpenRouter — 通过一个 API 密钥访问数百个模型（灵活性首选）
Nous Portal — Nous Research 自有推理端点
OpenAI — GPT-4o、o1、o3 等
Anthropic — Claude 模型（通过 OpenRouter 或兼容代理）
Google — Gemini 模型（通过 OpenRouter 或兼容代理）
z.ai / ZhipuAI — GLM 模型
Kimi / Moonshot AI — Kimi 模型
MiniMax — 全球端点和中国端点
本地模型 — 通过 Ollama、vLLM、llama.cpp、SGLang 或任何 OpenAI 兼容服务器

使用 hermes model 或编辑 ~/.hermes/.env 来设置提供商。所有提供商密钥请参阅环境变量参考文档。

是否支持 Windows？

不支持原生 Windows。 Hermes Agent 需要类 Unix 环境。在 Windows 上，请安装 WSL2 并在其中运行 Hermes。标准安装命令在 WSL2 中可完美运行：

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

在 WSL2 中使用 Hermes 时，如何控制 Windows 上的 Chrome？

推荐使用 MCP 桥接而非 /browser connect。

推荐方案：

在 WSL2 内运行 Hermes
继续在 Windows 上使用已登录的普通 Chrome
通过 cmd.exe 或 powershell.exe 将 chrome-devtools-mcp 添加为 MCP 服务器
让 Hermes 使用 MCP 浏览器工具

这比尝试让 Hermes 核心浏览器传输跨越 WSL2/Windows 边界直接连接更为可靠。

参见：

是否支持 Android / Termux？

是的——Hermes 已提供针对 Android 手机的 Termux 安装路径。

快速安装：

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

完整的手动步骤、支持的扩展包及当前限制，请参阅 Termux 指南。

重要说明：.[all] 扩展包目前在 Android 上不可用，因为 voice 扩展依赖 faster-whisper → ctranslate2，而 ctranslate2 未发布 Android wheel 包。请改用经过测试的 .[termux] 扩展包。

我的数据会被发送到哪里？

API 调用仅发送至你配置的 LLM 提供商（例如 OpenRouter、本地 Ollama 实例）。Hermes Agent 不收集遥测数据、使用数据或分析数据。你的对话、记忆和技能均存储在本地 ~/.hermes/ 目录中。

能否离线使用或使用本地模型？

可以。运行 hermes model，选择自定义端点，然后输入服务器 URL：

hermes model
# 选择：自定义端点（手动输入 URL）
# API 基础 URL: http://localhost:11434/v1
# API 密钥: ollama
# 模型名称: qwen3.5:27b
# 上下文长度: 32768   ← 设置为与服务器实际上下文窗口匹配的值

或直接在 config.yaml 中配置：

model:
  default: qwen3.5:27b
  provider: custom
  base_url: http://localhost:11434/v1

Hermes 会将端点、提供商和 base URL 持久化到 config.yaml 中，重启后仍然有效。如果本地服务器只加载了一个模型，/model custom 可自动检测。你也可以在 config.yaml 中设置 provider: custom——它是一个独立的一等提供商，不是其他任何东西的别名。

这适用于 Ollama、vLLM、llama.cpp server、SGLang、LocalAI 等。详情请参阅配置指南。

Ollama 用户

如果你在 Ollama 中设置了自定义 num_ctx（例如 ollama run --num_ctx 16384），请确保在 Hermes 中设置匹配的上下文长度——Ollama 的 /api/show 返回的是模型的最大上下文，而非你配置的有效 num_ctx。

本地模型超时问题

Hermes 会自动检测本地端点并放宽流式传输超时限制（读取超时从 120 秒提高到 1800 秒，并禁用停滞流检测）。如果在非常大的上下文下仍然超时，请在 .env 中设置 HERMES_STREAM_READ_TIMEOUT=1800。详情请参阅本地 LLM 指南。

使用费用是多少？

Hermes Agent 本身是免费且开源的（MIT 许可证）。你只需支付所选提供商的 LLM API 费用。本地模型完全免费运行。

多人能否使用同一个实例？

可以。消息网关允许多个用户通过 Telegram、Discord、Slack、WhatsApp 或 Home Assistant 与同一个 Hermes Agent 实例交互。访问控制通过白名单（特定用户 ID）和私信配对（第一个发消息的用户获得独占访问权）来管理。

记忆与技能有什么区别？

记忆存储事实——Agent 了解的关于你、你的项目和偏好的信息。记忆根据相关性自动检索。
技能存储流程——如何完成某件事的分步说明。技能在 Agent 遇到类似任务时被调用。

两者都跨会话持久化。详情请参阅记忆和技能。

能否在自己的 Python 项目中使用？

可以。导入 AIAgent 类，以编程方式使用 Hermes：

from run_agent import AIAgent

agent = AIAgent(model="anthropic/claude-opus-4.7")
response = agent.chat("Explain quantum computing briefly")

完整的 API 使用方法请参阅 Python 库指南。

故障排查

安装问题

安装后出现 `hermes: command not found`

原因： Shell 未重新加载更新后的 PATH。

解决方案：

# 重新加载 Shell 配置文件
source ~/.bashrc    # bash
source ~/.zshrc     # zsh

# 或开启一个新的终端会话

如果仍然无效，请验证安装位置：

which hermes
ls ~/.local/bin/hermes

提示

安装程序会将 ~/.local/bin 添加到 PATH。如果你使用非标准的 Shell 配置，请手动添加 export PATH="$HOME/.local/bin:$PATH"。

Python 版本过旧

原因： Hermes 需要 Python 3.11 或更高版本。

解决方案：

python3 --version   # 检查当前版本

# 安装较新的 Python
sudo apt install python3.12   # Ubuntu/Debian
brew install python@3.12      # macOS

安装程序会自动处理此问题——如果在手动安装时出现此错误，请先升级 Python。

终端命令提示 `node: command not found`（或 `nvm`、`pyenv`、`asdf` 等）

原因： Hermes 在启动时通过运行一次 bash -l 来构建每个会话的环境快照。bash 登录 Shell 会读取 /etc/profile、~/.bash_profile 和 ~/.profile，但不会 source ~/.bashrc——因此通过 ~/.bashrc 安装自身的工具（nvm、asdf、pyenv、cargo、自定义 PATH 导出）在快照中是不可见的。这种情况最常发生在 Hermes 在 systemd 下运行或在最小化 Shell 中运行，且没有预先加载交互式 Shell 配置文件时。

解决方案： Hermes 默认自动 source ~/.bashrc。如果这还不够——例如你是一个 PATH 存储在 ~/.zshrc 中的 zsh 用户，或从独立文件初始化 nvm——请在 ~/.hermes/config.yaml 中列出需要额外 source 的文件：

terminal:
  shell_init_files:
    - ~/.zshrc                     # zsh 用户：将 zsh 管理的 PATH 引入 bash 快照
    - ~/.nvm/nvm.sh                # 直接初始化 nvm（不依赖 Shell）
    - /etc/profile.d/cargo.sh      # 系统级 rc 文件
  # 设置此列表时，默认的 ~/.bashrc 自动 source 不会被添加——
  # 如需同时保留，请显式包含：
  #   - ~/.bashrc
  #   - ~/.zshrc

缺失的文件会被静默跳过。source 在 bash 中执行，因此依赖 zsh 特有语法的文件可能会报错——如有顾虑，只 source PATH 设置部分（例如直接 source nvm 的 nvm.sh），而非整个 rc 文件。

如需禁用自动 source 行为（仅使用严格的登录 Shell 语义）：

terminal:
  auto_source_bashrc: false

`uv: command not found`

原因： uv 包管理器未安装或不在 PATH 中。

解决方案：

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

安装过程中出现权限拒绝错误

原因： 对安装目录没有足够的写入权限。

解决方案：

# 不要对安装程序使用 sudo——它安装到 ~/.local/bin
# 如果之前使用 sudo 安装，请先清理：
sudo rm /usr/local/bin/hermes
# 然后重新运行标准安装程序
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

提供商与模型问题

`/model` 只显示一个提供商 / 无法切换提供商

原因： /model（在聊天会话内）只能在你已配置的提供商之间切换。如果你只设置了 OpenRouter，/model 只会显示它。

解决方案： 退出当前会话，使用终端中的 hermes model 添加新提供商：

# 先退出 Hermes 聊天会话（Ctrl+C 或 /quit）

# 运行完整的提供商设置向导
hermes model

# 这让你可以：添加提供商、运行 OAuth、输入 API 密钥、配置端点

通过 hermes model 添加新提供商后，开启新的聊天会话——/model 将会显示所有已配置的提供商。

快速参考

想要...	使用
添加新提供商	`hermes model`（在终端中）
输入/更改 API 密钥	`hermes model`（在终端中）
会话中途切换模型	`/model <name>`（在会话内）
切换到不同的已配置提供商	`/model provider:model`（在会话内）

API 密钥不起作用

原因： 密钥缺失、过期、设置错误或属于错误的提供商。

解决方案：

# 检查配置
hermes config show

# 重新配置提供商
hermes model

# 或直接设置
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxxxxxx

注意

确保密钥与提供商匹配。OpenAI 密钥不能用于 OpenRouter，反之亦然。检查 ~/.hermes/.env 是否有冲突的条目。

模型不可用 / 找不到模型

原因： 模型标识符不正确或在你的提供商上不可用。

解决方案：

# 列出提供商可用的模型
hermes model

# 设置有效的模型
hermes config set HERMES_MODEL anthropic/claude-opus-4.7

# 或按会话指定
hermes chat --model openrouter/meta-llama/llama-3.1-70b-instruct

速率限制（429 错误）

原因： 超出了提供商的速率限制。

解决方案： 稍等片刻后重试。对于持续使用，可以考虑：

升级提供商计划
切换到不同的模型或提供商
使用 hermes chat --provider <alternative> 路由到不同的后端

超出上下文长度

原因： 对话内容超过了模型上下文窗口，或 Hermes 检测到的模型上下文长度有误。

解决方案：

# 压缩当前会话
/compress

# 或开启新会话
hermes chat

# 使用上下文窗口更大的模型
hermes chat --model openrouter/google/gemini-3-flash-preview

如果在第一次长对话时就出现此问题，Hermes 可能对你的模型检测到了错误的上下文长度。查看检测到的值：

查看 CLI 启动行——它会显示检测到的上下文长度（例如 📊 Context limit: 128000 tokens）。也可以在会话中使用 /usage 查看。

要修复上下文检测，请显式设置：

# 在 ~/.hermes/config.yaml 中
model:
  default: your-model-name
  context_length: 131072  # 你的模型实际的上下文窗口

对于自定义端点，也可以按模型设置：

custom_providers:
  - name: "My Server"
    base_url: "http://localhost:11434/v1"
    models:
      qwen3.5:27b:
        context_length: 32768

自动检测的工作方式及所有覆盖选项，请参阅上下文长度检测。

终端问题

命令被阻止为危险操作

原因： Hermes 检测到潜在的破坏性命令（例如 rm -rf、DROP TABLE）。这是一项安全功能。

解决方案： 出现提示时，检查命令并输入 y 以批准。你也可以：

要求 Agent 使用更安全的替代方案
在安全文档中查看完整的危险模式列表

提示

这是按预期工作的——Hermes 不会静默执行破坏性命令。审批提示会明确显示将要执行的内容。

通过消息网关时 `sudo` 无效

原因： 消息网关在没有交互式终端的情况下运行，因此 sudo 无法提示输入密码。

解决方案：

在消息中避免使用 sudo——让 Agent 找到替代方案
如果必须使用 sudo，在 /etc/sudoers 中为特定命令配置免密 sudo
或切换到终端界面进行管理任务：hermes chat

Docker 后端无法连接

原因： Docker 守护进程未运行或用户没有权限。

解决方案：

# 检查 Docker 是否在运行
docker info

# 将你的用户添加到 docker 组
sudo usermod -aG docker $USER
newgrp docker

# 验证
docker run hello-world

消息问题

机器人不响应消息

原因： 机器人未运行、未授权，或你的用户不在白名单中。

解决方案：

# 检查网关是否在运行
hermes gateway status

# 启动网关
hermes gateway start

# 检查错误日志
cat ~/.hermes/logs/gateway.log | tail -50

消息未送达

原因： 网络问题、机器人令牌过期或平台 Webhook 配置错误。

解决方案：

使用 hermes gateway setup 验证机器人令牌是否有效
检查网关日志：cat ~/.hermes/logs/gateway.log | tail -50
对于基于 Webhook 的平台（Slack、WhatsApp），确保服务器可公开访问

白名单混乱——谁可以与机器人对话？

原因： 授权模式决定了谁可以访问。

解决方案：

模式	工作方式
白名单	只有配置中列出的用户 ID 才能交互
私信配对	第一个在私信中发消息的用户获得独占访问权
开放	任何人均可交互（不建议用于生产环境）

在 ~/.hermes/config.yaml 的网关设置下进行配置。请参阅消息文档。

网关无法启动

原因： 缺少依赖项、端口冲突或令牌配置错误。

解决方案：

# 安装核心消息网关依赖项
pip install "hermes-agent[messaging]"  # Telegram、Discord、Slack 及共享网关依赖

# 检查端口冲突
lsof -i :8080

# 验证配置
hermes config show

WSL：网关持续断线或 `hermes gateway start` 失败

原因： WSL 的 systemd 支持不稳定。许多 WSL2 安装没有启用 systemd，即使启用了，服务也可能在 WSL 重启或 Windows 空闲关机后无法恢复。

解决方案： 使用前台模式而非 systemd 服务：

# 方案一：直接前台运行（最简单）
hermes gateway run

# 方案二：通过 tmux 持久运行（终端关闭后仍然存活）
tmux new -s hermes 'hermes gateway run'
# 稍后重新连接：tmux attach -t hermes

# 方案三：通过 nohup 在后台运行
nohup hermes gateway run > ~/.hermes/logs/gateway.log 2>&1 &

如果想尝试 systemd，请确保它已启用：

打开 /etc/wsl.conf（如不存在则创建）
添加：
```
[boot]
systemd=true
```
在 PowerShell 中运行：wsl --shutdown
重新打开 WSL 终端
验证：systemctl is-system-running 应显示 "running" 或 "degraded"

Windows 开机自启

要实现可靠的开机自启，使用 Windows 任务计划程序在登录时启动 WSL + 网关：

创建一个任务，运行 wsl -d Ubuntu -- bash -lc 'hermes gateway run'
设置在用户登录时触发

macOS：网关找不到 Node.js / ffmpeg / 其他工具

原因： launchd 服务继承的是最小化 PATH（/usr/bin:/bin:/usr/sbin:/sbin），不包含 Homebrew、nvm、cargo 或其他用户安装的工具目录。这通常会导致 WhatsApp 桥接失败（node not found）或语音转录失败（ffmpeg not found）。

解决方案： 网关在你运行 hermes gateway install 时会捕获你的 Shell PATH。如果你在设置网关后安装了新工具，请重新运行 install 以捕获更新后的 PATH：

hermes gateway install    # 重新快照当前 PATH
hermes gateway start      # 检测更新后的 plist 并重新加载

可以验证 plist 中是否包含正确的 PATH：

/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" \
  ~/Library/LaunchAgents/ai.hermes.gateway.plist

性能问题

响应缓慢

原因： 模型大、API 服务器较远，或系统提示中包含大量工具。

解决方案：

尝试更快/更小的模型：hermes chat --model openrouter/meta-llama/llama-3.1-8b-instruct
减少活跃工具集：hermes chat -t "terminal"
检查到提供商的网络延迟
对于本地模型，确保有足够的 GPU 显存

Token 用量过高

原因： 对话时间长、系统提示冗长，或大量工具调用积累了上下文。

解决方案：

# 压缩对话以减少 token 数
/compress

# 检查会话 token 用量
/usage

提示

在长会话中定期使用 /compress。它会汇总对话历史，在保留上下文的同时显著减少 token 用量。

会话过长

原因： 长时间的对话积累了大量消息和工具输出，接近上下文限制。

解决方案：

# 压缩当前会话（保留关键上下文）
/compress

# 开启新会话并引用旧会话
hermes chat

# 需要时恢复特定会话
hermes chat --continue

MCP 问题

MCP 服务器无法连接

原因： 找不到服务器二进制文件、命令路径错误或缺少运行时。

解决方案：

# 确保已安装 MCP 依赖项（已包含在标准安装中）
cd ~/.hermes/hermes-agent && uv pip install -e ".[mcp]"

# 对于基于 npm 的服务器，确保 Node.js 可用
node --version
npx --version

# 手动测试服务器
npx -y @modelcontextprotocol/server-filesystem /tmp

验证 ~/.hermes/config.yaml 中的 MCP 配置：

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/docs"]

MCP 服务器的工具未显示

原因： 服务器已启动但工具发现失败、工具被配置过滤掉，或服务器不支持你预期的 MCP 能力。

解决方案：

检查网关/Agent 日志中的 MCP 连接错误
确保服务器响应 tools/list RPC 方法
检查该服务器下的 tools.include、tools.exclude、tools.resources、tools.prompts 或 enabled 设置
记住，资源/提示工具仅在会话实际支持这些能力时才被注册
更改配置后使用 /reload-mcp

# 验证 MCP 服务器已配置
hermes config show | grep -A 12 mcp_servers

# 更改配置后重启 Hermes 或重新加载 MCP
hermes chat

另请参阅：

MCP 超时错误

原因： MCP 服务器响应时间过长，或在执行过程中崩溃。

解决方案：

如果 MCP 服务器配置支持，增加超时时间
检查 MCP 服务器进程是否仍在运行
对于远程 HTTP MCP 服务器，检查网络连接

注意

如果 MCP 服务器在请求中途崩溃，Hermes 会报告超时。请检查服务器自己的日志（不仅仅是 Hermes 日志）以诊断根本原因。

配置文件（Profiles）

配置文件与设置 HERMES_HOME 有何不同？

配置文件是 HERMES_HOME 之上的一个管理层。你可以在每个命令之前手动设置 HERMES_HOME=/some/path，但配置文件会为你处理所有繁琐工作：创建目录结构、生成 Shell 别名（hermes-work）、将活动配置文件记录在 ~/.hermes/active_profile 中，以及自动在所有配置文件间同步技能更新。它们还与 Tab 补全集成，让你无需记住路径。

两个配置文件能否共用同一个机器人令牌？

不能。每个消息平台（Telegram、Discord 等）需要对机器人令牌的独占访问权。如果两个配置文件尝试同时使用同一个令牌，第二个网关将无法连接。请为每个配置文件创建单独的机器人——对于 Telegram，可以通过 @BotFather 创建额外的机器人。

配置文件之间是否共享记忆或会话？

不共享。每个配置文件都有自己的记忆存储、会话数据库和技能目录，完全隔离。如果你想用现有记忆和会话开启新配置文件，可以使用 hermes profile create newname --clone-all 从当前配置文件复制所有内容。

运行 `hermes update` 时会发生什么？

hermes update 拉取最新代码并重新安装依赖项一次（不是每个配置文件各一次）。然后它会自动将更新后的技能同步到所有配置文件。你只需运行 hermes update 一次——它会覆盖机器上的每个配置文件。

可以运行多少个配置文件？

没有硬性限制。每个配置文件只是 ~/.hermes/profiles/ 下的一个目录。实际限制取决于磁盘空间以及系统能处理多少个并发网关（每个网关是一个轻量级 Python 进程）。运行数十个配置文件完全没问题；每个空闲中的配置文件不消耗任何资源。

工作流程与模式

针对不同任务使用不同模型（多模型工作流）

场景： 你日常使用 GPT-5.4，但 Gemini 或 Grok 写社交媒体内容更出色。每次手动切换模型很繁琐。

解决方案：使用委派（Delegation）配置。 Hermes 可以自动将子 Agent 路由到不同的模型。在 ~/.hermes/config.yaml 中设置：

delegation:
  model: "google/gemini-3-flash-preview"   # 子 Agent 使用此模型
  provider: "openrouter"                    # 子 Agent 的提供商

现在当你让 Hermes "写一篇关于 X 的 Twitter 帖子"并生成 delegate_task 子 Agent 时，该子 Agent 会在 Gemini 上运行，而非你的主模型。你的主对话仍然使用 GPT-5.4。

你也可以在提示中明确指定："委派任务，写一篇关于我们产品发布的社交媒体帖子。让你的子 Agent 来完成实际写作。" Agent 会使用 delegate_task，它会自动采用委派配置。

对于不需要委派的一次性模型切换，在 CLI 中使用 /model：

/model google/gemini-3-flash-preview    # 本次会话切换
# ... 写内容 ...
/model openai/gpt-5.4                   # 切换回来

详情请参阅子 Agent 委派。

在一个 WhatsApp 号码上运行多个 Agent（按聊天绑定）

场景： 在 OpenClaw 中，你曾将多个独立 Agent 绑定到特定的 WhatsApp 聊天——一个用于家庭购物清单群组，另一个用于私人聊天。Hermes 能做到吗？

当前限制： Hermes 配置文件各自需要独立的 WhatsApp 号码/会话。你无法将多个配置文件绑定到同一个 WhatsApp 号码上的不同聊天——WhatsApp 桥接（Baileys）每个号码只使用一个经过认证的会话。

变通方案：

使用单一配置文件加个性化切换。 创建不同的 AGENTS.md 上下文文件或使用 /personality 命令按聊天更改行为。Agent 能感知自己在哪个聊天中并相应调整。
使用定时任务处理专项任务。 对于购物清单跟踪，设置一个定时任务监控特定聊天并管理列表——不需要单独的 Agent。
使用不同的号码。 如果你需要真正独立的 Agent，请为每个配置文件配对一个独立的 WhatsApp 号码。Google Voice 等服务提供的虚拟号码适合此用途。
使用 Telegram 或 Discord 代替。 这些平台更自然地支持按聊天绑定——每个 Telegram 群组或 Discord 频道都有独立的会话，你可以在同一账号上运行多个机器人令牌（每个配置文件一个）。

详情请参阅配置文件和 WhatsApp 设置。

控制 Telegram 中显示的内容（隐藏日志和推理过程）

场景： 你在 Telegram 中看到了网关执行日志、Hermes 推理过程和工具调用详情，而不是最终输出。

解决方案： config.yaml 中的 display.tool_progress 设置控制显示多少工具活动：

display:
  tool_progress: "off"   # 选项：off、new、all、verbose

off — 只显示最终响应。无工具调用、无推理过程、无日志。
new — 实时显示新工具调用（简短的单行信息）。
all — 显示所有工具活动，包括结果。
verbose — 完整详情，包括工具参数和输出。

对于消息平台，通常推荐 off 或 new。编辑 config.yaml 后，重启网关使更改生效。

你也可以使用 /verbose 命令按会话切换（如已启用）：

display:
  tool_progress_command: true   # 在网关中启用 /verbose

在 Telegram 上管理技能（斜杠命令限制）

场景： Telegram 有 100 个斜杠命令的限制，你的技能已经超过这个数量。你想在 Telegram 上禁用不需要的技能，但 hermes skills config 设置似乎没有生效。

解决方案： 使用 hermes skills config 按平台禁用技能。这会写入 config.yaml：

skills:
  disabled: []                    # 全局禁用的技能
  platform_disabled:
    telegram: [skill-a, skill-b]  # 仅在 Telegram 上禁用

更改后，重启网关（hermes gateway restart 或停止后重新启动）。Telegram 机器人命令菜单会在启动时重建。

提示

描述非常长的技能在 Telegram 菜单中会被截断为 40 个字符，以符合负载大小限制。如果技能未显示，可能是总负载大小问题而非 100 个命令计数限制——禁用未使用的技能对两者都有帮助。

共享线程会话（多用户，一个对话）

场景： 你有一个 Telegram 或 Discord 线程，多人在其中 @ 机器人。你希望该线程中的所有提及都属于同一个对话，而非各自独立的会话。

当前行为： Hermes 在大多数平台上按用户 ID 创建会话，因此每个人都有自己的对话上下文。这是出于隐私和上下文隔离的设计考量。

变通方案：

使用 Slack。 Slack 的会话按线程而非用户进行键控。同一线程中的多个用户共享一个对话——正是你所描述的行为。这是最自然的选择。
使用由单个用户运营的群聊。 如果一个人是"操作员"负责转达问题，会话保持统一。其他人可以跟着阅读。
使用 Discord 频道。 Discord 会话按频道键控，因此同一频道中的所有用户共享上下文。使用专用频道进行共享对话。

将 Hermes 迁移到另一台机器

场景： 你在一台机器上积累了技能、定时任务和记忆，想将所有内容迁移到新的专用 Linux 机器上。

解决方案：

在新机器上安装 Hermes Agent：

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

在源机器上创建完整备份：
```
hermes backup
```
这会将整个 ~/.hermes/ 目录（配置、API 密钥、记忆、技能、会话和配置文件）打包为 zip 文件，保存到主目录，文件名为 ~/hermes-backup-<timestamp>.zip。

将 zip 文件复制到新机器并导入：

# 在源机器上
scp ~/hermes-backup-<timestamp>.zip newmachine:~/

# 在新机器上
hermes import ~/hermes-backup-<timestamp>.zip

在新机器上运行 hermes setup 以验证 API 密钥和提供商配置是否正常工作。

将单个配置文件迁移到另一台机器

场景： 你想迁移或分享某个特定配置文件——而非整个安装。

# 在源机器上
hermes profile export work ./work-backup.tar.gz

# 将文件复制到目标机器，然后：
hermes profile import ./work-backup.tar.gz work

导入的配置文件将包含导出中的所有配置、记忆、会话和技能。如果新机器的设置不同，你可能需要更新路径或重新向提供商进行身份验证。

`hermes backup` 与 `hermes profile export` 的对比

功能	`hermes backup`	`hermes profile export`
使用场景	整机迁移	移植/分享特定配置文件
范围	全局（整个 `~/.hermes` 目录）	局部（单个配置文件目录）
包含内容	所有配置文件、全局配置、API 密钥、会话	单个配置文件：SOUL.md、记忆、会话、技能
凭据	包含（`.env` 和 `auth.json`）	不包含（已移除，便于安全分享）
格式	`.zip`	`.tar.gz`

手动备用方案（rsync）： 如果你更喜欢直接复制文件，可以排除代码仓库：

rsync -av --exclude='hermes-agent' ~/.hermes/ newmachine:~/.hermes/

提示

hermes backup 即使在 Hermes 正在运行时也能生成一致的快照。还原的归档文件中不包含机器本地的运行时文件，如 gateway.pid 和 cron.pid。

安装后重新加载 Shell 时出现权限拒绝错误

场景： 运行 Hermes 安装程序后，source ~/.zshrc 提示权限拒绝。

原因： 这通常发生在 ~/.zshrc（或 ~/.bashrc）文件权限不正确，或安装程序无法干净写入时。这不是 Hermes 特有的问题——这是 Shell 配置文件权限问题。

解决方案：

# 检查权限
ls -la ~/.zshrc

# 如有需要则修复（应为 -rw-r--r-- 或 644）
chmod 644 ~/.zshrc

# 然后重新加载
source ~/.zshrc

# 或者直接打开一个新的终端窗口——它会自动获取 PATH 变更

如果安装程序添加了 PATH 行但权限有误，你可以手动添加：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

首次运行 Agent 时出现 400 错误

场景： 设置顺利完成，但第一次尝试聊天时出现 HTTP 400。

原因： 通常是模型名称不匹配——配置的模型在你的提供商上不存在，或 API 密钥无权访问该模型。

解决方案：

# 检查配置了什么模型和提供商
hermes config show | head -20

# 重新运行模型选择
hermes model

# 或使用已知可用的模型测试
hermes chat -q "hello" --model anthropic/claude-opus-4.7

如果使用 OpenRouter，请确保 API 密钥有余额。OpenRouter 的 400 错误通常意味着该模型需要付费计划，或者模型 ID 有拼写错误。

还有问题？

如果你的问题未在此处涵盖：

搜索现有 Issue： GitHub Issues
向社区求助： Nous Research Discord
提交 Bug 报告： 请附上你的操作系统、Python 版本（python3 --version）、Hermes 版本（hermes --version）和完整的错误信息

常见问题​

Hermes 支持哪些 LLM 提供商？​

是否支持 Windows？​

在 WSL2 中使用 Hermes 时，如何控制 Windows 上的 Chrome？​

是否支持 Android / Termux？​

我的数据会被发送到哪里？​

能否离线使用或使用本地模型？​

使用费用是多少？​

多人能否使用同一个实例？​

记忆与技能有什么区别？​

能否在自己的 Python 项目中使用？​

故障排查​

安装问题​

安装后出现 hermes: command not found​

Python 版本过旧​

终端命令提示 node: command not found（或 nvm、pyenv、asdf 等）​

uv: command not found​

安装过程中出现权限拒绝错误​

提供商与模型问题​

/model 只显示一个提供商 / 无法切换提供商​

API 密钥不起作用​

模型不可用 / 找不到模型​

速率限制（429 错误）​

超出上下文长度​

终端问题​

命令被阻止为危险操作​

通过消息网关时 sudo 无效​

Docker 后端无法连接​

消息问题​

机器人不响应消息​

消息未送达​

白名单混乱——谁可以与机器人对话？​

网关无法启动​

WSL：网关持续断线或 hermes gateway start 失败​

macOS：网关找不到 Node.js / ffmpeg / 其他工具​

性能问题​

响应缓慢​

Token 用量过高​

会话过长​

MCP 问题​

MCP 服务器无法连接​

MCP 服务器的工具未显示​

MCP 超时错误​

配置文件（Profiles）​

配置文件与设置 HERMES_HOME 有何不同？​

两个配置文件能否共用同一个机器人令牌？​

配置文件之间是否共享记忆或会话？​

运行 hermes update 时会发生什么？​

可以运行多少个配置文件？​

工作流程与模式​

针对不同任务使用不同模型（多模型工作流）​

在一个 WhatsApp 号码上运行多个 Agent（按聊天绑定）​

控制 Telegram 中显示的内容（隐藏日志和推理过程）​

在 Telegram 上管理技能（斜杠命令限制）​

共享线程会话（多用户，一个对话）​

将 Hermes 迁移到另一台机器​

将单个配置文件迁移到另一台机器​

hermes backup 与 hermes profile export 的对比​

安装后重新加载 Shell 时出现权限拒绝错误​

首次运行 Agent 时出现 400 错误​

还有问题？​

常见问题

Hermes 支持哪些 LLM 提供商？

是否支持 Windows？

在 WSL2 中使用 Hermes 时，如何控制 Windows 上的 Chrome？

是否支持 Android / Termux？

我的数据会被发送到哪里？

能否离线使用或使用本地模型？

使用费用是多少？

多人能否使用同一个实例？

记忆与技能有什么区别？

能否在自己的 Python 项目中使用？

故障排查

安装问题

安装后出现 `hermes: command not found`

Python 版本过旧

终端命令提示 `node: command not found`（或 `nvm`、`pyenv`、`asdf` 等）

`uv: command not found`

安装过程中出现权限拒绝错误

提供商与模型问题

`/model` 只显示一个提供商 / 无法切换提供商

API 密钥不起作用

模型不可用 / 找不到模型

速率限制（429 错误）

超出上下文长度

终端问题

命令被阻止为危险操作

通过消息网关时 `sudo` 无效

Docker 后端无法连接

消息问题

机器人不响应消息

消息未送达

白名单混乱——谁可以与机器人对话？

网关无法启动

WSL：网关持续断线或 `hermes gateway start` 失败

macOS：网关找不到 Node.js / ffmpeg / 其他工具

性能问题

响应缓慢

Token 用量过高

会话过长

MCP 问题

MCP 服务器无法连接

MCP 服务器的工具未显示

MCP 超时错误

配置文件（Profiles）

配置文件与设置 HERMES_HOME 有何不同？

两个配置文件能否共用同一个机器人令牌？

配置文件之间是否共享记忆或会话？

运行 `hermes update` 时会发生什么？

可以运行多少个配置文件？

工作流程与模式

针对不同任务使用不同模型（多模型工作流）

在一个 WhatsApp 号码上运行多个 Agent（按聊天绑定）

控制 Telegram 中显示的内容（隐藏日志和推理过程）

在 Telegram 上管理技能（斜杠命令限制）

共享线程会话（多用户，一个对话）

将 Hermes 迁移到另一台机器

将单个配置文件迁移到另一台机器

`hermes backup` 与 `hermes profile export` 的对比

安装后重新加载 Shell 时出现权限拒绝错误

首次运行 Agent 时出现 400 错误

还有问题？