一键快速安装

安装前检查

系统要求

在运行安装命令前，先确认基础环境满足要求。

操作系统

当前安装流程支持以下运行环境。

macOSLinuxWindows WSL2Termux

内存

建议至少预留 2GB RAM，保证安装与基础运行过程稳定。

2GB+ RAM

网络

需要能够访问互联网，以下载资源并调用你的 LLM API 服务。

Internet RequiredLLM API Access

依赖项

如果你的工作流依赖 Python 或 Node，可先保留版本占位符。

Python：<版本占位符>Node：<版本占位符>

# 支持 macOS、WSL2、Linux 以及 Android 端 Termux
$curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 然后一键启动配置向导！
$hermes setup

安装文档快速开始 Telegram 配置从 OpenClaw 迁移

零摩擦迁移

One-Click Migration

用一条命令把 OpenClaw 配置迁移到 Hermes。Hermes 会自动从 ~/.openclaw 导入全部内容。

$ hermes claw migrate

API KeysMemorySkills

可节省大约 10 分钟手动配置时间

迁移前

手动查找并复制 API 凭据
重新整理记忆文件和本地状态
逐个重新导入技能

迁移后

只需执行一次 hermes claw migrate
Hermes 自动从 ~/.openclaw 拉取配置
API Keys、Memory 和 Skills 立即就绪

网关接入

Connect to Your World

连接中

通过 Hermes gateway，把智能体直接接入你已经在使用的聊天空间。

先完成配置，再验证机器人是否可达

Gateway 流程

获取 Bot Token

通过 BotFather 创建机器人，并复制 Bot Token。

运行 Setup

先使用官方 setup 向导写入配置，再启动已经配置好的 gateway。

hermes gateway setup

验证机器人接入

启动 gateway 后给机器人发消息验证；如果你的配置启用了配对，再按提示审批配对码。

hermes gateway

Discord

先完成配置，再验证机器人是否可达

Gateway 流程

获取 Bot Token

在 Discord Developer Portal 创建 Bot，并复制 Bot Token。

运行 Setup

先使用官方 setup 向导写入配置，再启动已经配置好的 gateway。

hermes gateway setup

验证机器人接入

启动 gateway，邀请机器人进服务器或直接私聊；只有在你的配置提示时才需要审批配对码。

hermes gateway

模型策略

Smart Model Selection

在 hermes setup 过程中，根据你的部署目标选择合适的模型提供方。

选项	定位	适用场景	配置片段
Nous Portal 最优适配	与 Hermes 体验最贴合	适合希望首轮配置最顺滑、默认参数更稳妥的用户。	`Provider: Nous Portal Profile: Best-fit default Use case: Turnkey Hermes setup`
OpenRouter 多模型选择	灵活的多模型路由层	适合需要在多个托管模型与供应商之间切换的用户。	`Provider: OpenRouter Model: anthropic/claude-3.7-sonnet Use case: Multi-model routing`
Local LLM 隐私优先	连接你自己的本地推理端点	适合优先考虑隐私、离线控制或自托管推理的用户。	`Provider: Local LLM Endpoint: http://localhost:1234/v1 Use case: Private local inference`