推荐新手使用quick setup模式启动hermes setup，依次选择custom endpoint模型、跳过消息平台配置、统一确认自动化任务，最后用/hermes model命令手动指定模型并验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 Hermes Agent 的安装，但在首次运行 hermes setup 时遇到选项混乱、模型未识别或平台配置中断等问题，则可能是由于向导交互逻辑不熟悉或环境变量未就绪所致。以下是针对 hermes setup 首次配置向导的全流程操作说明：
一、启动配置向导并选择初始化模式
该步骤用于确定配置粒度与自动化程度，直接影响后续模型与平台的绑定方式。推荐新手使用预设路径以规避手动输入错误。
1、在终端中输入命令：hermes setup 并回车执行；
2、当出现选项列表时，使用上下方向键高亮选中 Quick setup；
3、按回车确认，进入自动引导流程，此时脚本将跳过高级自定义环节。
二、指定模型供应商与API凭证
此步骤决定Hermes Agent能否调用大模型生成响应。若跳过或填错，将导致后续对话返回空内容或报错“no model available”。
1、在模型提供商列表中，使用方向键选择 Custom endpoint (OpenAI compatible)；
2、在提示输入 API Base URL 时，粘贴完整地址（例如：https://api.yibuapi.com/v1），注意末尾无斜杠、无空格；
3、在提示输入 API Key 时，粘贴从一步API控制台复制的密钥（格式为 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx）；
4、确认后等待验证完成，终端显示 Model successfully configured 即表示模型已激活。
三、跳过原生消息平台配置
当前版本的 hermes setup 向导尚未内置飞书、微信等国内主流平台的直接集成选项，强行配置会导致流程卡死或配置文件损坏。
1、当向导显示消息平台列表（含 Telegram、Discord、Slack 等）时，直接按 ↓ 键到底部；
2、选择 Skip message platform configuration 并回车；
3、看到提示 Proceeding without message gateway... 后继续下一步。
四、启用自动化配置并完成初始化
该环节将生成核心配置文件 ~/.hermes/config.yaml 与记忆数据库，并校验依赖完整性。
1、向导将自动列出待执行的自动化子任务（如创建目录、初始化SQLite、下载默认Skill）；
2、每项任务后出现 [Y/n] 提示时，统一按 Y 回车 确认；
3、当终端输出 Welcome to Hermes Agent! 及 ASCII 图标时，表示配置向导已退出并完成初始化。
五、验证模型是否生效
向导结束后模型可能仍处于未加载状态，需通过内置命令强制刷新模型注册表，否则会持续显示“no model selected”。
1、在终端中直接输入命令：hermes /model；
2、观察返回内容是否包含已配置的模型名称（如 kimi-3.5 或 gpt-4o-mini）；
3、若显示 No model selected，则立即执行：hermes /model kimi-3.5（替换为实际模型ID）；
4、再次运行 hermes /model，确认模型名称正确显示且状态为 active。
