debian安装Hermes的过程

一、用kejilion.sh的一键脚本

bash <(curl -sL kejilion.sh)

选11然后选115选择1就可以了

二、开始安装

  • 想用官方 Nous 免密钥 OAuth 登录:选第一项 Quick Setup (Nous Portal),回车
  • 自己填各家 API 密钥、完全自定义:选第二项 Full setup,回车
  • 从零手动逐项开启全部能力:选第三项 Blank Slate,回车
  • 本地部署自有模型选第二项

  • 本地本机直接运行:选 Local - run directly on this machine (default),回车。
  • 保持现有本地配置:直接回车确认 Keep current (local)。
  • 有 Docker 环境选 Docker;远程机器选 SSH;云环境选 Modal/Vercel Sandbox。
  • 选 Local - run directly on this machine (default),回车。

不需要任何聊天平台,全部不勾选,直接按 Enter 确认。 后续需要哪个平台再回来开启。

直接保持当前全部勾选状态,按 Enter 确认。

直接回车,保持选中 Browser Use [free · local · cloud] − New SOTA web harness (CLI 3.0) [active]。

选最底部 Skip − keep defaults / configure later,回车。

选最下面 Skip − keep defaults / configure later,回车。

选最下面 Skip,回车跳过视觉后端配置。

选最底部 Skip − keep defaults / configure later,回车跳过联网搜索配置。

安装完成,当前询问是否立刻启动 gateway 服务。输入:y

现在询问是否让 gateway 随系统 systemd 开机自启。输入:y

输入4添加大模型

输入2添加模型供应商

按要求填写URL、KEY、选择默认模型

完成。

Hermes‑Agent 常用命令

hermes                # 进入交互式对话终端(最常用)
hermes setup          # 重新走向导配置工具(搜索/TTS/视觉等,不修改LLM模型)
hermes config         # 查看当前完整配置
hermes config edit    # 编辑 config.yaml 配置文件(修改大模型、参数)
hermes doctor         # 诊断配置、网络、模型连通性,排错必用
hermes update         # 更新到最新版本
hermes gateway        # 网关消息服务(消息API、定时cron任务)
hermes gateway install # 安装systemd网关系统服务
hermes gateway start   # 手动启动网关
hermes gateway stop    # 停止网关
hermes gateway status  # 查看网关运行状态
hermes gateway logs   # 查看网关日志
hermes model          #重新运行模型选择向导:直接在终端输入以下命令,它会启动一个交互式界面,引导你重新选择提供商和模型

添加DeepSeek模型

在向导中,当提示选择模型提供商(Provider)时,滚动到列表最底部,选择 Custom endpoint(自定义端点)

  • Base URL: https://api.deepseek.com

  • API Key: 你的 DeepSeek API Key

保持默认的 1. Auto-detect

原因: DeepSeek 是完全标准的 OpenAI 兼容接口,选 1(自动检测)或 2(Chat Completions)都可以。直接按回车即可继续

Context length in tokens [leave blank for auto-detect

直接按 Enter 键(回车)留空即可

原因:这里设置的是“上下文长度(Context length)”。选择留空让它自动检测是最安全的,Hermes 会自动获取该模型的默认上下文窗口大小(DeepSeek 通常为 64k 或 128k)

Display name [Api.deepseek.com]:

直接输入 DeepSeek 然后按回车。(这只是一个别名)

文件快速定位

cat /root/.hermes/config.yaml    # 直接打印配置
cat /root/.hermes/.env           # API密钥环境文件
ls /root/.hermes/logs/           # 会话运行日志

排错高频操作

  1. 修改完模型配置后,务必执行
hermes doctor

看有没有报错:API连通性、模型名称错误、base‑url写错。

  1. 直接启动对话
hermes

Hermes交互终端内部指令(进入hermes之后)

/help          # 查看内部命令
/reset         # 清空当前会话上下文
/tools         # 查看已加载可用工具列表
/config        # 查看运行时配置
/exit          # 退出交互终端

实操建议(你的场景)

  • 日常调试只用:hermes,不需要跑gateway,gateway是用来对外提供API接口、定时任务。
  • 改大模型:hermes config edit → hermes doctor校验 → hermes开始对话。
  • 出问题优先:hermes doctor,绝大多数配置错误一眼就能看到。
上一篇 安装Cinema4D_2025报错的解决办法
下一篇 梵想 S101 (SM2259XT) 固态硬盘量产修复指南