Hermes Agent在Linux服务器上有五种部署方式：一、用Claude Code全自动安装；二、源码编译安装（Ubuntu 22.04/CentOS 8）；三、Docker容器化部署；四、UniAgent兼容层集成（华为云专用）；五、手动配置Telegram与模型后端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Linux服务器上部署Hermes Agent，但尚未明确安装路径与系统适配细节，则可能是由于缺少针对不同发行版的标准化安装流程。以下是适用于Ubuntu和CentOS系统的多种安装方法，涵盖从依赖准备到服务启动的完整操作链。
一、使用Claude Code辅助全自动安装（推荐）
该方法利用Claude Code作为终端AI助手，自动完成Hermes Agent的下载、配置与启动，全程无需手动编辑文件，适合具备基础命令行经验且已配置Claude API密钥的用户。
1、确保系统已安装Node.js v20+及npm v10+，执行node -v与npm -v验证版本。
2、全局安装Claude Code CLI：npm install -g @anthropic-ai/claude-code。
3、配置API中转地址，将https://api.apiplus.cloud设为Base URL，运行claude-code config set base-url https://api.apiplus.cloud。
4、启动Claude Code并输入指令：“请帮我安装Hermes Agent，使用默认配置，绑定Telegram Bot Token，并启用devicemapper存储驱动”。
5、确认CLI输出的执行命令无误后，允许其自动执行git clone、make build、systemctl enable --now hermes-agent等步骤。
二、基于源码编译安装（Ubuntu 22.04 / CentOS 8）
此方式直接构建Hermes Agent主程序及其依赖组件，适用于需定制模型后端或审计全部二进制来源的安全敏感环境，要求系统预装Rust 1.91+与Python 3.12+。
1、克隆ANOLISA项目仓库：git clone https://github.com/anolisa/anolisa.git && cd anolisa。
2、进入agent核心模块目录：cd src/agent-sec-core。
3、使用uv工具安装Python依赖（若未安装uv，请先运行curl -LsSf https://astral.sh/uv/install.sh | sh）。
4、执行构建脚本：make build-agent，该命令将同时编译Rust沙箱与Python技能加载器。
5、复制生成的可执行文件至系统路径：sudo cp target/release/hermes-agent /usr/local/bin/。
6、创建systemd服务单元文件/etc/systemd/system/hermes-agent.service，内容包含ExecStart=/usr/local/bin/hermes-agent --config /etc/hermes/config.yaml。
三、Docker容器化部署（通用Linux）
通过Docker封装运行时依赖，规避系统库版本冲突问题，适用于无法修改宿主机环境或需多实例隔离的场景，前提是已安装Docker CE并启动dockerd服务。
1、确认Docker已就绪：sudo docker version --format '{{.Server.Version}}'应返回≥24.0的版本号。
该技能指导用户根据设计灵感创建视觉情绪板。它提供分步说明，用于提取颜色、排版和UI模式，并将其组织成文档化的设计方向。工作流程包括根据用户反馈进行迭代优化，最终形成可供实施的设计系统。
2、拉取官方Hermes Agent镜像：sudo docker pull ghcr.io/nous-research/hermes-agent:latest。
3、创建配置挂载目录：sudo mkdir -p /etc/hermes/{config,skills}。
4、生成初始配置文件/etc/hermes/config.yaml，其中必须包含model_provider: "anthropic"与telegram_bot_token: "xxx"字段。
5、运行容器并绑定端口与卷：sudo docker run -d --name hermes --restart=always -p 8080:8080 -v /etc/hermes:/app/config ghcr.io/nous-research/hermes-agent:latest。
四、通过UniAgent兼容层集成安装（华为云ECS/BMS专用）
该方法将Hermes Agent注册为UniAgent插件，复用现有采集通道与委托授权体系，适用于已在华为云环境中部署UniAgent 2.5.6+版本的ECS或BMS实例。
1、确认UniAgent已运行：sudo systemctl is-active uniagent返回active。
2、下载Hermes适配插件包：curl -k -o /tmp/hermes-plugin.tar.gz https://obs.my-kualalumpur-1.alphaedge.tmone.com.my/package/hermes-plugin-0.3.1.tar.gz。
3、解压至UniAgent插件目录：sudo tar -xzf /tmp/hermes-plugin.tar.gz -C /usr/local/uniagent/extension/。
4、执行修复插件配置命令：sudo /usr/local/uniagent/extension/hermes-plugin/bin/repair-config.sh，自动注入RegionId与ProjectId。
5、重启UniAgent服务以加载新插件：sudo systemctl restart uniagent。
五、手动配置Telegram接入与模型后端（所有安装方式通用）
无论采用何种安装路径，Hermes Agent均需连接Telegram Bot与大模型API方可响应指令，此步骤不可跳过，且配置错误将导致服务启动后无响应。
1、在Telegram中创建Bot，获取Bot Token，格式为1234567890:ABCdefGhIJKlmNoPQRstUvWxyZaBcDeFgHiJ。
2、访问https://api.apiplus.cloud注册账号，开通Claude 3.5 Sonnet调用权限，并记录API Key。
3、编辑Hermes配置文件（如/etc/hermes/config.yaml），在telegram节下填入token: "上述Bot Token"。
4、在llm节中设置provider: anthropic与base_url: https://api.apiplus.cloud/v1。
5、将API Key写入环境变量：echo 'export ANTHROPIC_API_KEY="sk-xxx"' | sudo tee -a /etc/profile.d/hermes.sh && sudo source /etc/profile.d/hermes.sh。
