📖 目录

1. [初始设置案例](#初始设置案例)
2. [日常开发工作流](#日常开发工作流)
3. [消息平台集成](#消息平台集成)
4. [多环境管理案例](#多环境管理案例)
5. [故障排查案例](#故障排查案例)
6. [高级用法案例](#高级用法案例)

初始设置案例

案例 1: 首次安装和配置

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

# 步骤 2: 进入安装目录
cd ~/.hermes/hermes-agent

# 步骤 3: 激活虚拟环境（如果创建了）
source .venv/bin/activate

# 步骤 4: 运行配置向导
hermes setup

# 步骤 5: 交互式配置完成后，设置模型
hermes model set --provider anthropic --model "claude-3-5-sonnet"

# 步骤 6: 启用常用工具
hermes tools enable terminal
hermes tools enable web
hermes tools enable skills

# 步骤 7: 验证安装
hermes doctor

# 步骤 8: 开始聊天
hermes

案例 2: 静默安装和配置

# 快速安装（适合脚本）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash && \
cd ~/.hermes/hermes-agent && \
source .venv/bin/activate && \
hermes setup --model --provider anthropic --model "claude-3-5-sonnet" && \
hermes tools enable terminal web skills && \
hermes chat -q "Hello"

案例 3: 从源码安装（开发环境）

# 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 设置 Python 环境
uv sync

# 安装语音和 MCP 支持
uv pip install -e ".[voice,mcp]"

# 运行配置
hermes setup

# 配置开发 Profile
hermes profile create dev
hermes profile set dev.model "gemini/gemini-2.0-flash"
hermes profile use dev

# 启动 TUI（开发模式）
hermes --tui --dev

日常开发工作流

案例 4: 代码库分析

# 进入项目目录
cd /path/to/your/project

# 使用 CLI 分析代码库
hermes chat -q "分析这个代码库的架构" -w /path/to/your/project

# 使用检查点跟踪对话
hermes chat --checkpoints --max-snapshots 30 -q "帮我理解这个库的设计模式" -w /path/to/your/project

# 使用特定模型进行代码审查
hermes chat --model "anthropic/claude-3-5-sonnet" -q "Review the pull request at PR #123" -w /path/to/your/project

案例 5: 代码生成和调试

# 生成 Python 脚本
hermes chat -q "帮我写一个 Python 脚本来备份数据库"

# 调试错误
hermes chat -q "帮我调试这个 Python 错误：[粘贴错误信息]"

# 重构代码
hermes chat -q "重构这段代码使其更清晰：[粘贴代码]"

# 生成测试
hermes chat -q "为这个函数生成单元测试：[粘贴代码]"

案例 6: 终端工具使用

# 查看 GPU 状态
hermes chat -q "nvidia-smi --query-gpu=name,memory.total,utilization.gpu --format=csv,noheader"

# 查看服务状态
hermes chat -q "systemctl status hermes-agent"

# 运行 Docker 命令
hermes chat -q "docker ps -a"

# 查看日志
hermes chat -q "journalctl -u hermes-agent -n 50"

# 查看目录内容
hermes chat -q "ls -la /path/to/dir"

# 运行 git 命令
hermes chat -q "git log --oneline -10"

案例 7: Web 工具使用

# 网页提取
hermes chat -q "总结 https://example.com 的内容"

# 网页搜索
hermes chat -q "search google for 'latest AI trends'"

# 检查网页
hermes chat -q "check the latest release notes at github.com/nousresearch/hermes-agent/releases"

# 提取文档
hermes chat -q "extract the API documentation from https://docs.example.com"

消息平台集成

案例 8: Telegram 集成

# 配置 Telegram
hermes gateway telegram config set bot_token=$TELEGRAM_BOT_TOKEN

# 启动 Telegram 网关
hermes gateway telegram start

# 网关会输出类似：
# ✓ Telegram gateway started
# Bot will listen for messages on your Telegram

# 然后在 Telegram 中：
# /help     # 查看帮助
# /chat     # 开始聊天
# /status   # 查看状态
# /restart  # 重启网关

案例 9: Discord 集成

# 配置 Discord（从 Discord Developer Portal 获取凭证）
hermes gateway discord config set client_id=$DISCORD_CLIENT_ID
hermes gateway discord config set client_secret=$DISCORD_CLIENT_SECRET
hermes gateway discord config set webhook_enabled=true

# 启动 Discord 网关
hermes gateway discord start

# 在 Discord 中使用 /hermes 命令

案例 10: Slack 集成

# 配置 Slack
hermes gateway slack config set bot_token=$SLACK_BOT_TOKEN

# 启动 Slack 网关
hermes gateway slack start

# 在 Slack 中使用 /hermes 命令

案例 11: 多平台网关

# 同时运行多个平台
hermes gateway telegram start
hermes gateway discord start
hermes gateway slack start

# 查看所有网关状态
hermes gateway status

# 停止特定平台
hermes gateway telegram stop
hermes gateway discord stop

# 查看所有网关日志
hermes gateway logs --all

多环境管理案例

案例 12: 开发/生产环境分离

# 创建不同环境的 Profile
hermes profile create dev
hermes profile create work
hermes profile create production

# 配置开发环境
hermes profile configure dev
hermes profile set dev.model "gemini/gemini-2.0-flash-exp"
hermes profile set dev.tools enabled terminal,web,skills

# 配置工作环境
hermes profile configure work
hermes profile set work.model "anthropic/claude-3-5-sonnet"
hermes profile set work.tools enabled terminal,web,browser

# 配置生产环境
hermes profile configure production
hermes profile set production.model "our-cost-effective-model"
hermes profile set production.tools enabled terminal,web

# 使用不同环境
hermes -p dev chat "帮我调试这个代码"
hermes -p work chat "准备项目报告"
hermes -p production chat "部署检查"

案例 13: 团队协作

# 创建团队 Profile
hermes profile create team-member
hermes profile create team-lead
hermes profile create architect

# 配置团队 Lead 的 Profile
hermes profile configure team-lead
hermes profile set team-lead.model "anthropic/claude-3-5-sonnet"
hermes profile set team-lead.tools enabled terminal,web,browser,wechat

# 配置架构师的 Profile
hermes profile configure architect
hermes profile set architect.model "gemini/gemini-2.0-pro"
hermes profile set architect.tools enabled terminal,web,skills

# 导出配置文件供团队成员使用
hermes profile export team-member > ~/team-member.yaml

故障排查案例

案例 14: 诊断工具问题

# 检查工具状态
hermes tools status

# 查看终端工具配置
hermes tools terminal local show

# 检查浏览器扩展
hermes browser-extension status

# 诊断浏览器扩展
hermes browser-extension doctor

# 修复工具问题
hermes tools doctor

# 重新安装工具依赖
hermes computer-use install

# 查看网关日志
hermes gateway logs --follow --level=error

# 诊断网关
hermes doctor check-gateway

案例 15: API 密钥问题

# 检查 API 密钥状态
hermes doctor check-keys

# 验证连接
hermes doctor check-models

# 设置新的 API 密钥
hermes config set ANTHROPIC_API_KEY=$NEW_KEY
hermes config set OPENAI_API_KEY=$NEW_KEY

# 重新配置模型
hermes model set --provider anthropic --model "claude-3-5-sonnet"

# 刷新配置
hermes config reload

案例 16: 终端环境问题

# 检查终端环境配置
hermes tools environments local show

# 切换到 Docker 环境
hermes tools set terminal.environment docker

# 配置 Docker
hermes tools terminal docker set image=nous/hermes-agent:latest

# 检查 SSH 连接
hermes tools environments ssh show

# 切换到 Modal 环境
hermes tools set terminal.environment modal
hermes tools terminal modal set default_region=us-east-1

高级用法案例

案例 17: MCP 服务器集成

# 配置 GitHub MCP 服务器
hermes config set mcp_servers.github command:npx args:["-y", "@modelcontextprotocol/server-github"]
hermes config set mcp_servers.github.ENV GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_TOKEN

# 配置 Docker MCP 服务器
hermes config set mcp_servers.docker command:npx args:["-y", "@modelcontextprotocol/server-docker"]
hermes config set mcp_servers.docker.ENV DOCKER_HOST=$DOCKER_HOST

# 配置多个 MCP 服务器
hermes config set mcp_servers."github,docker" command:npx args:["-y", "@modelcontextprotocol/server-github", "@modelcontextprotocol/server-docker"]

案例 18: 检查点管理

# 启用检查点
hermes chat --checkpoints --max-snapshots 50

# 查看检查点
hermes checkpoints list

# 恢复检查点
hermes chat --resume <checkpoints_dir>/last

# 删除旧检查点
hermes checkpoints clean --older-than 7d

案例 19: 工作流自动化

# 定义快速命令
hermes config set quick_commands.status.type=exec
hermes config set quick_commands.status.command=hermes doctor
hermes config set quick_commands.gpu.type=exec
hermes config set quick_commands.gpu.command=nvidia-smi
hermes config set quick_commands.restart.type=alias
hermes config set quick_commands.restart.target=/gateway restart

# 然后在聊天中使用：
# /status    # 运行 hermes doctor
# /gpu       # 运行 nvidia-smi
# /restart    # 重启网关

案例 20: 批量操作

# 批量安装多个技能
for skill in kubernetes docker terraform aws; do
  hermes skills install openai/skills/$skill
done

# 批量启用工具
hermes tools enable terminal
hermes tools enable web
hermes tools enable skills
hermes tools enable browser

# 批量配置 Profile
hermes profile create dev work personal
hermes profile configure dev
hermes profile configure work
hermes profile configure personal

🎯 最佳实践

日常使用

# 1. 启动会话时启用检查点
hermes chat --checkpoints

# 2. 使用 Profile 分离环境
hermes -p dev chat "..."
hermes -p work chat "..."

# 3. 定期诊断
hermes doctor

# 4. 更新工具
hermes tools

# 5. 清理临时文件
hermes cleanup --older-than 30d

故障排查

# 1. 检查日志
hermes gateway logs --follow --level=error

# 2. 诊断问题
hermes doctor --verbose

# 3. 检查 API 密钥
hermes doctor check-keys

# 4. 查看工具状态
hermes tools status

# 5. 检查配置
hermes config show

📚 参考

• [完整命令参考](./HERMES_COMMANDS.md)
• [速查表](./HERMES_COMMANDS_CHEATSHEET.md)