快速开始
本文帮助你在五分钟内完成首次配置并开始与 Hermes Agent 对话。
前置条件
确保已完成安装并通过验证：
bash
hermes doctor所有检查项显示 ✓ 后继续以下步骤。
第一步：运行初始化向导
bash
hermes setup向导会引导你完成以下配置：
- 选择默认模型提供商（OpenAI / Anthropic / Nous Portal / OpenRouter 等）
- 输入 API Key（安全写入
~/.hermes/.env） - 选择终端后端（本地 / Docker / SSH）
- 配置记忆功能（建议开启）
- 选择语言偏好（中文 / 英文）
向导完成后，配置自动保存到 ~/.hermes/config.yaml。
第二步：选择模型
运行交互式模型选择器：
bash
hermes model界面示例：
? 选择模型提供商：
❯ Nous Portal
OpenRouter
OpenAI
Anthropic
Google Gemini
DeepSeek
本地（Ollama）
...
? 选择模型：
❯ hermes-3-llama-3.1-70b
hermes-3-llama-3.1-405b
...也可以直接通过命令行指定：
bash
hermes --model openai/gpt-4o
hermes --model anthropic/claude-3-5-sonnet
hermes --model ollama/llama3.2第三步：配置 API Key
API Key 存储在 ~/.hermes/.env 文件中。直接编辑或通过命令设置：
bash
# 方式一：直接编辑
nano ~/.hermes/.env
# 方式二：通过命令设置（推荐）
hermes config set NOUS_API_KEY your_key_here
hermes config set OPENAI_API_KEY your_key_here
hermes config set ANTHROPIC_API_KEY your_key_here.env 文件格式：
bash
# Nous Portal
NOUS_API_KEY=nsk-xxxxxxxxxxxx
# OpenRouter（可访问 200+ 模型）
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxx
# OpenAI
OPENAI_API_KEY=sk-xxxxxxxxxxxx
# Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx
# Google Gemini
GOOGLE_API_KEY=AIzaxxxxxxxxxx
# DeepSeek
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxx第四步：开始对话
进入交互模式
bash
hermes这会打开一个持续的对话界面，支持多轮对话和上下文保持。
单次问答
bash
hermes chat -q "你好，请介绍一下你自己"
hermes chat -q "用 Python 写一个快速排序算法"
hermes chat -q "总结一下今天的新闻"使用管道输入
bash
echo "解释这段代码" | hermes chat
cat error.log | hermes chat -q "帮我分析这个错误"常用命令行标志
模型选择
bash
# 指定模型
hermes --model openai/gpt-4o
# 使用交互选择器
hermes model工具集控制
bash
# 启用指定工具集
hermes --toolsets web,terminal,browser
# 禁用所有工具（纯对话模式）
hermes --toolsets none
# 查看所有可用工具集
hermes toolsets list技能管理
bash
# 启用指定技能
hermes -s my_skill_name
# 列出所有技能
hermes skills list
# 查看技能详情
hermes skills show my_skill_name会话管理
bash
# 继续上一次会话
hermes --continue
# 从指定会话恢复
hermes --resume session_id_here
# 列出历史会话
hermes sessions list调试与输出
bash
# 详细输出（显示工具调用过程）
hermes --verbose
# 自动批准所有操作（无需手动确认，谨慎使用）
hermes --yolo
# 指定系统提示词
hermes --system "你是一个专业的 Python 开发者，回复请使用简洁的技术语言"创建你的第一个技能
技能（Skill）是 Hermes Agent 的核心学习机制。以下演示如何创建一个简单技能：
方式一：从对话中自动提炼
在对话中，Hermes Agent 会自动识别可复用的操作序列并提示你保存为技能：
你：帮我查一下 Python requests 库的最新版本，然后检查我的项目是否需要更新
Hermes：[执行一系列操作后]
我注意到这个流程可以复用。是否将其保存为技能"check_package_version"？
你：是的，保存方式二：手动创建技能文件
在 ~/.hermes/skills/ 目录下创建 YAML 文件：
bash
nano ~/.hermes/skills/git_summary.yamlyaml
name: git_summary
description: 生成当前 Git 仓库的提交摘要报告
version: "1.0"
author: your_name
tags:
- git
- development
steps:
- tool: terminal
command: git log --oneline -20
description: 获取最近 20 条提交记录
- tool: terminal
command: git diff --stat HEAD~5
description: 查看近 5 次提交的变更统计
- tool: llm
prompt: |
基于以上 git 信息，生成一份简洁的中文摘要报告，
包括主要变更内容和开发进展。使用技能：
bash
hermes -s git_summary方式三：从对话描述生成技能
bash
hermes chat -q "帮我创建一个技能，功能是：检查系统资源使用情况（CPU、内存、磁盘），并生成中文报告"Hermes Agent 会自动生成技能文件并保存到技能库。
快速配置消息平台网关
如果你想让 Hermes Agent 在 Telegram、Discord 等平台上响应消息：
bash
hermes gateway setup向导会引导你选择平台并完成配置。以 Telegram 为例：
? 选择要配置的平台：Telegram
? 请输入 Bot Token（从 @BotFather 获取）：
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
? 允许哪些用户使用此机器人？
❯ 指定用户 ID 列表
所有人（不推荐）
DM 配对模式
? 输入允许的 Telegram 用户 ID（逗号分隔）：
123456789, 987654321
✓ Telegram Bot 配置完成！
启动网关：hermes gateway start启动网关：
bash
hermes gateway start
# 后台运行
hermes gateway start --daemon