词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Windows (WSL2) 指南"
Windows (WSL2) 指南
/chat 标签页）—— 该面板需要 POSIX PTY（伪终端），仅 WSL2 支持。简体中文
为什么选择 WSL2（而非原生 Windows）
C:\Users\…）和 Windows 进程。Hermes 使用 Git Bash 执行 shell 命令，这也是 Claude Code 等 agent 目前处理 Windows 的方式 —— 无需完整重写即可绕过 POSIX 与 Windows 的差异。fork、/tmp、UNIX socket、信号语义、PTY 支持的终端、bash/zsh 等 shell，以及 rg、git、ffmpeg 等在 Linux 上行为一致的工具。安装 WSL2
wsl --installwsl --list --verboseVERSION 2。如果某个发行版显示 VERSION 1，请转换：wsl --set-version Ubuntu 2
wsl --set-default-version 2发行版选择
apt 系统 —— 如需其他路径，请参阅 Nix 安装指南。启用 systemd（推荐）
wsl --shutdownps -p 1 -o comm= 应输出 systemd。metadata 挂载选项很重要 —— 没有它，/mnt/c/... 上的文件无法存储真实的 Linux 权限位，这会导致在 Windows 路径下对脚本执行 chmod +x 等操作失效。在 WSL 内安装 Hermes
文件系统：跨越 Windows ↔ WSL2 边界
两个方向
| 方向 | 内部路径 | 使用的路径 |
|---|---|---|
| Windows 磁盘，从 WSL 访问 | C:\Users\you\Documents | /mnt/c/Users/you/Documents |
| WSL 磁盘，从 Windows 访问 | /home/you/code | \\wsl$\Ubuntu\home\you\code（较新版本为 \\wsl.localhost\Ubuntu\...） |
Hermes 和项目应放在哪里
~/.hermes/）—— Linux 侧。安装程序已自动处理。~/code/...、~/projects/...）。/mnt/c/... 的操作需经过 9P，比原生 ext4 慢 10–100 倍。在 ~/code 下感觉瞬间完成的 git status（10k 文件仓库），在 /mnt/c 下可能需要 15 秒以上。/mnt/c 上只是尽力模拟。ssh 因"权限不当"拒绝密钥，或 chmod +x 静默失败，都是常见问题。/mnt/c 上经常漏报变更。Readme.md 和 README.md 的项目在两侧行为不同。/mnt/c 下 —— 例如需要从 Windows GUI 应用打开，或 Windows Chrome 的 DevTools MCP 需要当前目录是 Windows 可访问的路径。在两侧之间传输文件
\\wsl.localhost\Ubuntu，然后拖放到 \home\<you>\...。或者在 PowerShell 中：wsl cp /mnt/c/Users/you/Downloads/file.pdf ~/incoming//mnt/c/Users/<you>/...，Windows 资源管理器会立即看到：explorer.exe 或 wslview：行尾符、BOM 与 git
CRLF 行尾符。当 Linux 侧的 bash 或 Python 读取这些文件时，shell 脚本会报错 bad interpreter: /bin/bash^M，带 BOM 的 .env 文件也可能导致 Python 失败。"在 WSL 内 clone 还是在 /mnt/c 上 clone？"
hermes chat、调用 rg/ripgrep 搜索仓库的工具、文件监听器、后台 gateway）在 ~/code/myrepo 下会比在 /mnt/c/Users/you/myrepo 下快得多，也更可靠。cmd.exe 使用 chrome-devtools-mcp（参见 MCP 指南：WSL → Windows Chrome），当 Hermes 的当前工作目录是 ~ 时，Windows 可能会报 UNC 警告。此时请从 /mnt/c/ 下的某个目录启动 Hermes，以便 Windows 进程拥有一个带盘符的工作目录。网络：WSL ↔ Windows
localhost 与 Windows 上的 localhost 并不相同 —— 从网络角度看，它们是两台独立的主机。对于每个服务，你需要确定流量方向，并选择正确的桥接方式。情况一 —— WSL 中的 Hermes 访问 Windows 上的服务
%USERPROFILE%\.wslconfig 中设置 networkingMode=mirrored，然后执行 wsl --shutdown）。之后 localhost 在两侧均可互通。0.0.0.0 而非仅 127.0.0.1。通常还需要在 Windows 防火墙中为该端口添加规则。情况二 —— Windows（或局域网）上的设备访问 WSL 中的 Hermes
API_SERVER_ENABLED=true 时由 hermes gateway 暴露）。参见 API Server 功能页。cloudflared/ngrok 而非原始端口转发。子情况 2a：从 Windows 宿主机本身访问
0.0.0.0:8080（甚至 127.0.0.1:8080）的进程，可直接从 Windows 浏览器通过 http://localhost:8080 访问。WSL 会自动将绑定发布回宿主机。127.0.0.1 绑定转发到 Windows 的 localhost，因此以 --host 127.0.0.1 启动的 Hermes 服务通常可从 Windows 通过 http://localhost:PORT 访问。如果无法访问：0.0.0.0。ip -4 addr show eth0 | grep inet 获取 WSL 虚拟机的 IP，然后从 Windows 直接访问该 IP。子情况 2b：从局域网中的其他设备访问（手机、平板、另一台 PC）
1.
127.0.0.1 的进程永远无法从虚拟机外部访问。请使用 0.0.0.0。2.
# 获取 WSL 虚拟机当前 IP（NAT 模式下每次重启 WSL 都会变化）
$wslIp = (wsl hostname -I).Trim().Split(' ')[0]
# 将 Windows 端口 8080 转发到 WSL:8080
netsh interface portproxy add v4tov4 `
listenaddress=0.0.0.0 listenport=8080 `
connectaddress=$wslIp connectport=8080
# 在 Windows 防火墙中放行该端口
New-NetFirewallRule -DisplayName "Hermes WSL 8080" `
-Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allownetsh interface portproxy delete v4tov4 listenaddress=0.0.0.0 listenport=8080。3.
http://<windows-lan-ip>:8080。wsl --shutdown 后即失效。如需持久化，要么启用镜像模式，要么将端口代理步骤写入 Windows 登录时自动运行的脚本。setWebhook、Slack 事件等），不建议折腾端口转发 —— 请使用 cloudflared 隧道。参见 webhook 指南。在 Windows 上长期运行 Hermes 服务
在 WSL 内使用 systemd（推荐）
hermes gateway 和 API 服务器的使用方式与任何 Linux 机器上完全相同。使用 gateway 设置向导：让 WSL 在 Windows 登录时自动启动
C:\Windows\System32\wsl.exe-d Ubuntu --exec /bin/sh -c "sleep infinity"wsl --install --no-launch + 自动启动流程也可以实现；sleep infinity 方案是兼容性最好的版本。GPU 直通（本地模型）
nvidia-smi 即可识别 GPU。之后，CUDA 工具链、torch、vllm、sglang 和 llama-server 均可正常使用真实 GPU。常见问题
参见 WSL2 网络配置。九成情况是服务绑定在
127.0.0.1 上，需要改为 0.0.0.0（Ollama：OLLAMA_HOST=0.0.0.0），或者缺少防火墙规则。git status / hermes chat 在仓库中极慢。你很可能在
/mnt/c/... 下工作。将仓库移到 ~/code/...（Linux 侧），速度会有数量级的提升。bad interpreter: /bin/bash^M。Windows 编辑器产生的 CRLF 行尾符。执行
dos2unix script.sh，并在 WSL git 配置中设置 core.autocrlf input。Hermes 的工作目录在 Linux 文件系统内，Windows
cmd.exe 无法识别。在该会话中从 /mnt/c/... 下启动 Hermes，或使用一个在调用 Windows 可执行文件前先 cd 到 Windows 可访问路径的包装脚本。宿主机从睡眠恢复后，WSL2 的时钟可能滞后数分钟，导致所有基于证书的操作失败（OAuth、HTTPS API）。按需修复：
ntpdate 并在登录时运行。镜像模式会将宿主机网络设置代理到 WSL —— 如果 Windows DNS 有问题（VPN 分流隧道、企业解析器），WSL 会继承这些问题。解决方法：手动覆盖
resolv.conf（在 /etc/wsl.conf 中设置 generateResolvConf=false，然后手动编写 /etc/resolv.conf，填入 1.1.1.1 或你的 VPN DNS）。hermes 命令。安装程序通过
~/.bashrc 将 ~/.local/bin 添加到 shell 的 PATH 中。需要执行 source ~/.bashrc（或打开新终端）才能在当前会话中生效。Defender 通过 9P 桥接扫描从 Windows 访问的文件，这会放大
/mnt/c 风格跨边界访问的延迟。如果你只在 WSL 内部访问 WSL 文件，则不受影响。如果你频繁使用 Windows 工具访问 \\wsl$\...，可考虑将 WSL 发行版路径排除在实时扫描之外。WSL2 将虚拟机磁盘存储为
%LOCALAPPDATA%\Packages\... 下的稀疏 VHDX 文件。它会自动增长，但删除文件后不会自动收缩。回收空 间的方法：执行 wsl --shutdown，然后在管理员 PowerShell 中运行 Optimize-VHD -Path <path-to-ext4.vhdx> -Mode Full（需要 Hyper-V 工具），或使用 WSL 文档中记录的更简单的 diskpart 方式。下一步
修改于 2026-05-31 00:25:01