hermes从零到一:完整 Demo 复盘 + 翻车自救指南
【摘要】 从零到一:完整 Demo 复盘 + 翻车自救指南系列第 10 篇 / 共 10 篇(终篇)终篇干两件事:把 9 篇的零件串成一条完整部署线,再给你一套官方的"翻车自救"流程。 1. 完整 Demo(以 Windows + Portal + 钉钉为例)第 1 步:安装iex(或官网下载 Hermes Desktop。)第 2 步:一条命令配好模型 + 工具网关hermes setup --p...
从零到一:完整 Demo 复盘 + 翻车自救指南
系列第 10 篇 / 共 10 篇(终篇)
终篇干两件事:把 9 篇的零件串成一条完整部署线,再给你一套官方的"翻车自救"流程。
1. 完整 Demo(以 Windows + Portal + 钉钉为例)
第 1 步:安装
iex
(或官网下载 Hermes Desktop。)
第 2 步:一条命令配好模型 + 工具网关
hermes setup --portal
第 3 步:验证基础对话
hermes
→ 问一句"看看当前目录,哪个像是主入口",确认横幅模型正确、能调工具、多轮正常。
第 4 步:验证会话恢复
hermes --continue
第 5 步:装一个技能并用起来
hermes skills browse
hermes skills install openai/skills/k8s
会话里发 /k8s 验证斜杠命令生效。
第 6 步:接入 IM
hermes gateway setup # 选钉钉/飞书/TG
hermes gateway status
群里发消息验证。
第 7 步:上沙箱后端(可选但建议)
hermes config set terminal.backend docker
hermes egress setup && hermes egress start
第 8 步:定时任务投递(可选)
建一个 cron:每天 9 点把健康检查结果发到群里。
第 9 步:习惯养成
- 告诉它你的偏好(如"Python 全用 uv"),让它进记忆;
- 观察
~/.hermes/skills/里新技能的出现; - 换机器前
hermes backup。
到这里:安装 → 模型 → 对话 → 会话 → 技能 → IM → 沙箱 → 定时,全链路打通。
2. 常见故障对照表
| 症状 | 大概率原因 | 处理 |
|---|---|---|
| 打开后回复为空/乱码 | provider 鉴权或模型选错 | 重跑 hermes model,核对 provider/模型/鉴权 |
| 自定义端点"能通但返回垃圾" | base URL 写错、模型名错、其实不是 OpenAI 兼容 | 先用独立客户端验证端点 |
| 网关起了但消息没人回 | token / allowlist / 平台配置没做完 | 重跑 hermes gateway setup + hermes gateway status |
--continue 找不到旧会话 |
切了 profile 或会话没保存 | hermes sessions list 核对 profile |
| 模型不可用/回退行为怪 | 路由/回退配得太激进 | 基础 provider 稳定前关掉 routing |
hermes doctor 报警 |
配置项缺失或过期 | 修配置后先重测裸对话,再叠功能 |
3. 翻车自救六步法(顺序很关键)
hermes doctor # 1. 体检
hermes model # 2. 核对模型
hermes setup # 3. 重跑向导
hermes sessions list # 4. 核对会话/profile
hermes --continue # 5. 验证恢复
hermes gateway status # 6. 核对网关
官方原话:这套动作能把"感觉哪里不对"快速拉回已知状态。
4. 三条铁律(全系列总结)
- 裸对话跑不通,不叠任何新功能。
- 模型上下文 ≥ 64K,本地模型手动拉。
- 不用的不开。 最小集 = provider + 文件工具 + 终端工具,按需加。
5. 参考资料
(完)
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)