想风技术文档
安装 | Hermes Agent
在 Linux、macOS、WSL2、原生 Windows 或通过 Termux 在 Android 上安装 Hermes Agent
🦁Hermes安装入门，配置Telegram为对话窗口
此前尝试了下 openclaw 这不几个月又流行了 hermes, 直接服务器ubuntu 搭建，并配置telegram 为窗口试试了！一步一步手把手教程记录！
📝 主旨内容
1.安装Hermes
2.新手选择Quick Setup 后续可切Full setup
Quick Setup：推荐新手或想省事。用 Nous Portal 登录，不用管 API keys，开箱即用。
Full setup：推荐高级用户。你可以配置 OpenAI、Anthropic、Google、本地模型、各种工具等，适合已经知道自己要接哪些能力的人。
Blank Slate：最干净、最保守。默认几乎什么都不开，适合想严格控制隐私、成本、权限，或者只想一步步手动启用功能的人。
3.复制open后面的链接！如果打不开，输入下方Code 8WUC-RCPK (输入你的)
4.选择 free 版先体验 点击后回到ssh 界面
5.ssh界面如下 选择local 回车（我的在云服务器本地安装）
6.连接一个信息平台 ，如下所示回车！新手推荐Telegram，相对简单
7.键盘上下键，移动到 Telegram,按空格键选中，回车
8.选择 1 回车 自动便捷 快速配置好！
把 link 对应链接，复制到浏览打开，一气呵成！复制打开 telegram 创建机器人, 发送/start !
9. 如果选择 2 是手动（完全手动）! 尽量不要手动，很容易出错！
打开 Telegram，搜索并进入 @BotFather 发送：
它会问你 bot 的显示名称，随便填，比如：
它会问你 bot 的用户名，必须以
bot 结尾，比如：创建成功后，BotFather 会返回一段 token，格式大概是：
把这整段复制，粘贴到终端里的：
注意：token 是密钥，不要发给别人，也不要截图公开。
刚才那个链接如果已经在 Telegram 里创建成功了，也可以去 Telegram 里找 BotFather 或新建出来的 bot，看有没有 token；如果没有，最稳就是按上面
/newbot 重新建一个。10 超时半手动：
正常很快响应好，但是我的超时了，需要手动设置了！如果超时，可以选择手动 或者后续重新设置—用命令：
复制链接 去浏览器打开，如果你已经安装了Telegram,会自动打开 telegram, 输入你的bot name ，如果没有你可以先下载app 或者从网页打开来操作！比如我的 HermesHelper 创建 bot 就好了
机器人已经创建 所以 我用 /mybots 就可以找到我的机器人了
点击你的机器人出现如下显示 你在点击API Token 就有密钥了
11.密钥黏贴到 Telegram bot token: xxxxxxxx 回车
填入你的telegram id 留空就是开放权限、谁都可以访问
如果你是测试可以留空！～
Telegram id 如何获取
这里有一个很容易错的提醒，用户id是数字的 不是用户名！
Telegram 里 username 不是 user id。Hermes 要的是 Telegram 的数字用户 ID。
在 Telegram
搜索这个（注意全是小写，官方蓝标）bot: @userinfobot 发送 /start 会返回你的用户id信息！
12. Y 回车 安装网关
User service 个人电脑、开发机、笔记本，推荐
System service 服务器、长期在线机器，需要 sudo
Skip service install 只是试用，或想手动运行
新手选 User service 或者 Skip service install 会简单些 System service可能会卡权限、麻烦点！
我第一次用当开发机了 选User service 回车
13. Start the service now? [Y/n]: Y
14.是否安装一个网关做为后台服务！
Would you like to install the gateway as a background service? [Y/n] Y
15.Hermes 启动聊天
16.尴尬 报错了
17.配置模型启用
推荐 hermes model 方便点 也可以 vim ~/.hermes/.env 修改配置
选择你的xAI 提供者
选择模型：默认先选 grok-4.3
模型 | 适合 |
grok-4.3 | 通用默认首选，日常任务、推理、代码、工具调用 |
grok-4.20-0309-reasoning | 更偏深度推理，可能更慢/更贵 |
grok-4.20-0309-non-reasoning | 速度优先，复杂问题可能弱一点 |
grok-4.20-multi-agent-0309 | 多代理/复杂编排场景 |
grok-composer-2.5-fast | 快速生成、轻量任务 |
grok-build-0.1 | 偏构建/实验性质，不建议当默认 |
grok-imagine-image / quality / video | 图像/视频生成，不适合作默认聊天模型 |
Enter custom model name | 你知道确切模型名时再用 |
Skip | 保持原来的配置 |
最后
Login successful!
Auth state: ~/.hermes/auth.json
Config updated: /root/.hermes/config.yaml (model.provider=xai-oauth)
Default model set to: grok-4.3 (via xAI Grok OAuth — SuperGrok / Premium+)
就行尝试对话：hermes 开启对话 测试成功
以上是初步在ubuntu 24 搭建好了 Hermes 和 Telegram
相关参考文档
有任何问题 欢迎联系我 一起交流、学习讨论
上一篇
AI 信息技术革命
下一篇
Claude Code / Codex / Gemini / Cusor / Grok 2026小白安装到基础使用指南
Loading...