已成功安装Hermes Agent但未完成基础配置时，需依次执行五步：一、运行hermes doctor自检；二、配置API密钥至.env文件；三、执行hermes setup向导；四、通过hermes channel接入通讯平台；五、编写SOUL.md定义角色行为。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装 Hermes Agent，但尚未完成基础配置，可能无法调用大模型、保存记忆或启用工具功能。以下是针对新手用户的完整配置流程：
一、执行系统自检与环境验证
该步骤通过内置诊断命令快速识别运行环境中的关键组件状态，包括模型连接性、记忆初始化情况及工具权限，避免后续操作因底层异常而中断。
1、在终端中运行诊断命令：hermes doctor
2、检查输出中是否包含三项绿色标识：Model: connected、Memory: initialized、Tools: enabled
3、若任一项显示红色 error 或 missing，暂停后续配置，优先返回安装环节确认依赖完整性
二、配置主语言模型 API 密钥
Hermes Agent 本身不内置模型，必须通过有效 API 密钥连接外部大语言模型服务才能响应指令。密钥需写入指定环境文件并确保格式无空格或换行错误。
1、打开环境变量配置文件：nano ~/.hermes/.env
2、根据所选服务商，在文件末尾添加对应密钥行（仅保留其中一行）：OPENROUTER_API_KEY=sk-or-xxx 或 QWEN_API_KEY=sk-qwen-xxx 或 KIMI_API_KEY=xxx
3、按 Ctrl+O 保存，Ctrl+X 退出编辑器
4、重启 Hermes Agent 使配置生效：hermes
三、运行交互式配置向导
此向导自动完成模型默认设置、工具开关启用与基础记忆初始化，无需手动编辑 YAML 文件，适合零配置经验用户一次性建立可用环境。
1、启动向导：hermes setup
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
2、依次选择：LLM 提供商类型（如 OpenRouter）、是否启用 Shell 工具（推荐选 yes）、是否启用浏览器控制（推荐选 yes）
3、向导结束后，确认生成文件：~/.hermes/config.yaml 与 ~/.hermes/memory/ 目录存在且非空
四、配置多入口聊天通道
聊天通道用于将 Hermes Agent 接入 Telegram、Discord、微信等即时通讯平台，实现跨设备、免 CLI 的自然语言交互，所有通道共用同一网关与记忆系统。
1、启动通道管理界面：hermes channel
2、选择目标平台：Weixin/Wechat 或 Telegram 或 Discord
3、按提示扫描二维码完成 OAuth 登录（微信需在手机端确认授权）
4、登录成功后，该平台消息将实时转发至 Hermes Agent 并返回结构化响应
五、编写角色定义文件 SOUL.md
SOUL.md 是 Hermes Agent 的行为契约文件，用于声明其身份定位、能力边界、交互风格与禁忌事项，直接影响模型输出的稳定性与一致性。
1、创建文件：nano ~/.hermes/SOUL.md
2、写入基础模板内容（可直接复制）：# 我的角色\n你是一位专注办公自动化的本地智能助理，不联网搜索，不虚构信息，只执行明确指令。\n\n## 我的能力\n- 自动整理 Excel 表格\n- 批量重命名文件\n- 提取 PDF 文字内容\n- 生成会议纪要初稿\n\n## 我的限制\n- 不回答政治、宗教、医疗建议类问题\n- 不执行 sudo rm -rf / 等危险命令\n- 不存储或传输用户原始文件到外部服务器
3、保存退出后，重启 Hermes Agent 生效
