这是一篇Hermes安装和使用的手把手教学，小白一看就懂，完全不需要折腾，安装最多半小时。

Hermes 是一个开源的 AI Agent 框架，由 @NousResearch @Teknium 开发的超级 AI 智能体平台，MIT 开源协议，完全自托管，不绑定任何一家平台。

现在市面上跟它功能接近的可以参考：OpenClaw 和 Codex，但这三个产品定位差得很远。

Codex 是 OpenAI 的编程助手，主要干代码活，绑定 OpenAI 账号，模型能力很强。在 IDE 里用，长期记忆缺失，也接不了飞书这类消息渠道。因为 computer use 能力，对本机操作的能力极强，适合代码开发和日常工作使用。

Hermes 走的是另一条路。 它是 Python 技术栈，强调技能包和长记忆，模型自选，配置灵活。如果你主要用飞书，想在中文环境里快速装起来一个私人助理，Hermes 更省事。

对普通用户来说最直接的价值是这个：接进飞书之后，24 小时待命，手机发消息就回，不用开电脑，不用登任何网页，长期记忆。

[!info] 阅读导览
整条路线分四步：准备与拿 Key（1-3）→ 装好 AI 助手工具（4-6）→ 用 AI 帮你装 Hermes 并配置（7-9）→ 接入飞书并部署服务器（10-11）。
每一步都给了可以直接复制粘贴的命令或提示词，照着做即可。

flowchart LR
    A[1 准备清单] --> B[2-3 申请 DeepSeek Key]
    B --> C[4-6 VSCode + Deep Code 配置]
    C --> D[7 让 AI 安装 Hermes]
    D --> E[8 安装中文 WebUI]
    E --> F[9 配置 DeepSeek 模型]
    F --> G[10 接入飞书机器人]
    G --> H[11 部署服务器 7×24 运行]

1. 准备清单

2. 先拿 DeepSeek Key

如果你还没有配置过大模型 Key，先按本节配置 DeepSeek；已经配过的可以直接跳到下一节。

打开 platform.deepseek.com，注册、充值（支持支付宝、微信），按量付费，不用的时候不扣钱，而且价格非常便宜，能力很强，性价比首选。先充个 20 块够用很久了。

3. 创建 API Key

进 API Keys 页面，点创建。名字随便起，比如 hermes-local。

[!warning] 重要
Key 只显示一次，务必复制到记事本里存好，丢了只能重新创建。Key 先放着，装好 Hermes 再用。

4. 安装 VSCode

没有 VSCode 的先去 code.visualstudio.com 下一个，装完打开。

5. 安装 Deep Code 扩展

左侧栏点扩展图标，搜索框输入 deepcode，找到 Deep Code，作者是 VegaMo，点安装。

6. 配置 API Key

6.1. 打开终端

按一下键盘的 Win 键打开开始菜单，输入 powershell，回车。会弹出一个黑色（或蓝色）的窗口，这就是终端。后面要敲的命令都在这里面。

6.2. 建文件夹

把下面这行整段复制，在终端里点右键粘贴，回车：

New-Item -ItemType Directory -Force -Path "$HOME\.deepcode"

回车后可能出现两种情况，都算成功，别管它：

• 显示一行带 Directory 字样的白字 → 文件夹建好了。
• 什么都没显示，直接跳到下一行 → 文件夹本来就在，也是好的。

6.3. 填 Key

接着复制下面这行，粘贴回车，会弹出记事本：

notepad "$HOME\.deepcode\settings.json"

如果记事本弹出一个框，问你「找不到文件，要不要新建」，点是。

然后把下面这段全部贴进空白的记事本，再把 sk-你的key 换成你自己申请到的 Key（连前面的 sk- 一起替换）：

{ 
  "env": { 
    "MODEL": "deepseek-v4-pro", 
    "BASEURL": "https://api.deepseek.com/", 
    "APIKEY": "sk-你的key" 
  }, 
  "thinkingEnabled": true, 
  "reasoningEffort": "max" 
}

填好后按 Ctrl + S 保存，关掉记事本。

6.4. 验证

回到 VSCode，点左侧边栏里的 Deep Code 图标（章鱼头像），随便发一句话，比如「在吗」。它能正常回复，就说明 Key 配对了。

7. 让 AI 帮你装 Hermes

Deep Code 配好之后，直接把下面这段提示词粘进对话框发出去，DeepSeek 会一步步带你把 Hermes 装完（本教程以 Windows 为例，AI 会按你的平台给出对应命令）：

帮我在本机（Windows）安装 Hermes Agent。步骤如下：
用 curl 安装 Hermes：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
如果 Windows 下直接执行 bash 报错，请告诉我需要 WSL 或 Git Bash，并给出对应的安装方式
安装完成后告诉我如何验证安装成功（Windows 下对应的命令）
运行 hermes doctor 检查 environment，告诉我绿色和黄色各代表什么
告诉我配置文件、API Key 和日志分别在哪个路径，每一步执行完等我确认再继续。

DeepSeek 会逐步给你命令，你复制到终端跑，跑完截图或粘回来，它接着往下走。遇到报错直接把错误信息粘给它，它会帮你排查。

8. 装中文 WebUI 界面

把这段提示词粘给 Deep Code：

帮我安装 Hermes WebUI 并切换成中文界面。

它会给你命令，跑完用浏览器打开它给出的本地地址，点击进入到网页即可。

左下角可以切换页面的语言，选中文即可。

9. 给 Hermes 配 DeepSeek

Hermes 装好之后还不知道用哪个模型，需要把 DeepSeek Key 告诉它。两种方式都行，效果一样，选顺手的。

9.1. 用 Deep Code 直接配

把这段粘进去：

帮我给 Hermes 配置 DeepSeek API Key，Key 是 sk-你的key，模型用 deepseek-v4-pro。

9.2. 在 WebUI 后台手动填

打开 http://localhost:8787，左侧菜单点密钥，往下找到 DeepSeek，在 DEEPSEEKAPIKEY 那栏输入你的 Key，保存。

配完发条消息测一下能不能回。

10. 接飞书

分三步。

10.1. 创建飞书机器人

去 open.feishu.cn，注册登录，创建企业自建应用，开启机器人能力。

进凭证与基础信息页面，复制 App ID 和 App Secret，存好备用。

注意，需要给机器人设置权限，一定要有接收消息的权限。

10.2. 对接 Hermes

把下面这段粘给 Deep Code：

帮我把飞书机器人接入 Hermes。我的 App ID 是 xxx，App Secret 是 xxx。

把 xxx 换成你刚复制的内容，Deep Code 会给你后续所有命令。

继续在对话框输入：hermes gateway restart，等待飞书渠道重启成功。

10.3. 飞书测试

应用发布之后，飞书里搜索机器人名字，加为联系人，发条消息。

能收到回复就全部跑通了。 群里用需要 @ 机器人，私信直接发。

11. 部署服务器

本地跑通了才做这一步。飞书要 7×24 小时接着，本机关机就断，放服务器才行。

先买一台服务器，2 核 4G 内存，40G 硬盘以上即可，Ubuntu 24.04 系统。火山引擎、阿里云、腾讯云都行，第一次买都很便宜的。

买完后，进入服务器页面，你能看到一个公网 IP 和登录密码。

服务器买好之后，把下面这段粘给 Deep Code，把公网 IP 和 DeepSeek Key 换成你的：

帮我把 Hermes Agent 部署到 Ubuntu 服务器上，实现 7×24 小时运行。
服务器公网 IP：你的IP
服务器 root 密码：你的密码
DeepSeek API Key：sk-你的key
需要完成：SSH 进服务器、安装 Hermes、配置 DeepSeek、安装 WebUI、把飞书 Gateway 跑成后台服务。
每步执行完等我确认再继续。

[!success] 全套跑通检查清单

• [ ] Deep Code 能正常对话（Key 配置成功）
• [ ] hermes doctor 无红色报错
• [ ] WebUI 后台能打开并切换中文
• [ ] 给 Hermes 配好 DeepSeek 后能正常回复
• [ ] 飞书机器人加好友后能收到回复
• [ ] 服务器部署完成后，手机关机、电脑不开，飞书依然能回（7×24 待命）