夜雨聆风
Hermes Agent 是一个开源的 AI Agent 框架，由 Nous Research 开发。它运行在你的终端里，能操作文件、执行命令、搜索网络、管理 GitHub、收发邮件——而且有跨会话记忆，越用越懂你。
这篇教程覆盖安装、配置、日常使用三个部分，跟着做就行。
一、系统要求
支持 Linux、macOS、WSL2（Windows 子系统）。不支持原生 Windows，Windows 用户需要先装 WSL2。
唯一的前置依赖：Git。其他所有东西（Python 3.11、Node.js v22、ripgrep、ffmpeg）安装脚本会自动处理。
# 检查 Git 是否已安装 git --version二、一键安装
复制下面这一行命令，在终端里执行：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装脚本会自动完成以下操作：
• 安装 uv（Python 包管理器）• 安装 Python 3.11• 安装 Node.js v22• 安装 ripgrep、ffmpeg• 克隆仓库并创建虚拟环境• 注册全局 hermes 命令• 启动模型配置向导
如果你已经安装了openclaw，会提示你是否导入
推荐使用快速配置
Hermes 不绑定任何模型。运行以下命令选择你的 LLM 供应商：
支持的供应商（部分）：
• Anthropic — Claude 系列（API Key 或 Claude Code 登录）• OpenAI Codex — ChatGPT OAuth 登录• OpenRouter — 多模型路由（一个 Key 访问几十个模型）• Z.AI（智谱） — GLM 系列，Zhipu AI direct API设 ZAI_API_KEY• DeepSeek — 设 DEEPSEEK_API_KEY• Kimi / Moonshot — 设 KIMI_API_KEY• 阿里云 — 通义千问，设 DASHSCOPE_API_KEY• Hugging Face — 20+ 开源模型，设 HF_TOKEN• GitHub Copilot — Copilot 订阅直接用• 自定义端点 — VLLM、Ollama 等任何兼容 OpenAI API 的服务
重要：模型需要至少 64K tokens 的上下文窗口。Claude、GPT、Gemini、Qwen、DeepSeek 等主流模型都满足。
API Key 的多种设置方式：
# 方法一：交互式配置 hermes model # 方法二：直接写入配置 hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxx # 方法三：编辑配置文件 vim ~/.hermes/.env # 写入： # ZAI_API_KEY=your-key # DEEPSEEK_API_KEY=your-key四、验证安装
hermes version # 查看版本 hermes doctor # 诊断问题 hermes status # 查看配置状态三个命令都正常通过，就可以开始使用了。
五、开始使用
直接输入 hermes 启动对话。你会看到欢迎界面，显示当前模型和可用工具。
hermes试几个操作：
❯ 查看磁盘使用情况，列出最大的5个目录 ❯ 在当前目录创建一个 Python FastAPI 项目脚手架 ❯ 帮我搜索最近一周 AI Agent 领域的重要新闻 ❯ 读一下 ~/project/main.py，告诉我有什么 bugHermes 会自动拆解任务、调用工具、执行操作。你不需要告诉它具体怎么做。
六、常用命令速查
对话中的斜杠命令：
• /help — 查看所有命令• /tools — 列出可用工具• /model — 切换模型• /save — 保存对话• /skills — 浏览和安装技能
终端命令：
• hermes — 开始对话• hermes --continue 或 hermes -c — 恢复上次对话• hermes model — 切换模型• hermes tools — 配置工具• hermes setup — 完整设置向导• hermes doctor — 诊断问题• hermes update — 更新版本• hermes gateway — 启动消息网关（Telegram/Discord/微信等）
快捷键：
• Alt+Enter 或 Ctrl+J — 多行输入• Ctrl+C — 中断当前任务• 直接输入新消息按回车 — 也会中断当前任务
七、技能系统
技能是预定义的任务流程，教 Hermes 怎么完成特定工作。社区有大量现成技能可用。
# 搜索技能 hermes skills search kubernetes hermes skills search react --source skills-sh # 从 URL 发现技能 hermes skills search https://docs.example.com --source well-known # 安装技能 hermes skills install openai/skills/k8s hermes skills install official/security/1password # 在对话中管理 /skills八、消息平台连接
Hermes 可以接入 Telegram、Discord、Slack、WhatsApp、Signal、邮件等平台，在手机上也能用：
hermes gateway setup # 交互式配置各平台 hermes gateway # 启动网关九、语音模式
支持语音输入和语音回复：
pip install "hermes-agent[voice]" pip install faster-whisper # 推荐，免费本地语音转文字 # 在对话中开启 /voice on # Ctrl+B 录音，/voice tts 开启语音回复十、常见问题
hermes: command not found重载 shell（source ~/.bashrc），或检查 ~/.local/bin 是否在 PATH 中。
API key not set运行 hermes model 配置，或 hermes config set OPENROUTER_API_KEY your_key。
更新后配置丢失运行 hermes config check，然后 hermes config migrate。
其他问题运行 hermes doctor，它会告诉你缺什么、怎么修。
GitHub：github.com/NousResearch/hermes-agent文档：hermes-agent.nousresearch.com/docsDiscord：discord.gg/NousResearch