马户科技官方认证 Hermes Agent 部署指南
从入门到精通，避坑指南 + 安全实践指南
电商平台的低价教程存在三大风险，官方指南帮你避坑
电商教程往往基于旧版本，缺少关键安全修复和功能更新。官方指南跟随最新 stable 版本。
第三方打包镜像可能植入恶意 Skill，窃取你的 API Key 或敏感数据。官方安装包经过安全审计。
遇到问题找谁？官方指南配套官方支持渠道，遇到问题有人管，不是卖完就不管。
最稳定、最可维护的部署方式，适合生产环境
mkdir -p ~/hermes && cd ~/hermesversion: '3.8'
services:
hermes:
image: nousresearch/hermes:latest
container_name: hermes
ports:
- "18790:18790" # Web UI
volumes:
- ./data:/app/data
- ./profiles:/opt/data/profiles
environment:
- HERMES_PORT=18790
- OPENMAIC_URL=http://172.18.0.1:3000
restart: unless-stopped
networks:
- hermes-net
networks:
hermes-net:
driver: bridgedocker compose up -d
docker compose logs -f hermes生产环境建议配置反向代理（Nginx/Caddy）和 SSL 证书。参考我们的 GEO 服务 获取专业部署支持。
适合 Python 开发者，完全掌控环境配置
# 使用 pip 安装
pip install hermes-agent
# 或使用国内镜像加速
pip install hermes-agent -i https://pypi.tuna.tsinghua.edu.cn/simple# 生成配置文件
hermes init
# 编辑配置（至少设置 API Key）
vim ~/.hermes/config.yaml# ~/.hermes/config.yaml
version: "1.0"
port: 18790
# 主模型（必填）
model:
provider: anthropic
model: claude-sonnet-4
api_key: ${ANTHROPIC_API_KEY}
# 辅助模型（可选）
auxiliary:
provider: openai
model: gpt-4o
api_key: ${OPENAI_API_KEY}切勿硬编码 API Key 到配置文件！使用环境变量或 secrets manager。示例：api_key: ${ANTHROPIC_API_KEY}
适合快速体验或测试环境，一行命令完成安装
以下脚本会自动检测系统环境，下载最新稳定版，完成基础配置。适合快速体验，生产环境建议使用 Docker Compose。
curl -fsSL https://get.hermes.ai | bash使用一键脚本前，请务必验证脚本来源。建议先阅读脚本内容或使用官方 Docker 镜像。脚本可能随版本更新，请访问 hermes-agent.nousresearch.com 获取最新链接。
完成安装后，需要配置模型 API 和基础参数
| 参数 | 说明 | 示例 |
|---|---|---|
| port | Web UI 端口 | 18790 |
| model.provider | 模型提供商 | anthropic / openai / custom |
| model.model | 模型名称 | claude-sonnet-4 |
| model.api_key | API 密钥（建议环境变量） | ${ANTHROPIC_API_KEY} |
| auxiliary | 辅助模型（可选） | openai / gpt-4o |
auth.json 存储用户身份信息，用于飞书、Discord 等第三方平台认证：
{
"feishu": {
"app_id": "cli_xxxxx",
"app_secret": "xxxxx"
},
"discord": {
"token": "xxxxx"
}
}马户科技推荐的多人协作部署模式
Hermes 支持多 Profile 架构，允许你在同一实例中运行多个独立 Agent，每个 Agent 拥有独立的配置、记忆和技能。马户科技使用四 Profile 架构：
战略大脑。负责情报分析、决策辅助、跨 Agent 协调。
代码之手。负责开发、运维、基础设施管理。
内容之王。负责中文内容生产、SEO、多平台运营。
情报猎手。负责 AI 情报采集、竞品监控、趋势扫描。
多 Profile 架构实现"一个大脑，多只手"的协作模式。每个 Profile 专注自己的领域，通过 Kanban 看板协同工作，避免权限混乱和记忆污染。
确认 Hermes 安装成功并正常运行
hermes status预期输出：显示版本号、运行状态、已加载的 Profile 列表。
hermes doctor预期输出：系统健康检查报告，包括配置、依赖、网络、权限等项目的检查结果。
打开浏览器访问：http://localhost:18790
如果看到 Hermes Dashboard，说明安装成功！
遇到问题先查这里，90% 的问题可以自行解决
原因：配置文件或数据目录权限不足。
解决：检查目录所有权：chown -R $USER ~/.hermes
原因：端口 18790 被其他进程占用。
解决：更换端口或停止占用进程：lsof -ti:18790 | xargs kill -9
原因：Hermes 未正确安装或 Python 环境不一致。
解决：重新安装：pip install --force-reinstall hermes-agent
原因：API 调用超限或并发过高。
解决：检查 API 配额，降低请求频率，或启用 fallback 链配置。
原因：Docker 服务未运行或当前用户无权限。
解决：启动 Docker：sudo systemctl start docker，或将用户加入 docker 组。
原因：内存不足，Hermes 被系统杀死。
解决：增加 RAM（推荐 8GB+），或减少 Profile 数量，或启用内存限制配置。
保护你的 AI Agent，从安全配置开始
遇到问题？我们在这里帮你