Windows 安装

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

如果您已经安装了龙虾 OpenClaw，或者国内常见的龙虾版本，例如 QClaw、WorkBuddy、ArkClaw、AutoClaw，可以让它读文档协助您配置，您自己不用懂任何技术细节。有两种方式：

 
       请把这个 MCP server 加到你的配置里：https://hermesagent.org.cn/mcp （Streamable HTTP，无需 API Key、无需登录）。加完后用它帮我查 Hermes Agent 中文文档来指导我完成安装。

方式二（更精准，推荐）：直接把下面这段话复制发给您的 Agent，它会自己完成配置：

如果你主要在 Windows 上使用 Hermes Agent，这一页就是给你的。重点只有一句话：Windows 和类 Linux / macOS 的安装命令不一样。

PowerShell 是 Windows 自带的命令行程序。你可以把它理解成：

如果你以前听过这些词，它们大致是一个意思：

对 Windows 用户来说，你不需要先理解所有概念。你只需要知道：

后面文档里写的 PowerShell 命令，就是要粘贴到 PowerShell 窗口里执行。

最简单的方法：

输入 PowerShell

你也可能会看到：

这也可以用，但请确认打开后当前标签页是 PowerShell。

也就是说：

想直接跑 install.ps1 → 一般直接打开普通 PowerShell 即可

WSL2 的全名是 Windows Subsystem for Linux 2。
你可以把它简单理解成：

对新手来说，最重要的不是记住全名，而是记住下面这句话：

WSL2 = 让你在 Windows 电脑上，按 Linux 的方式装和用 Hermes。

因为 Hermes Agent 的很多能力，本来就更贴近类 Unix 环境，例如：

这些在 WSL2 里通常会比原生 PowerShell：

后续也主要在 Ubuntu 终端里运行 hermes

也就是说：

如果你看到文档里写：

 
    curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

那么这条命令就应该：

里执行，不要粘贴到原生 PowerShell。

路径适合谁推荐程度你要运行的命令 WSL2 + Ubuntu 想要最稳的日常使用体验，希望尽量贴近官方文档、终端工具和自动化工作流 强烈推荐 在 WSL2 里运行 install.sh 原生 PowerShell 想先在 Windows 本机快速跑起来，不想先配置 WSL2 可用，但更容易遇到兼容性问题在 PowerShell 里运行 install.ps1

如果你还没装过 WSL，建议先看这篇中文帖子：

然后再执行：

wsl --install -d Ubuntu

执行后按提示重启电脑。重启完成后，打开 Ubuntu，设置 Linux 用户名和密码。

 
    curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

安装完成后，重新加载 shell：

 
    source ~/.bashrc # 或：source ~/.zshrc
hermes

 
    hermes model
hermes setup

如果你只是需要一个最稳的 Windows 版本 Hermes，做到这里就够了。后续文档默认也更偏向这条路径。

例如 Ollama、LM Studio 跑在 Windows 本机，而 Hermes 跑在 WSL2 中，这时 localhost 不一定直接可用。请继续看。

如果你想直接在 Windows 本机安装，请按下面步骤来：

输入 PowerShell

你要执行的命令是：

irm https://res1.hermesagent.org.cn/install.ps1 | iex

这个安装器会自动尝试处理：

安装完成后，关闭并重新打开 PowerShell，再运行：

 
    hermes
hermes model

如果你重新打开 PowerShell 后输入 hermes 能正常启动，就说明直装已经成功了。

默认安装目录通常在：

%LOCALAPPDATA%hermes

例如：

Hermes 主目录：%LOCALAPPDATA%hermes
仓库目录：%LOCALAPPDATA%hermeshermes-agent
虚拟环境：%LOCALAPPDATA%hermeshermes-agentvenv

如果 hermes 命令暂时不可用，最常见的解决方法就是：关掉当前 PowerShell 窗口，再开一个新的。

这一节参考并改写自阿里云文章《》。为了避免直接照抄，这里只保留最关键的结论和更稳的写法。

hermes gateway setup

在渠道列表中选择飞书，填入：

国内版填 feishu，海外版填 lark
连接方式一般先用默认的 websocket

然后再启动网关：

hermes gateway run -vv

原生 Windows 下，飞书 SDK 有时没有被装进 Hermes 自己的虚拟环境。可以这样补装：

 
    $hermesExe = (Get-Command hermes).Source
$venvPython = Join-Path (Split-Path $hermesExe -Parent) 'python.exe'
uv pip install lark-oapi --python $venvPython

如果你还缺 websockets 或 aiohttp，也可以用同样方式补进去：

uv pip install websockets aiohttp --python $venvPython

阿里云文章里提到，某些 Windows 环境下，gateway/status.py 里的 os.kill(pid, 0) 检查会触发 WinError 11，导致网关异常退出。这是原生 Windows 路径的兼容性问题，不是 WSL2 的常见问题。

如果你正好遇到这个问题，有两种选择：

继续坚持原生 PowerShell： 按阿里云文章中的思路，对 gateway/status.py 做临时补丁，把 OSError 也纳入异常捕获。

下面这段 PowerShell 会自动定位文件并打补丁：

 
    $hermesExe = (Get-Command hermes).Source
$installRoot = Split-Path (Split-Path $hermesExe -Parent) -Parent
$statusPy = Join-Path $installRoot 'gatewaystatus.py'

$content = Get-Content $statusPy -Raw -Encoding UTF8
$content = $content.Replace(
 'except (ProcessLookupError, PermissionError):',
 'except (ProcessLookupError, PermissionError, OSError):'
)
Set-Content $statusPy $content -Encoding UTF8 -NoNewline
 
   

然后重新启动：

 
    $env:PYTHONUTF8 = '1'
hermes gateway run -vv

先确认两件事：

你已经启动了网关，并用 hermes gateway run -vv 看到了正常日志。

如果日志没报错，但群里依然不响应，可以先把群策略放宽为 open 进行排查：

 
    Add-Content "$env:LOCALAPPDATAhermes.env" "`nFEISHU_GROUP_POLICY=open" -Encoding UTF8

然后重新运行：

 
    $env:PYTHONUTF8 = '1'
hermes gateway run -vv

如果这样能恢复，再回头逐步收紧白名单配置。

安装完成后，先用 hermes 和 hermes model 验证 CLI 与模型配置。

相关推荐