一、环境要求
- 系统: Linux / macOS / WSL (Windows)
- Python: 3.10+
- 内存: 建议 2GB+
- 磁盘: 至少 2GB 可用空间
二、安装
一键安装（推荐）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash或者 git 克隆安装：
git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent
cd ~/.hermes/hermes-agent
pip install -e .安装完成后验证：
hermes --version三、配置模型（核心步骤）
方式一：交互式向导
hermes setup model方式二：手动配置
# 编辑配置文件
hermes config edit
# 或直接设置
hermes config set model.default "模型名称"
hermes config set model.provider "提供商"常用提供商配置示例：
# OpenRouter（推荐，支持多模型）
export OPENROUTER_API_KEY="sk-or-xxx"
hermes config set model.provider openrouter
hermes config set model.default anthropic/claude-sonnet-4
# Anthropic（Claude）
export ANTHROPIC_API_KEY="sk-ant-xxx"
hermes config set model.provider anthropic
hermes config set model.default claude-sonnet-4
# DeepSeek（便宜好用）
export DEEPSEEK_API_KEY="sk-xxx"
hermes config set model.provider deepseek
hermes config set model.default deepseek-chat
# Google Gemini
export GOOGLE_API_KEY="AIza-xxx"
hermes config set model.provider google
hermes config set model.default gemini-2.0-flash
# 小米 MiMo
export XIAOMI_API_KEY="xxx"
hermes config set model.provider xiaomi
hermes config set model.default mimo-v2.5-pro
# 自定义端点（兼容 OpenAI API）
hermes config set model.provider custom
hermes config set model.base_url "https://your-api.com/v1"
hermes config set model.api_key "your-key"
hermes config set model.default "model-name"API Key 建议写入 .env 文件：
hermes config env-path # 查看 .env 路径
# 然后编辑该文件添加 API keys四、健康检查
hermes doctor # 检查依赖和配置
hermes doctor --fix # 自动修复问题
hermes status --all # 查看所有组件状态五、基本使用
CLI 模式（终端交互）：
hermes # 进入交互式聊天
hermes chat -q "你好" # 单次查询
hermes --continue # 继续上次会话
hermes -s skill-name # 预加载 skill常用斜杠命令（聊天中使用）：
- /help — 帮助
- /new — 新会话
- /model — 切换模型
- /tools — 管理工具
- /skills — 管理技能
六、配置消息网关（Telegram / Discord 等）
安装网关服务：
hermes gateway setup # 交互式配置平台
hermes gateway install # 安装为后台服务
hermes gateway start # 启动服务
hermes gateway status # 查看状态支持的平台：
飞书、钉钉、企业微信 等 20+ 个平台
七、工具与技能管理
# 管理工具集
hermes tools list # 查看所有工具
hermes tools enable web # 启用 web 搜索
hermes tools enable browser # 启用浏览器
# 管理技能
hermes skills list # 已安装的技能
hermes skills browse # 浏览可用技能
hermes skills install <id> # 安装技能
hermes skills update # 更新技能八、定时任务
hermes cron list # 查看任务
hermes cron create "0 9 * * *" # 每天 9 点执行
hermes cron create "30m" # 每 30 分钟
hermes cron create "every 2h" # 每 2 小时九、关键文件路径
~/.hermes/config.yaml 主配置文件
~/.hermes/.env API Keys 和密钥
~/.hermes/skills/ 已安装的技能
~/.hermes/sessions/ 会话记录
~/.hermes/logs/ 日志文件
~/.hermes/auth.json OAuth 令牌
十、常见问题
工具不可用
• 问题: 工具不可用
• 解决方案: hermes tools 检查是否启用，/reset 刷新
配置不生效
• 问题: 配置不生效
• 解决方案: CLI 退出重进，gateway 执行 /restart
Gateway 掉线
• 问题: Gateway 掉线
• 解决方案: sudo loginctl enable-linger $USER
模型报错
• 问题: 模型报错
• 解决方案: hermes doctor 检查，确认 API Key 正确
技能不显示
• 问题: 技能不显示
• 解决方案: hermes skills config 检查平台启用状态