新手配置hermes agent需依次完成环境检查、一键安装、交互式setup、soul.md人格定义及首个markdown转微信html任务演练。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚接触 Hermes Agent，正准备完成初始配置并执行第一个实际任务，则可能面临环境缺失、API 密钥未设置、模型未指定或技能未激活等问题。以下是完成新手配置与首个任务演练的多种可行路径：
一、环境检查与基础依赖安装
确保系统具备运行 Hermes Agent 的最低硬件与软件条件，避免因依赖缺失导致安装失败或启动异常。该步骤为所有后续操作的前提。
1、打开终端，执行命令检查 Git 是否已安装：git --version
2、若提示 command not found，则按系统类型执行对应安装命令：Ubuntu/Debian 执行 sudo apt update && sudo apt install git；macOS 执行 brew install git；WSL2 同 Ubuntu 命令
3、确认磁盘剩余空间不少于 5GB，内存不低于 2GB（推荐 4GB）
4、确保网络可访问 GitHub 与模型提供商 API 端点（如 openrouter.ai、z.ai、api.anthropic.com）
二、一键安装与环境初始化
通过官方维护的安装脚本自动完成 Python、Node.js、ripgrep、ffmpeg 及 Hermes Agent 核心代码的部署，适用于 macOS、Linux 和 WSL2 环境。
1、在终端中粘贴并执行以下命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2、安装完成后，根据 shell 类型执行环境重载：source ~/.bashrc（bash 用户）或 source ~/.zshrc（zsh 用户）
3、验证安装结果：hermes --version，预期输出类似 hermes v0.8.0 (v2026.4.8)
4、运行诊断命令确认运行时状态：hermes doctor
三、交互式配置向导启动
通过 hermes setup 启动向导，引导用户完成模型提供商选择、API Key 输入、默认消息通道设定等关键参数，避免手动编辑配置文件出错。
1、在终端中输入：hermes setup
2、使用方向键选择 Quick setup — provider, model & messaging (recommended)，回车确认
3、在模型提供商列表中，若未显示所需服务商（如 Z.AI），选择 More providers 并回车
4、从扩展列表中选择目标提供商（如 Z.AI），粘贴已获取的 API Key，Base URL 留空即使用默认值，再选择模型（如 glm-5.1）
5、当提示是否连接聊天平台时，可先选 Skip for now，后续再配置网关
四、SOUL.md 人格定义文件创建
SOUL.md 是 Hermes Agent 的行为约束与输出风格定义文件，决定其响应语气、技术深度、交互节奏等主观特征，直接影响首个任务的执行质量。
1、执行命令生成模板：hermes soul init
2、用编辑器打开文件：nano ~/.hermes/SOUL.md
3、在文件中添加明确指令，例如：你是一名专注 Java 开发的 macOS 用户助手，优先使用 Terminal 工具链，输出代码块必须带语言标识，拒绝虚构信息
4、保存退出后，重启 Hermes：hermes，新设定立即生效
五、首个任务演练：将 Markdown 转为微信公众号兼容 HTML
该任务触发 Hermes Agent 的技能自生成机制，验证记忆、工具调用与格式转换能力，是检验配置完整性的典型用例。
1、启动对话：hermes chat
2、输入任务指令：帮我把这段 Markdown 转成微信公众号兼容的 HTML，保留加粗和代码块样式。示例文本：# 标题\n\n**加粗文字**\n\n```java\nSystem.out.println("Hello");\n```
3、等待 Agent 自动调用浏览器工具或内置解析器完成转换，并返回结果
4、检查 ~/.hermes/skills/ 目录是否新增文件：markdown-to-wechat.md
5、确认 ~/.hermes/state.db 中已存入本次对话记录，并可通过 FTS5 全文索引检索
