第 2 课 10 分钟部署：从零搭建你的全天候 AI 助理

第 2 课 10 分钟部署：从零搭建你的全天候 AI 助理

本课目标

  • 在本地或 VPS 上完成 Hermes Agent 安装
  • 完成首次配置向导（模型选择、API Key、工具集）
  • 与 Hermes 进行第一次完整对话

2.1 安装前准备：系统要求与环境检查

支持的操作系统

系统 支持情况 备注
Linux（Ubuntu/Debian/CentOS） ✅ 原生支持 推荐 Ubuntu 22.04+
macOS ✅ 原生支持 Intel 和 Apple Silicon 均可
Windows WSL2 ✅ 支持 需先安装 WSL2
Android Termux ✅ 支持 手机上也能跑
Windows 原生 ❌ 不支持 必须用 WSL2

环境要求

必需：

  • Python 3.10 或更高版本
  • 外网访问能力（下载安装脚本、调用 LLM API）
  • 一个 LLM API Key（下面会教你获取）

推荐：

  • curl 和 git（大多数系统已预装）
  • 至少 2GB 可用内存
  • 稳定的网络连接

Windows 用户：先装 WSL2

如果你用 Windows，先在 PowerShell 管理员模式中执行：

wsl --install

重启后，打开 Ubuntu 终端，后续所有操作在这里进行。

检查 Python 版本

python3 --version

输出应为 Python 3.10.x 或更高。如果低于 3.10 或未安装：

# Ubuntu / Debian
sudo apt update && sudo apt install python3 python3-pip -y

# macOS
brew install python3

2.2 一键安装脚本详解

Hermes Agent 提供了官方一键安装脚本：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

这行命令做了什么？

  1. 检测你的操作系统和架构
  2. 安装 Hermes CLI 可执行文件到 ~/.local/bin/hermes
  3. 设置环境变量（PATH）
  4. 创建配置目录 ~/.hermes/
  5. 显示安装成功提示

安装完成后，验证：

hermes --version

应输出类似 hermes v0.8.0 (v2026.4.8)。

安装失败怎么办？

问题 解决方案
curl: command not found sudo apt install curl
权限不足 不要用 sudo 运行安装脚本，脚本会自动处理权限
网络超时 检查网络，或使用代理：export https_proxy=...
Python 版本太低 升级到 Python 3.10+（见上一节）
hermes: command not found 运行 source ~/.bashrc 或重新打开终端

2.3 首次运行 hermes setup：配置向导全流程

安装完成后，运行配置向导：

hermes setup

向导会依次引导你完成以下配置：

Step 1：选择 LLM 提供商

? Select your LLM provider:
  > Nous Portal (recommended, free credits included)
    OpenRouter (200+ models, pay-per-use)
    OpenAI (GPT-4o, GPT-4-turbo)
    z.ai / GLM (智谱清言)
    Kimi / Moonshot
    MiniMax
    Custom endpoint

推荐选择：

  • 零成本起步 → Nous Portal：注册即送免费额度，足够你学完本书
  • 模型多样性 → OpenRouter：200+ 模型按量付费，$5 可用很久
  • 国内用户 → 智谱 GLM 或 Kimi：无需翻墙，中文效果好

Step 2：输入 API Key

以 OpenRouter 为例：

  1. 访问 https://openrouter.ai/
  2. 注册账户
  3. 进入 Keys 页面，点击 “Create Key”
  4. 复制 Key，粘贴到向导中
? Enter your API key: sk-or-v1-xxxxxxx

Step 3：选择默认模型

? Select your default model:
  > nous/hermes-3-llama-3.1-405b
    anthropic/claude-3.5-sonnet
    openai/gpt-4o
    google/gemini-pro-1.5

建议：

  • 日常使用：anthropic/claude-3.5-sonnet（性价比最优）
  • 预算紧张：nous/hermes-3-llama-3.1-405b（Nous Portal 免费额度）
  • 中文优先：zhipu/glm-4

Step 4：选择终端后端

? Select terminal backend:
  > local (run commands on this machine)
    docker (isolated container)
    ssh (remote server)

初学者选 local 即可。Docker 和 SSH 在第 11 课讲省钱部署时会详细介绍。

Step 5：启用工具集

? Enable tool categories:
  [x] Web Search
  [x] Code Execution
  [x] File Operations
  [x] Image Generation
  [ ] MCP Servers (advanced)

建议全部勾选 Web Search、Code Execution、File Operations。MCP Servers 后面课程会用到时再开启。

配置完成后，Hermes 会显示：

✅ Setup complete! Run 'hermes' to start chatting.

2.4 选择你的模型：三种策略

模型选择直接影响效果和成本。以下是三种适合个人创业者的策略：

策略 A：极简省钱型（$0-5/月）

hermes config set model "nous/hermes-3-llama-3.1-405b"

使用 Nous Portal 免费额度，超出后切到 OpenRouter 小模型。适合预算紧张、任务简单的场景。

策略 B：均衡型（$5-15/月）

hermes config set model "anthropic/claude-3.5-sonnet"

日常使用 Claude 3.5 Sonnet，$3/M tokens 输入 + $15/M tokens 输出。一般个人创业者每天消耗 10-50K tokens，月费 $5-15。

策略 C：灵活切换型

不设置默认模型，根据任务场景用 /model 命令切换：

/model anthropic/claude-3.5-sonnet    # 复杂分析
/model openai/gpt-4o-mini             # 简单对话
/model zhipu/glm-4                    # 中文写作

小林的选择： 策略 B——Claude 3.5 Sonnet 作为日常模型，遇到中文长文写作时临时切换到 GLM-4。每月约 $8。

2.5 hermes doctor：诊断与常见问题排查

任何时候遇到问题，先运行：

hermes doctor

它会检查：

✅ Hermes CLI version: v0.8.0
✅ Python: 3.12.3
✅ Terminal backend: local (running)
✅ LLM provider: OpenRouter (connected)
✅ Default model: anthropic/claude-3.5-sonnet
✅ Web search: enabled
✅ Code execution: enabled
⚠️  No gateways configured (optional)
⚠️  No cron jobs configured (optional)

常见问题速查表：

doctor 输出 问题 解决方案
❌ LLM provider: connection failed API Key 无效或网络问题 检查 Key 是否正确，检查网络
❌ Terminal backend: not running Docker 未启动 docker start hermes-sandbox 或换 local
❌ Python: not found Python 未安装 安装 Python 3.10+
⚠️ Model not available 模型名称错误 hermes model list 查看可用模型

2.6 第一次对话：让 Hermes 帮你整理桌面文件

安装和配置都搞定了，现在来真正上手！

启动 Hermes

hermes

你会看到一个交互式命令行界面：

🔮 Hermes Agent v0.8.0
Model: anthropic/claude-3.5-sonnet via OpenRouter
Type /help for commands

You:

第一个任务：自我介绍 + 文件整理

输入：

你好！我是小林，独立品牌设计师，一个人运营"林間设计工作室"。

请帮我做两件事：
1. 记住我的基本信息，以后我们会经常合作
2. 看看我桌面上有哪些文件，按类型整理成文件夹

Hermes 会：

  1. 记忆你的信息：把"小林、独立品牌设计师、林間设计工作室"存入长期记忆
  2. 扫描桌面：列出 ~/Desktop 下的所有文件
  3. 提出整理方案：建议按类型（文档/图片/设计文件/其他）分类
  4. 征求确认：问你"要执行这个方案吗？"
  5. 执行整理：创建文件夹并移动文件

观察要点

注意 Hermes 的回复中包含：

  • 思考过程（会展示它的推理链）
  • 工具调用（如 ls ~/Desktop、mkdir ~/Desktop/Documents）
  • 确认请求（涉及文件移动时会先问你）

这就是 Agent 和普通聊天的区别——它不只是回答问题，而是真的在帮你做事。

尝试更多命令

请帮我搜索一下 2026 年品牌设计行业的趋势，列出 5 个重点方向

这次 Hermes 会调用 Web 搜索工具，联网查找最新信息，而不是依赖训练数据。

/usage

输入斜杠命令查看你这次对话消耗了多少 tokens 和费用。

2.7 VPS 部署预览（详见第 11 课）

如果你希望 Hermes 7×24 小时在线（不是只有你开电脑时才能用），需要部署到一台 VPS。简要预览：

# 在 VPS 上（推荐 Hetzner / BandwagonHost / Vultr，$5/月）
# 1. SSH 登录 VPS
ssh root@your-vps-ip

# 2. 安装 Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 3. 运行 setup
hermes setup

# 4. 配置 Telegram 网关（第 3 课详解）
hermes gateway setup

# 5. 用 tmux 保持运行
tmux new -s hermes
hermes gateway start
# Ctrl+B, D 退出 tmux（进程继续运行）

这样 Hermes 就在 VPS 上 24 小时待命，你随时在手机 Telegram 上就能和它对话。

动手练习

  1. 安装 Hermes Agent：按照 2.2 节的步骤完成安装，运行 hermes --version 确认成功
  2. 完成配置向导：运行 hermes setup，选择你偏好的模型和 API Key
  3. 运行 hermes doctor：检查所有项目是否正常
  4. 完成第一次对话：启动 hermes，让它帮你整理桌面文件（或列出某个文件夹的内容）
  5. 查看用量：用 /usage 看看这次对话花了多少钱

本课小结

要点 内容
安装命令 curl -fsSL https://...install.sh | bash
配置向导 hermes setup → 选提供商 → 输入 Key → 选模型 → 选后端
推荐模型 Claude 3.5 Sonnet（均衡）或 Nous Hermes 3（免费）
诊断命令 hermes doctor 一键检查所有配置
费用预估 软件免费 + API $5-15/月
第一个任务 让 Hermes 整理桌面文件——感受 Agent 的执行力

下一课预告

第 3 课：让 AI 住进你的微信和 Telegram

安装好了 Hermes，但目前你只能在终端窗口中使用。下一课我们将配置消息网关，让你在手机上随时和 Hermes 对话——真正实现"永不下线的 AI 员工"。