资源站：xingkeit.top/17880/

Hermes Agent 是一款强大的开源 AI 智能体框架，支持接入 Kimi、DeepSeek 等多种大模型，并能自动执行终端命令、读写文件等复杂任务。以下是专为零基础用户整理的保姆级部署与避坑指南。

环境准备：Windows 用户必看

Hermes Agent 原生不支持 Windows 的 CMD 或 PowerShell，Windows 用户必须先安装 WSL2（Windows Subsystem for Linux）。以管理员身份打开 PowerShell，依次执行以下命令启用 WSL 并安装 Ubuntu：

wsl --install -d Ubuntu
wsl --set-default Ubuntu

安装完成后重启电脑，进入 Ubuntu 终端即可开始后续操作。Mac 和 Linux 用户可直接在终端进行。

一键安装：国内网络加速方案

由于官方脚本托管在 GitHub，国内直连极易超时失败。推荐使用以下国内镜像源一键安装：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

如果习惯使用 Windows PowerShell 且已配置好 WSL2，也可以尝试国内提供的 PowerShell 专用安装脚本：

irm https://res1.hermesagent.org.cn/install.ps1 | iex

安装完成后，务必刷新环境变量或重启终端，否则会出现 hermes: command not found 的报错。

核心配置：接入大模型

运行 hermes setup 进入交互式配置向导。对于国内用户，强烈推荐选择 Kimi（Moonshot）模型，其长文本处理能力出色且国内直连稳定。

在向导中选择 Moonshot/Kimi-K2.6 模型，并粘贴你的 API Key。如果你更喜欢命令行手动配置，可以直接执行：

hermes config set model moonshot/k2.6
hermes config set MOONSHOT_API_KEY sk-你的API密钥

配置工具时，新手建议先勾选 web（网络搜索）、terminal（终端执行）和 file（文件读写）这三个基础工具，后续再按需开启浏览器自动化等高级功能。

启动验证与日常使用

在终端输入 hermes 即可启动交互模式。当看到 What can I do for you today? 提示时，说明部署成功。你可以直接输入“帮我统计当前目录下所有 Python 文件的数量”来测试其执行能力。

常用的快捷指令包括：输入 /help 查看所有命令，/skill list 查看已加载的技能，/save 会话名 保存当前对话记忆，按 Ctrl+C 或输入 /exit 退出。

高频踩坑与排查指南

1. 安装脚本报错或卡住：90% 是因为网络问题。请确保关闭了全局代理（如 Clash），或切换手机热点重试。Linux 极简系统若提示依赖缺失，可手动执行 sudo apt install git curl build-essential 补齐基础工具。
2. 提示 hermes: command not found：这是环境变量未生效。执行 source ~/.bashrc（或 ~/.zshrc），或者直接关闭终端重新打开。Windows 用户若仍报错，需手动将 %LOCALAPPDATA%\hermes\bin 添加到系统 PATH 中。
3. 模型连接失败或 401 错误：首先核对 API Key 是否正确，注意前后不要有多余的空格或换行符。其次确认模型名称拼写无误（如 moonshot/k2.6），并检查账户余额是否充足。
4. Python 版本冲突：Hermes 要求 Python 3.11+。如果系统默认版本过低，建议使用 python3.11 -m venv hermes-venv 创建虚拟环境后再进行安装。

按照以上步骤，通常 5 分钟内即可跑通你的第一个 AI 智能体。遇到报错时，优先检查网络环境和 API Key 格式，这能解决绝大多数新手问题。