1. 为什么把 Hermes Agent 放到 Lighthouse 云服务器上跑
Hermes Agent 是 Nous Research 开源的一个 AI Agent 项目，简单说，它不只是"聊天机器人"，而是能记住上下文、能自己创建技能、还能在使用中不断改进技能的一类智能体。你可以把它理解成一个会"越用越顺手"的助手：第一次帮你处理某类任务时可能笨拙，但用几次之后它会沉淀出自己的处理方式。它适合谁？适合想自建 AI Agent、又不想被本地电脑绑死的开发者，尤其是希望 7×24 小时在线、随时通过聊天软件调用的人。
问题来了：Hermes Agent 官方明确说它"并不依赖你的笔记本电脑"，优先推荐 Linux 环境。如果你把它装在自己的主力机上，会碰到几个现实麻烦。第一，电脑一关机 Agent 就下线，做不到全天候在线；第二，Agent 要执行技能、拉取代码，和你的本地开发环境混在一起，隔离性差，出问题不好收拾；第三，Windows 用户还得先装 WSL2 才能跑，多一层折腾。
所以更合理的做法是把它放到云服务器上。腾讯云 Lighthouse（轻量应用服务器）就是为这种轻量场景准备的：不用理解复杂的云计算概念，套餐便宜，还预置了社区项目应用模板，能一键部署。把 Hermes Agent 部署在 Lighthouse 上，本地电脑和云端互相隔离，服务器 7×24 小时在线，你随时随地通过微信、企业微信、飞书、钉钉就能和它对话。
这篇就按"从零部署"的完整流程走一遍：用应用模板一键装好 Hermes Agent，配置模型、通道、技能三个核心模块，最后验证连通性，并把常见报错逐个排查掉。全程可复制，跟着做就能在云上跑通你的第一个 Hermes Agent 实例。
需要说明的是，Hermes Agent 本身不包含 AI 模型，它需要连接一个外部大语言模型来驱动智能。所以部署只是第一步，模型接入才是让它"活过来"的关键。下面会给出具体的配置片段和验证命令。
2. 部署前的准备：Lighthouse 选型与 TaoToken 模型接入前置
在动手之前，先把两件事定下来：服务器怎么选，模型从哪来。
先说 Lighthouse 选型。进入购买页后，应用创建方式选择"使用应用模板 > 龙虾专区 > Hermes Agent"。地域选择上有个实用建议：如果你后续主要调用国内模型、用微信/企业微信/飞书/钉钉这类国内聊天软件，就选国内地域；如果主要用 Discord 这类海外聊天软件，再考虑海外地域。套餐配置推荐 2 核 4G 内存起步，最低 2 核 2G 只能做简单体验，跑技能和长上下文会吃力。登录方式和服务器名称按需填，没特殊需要可以跳过。勾选协议后点立即购买，大约 30 秒实例就创建好了。
如果你已经有一台闲置的 Lighthouse，也可以走"重装系统"这条路：在实例卡片右上角的"..."里找到重装系统，同样选"使用应用模板 > 龙虾专区 > Hermes Agent"。这里必须提醒一句：重装会清空服务器内原有全部数据，操作前务必先做快照备份。
再说模型接入。Hermes Agent 的配置面板支持多种模型提供商，但如果你想要一个统一、稳定的 API 入口来驱动 Agent，TaoToken 是一个值得考虑的选项。它的 API 地址是https://taotoken.net/api，兼容主流大模型的调用格式，你可以在控制台创建 API Key，然后在 Hermes Agent 的模型配置里填入 Base URL、Key 和 Model ID 三件套。
具体来说，TaoToken 提供的能力包括：模型对话（用于验证模型是否通）、Coding Plan（适合长期编码和 Agent 场景）、控制台（管理 Key 和用量）、API Keys（创建密钥）、接入文档（查参数）。对 Hermes Agent 这种需要长期在线、频繁调用模型的场景，Coding Plan 会更划算一些。
这里给一个模型接入的配置思路，你可以把它对应到 Hermes Agent 面板的 Provider / Model / API Key 三个输入项：
{ "provider": "custom", "base_url": "https://taotoken.net/api", "api_key": "sk-你的TaoToken密钥", "model_id": "你选择的模型ID", "default": true }注意：Base URL 填https://taotoken.net/api，不要多加路径；API Key 从控制台的 API Keys 页面创建，创建后立即复制保存，页面刷新后就看不到了。Model ID 要和你实际开通的模型一致，填错会直接报模型不存在。
如果你只是想先快速体验，Hermes Agent 面板里也内置了腾讯云通用 Token Plan 这类免 Key 的选项，选中即可用。但如果你希望模型来源可控、方便切换，用 TaoToken 这类统一 API 入口会更灵活。两种方式不冲突，按需选一种即可。
3. 可复制配置：模型、通道、技能三件套怎么填
Hermes Agent 装好后，要配三个核心模块才能正常用：模型（Models）给它"大脑"，通道（Channels）给它"对话入口"，技能（Skills）给它"手脚"。Lighthouse 为 Hermes Agent 应用模板提供了可视化配置面板，这三件事都能在面板里点鼠标完成，不用登录服务器敲命令。
先找到面板：登录轻量云控制台，点进装好 Hermes Agent 的实例详情页，顶部导航进入"应用管理"页，就能看到从左到右的模型、通道、技能三栏。如果你看到的只是一个展示版本号和文档链接的简化页面，说明应用模板版本较旧，需要按前面的重装流程升级到最新版才能看到配置面板。
3.1 模型配置：填对 Base URL 和 Key
模型配置区有两个下拉框，上面选提供商（Provider），下面选具体模型。以接入 TaoToken 为例，Provider 选自定义/custom，然后在 API Key 输入框粘贴你的 TaoToken 密钥，Base URL 填https://taotoken.net/api，Model ID 填你开通的模型标识，最后点"一键添加为默认"。
如果你用的是 MiniMax Token Plan，流程类似：去 MiniMax 开放平台复制以sk-cp-开头的 Key，回到面板选 MiniMax Token Plan 和具体模型（如 MiniMax-M2.7），粘贴 Key 后添加为默认。DeepSeek V4 则是去 DeepSeek 开放平台创建以sk-开头的 Key，面板里选 DeepSeek 和 DeepSeek V4。
这里有个硬性限制要记住：配置面板目前只支持一个默认模型，每次"一键添加为默认"都会覆盖上一次的配置。想切换模型就重新选、重新填，覆盖即可。
一个容易踩的坑是 Key 前后带了空格或换行。建议复制后先粘到纯文本编辑器里看一眼，确认没有多余字符再粘进面板。另外，如果你用的是按量付费的模型，账号余额为 0 时即使 Key 正确也调不通，先去开放平台充值。
3.2 通道配置：微信授权接入
通道区域默认选中微信，点"授权接入"，页面弹出二维码，用手机微信扫一扫。扫码后微信会弹出"将新的 OpenClaw/Hermes Agent 连接到微信"，点"继续连接"。回到面板看到"已接入通道"多了一条微信记录，就成功了。
注意：微信目前只支持连接一个 Agent。如果你的微信之前授权过别的 Agent，页面会提示"继续连接将解除原有连接"，点继续会覆盖掉原来的授权。扫码失败时，先确认扫码的微信账号和你想接收消息的账号是同一个；二维码过期就关掉弹窗重新点授权接入。
3.3 技能配置：安装 self-improving-agent
技能来源是腾讯云自研的 SkillHub 平台。在技能区搜索框输入self-improving-agent，选中候选结果，点"安装技能"。面板会弹出安全提示，告知部分技能由第三方社区收录可能存在风险，你可以点"点击前往"到 SkillHub 核对详情，确认无误后点确定继续安装。稍等片刻，"已安装技能"区显示该技能即成功。
这里给一个技能安装后的验证配置片段，方便你确认技能目录结构：
# Hermes Agent 技能配置参考 [skills] enabled = true source = "skillhub" installed = ["self-improving-agent"] [skills.self-improving-agent] auto_update = true trust_level = "community"安全提醒：技能安装涉及从 SkillHub 拉取代码并执行，第三方技能存在风险，安装前务必在 SkillHub 查看说明和评价，不要装来源不明的技能。
4. 验证请求：确认 Agent 真的跑通了
配置完成后，必须做连通性验证，否则你可能以为配好了，实际模型根本没调通。
第一步，在微信里找到刚授权的 Hermes Agent 联系人，发一条消息，比如"你好，请做一下自我介绍"。如果一切正常，Agent 会通过你配置的模型生成回复出现在聊天窗口。这一步验证的是"通道 + 模型"整条链路。
第二步，如果你想更精确地确认模型 API 本身是否通，可以直接用 curl 打一次 TaoToken 的接口。这是排查问题时区分"是模型问题还是 Agent 问题"的关键动作：
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "你选择的模型ID", "messages": [ {"role": "user", "content": "你好，请回复ok"} ] }'如果返回里能看到choices字段和正常的回复内容，说明模型 API 是通的，问题不在模型侧。如果这里就报错，那 Hermes Agent 里再怎么配也没用，得先把 API 调通。
第三步，验证技能是否生效。给 Agent 发一个需要用到技能的任务，观察它是否会调用已安装的self-improving-agent。技能生效的表现是 Agent 在处理任务时会引用技能逻辑，而不是单纯靠模型裸答。
实测下来，最常见的"假成功"是：微信里 Agent 能回消息，但回的是模型默认的兜底话术，说明模型其实没接上，只是通道通了。所以一定要用 curl 单独验证一次模型 API，别只看微信有没有回复。
成功的结果应该是：微信里 Agent 回复内容和你配置的模型能力一致，curl 请求返回正常的choices结构，技能任务能触发对应逻辑。三者都满足，才算真正跑通。
5. 常见报错排查：401、local proxy failed、reading choices 逐个解决
部署过程中最容易卡在几个典型报错上，下面按真实错误信息逐个拆。
401 Unauthorized：这是鉴权失败，九成是 API Key 的问题。检查三处：Key 是否复制完整（有没有漏字符）、Key 前后是否带了空格或换行、Key 是否已过期或被删除。如果你用的是 TaoToken，去控制台的 API Keys 页面确认这个 Key 还在、还有效。另外确认 Authorization 头格式是Bearer sk-xxx，少了Bearer前缀也会 401。
local proxy failed / connection refused：这类报错通常出现在 Agent 尝试访问模型 API 时网络不通。先确认服务器地域和模型服务地域是否匹配——国内地域的 Lighthouse 访问海外模型 API 可能不稳定，反之亦然。然后用 curl 在服务器上直接测https://taotoken.net/api是否可达。如果 curl 都不通，说明是网络层问题，不是配置问题。
reading choices 相关报错（如 cannot read property 'choices' of undefined）：这表示请求发出去了，但返回结构里没有choices字段。常见原因有三个：一是 Model ID 填错了，服务端返回的是错误信息而不是正常响应；二是请求体格式不对，比如messages字段拼写错误；三是模型服务返回了限流或余额不足的错误。解决办法是先看完整返回体，别只看报错，返回体里通常有明确的错误原因。
OAuth / 授权相关报错：微信通道授权失败时，先确认扫码账号一致、二维码未过期。如果提示"已连接其他 Agent"，说明你的微信之前授权过别的 Agent，需要先解除或直接覆盖。覆盖操作会断开原连接，确认清楚再点。
技能安装失败：搜不到技能时，先去 SkillHub 浏览确认技能准确名称和上架状态，再回面板搜索。安装报错时检查服务器磁盘空间和网络，技能拉取需要从 SkillHub 下载代码。
排查顺序建议固定下来：先 curl 测模型 API → 再测通道（微信发消息）→ 最后测技能。这样能快速定位问题出在哪一层，避免在错误的层面反复改配置。每次改完配置，都重新走一遍这个顺序验证。
6. 后续怎么用：切换模型、扩展技能与长期运行
跑通第一个实例后，日常使用中你大概率会想调整配置。切换模型很简单：回到实例详情页的应用管理页，在模型区重新选 Provider 和模型，填新 Key，点"一键添加为默认"，新配置覆盖旧的。想换通道或删技能，在"已接入通道"和"已安装技能"列表里按提示移除或重新配置即可。
如果你打算让 Hermes Agent 长期在线跑编码或 Agent 类任务，模型调用会变得频繁，这时候用 TaoToken 的 Coding Plan 会比按量付费更省心，配合控制台可以随时看用量。想验证新模型效果，可以去模型对话页面直接试；需要创建或管理密钥，去 API Keys 页面；接入参数不确定时，查接入文档最稳妥。
最后给一个实用建议：把服务器快照定期做一次。Hermes Agent 会沉淀记忆和技能，这些数据在服务器上，重装或迁移前有快照就不怕丢。另外，技能不要贪多，装一个用一个，第三方技能先看评价再装，安全永远排在方便前面。
