若未完成gcp实例创建、依赖安装及二进制校验,则hermes agent无法启动或触发自主学习;需依次执行:一、创建us-central1-a区域的e2-medium ubuntu 22.04实例并配置开机脚本;二、通过vpc防火墙开放8080/9090/8000端口;三、ssh连接后安装libssl1.1等依赖并设utc时区;四、下载v0.8.3二进制包,用sha256sums校验后解压;五、导出openai_api_key,运行setup向导配置telegram与工具集,最后serve启动服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您计划在谷歌云平台(GCP)上部署 Hermes Agent,但尚未完成实例创建、依赖安装或二进制验证等关键环节,则可能无法启动服务或触发自主学习循环。以下是针对 GCP 环境的完整部署步骤:
一、创建并配置GCP Compute Engine实例
该步骤为 Hermes Agent 提供稳定、可公网访问的 Linux 运行环境,需确保操作系统版本、网络连通性与资源规格满足最低要求。
1、登录 Google Cloud Console,进入 Compute Engine → “创建实例”。
2、实例名称填写为 hermes-agent-prod,地区选择 us-central1,区域选择 us-central1-a。
3、机器类型选择 e2-medium(2 vCPU,4 GB 内存),满足 Hermes Agent 基础运行与轻量模型调用需求。
4、启动磁盘选用 Ubuntu 22.04 LTS 映像,大小设为 50 GB,启用“删除启动磁盘”选项以保障后续重置安全。
5、在“防火墙”部分勾选“允许 HTTP 流量”和“允许 HTTPS 流量”,并在“管理、安全、磁盘、网络、单独租用”标签页中点击“网络”,添加自定义标签 hermes-agent。
6、点击“管理”标签页,在“元数据”中添加键值对:startup-script,值为以下内容(用于开机自动安装基础依赖):
#!/bin/bash
apt-get update && apt-get install -y curl wget libssl1.1 libcurl4 tzdata
7、点击“创建”,等待实例状态变为“正在运行”,并记录其外部 IPv4 地址。
二、开放端口并配置VPC防火墙规则
GCP 默认限制所有入站流量,必须显式放行 Hermes Agent 所需通信端口,否则 Telegram 网关、HTTP 管理接口及内部 RPC 将无法响应。
1、在 Google Cloud Console 中进入 VPC 网络 → “防火墙”。
2、点击“创建防火墙规则”,名称设为 allow-hermes-ports。
3、目标设为“指定的目标标记”,输入 hermes-agent。
4、源 IP 范围填写 0.0.0.0/0(若仅限可信来源,可替换为具体 IP 段)。
5、协议和端口选择“指定的协议和端口”,勾选 TCP 并填入 8080,9090,8000(分别对应管理 UI、内部通信、Telegram webhook 回调端口)。
6、点击“创建”,规则生效后约 30 秒内可用。
三、连接实例并安装运行时依赖
Hermes Agent 预编译二进制依赖 OpenSSL 1.1.1+ 与标准 C 运行时库,Ubuntu 22.04 默认未预装 libssl1.1,必须手动补全,否则运行时将报错“libssl.so.1.1: cannot open shared object file”。
在 Linux 上通过 Chrome 挂载/VNC 自动发布小红书长笔记。Agent 撰写标题和正文后执行 xhs_publish.sh --publish --submit,触发小红书发布。
1、使用 SSH 按钮或本地终端执行:gcloud compute ssh --zone "us-central1-a" "hermes-agent-prod"。
2、执行更新与依赖安装命令:sudo apt update && sudo apt install -y curl wget libssl1.1 libcurl4 tzdata。
3、验证 OpenSSL 版本:openssl version,输出应为 OpenSSL 1.1.1f 或更高版本。
4、设置系统时区为 UTC:sudo timedatectl set-timezone UTC,避免日志时间戳错乱影响故障排查。
四、下载、校验并解压Hermes Agent二进制包
从官方 GitHub Releases 获取 x86_64 架构的静态链接二进制文件,并通过 SHA256SUMS 文件验证完整性,防止因网络中断或镜像劫持导致程序损坏或安全风险。
1、执行下载命令:curl -L -o hermes-agent.tar.gz https://github.com/hermes-org/agent/releases/download/v0.8.3/hermes-agent-x86_64-unknown-linux-gnu.tar.gz。
2、同步下载校验文件:curl -L -o SHA256SUMS https://github.com/hermes-org/agent/releases/download/v0.8.3/SHA256SUMS。
3、执行校验:sha256sum -c SHA256SUMS --ignore-missing | grep "OK",输出中必须包含 hermes-agent-x86_64-unknown-linux-gnu 和 OK 标识。
4、创建部署目录并解压:mkdir -p ~/hermes && tar -xzf hermes-agent.tar.gz -C ~/hermes --strip-components=1。
5、赋予执行权限:chmod +x ~/hermes/hermes-agent。
五、配置环境变量与首次运行
Hermes Agent 启动前需加载 API 密钥、网关配置及模型端点信息,首次运行将触发交互式 setup 向导,所有配置项均写入 ~/.hermes/config.yaml,后续可直接复用。
1、导出 OpenAI API Key(或其他 LLM 提供商密钥):export OPENAI_API_KEY="sk-xxx"(请替换为真实密钥)。
2、切换至部署目录:cd ~/hermes。
3、首次运行并启动配置向导:./hermes-agent setup。
4、按提示依次选择:LLM 提供商(OpenAI)、启用工具集(terminal、file、browser)、配置 Telegram 网关(输入 Bot Token 与 Chat ID)。
5、完成配置后,启动服务:./hermes-agent serve --http-port 8080 --rpc-port 9090。










