Hermes Agent 部署完整文档文档信息适配版本Hermes Agent 最新稳定版适用系统Ubuntu / Debian / macOS / WSL2 / Docker核心定位开源自主智能体支持任务规划、长期记忆、工具调用、多渠道接入默认端口8642一、环境前置要求1. 基础依赖Python ≥ 3.11Git、curlNode.js ≥ 22部分网关组件依赖包管理器uv/ pip 二选一2. 系统防火墙放行如需外网访问服务器放行端口8642二、部署方式四种可选方式1一键脚本快速部署新手推荐Linux / macOS / WSL国内加速脚本解决GitHub访问慢curl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bash官方原版脚本海外网络使用curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash执行完成后刷新环境变量# bash 用户source~/.bashrc# zsh 用户macOS默认source~/.zshrc验证安装hermes--version# 环境自动自检hermes doctor方式2PIP 包安装已有Python环境pipinstallhermes-agent# 安装浏览器、系统工具依赖hermes postinstall方式3源码手动部署开发二次修改首选# 1. 安装 uv 高速包管理器curl-LsSfhttps://astral.sh/uv/install.sh|shsource~/.bashrc# 2. 拉取源码gitclone https://github.com/NousResearch/hermes-agent.gitcdhermes-agent# 3. 创建虚拟环境uv venv venv--python3.11sourcevenv/bin/activate# 4. 安装全量依赖uv pipinstall-e.[all]# 5. 全局注册 hermes 命令ln-sf$(pwd)/venv/bin/hermes ~/.local/bin/ hermes--version方式4Docker 容器部署服务端常驻运行# 1. 创建持久化配置目录mkdir-p~/.hermes# 2. 初始化配置向导dockerrun-it--rm\-v~/.hermes:/opt/data\nousresearch/hermes-agent setup# 3. 后台启动网关服务dockerrun-d\--namehermes-agent\--restartunless-stopped\-p8642:8642\-v~/.hermes:/opt/data\nousresearch/hermes-agent gateway runDocker 常用管理命令# 实时日志查看dockerlogs-fhermes-agent# 重启dockerrestart hermes-agent# 停止dockerstop hermes-agent三、初始化核心配置1. 配置大模型接口交互式配置模型服务商与 API Keyhermes model支持接入类型Nous Portal官方渠道入门测试首选OpenRouter聚合多模型Ollama本地私有化模型OpenAI 兼容接口通义、Kimi、自定义中转地址配置完成测试对话hermes chat-q部署测试正常回复即配置成功2. 网关多机器人渠道配置Telegram/Discord等# 进入渠道配置向导hermes gateway setup# 查看网关运行状态hermes gateway status# 启停网关hermes gateway start hermes gateway restart hermes gateway stop关键配置allowed_user_ids用户白名单防止外人调用智能体四、Web 管理面板访问网关启动后浏览器打开地址本地访问http://localhost:8642服务器公网访问http://服务器IP:8642功能会话记忆管理、技能查看、任务日志、渠道配置可视化管理五、常用运维命令汇总基础对话hermes# 交互式终端对话hermes--continue# 接续上一轮会话hermes chat-q单次指令配置管理hermes config show# 查看全部配置hermes config edit# 手动编辑配置文件hermes update# 一键升级新版本智能体技能管理核心自主进化能力hermes skills list# 查看已加载技能hermes skills browse# 浏览社区公共技能库hermes skills reload# 重载生效新安装技能日志排查hermes logs--followcat~/.hermes/logs/main.log六、卸载步骤PIP / 脚本安装卸载pip uninstall-yhermes-agent# 删除全部配置、记忆、日志数据rm-rf~/.hermes# 删除全局命令rm~/.local/bin/hermesDocker 卸载dockerrm-fhermes-agentdockerrmi nousresearch/hermes-agentrm-rf~/.hermes七、常见问题排错hermes: command not found刷新环境变量source ~/.bashrc重启终端重试Python 版本过低使用 pyenv / uv 指定 Python3.11 虚拟环境运行API 调用报错 401 / 超时执行hermes model重新填写有效密钥配置代理环境变量排查网络问题端口 8642 被占用# Linux/macOSlsof-i:8642kill对应PID# 自定义端口启动hermes gateway run--port8643网关机器人无响应检查网关状态、确认白名单ID配置通过实时日志定位异常八、官方地址开源仓库https://github.com/NousResearch/hermes-agent官方文档https://hermes-agent.nousresearch.com/docs/zh-Hans国内社区https://hermesagent.org.cn