1. 为什么要在 Windows 上用 WSL2 跑 Hermes OpenClaw 双 Agent如果你最近在折腾 AI Agent大概率会同时刷到 Hermes 和 OpenClaw 这两个名字。简单说OpenClaw 是一个偏执行层的 Agent 框架擅长接多平台、跑任务、调用各种技能Hermes 则更偏记忆和推理层负责长期上下文、自主迭代、深度思考。一个负责“干活”一个负责“成长”组合起来就是一套能自己积累经验的自动化工作流。问题在于很多教程默认你在 Mac 或 Linux 上操作Windows 用户直接照着敲命令十有八九会卡在依赖、路径、权限上。我实测下来Windows 下最稳的方案不是原生 PowerShell而是 WSL2Windows Subsystem for Linux 2。它本质是在 Windows 里跑一个轻量 Linux 子系统命令和 Ubuntu 基本一致端口、文件系统、网络都能和 Windows 互通对小白来说比装双系统省事得多。这篇内容面向零基础读者从 WSL2 环境准备开始到依赖安装、API Key 与 Base URL 统一配置到 TaoToken 通道再到一键启动脚本和连通性验证全部给可复制的命令。你不需要懂 Linux 内核只要会复制粘贴、会看终端输出就行。核心检索词先记住Hermes、OpenClaw、AI Agent、WSL2、API Key后面每一步都会围绕这几个点展开。适合谁看想在 Windows 上搭双 Agent 但被环境劝退的人已经装过 OpenClaw 但模型调用总报错的人想把 API Key 统一管理、不想每个工具单独填一遍的人。下面直接进入操作。2. TaoToken 前置准备统一 API Key 与 Base URL 的接入通道在装 Hermes 和 OpenClaw 之前先把模型调用通道准备好。两个 Agent 都要调大模型如果各自填一套 Key 和地址后面排查问题会非常乱。我的做法是统一走 TaoToken 的 API 通道一个 Key、一个 Base URL两个工具共用省去重复配置。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 Base URL 填到配置里。官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册和查看文档都从这里进。API Key 在控制台的 API Keys 页面生成地址是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite生成后先复制到记事本后面两个工具都要用。这里要强调一个概念Base URL 和 API Key 是两件事。Base URL 告诉工具“请求发到哪个网关”API Key 告诉网关“你是谁、有没有额度”。很多新手报 401就是把 Key 填错位置或者 Base URL 多加了/v1之类的后缀。TaoToken 的 Base URL 就写https://taotoken.net/api不要自己拼路径模型 ID 在请求体里单独指定。如果你还没决定用哪个模型可以先到模型对话页面试一下地址是https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite在里面选一个模型发一句话确认 Key 有额度、通道能通。这一步花两分钟能省掉后面大量排障时间。对于长期要跑编码类 Agent 的场景可以关注 Coding Plan地址是https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite适合需要稳定调用、频繁跑 Agent 任务的用户。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite里面写了不同工具怎么填 Base URL 和 Model ID遇到不确定的参数先查文档。准备好这三样东西Base URLhttps://taotoken.net/api、API Key控制台生成、一个可用的 Model ID比如你在模型对话里试通的那个。把它们记在同一个地方下面配置 OpenClaw 和 Hermes 时直接复用。3. WSL2 环境准备与依赖安装可复制的完整配置这一章是整篇的核心操作区所有命令都可以直接复制。先确认你的 Windows 版本Win10 2004 及以上或 Win11 都支持 WSL2。打开 PowerShell管理员模式执行安装命令wsl --install这条命令会自动启用虚拟机平台、安装 WSL2 内核、并默认装一个 Ubuntu 发行版。执行完重启电脑重启后 Ubuntu 会自动启动让你设置用户名和密码。密码输入时屏幕不显示正常现象输完回车即可。如果你已经装过 WSL 但不确定版本用这条命令查看并切换wsl --list --verbose wsl --set-default-version 2确认 VERSION 列显示 2 就对了。接下来进入 Ubuntu 终端先更新软件源并安装基础依赖sudo apt update sudo apt upgrade -y sudo apt install -y git curl python3 python3-pip python3-venv nodejs npm build-essential这里解释一下每个包的作用git用来拉取仓库curl用来下载安装脚本python3和pip是 Hermes 的运行环境nodejs和npm是 OpenClaw 的前端依赖build-essential提供编译工具避免某些 Python 包安装时报 gcc 缺失。装完后验证版本python3 --version node --version npm --version正常应该输出 Python 3.10、Node 18。如果 Node 版本太低用 NodeSource 源升级curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs端口方面OpenClaw 默认网关端口是 18789Hermes 作为客户端模式不额外占端口。WSL2 的网络和 Windows 主机是 NAT 关系本机访问localhost:18789通常能通如果要从局域网其他设备访问需要在 Windows 防火墙放行或者用wsl --hostname查 IP。小白阶段先在本机跑通不用折腾端口转发。再装一个常用工具jq后面验证 API 返回时会用到sudo apt install -y jq到这里 WSL2 环境就绪。建议把工作目录固定下来比如mkdir -p ~/agents cd ~/agents后面所有安装都在这下面操作方便管理。4. 安装 OpenClaw 与 Hermes 并配置 TaoToken 通道先装 OpenClaw。官方提供了一键安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装完成后执行初始化向导openclaw onboard --install-daemon向导会依次问几个问题。风险提示选 Yes部署模式选 QuickStart模型供应商这一步选“自定义”或“OpenAI 兼容”因为我们要填 TaoToken 的地址。关键配置如下Base URLhttps://taotoken.net/apiAPI Key你从控制台生成的那串Model ID填你在模型对话里验证过的模型名网关端口保持默认 18789社群渠道绑定直接 Skip。完成后检查状态openclaw status看到gateway: running就说明底座起来了。如果这里报端口占用用ss -tlnp | grep 18789查是谁占了改配置里的端口或停掉冲突进程。接着装 Hermes。先备份 OpenClaw 数据养成好习惯openclaw gateway stop cp -a ~/.openclaw ~/.openclaw.bak.$(date %Y%m%d) openclaw gateway start然后拉取 Hermes 安装脚本curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装完会自动弹出配置向导。Import OpenClaw Data 选 Yes让它自动迁移配置数据迁移确认选 Yes搭建模式选 Quick Setup模型配置这里同样填 TaoToken 的 Base URL 和同一个 API Key保持两个 Agent 走同一通道。平台绑定先跳过。验证hermes status显示Hermes Agent running即成功。如果你用的是 Claude Code 类工具做辅助Anthropic 兼容入口在https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite配置方式类似Base URL 和 Key 填法一致。这一步最容易踩的坑是 Model ID 写错。OpenClaw 和 Hermes 都要求模型名和网关支持的名称完全一致大小写、连字符都不能差。不确定就回模型对话页面复制。5. 双 Agent 联动配置与连通性验证请求两个 Agent 各自跑起来后要让它们协同。新手推荐用数据迁移方案hermes claw migrate --dry-run hermes claw migrate第一条是预览不实际改动第二条正式同步模型配置和基础设置。注意两个工具要用不同的 Bot Token否则消息会循环。如果你要进阶联动可以用 ACP 模式cd ~/.hermes/hermes-agent pip install -e .[acp] hermes acp然后在 OpenClaw 配置里关联 Hermes重启网关openclaw gateway restart聊天窗口里用/acp spawn hermes-agent --bind here召唤子 Agent。连通性验证是必须做的。先用 curl 直接打 TaoToken 通道确认 Key 和 Base URL 没问题curl -s https://taotoken.net/api/chat/completions \ -H Authorization: Bearer 你的API_KEY \ -H Content-Type: application/json \ -d { model: 你的Model_ID, messages: [{role: user, content: ping}] } | jq .返回里有choices字段和内容说明通道通。如果返回 401检查 Key 是否复制完整、有没有多余空格如果返回 model not found检查 Model ID。这一步通了再验证 OpenClaw 和 Hermes 各自能否调模型。写一个一键启动脚本start-agents.sh#!/bin/bash openclaw gateway start hermes start sleep 3 openclaw status hermes status赋权并运行chmod x start-agents.sh ./start-agents.sh两个状态都显示 running且 curl 验证有返回就算跑通了。日常管理命令openclaw gateway stop、hermes stop停服务openclaw status、hermes status看状态。6. 常见报错排查401、local proxy failed、reading choices 对照解决这一章按真实报错来。第一类401 Unauthorized。原因通常是 API Key 错误或没带上。检查三处curl 里的Authorization: Bearer后面有没有空格OpenClaw 配置里的 Key 字段是不是完整Hermes 迁移后有没有覆盖成旧 Key。解决方法是重新从控制台复制 Key两个工具都更新一遍。第二类local proxy failed或连接超时。这通常是 Base URL 写错比如多写了/v1或少了/api。TaoToken 的地址就是https://taotoken.net/api不要自己拼。另外检查 WSL2 里能不能解析域名curl -I https://taotoken.net/api如果 DNS 失败在/etc/resolv.conf里加nameserver 8.8.8.8再试。第三类reading choices相关报错比如cannot read property choices of undefined。这说明请求发出去了但返回结构不对常见原因是 Model ID 不存在或额度不足。先用第 5 章的 curl 命令单独验证返回体里如果没有choices看error字段写了什么。额度问题去控制台看余额模型名问题回模型对话页面确认。第四类OAuth 或认证跳转失败。如果你在配置 Claude Code 类工具时遇到检查是否用了 Anthropic 兼容入口https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewriteBase URL 和 Key 的填法和其他工具一致不要混用不同通道的地址。第五类端口冲突。OpenClaw 固定 18789如果启动报address already in use用ss -tlnp | grep 18789找到进程要么停掉要么在配置里改端口。Hermes 客户端模式一般不占端口如果它报端口问题检查是不是误开了网关模式。第六类WSL2 权限报错。所有安装命令不要用sudo bash跑安装脚本脚本内部会自己提权。如果遇到permission denied检查文件属主ls -l必要时chown -R $USER:$USER ~/.openclaw ~/.hermes。Windows 原生 PowerShell 不推荐跑这些脚本路径和权限模型都不一样老老实实用 WSL2。排查顺序建议先 curl 验通道再验单个 Agent最后验联动。每步都有明确输出不要跳步。7. 跑通之后把双 Agent 用起来的几个实用方向双 Agent 跑通只是起点。OpenClaw 负责执行你可以把它接到日常任务上比如定时抓取信息、批量处理文件、调用技能完成重复操作。Hermes 负责记忆它会把你和它的交互沉淀下来越用越贴合你的习惯。两者通过 ACP 或数据迁移联动后一个任务可以既执行又积累经验。如果你要长期跑编码或 Agent 任务建议把模型调用统一在 TaoToken 通道下管理Key 和 Base URL 只维护一份换模型时两个工具一起改不会出现一个通一个不通的情况。需要看用量和额度就去控制台需要试新模型就去模型对话页面需要查参数就去接入文档。这三个入口在前面都给过带归因的链接收藏一下比每次搜更省事。最后提醒一句Bot Token 一定分开OpenClaw 和 Hermes 各用各的这是避免消息循环最直接的办法。端口、Key、Model ID 这三样在配置时抄写准确后面基本不会出问题。跑通后先拿一个简单任务试联动确认两个 Agent 都能正常响应再逐步加复杂度。