需先确认系统环境与依赖，再克隆项目、运行安装脚本、配置model_provider并执行hermes chat -q "Hello!"验证；官方不支持原生Windows，须用Linux/macOS/WSL2，且需Git和LLM API Key。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚刚接触 Hermes Agent，希望快速建立可用环境并理解其核心运作逻辑，则需从基础安装、配置验证到首次交互逐步推进。以下是完成这一目标的具体路径：
一、确认系统与前置依赖
运行 Hermes Agent 需要特定的操作系统环境和基础工具链，缺失任一条件都将导致后续步骤失败。官方明确不支持原生 Windows，必须使用 Linux、macOS 或 WSL2；Git 是克隆仓库的必要工具；至少一个 LLM Provider API Key（如 OpenAI、OpenRouter 或阿里云 DashScope）用于模型调用；若接入飞书，还需提前准备 App ID 与 App Secret。
1、执行 git --version 验证 Git 是否已安装并可用。
2、在终端中输入 uname -s，确认输出为 Linux 或 Darwin（macOS），或在 WSL2 中运行 cat /proc/version 查看内核信息。
3、检查是否已设置环境变量 OPENAI_API_KEY 或其他对应 Provider 的密钥变量（如 DASHSCOPE_API_KEY）。
二、克隆与初始化项目
项目根目录是所有配置与命令执行的基准位置，必须确保克隆时启用子模块，否则 gateway、feishu 等关键组件将缺失。官方推荐使用递归克隆方式获取完整代码结构，并进入该目录后方可执行后续脚本。
1、运行命令 git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git 完整拉取主干及全部子模块。
2、执行 cd hermes-agent 进入项目根目录。
3、查看当前目录是否存在 pyproject.toml 和 setup-hermes.sh 文件，二者均为初始化必需文件。
三、执行一键安装与环境配置
安装脚本会自动处理 Python 依赖、可选扩展（含飞书网关）、本地 CLI 工具注册等任务，避免手动逐条安装引发的版本冲突或遗漏。该过程依赖 uv 或 pip，且默认启用 .[all] extras，确保 feishu 模块被包含在内。
1、赋予脚本执行权限：chmod +x setup-hermes.sh。
2、运行安装命令：./setup-hermes.sh，等待终端输出 Installation completed successfully 提示。
3、验证 CLI 是否注册成功：hermes --help 应显示完整命令列表，包括 hermes doctor 和 hermes chat。
四、生成并校验基础配置
配置文件决定 Agent 使用哪个模型、如何连接消息通道、是否启用技能记忆等关键行为。Hermes 优先读取 config.yaml，若不存在则回退至 .env；初始配置需基于 example 文件复制并编辑，不可直接运行未修改的模板。
1、复制示例配置：cp cli-config.yaml.example cli-config.yaml。
2、用文本编辑器打开 cli-config.yaml，定位 model_provider 字段，将其值设为 openai 或 dashscope（与所持 API Key 类型一致）。
3、保存文件后，在终端执行 hermes doctor，观察输出中 Config OK、Model Provider OK、Gateway OK 三项是否全部为 ✅。
五、启动首次对话并验证响应能力
CLI 是最轻量的交互入口，无需部署网关即可测试模型层与提示工程是否正常工作。通过带查询参数的 chat 命令可绕过会话状态管理，直接触发一次端到端推理，是判断基础链路是否打通的最快方式。
1、运行命令：hermes chat -q "Hello!"。
2、等待终端输出一段自然语言回复，例如 "Hello! How can I assist you today?"。
3、若出现 ConnectionError 或 AuthenticationError，立即检查 .env 中对应 API KEY 是否拼写正确、是否设置了多余空格。
