在Docker中快速部署Hermes Agent v0.19.1只需三步:拉取指定版本镜像(禁用:latest)、通过docker run -it ... setup初始化配置、再以docker run -d启动gateway服务并映射8642端口,全程无需编译或修改源码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Docker里快速部署Hermes Agent v0.19.1,只需完成镜像拉取、配置初始化、网关服务启动三步,全程不用编译、不改配置文件、不碰源码,适合想立刻试用或验证功能的用户。
拉取v0.19.1专用镜像
官方镜像标签已明确支持v0.19.1,直接拉取即可,不要用:latest——它可能已升级到v0.20.x,与当前教程步骤不兼容:
docker pull nousresearch/hermes-agent:v0.19.1
这一步耗时取决于网络,国内用户若卡在“Waiting”状态超过2分钟,【必须换国内镜像源】,执行:
docker pull docker.xuanyuan.run/nousresearch/hermes-agent:v0.19.1
创建数据目录并初始化配置
先建一个本地目录存配置和记忆数据,避免容器删掉后所有会话、技能、API Key全丢:
mkdir -p ~/.hermes
然后运行初始化向导,它会交互式问你模型提供商、API Key、默认语言等:
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent:v0.19.1 setup
注意:输入API Key时终端不会回显字符,这是正常行为,输完直接回车就行。如果中途选错模型(比如选了Claude但没配Anthropic Key),后续启动会报错退出,得重新运行这一步。
为Claude Code提供对提醒事项、日历、联系人、笔记、邮件和tmux的本地命令访问权限,以便在macOS上进行工作流感知的个人操作。
启动Gateway服务
① 创建专用网络,让Hermes内部组件通信更稳定:
docker network create hermes-net
② 启动核心网关容器,映射端口8642供外部访问:
docker run -d \
--name hermes \
--restart unless-stopped \
--network hermes-net \
-v ~/.hermes:/opt/data \
-p 8642:8642 \
nousresearch/hermes-agent:v0.19.1 gateway run
③ 等待约10秒,检查容器是否健康:
docker ps -f name=hermes
看到STATUS列显示“Up X seconds”且没有“unhealthy”字样,说明服务已就绪。此时打开浏览器访问 http://localhost:8642,就能看到Hermes的Web UI登录页。










