Hermes Agent 快速上手需掌握三类指令：启动会话（hermes / hermes chat -q / hermes --continue）、模型切换（临时--model/永久config set/编辑config.yaml）及报错修复（PATH、API key、限流、Docker）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想快速调用 Hermes Agent 功能却卡在命令记不全、输错参数、报错看不懂的环节？这不是配置没对，而是缺少一份按真实使用场景组织的指令速查与排障路径。
启动与基础会话
第一步：直接输入 【hermes】 启动交互式终端，这是最常用也最安全的入口。它会自动加载当前配置、恢复上下文，并进入带历史回溯的 TUI 界面。
第二步：若只想问一句就退出，用 【hermes chat -q "你的问题"】。比如 hermes chat -q "今天北京天气怎么样"，适合写进脚本或定时任务里触发。
第三步：意外中断后想接着聊？运行 【hermes --continue】 或简写 hermes -c。它会自动定位最近一次未完成的 session，不是靠时间戳猜，而是读取 ~/.hermes/state/last_session_id 文件。
注意：clear 是终端命令，不是 Hermes 子命令——在 Hermes 交互界面里直接敲 clear 只清屏，不重置会话；真要清空上下文，得输 /clear 斜杠指令。
模型切换与配置管理
方法一：临时换模型（本次对话生效）
输入 hermes chat -q "hello" --model anthropic/claude-3.5-sonnet。这种方式不改配置文件，适合快速对比不同模型输出风格。
方法二：永久设为默认模型
执行 hermes config set model.default deepseek/deepseek-v3。这会写入 ~/.hermes/config.yaml，下次启动即生效。如果填错模型 ID，后续所有 hermes 命令都会卡住等待超时，必须手动编辑 config.yaml 删除该行或改回可用值。
方法三：打开配置文件直接改hermes config edit。它会调用系统默认编辑器（通常是 nano），修改保存后无需重启 Hermes，新配置在下一次请求时自动加载。
高频报错一键修复
① 【hermes: command not found】
不是没装上，是 shell 没刷新 PATH。Mac/Linux 用户执行 source ~/.zshrc（zsh）或 source ~/.bashrc（bash）；Windows PowerShell 用户运行 $PROFILE 确认路径后执行 . $PROFILE。
② 【AuthenticationError: Invalid API key】
先确认 key 是否复制完整（Kimi 的 key 以 sk- 开头，共 48 位字符），再检查是否设到了正确字段：hermes config set KIMI_CN_API_KEY your_key_here。漏掉 _CN_ 或写成 KIMI_API_KEY 都会失败。
③ 【RateLimitError: Too many requests】
立刻停手，等 60 秒。不要连发 hermes chat -q 测试，Hermes 默认启用请求节流保护，连续触发会锁死当前 session 3 分钟。改用 hermes --yolo chat -q 可绕过节流，但仅限调试，不可用于生产。
④ 【Cannot connect to Docker daemon】
说明你启用了 Docker 后端但 Docker Desktop 没开，或 Linux 上没加用户到 docker 组。执行 sudo usermod -aG docker $USER，然后完全退出终端重进——只 source 不生效。
诊断与状态检查
第一步：看版本和环境是否就绪hermes --version && hermes doctor。前者确认 CLI 可调用，后者检查 Python 版本、依赖完整性、API key 可读性、网络连通性四项硬指标。
第二步：查配置有没有被意外覆盖hermes config show | grep -E "(model|provider|key)"。重点核对 model.default、model.provider 和对应 key 字段是否为空或拼写错误。空值会导致所有请求 fallback 到无效默认值。
第三步：抓一段可分享的诊断快照hermes dump --show-keys=false。它会生成不含敏感信息的 JSON 摘要，包含 OS、Python、Hermes 版本、已启用插件、网关状态等，方便贴给社区求助。
