★ FEATURED ARTICLE 1. 为什么要在 WSL2 里跑 Hermes AgentHermes Agent 是 Nous Research 开源的一套自主 Agent 框架MIT 协议、可自托管支持接入 200 多个模型还能挂到飞书、Telegram、Discord 这类聊天平台上当数字员工用。它最吸引人的地方是技能自增长你让它干完一件复杂活儿它会问你要不要把这套流程存成 Skill下次同类任务直接复用实测下来重复任务的耗时会明显下降。这也是它能在短时间内冲到 116k Star 的原因很多人把它当成 OpenClaw 的平替甚至升级版。但 Hermes Agent 有一个硬门槛它不支持原生 Windows官方只给 Linux 和 macOS 提供直接安装路径。Windows 用户想跑就必须先上 WSL2。WSL2 是 Windows 自带的 Linux 子系统相当于在你的 Windows 里开了一台轻量 Linux 虚拟机Hermes Agent 在里面跑起来和真机 Linux 没区别。最低配置 1 核 1GB 内存的机器就能带动本地开发机基本都够。这篇教程聚焦的就是这条完整落地路径从零开 WSL2、装 Hermes Agent、配好统一模型通道再到把飞书 Skill 打通。每一步我都给可复制的命令和配置片段遇到卡点直接告诉你原因和绕法。适合谁看想在 Windows 上本地跑自主 Agent 的开发者、想把 Agent 接到飞书当团队助手的同学以及被各种照着做卡在某一步的教程坑过的人。需要提前说明的是Hermes Agent 本身是开源项目模型调用需要你自己准备 API Key。下面配置环节我会用 TaoToken 作为统一 Key/API 通道来演示因为它把多家模型的接入格式统一了换模型时不用改一堆配置对新手比较友好。你也可以换成任意兼容 OpenAI 格式的服务配置结构是一样的。2. WSL2 环境准备与 Hermes Agent 安装全流程这一节是整篇的地基装不好后面全白搭。我按开 WSL2 → 装 Hermes → 验证的顺序走Windows 用户从第一步开始macOS 和 Linux 用户可以直接跳到安装环节。2.1 开启 WSL2 并初始化 Ubuntu以管理员身份打开 PowerShell右键开始菜单选Windows PowerShell 管理员执行wsl --install这一条命令会自动装好 WSL2 内核和默认的 Ubuntu 发行版。执行完必须重启电脑别跳过。重启后 Ubuntu 会自动弹出一个终端窗口让你设置用户名和密码。密码输入时屏幕不显示任何字符这是 Linux 的正常行为直接输完回车即可。初始化完成后重新开一个普通权限的 PowerShell验证安装状态wsl -l -v正常输出里应该能看到 Ubuntu并且 VERSION 列是 2。如果显示 1执行wsl --set-version Ubuntu 2切换。确认无误后后续所有操作都在 Ubuntu 终端里进行和 Linux/macOS 完全一致。2.2 安装 Hermes Agent 的两种路线路线一适合网络畅通的环境一行命令搞定curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装大概 3 到 10 分钟脚本会自动处理依赖。注意不要加 sudo加了会导致权限问题后面命令会找不到。路线二适合国内网络GitHub 直连容易超时。思路是用 PowerShell 下载压缩包再交给 WSL 安装绕开网络问题。先在 PowerShell不是 WSL里下载Invoke-WebRequest -Uri https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip -OutFile $env:USERPROFILE\Desktop\hermes.zip等桌面出现 hermes.zip 后解压Expand-Archive -Path $env:USERPROFILE\Desktop\hermes.zip -DestinationPath $env:USERPROFILE\Desktop\hermes -Force然后回到 Ubuntu 终端把解压出来的目录复制到正确位置。注意把 Administrator 换成你自己的 Windows 用户名mkdir -p ~/.hermes cp -r /mnt/c/Users/Administrator/Desktop/hermes/hermes-agent-main ~/.hermes/hermes-agent cd ~/.hermes/hermes-agent uv syncuv sync 跑完看到一长串包名列表就说明依赖装好了。2.3 设置快捷命令并验证为了不用每次都 cd 进目录加一个别名echo alias hermescd ~/.hermes/hermes-agent uv run hermes ~/.bashrc source ~/.bashrc验证安装hermes --version能打印出版本号就成功了。如果提示 command not found先执行export PATH$HOME/.local/bin:$PATH再source ~/.bashrc。这一步是 WSL2 里最常见的坑之一因为 WSL2 关掉终端后环境变量可能失效建议把 PATH 那行也写进 ~/.bashrc 里持久化。3. 用 TaoToken 统一配置模型通道含可复制配置片段Hermes Agent 支持 200 多个模型配置向导里会让你选提供商。国内常用的有 DeepSeek、阿里云百炼、Kimi、MiniMax 等各自申请地址和特点如下提供商申请地址特点DeepSeekplatform.deepseek.com审核快便宜稳定阿里云百炼bailian.console.aliyun.comqwen-plus/max 系列Kimiplatform.moonshot.cn中文强长上下文MiniMaxapi.minimax.chat国内稳定如果你不想每换一个模型就改一遍配置可以用 TaoToken 作为统一通道。它把多家模型的接入格式统一成 OpenAI 兼容格式Base URL 和 Key 固定只改 Model ID 就能切换模型。运行配置向导hermes setup选快速设置然后在提供商列表里选 Custom endpoint按下面格式填。这里以统一通道为例# ~/.hermes/config.toml 片段 [model] provider custom base_url https://taotoken.net/api api_key sk-你的key model claude-sonnet-4-5对应的环境变量写法如果你更习惯用 .env# ~/.hermes/.env CUSTOM_BASE_URLhttps://taotoken.net/api CUSTOM_API_KEYsk-你的key CUSTOM_MODELclaude-sonnet-4-5三件套记牢Base URL 填https://taotoken.net/apiKey 填你在控制台生成的 sk- 开头的串Model ID 按你要用的模型填。想换模型时只改 Model ID 这一行Base URL 和 Key 不动。Key 的获取入口在控制台的 API Keys 页面接入细节可以对照接入文档两处都在同一个站点下。配置完成后启动hermes发第一条消息测试比如帮我查一下今天 AI 领域的最新新闻。如果模型正常返回说明通道通了。常用命令顺手记一下hermes -c继续上次对话hermes model切换模型hermes doctor诊断问题hermes skills list查看已装 Skill。4. 飞书 Skill 接入与连通性验证飞书是 Hermes Agent 原生支持的平台v0.6.0 版本正式加入支持私聊、群聊、图片和文件收发。推荐用 WebSocket 模式不需要公网 IP本地机器就能跑。4.1 创建飞书应用并拿凭证打开飞书开放平台 open.feishu.cn点创建企业自建应用填应用名称和描述。进入应用详情页在凭证与基础信息里复制 App ID 和 App Secret。然后左侧菜单进应用功能→机器人开启机器人能力。这两步缺一不可很多人卡在机器人不回复就是忘了开机器人能力。4.2 配置网关并启动回到 Ubuntu 终端运行网关配置hermes gateway setup在平台列表里选 Feishu / Lark填入刚才的 App ID 和 App SecretConnection mode 选 websocket。配置会写进 ~/.hermes/.env你可以检查一下# ~/.hermes/.env 片段 FEISHU_APP_IDcli_xxxxxxxx FEISHU_APP_SECRETxxxxxxxx FEISHU_CONNECTION_MODEwebsocket FEISHU_GROUP_POLICYallowlist启动网关hermes gateway start本地长期跑可以用 screenscreen -S hermes-gateway hermes gateway start # CtrlA 然后按 D 退出 screen进程继续跑服务器上更推荐装成系统服务hermes gateway install-service systemctl enable --now hermes-gateway4.3 验证连通性在飞书里私聊你的机器人发一句你好看是否有回复。群聊里必须 机器人才会触发私聊不需要。如果没反应先跑hermes gateway status看网关是否在跑再检查用户是否在 FEISHU_ALLOWED_USERS 列表里。默认策略是 allowlist需要显式配置允许的用户。不想限制用户的话在 ~/.hermes/.env 里加FEISHU_GROUP_POLICYopen如果报 lark-oapi 没安装补一下依赖cd ~/.hermes/hermes-agent uv pip install lark-oapi5. 本篇常见报错排查对照装 Hermes Agent 和接飞书的过程中报错基本集中在几个固定位置。我把真实遇到的错误和对应解法列出来你对着查。hermes: command not found这是 PATH 没生效。执行export PATH$HOME/.local/bin:$PATH source ~/.bashrcWSL2 关掉终端后命令失效也是同一个原因把上面这行写进 ~/.bashrc 持久化即可。GitHub 超时安装卡死直连 raw.githubusercontent.com 容易超时走 2.2 的路线二手动安装或者用国内镜像脚本。别反复重试同一条命令浪费时间。模型连接失败 / 401先跑hermes doctor80% 的问题它能直接告诉你原因。401 通常是 Key 填错或 Base URL 写错。检查三件套Base URL 是不是https://taotoken.net/apiKey 是不是 sk- 开头且没多余空格Model ID 是不是服务端支持的名称。如果报local proxy failed说明本地网络层有问题检查 WSL2 的网络模式必要时在 Windows 侧确认网络正常。reading choices 相关报错这类报错一般出现在模型返回格式不符合预期时多半是 Model ID 填了一个不存在的模型或者通道不支持该模型。换一个确认可用的 Model ID 再试。OAuth 相关报错如果你用的是需要 OAuth 的提供商报错通常是回调地址或授权过期。改用 API Key 方式接入最省事统一通道就是 Key 模式不涉及 OAuth 流程。Telegram Bot 不回复hermes gateway status检查网关hermes gateway start重启。飞书同理。群聊 机器人没反应确认机器人已被加入群聊且群聊里必须 才触发。私聊不需要 。排查顺序建议固定成先hermes doctor再看hermes gateway status最后查 .env 配置。这三步能覆盖绝大多数问题。6. 把 Hermes Agent 用起来的三个动作装好只是开始真正让它变成数字员工的是后面这几个动作。第一设一个定时任务。直接在对话里说每天早上 8 点搜索 AI 相关新闻整理成简报发到飞书Hermes 会把它存成 cron 任务。用hermes cron list查看已设置的任务。用几天你就能体会到自动推送的价值。第二复杂任务完成后选 y 保存 Skill。Hermes 会问这个任务挺复杂的要保存为 Skill 吗选 y 之后它把解决过程整理成文档存到 ~/.hermes/skills/下次同类任务直接复用。内置已有 118 个 Skill可以用hermes skills list查看hermes skills search github搜索hermes skills install agentskills/daily-standup从社区安装。积累几周它会越来越顺手。第三遇到问题先跑hermes doctor再去搜教程。这个习惯能帮你省掉大量瞎试的时间。模型通道这块如果你后面想换模型只改 Model ID 就行Base URL 和 Key 不用动。需要新 Key 或想看接入细节去控制台的 API Keys 页面和接入文档想先验证模型通不通用模型对话页面发一条消息最快如果是长期编码或跑 Agent 任务Coding Plan 更划算。这几个入口都在同一个站点下按你的场景选就行。
阅读完成 · 觉得有帮助？
