错误根源是Hermes未正确创建或校验Grok模型软链接，需依次完成OAuth授权绑定、检查并修复软链接、验证模型文件完整性（config.json等4个核心文件）、重载模型注册表。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在Hermes Agent中执行Grok模型调用时终端报错“Model not found”，该错误不是Grok服务不可达或账号未授权导致，而是Hermes在解析模型加载路径时未能定位到有效软链接目标。根本原因在于xAI模型接入依赖本地符号链接结构，而默认安装流程不会自动创建或校验该链接。
确认Hermes是否已正确绑定Grok OAuth凭证
打开终端，运行hermes model命令，进入模型配置界面；选择“xAI Grok OAuth”提供商后，观察终端是否显示已授权状态（如Active: true）；若显示Active: false或空白，则说明OAuth令牌未持久化，需重新触发浏览器授权并等待终端返回✅ Grok access token saved提示。
【必须完成此步才能继续后续路径排查】
检查Grok模型软链接是否存在且指向正确目录
执行ls -l ~/.hermes/models/grok，查看输出是否形如grok -> /Users/yourname/.hermes/assets/grok-v3.5；若显示No such file or directory，说明软链接缺失，需手动创建；若箭头指向路径不存在（如-> /nonexistent/path），则软链接已失效。
若软链接缺失：先创建目标目录mkdir -p ~/.hermes/assets/grok-v3.5，再执行ln -sf ~/.hermes/assets/grok-v3.5 ~/.hermes/models/grok；注意-f参数强制覆盖旧链接，避免残留损坏链接。
验证Grok模型资产文件完整性
进入软链接实际指向目录：cd ~/.hermes/assets/grok-v3.5；运行ls -la，确认存在以下4个核心文件：config.json、tokenizer.json、model.safetensors、pytorch_model.bin；缺少任一文件都会触发“Model not found”错误，且Hermes不会明确提示缺失哪个文件。
若文件不全：访问https://github.com/nousresearch/hermes-agent/releases，下载对应版本的grok-v3.5-assets.tar.gz，解压后将全部文件复制进~/.hermes/assets/grok-v3.5/目录，覆盖同名文件。
重载Hermes模型注册表
第一步：停止当前服务，执行hermes stop；
第二步：清除模型缓存索引，运行rm -f ~/.hermes/cache/model_registry.db；
第三步：强制重建注册表，执行hermes model --reload；
第四步：启动服务，输入hermes start，观察日志中是否出现Loaded model 'grok' from ~/.hermes/models/grok；若仍报错，说明软链接目标路径下无有效模型文件，需返回上一节重新校验资产完整性。
