hermes agent是openclaw的高兼容本地ai智能体替代方案，需在macos/linux或wsl2环境下安装，通过一键脚本配置deepseek api后可启动聊天与飞书网关。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正考虑替换OpenClaw，转向更可控、更透明的本地AI智能体框架，则Hermes Agent是一个高兼容性、强扩展性的替代选择。以下是完成其一键安装与基础配置的全流程操作指南：
一、确认系统环境与前置依赖
Hermes Agent不支持纯Windows原生运行，需确保终端可执行环境已就绪。macOS与Linux用户可直接使用系统终端；Windows用户必须启用WSL2子系统，否则安装将中断或功能异常。该步骤旨在排除因底层环境缺失导致的脚本失败、权限拒绝或模型加载失败等问题。
1、macOS用户检查Homebrew是否已安装：在终端中输入brew --version，若返回版本号则跳过；否则执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装。
2、Linux（Ubuntu）用户更新系统并安装基础工具：sudo apt update && sudo apt install -y curl git python3.11-venv nodejs npm。
3、Windows用户以管理员身份打开PowerShell，执行：wsl --install；重启后在Microsoft Store中安装Ubuntu 24.04 LTS，启动并完成初始账户设置。
4、所有平台均需验证Python版本不低于3.11：python3 --version；若低于该版本，需手动升级或通过pyenv管理多版本。
二、执行官方一键安装脚本
该脚本自动完成仓库克隆、虚拟环境创建、依赖解析、CLI命令注册及基础目录初始化，避免手动配置引发的路径错误或包冲突。国内用户应优先使用镜像加速源，防止因网络波动导致安装中断。
1、在终端中执行国内加速版安装命令：curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
2、等待脚本输出✅ Hermes Agent installed successfully提示；若卡在Installing playwright...，请确认已设置Playwright镜像：export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright后再重试。
3、验证安装结果：hermes --version应返回类似v0.13.2的版本号；若提示command not found，请关闭当前终端并重新打开，或执行source ~/.bashrc（Linux/macOS）或重启WSL2（Windows）。
三、运行交互式配置向导
配置向导将引导用户完成模型提供商选择、API密钥注入与默认模型设定，是连接Hermes Agent与大语言模型服务的关键环节。未完成此步将无法发起任何推理请求，所有后续操作均处于“空载”状态。
1、在终端中输入：hermes setup，进入向导界面。
2、选择Quick setup模式（推荐新手）。
3、从列表中选择模型提供商，DeepSeek为当前最优选，因其v4系列模型完全兼容OpenAI协议且无需额外适配层。
4、粘贴DeepSeek API Key（格式为sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），注意终端无回显属正常现象。
OpenClaw专家 — 用于任何OpenClaw问题或需求，包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
5、选择模型名称：deepseek-v4-flash（轻量任务）或deepseek-v4-pro（复杂推理），按回车确认。
四、启动并验证基础会话能力
启动过程将加载配置、初始化Memory模块并建立首个会话上下文。成功启动后，Agent即具备响应简单指令、调用内置工具及维持短期记忆的能力，是判断部署是否可用的核心判据。
1、执行启动命令：hermes chat。
2、在提示符后输入：你好，你是谁？。
3、观察终端是否在5秒内返回结构化响应，包含角色定义、能力说明及当前支持的工具列表；若出现"Error: Failed to call provider"或超时无响应，请立即检查config.yaml中base_url是否为https://api.deepseek.com/v1。
4、键入Ctrl+C退出会话，此时会话数据已自动保存至~/.hermes/sessions/目录。
五、配置飞书网关实现消息互通
飞书网关使Hermes Agent可通过企业IM接收指令并主动推送结果，适用于自动化日报、审批提醒、文档摘要等办公场景。该配置需飞书开放平台侧与本地Agent侧双向协同，任一侧遗漏将导致消息无法路由。
1、登录https://open.feishu.cn，创建企业自建应用，填写名称如“Hermes办公助手”。
2、在应用能力中启用“机器人”，并在权限管理中开通im:message.p2p_msg、im:message.group_at_msg、contact:user.id:readonly三项核心权限。
3、记录飞书应用凭证页中的App ID与App Secret。
4、编辑本地配置文件：nano ~/.hermes/config.yaml，在gateways:节点下添加以下内容：
feishu:
enabled: true
app_id: "cli_xxxxxxxxxx"
app_secret: "xxxxxxxxxxxxxxx"
verification_token: "xxxxx"
5、保存退出后，执行hermes gateway start feishu；终端应显示Feishu gateway listening on port 3000。
6、在飞书中搜索机器人名称并发送@Hermes办公助手 今天天气如何？，若收到“我无法访问实时天气API，但可为您生成模拟报告”类响应，表明网关已连通。
