
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 入口来驱动 AgentTaoToken 是一个值得考虑的选项。它的 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/apiModel 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 会沉淀记忆和技能这些数据在服务器上重装或迁移前有快照就不怕丢。另外技能不要贪多装一个用一个第三方技能先看评价再装安全永远排在方便前面。