先执行一键安装脚本自动配置依赖，再通过Quick setup向导设置模型并运行hermes doctor验证，最后用hermes chat进行本地交互测试，确保模型可用、工具调用正常、响应延迟低于8秒。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在短时间内完成 Hermes Agent 的基础部署并验证其基本功能，则可能是由于环境依赖缺失、配置文件未初始化或模型未正确绑定导致启动失败。以下是快速完成部署与验证的步骤：
一、环境准备与一键安装
确保系统满足最低运行要求，使用官方推荐的一键脚本可绕过手动安装 Python、Git 等依赖的繁琐过程，适用于 Windows（需 PowerShell）、macOS 和 Linux 环境。
1、打开 PowerShell（Windows）或终端（macOS/Linux），以管理员/普通用户权限运行以下命令：
2、执行 irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex（Windows）或 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash（macOS/Linux）。
3、等待脚本自动检测并安装 Python 3.10+、Git、Node.js、ripgrep 等必要组件。
4、安装完成后，终端将自动进入 Quick setup 向导界面。
二、模型配置与验证
模型是 Hermes Agent 执行推理任务的核心，必须显式指定可用的 LLM 提供商及对应 API Key，否则 hermes chat 命令将无法响应。
1、在向导中选择 Quick setup，按提示输入您的 API Key（如 OpenRouter、Kimi、DashScope 或 OpenAI）。
2、若向导未识别模型或执行 hermes chat -q "Hello!" 返回空响应，请手动运行 hermes model set openrouter/llama-3.1-70b-versatile（示例模型，按实际支持列表替换）。
3、运行 hermes doctor 检查模型层状态，输出中 Model Provider: OK 表示模型已就绪。
三、本地交互测试
跳过消息网关配置，直接通过 CLI 进行最小闭环验证，确认 Agent 能解析指令、调用工具并生成有效响应。
1、执行 hermes chat 启动交互式会话模式。
2、输入问题，例如：列出当前目录下的所有 .py 文件。
3、观察是否触发 ls 工具调用，并返回类似 tools.file_operations.list_files 的执行日志。
4、输入 exit 退出会话，确认无报错且响应延迟低于 8 秒。
四、飞书网关快速接入（可选）
若需立即在飞书群内启用机器人，可跳过向导中的消息平台选项，单独配置 Gateway，避免因渠道列表缺失导致中断。
1、访问 https://open.feishu.cn/app 创建应用，获取 App ID 与 App Secret。
2、新开终端，执行 hermes gateway setup，在渠道列表中选择 feishu。
3、依次填入 App ID、App Secret；来源填 feishu；连接方式保留默认 websocket；允许的 User ID 留空后输入 1 表示不限制成员。
4、运行 hermes gateway start，检查日志中是否出现 Feishu gateway listening on ws://...。
五、常见阻断点即时修复
部分用户在 10 分钟内卡在特定环节，以下为高频问题的独立修复路径，无需重装或回退配置。
1、执行 hermes doctor 后显示 Gateway: NOT INSTALLED：运行 uv pip install -e ".[feishu]"（Linux/macOS）或 pip install lark-oapi（Windows）补全依赖。
2、hermes chat 报错 No available model provider configured：检查 ~/hermes-agent/.env 中是否存在 HERMES_MODEL_PROVIDER=openrouter 及对应 KEY 变量。
3、飞书消息无响应：在飞书开放平台应用后台，确认「事件订阅」已启用 message.receive 事件，并将请求 URL 替换为 https://your-domain.com/webhook（若使用本地调试，需配合 ngrok）。
