hermes doctor显示红色error或missing说明本地初始化校验失败，需按Model、Memory、Tools三项逐项修复：Model问题用hermes model重配；Memory问题修正state.db权限；Tools缺失则安装并赋权二进制文件；最后执行hermes doctor --fix自动修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装 Hermes Agent v0.19.1 后运行 hermes doctor 显示红色 error 或 missing，说明核心组件未通过本地初始化校验，此时所有后续操作（如聊天、插件调用、网关启动）都不可靠，必须先修复 doctor 状态才能继续使用。
第一步：确认失败项并定位根源
执行 hermes doctor，紧盯输出中三项关键状态：【Model: connected】、【Memory: initialized】、【Tools: enabled】。任一项为红色即代表对应模块初始化失败——不是网络不通，而是本地配置加载失败、SQLite 文件不可写或工具二进制缺失/无执行权限。
这一步不依赖模型 API 或代理，纯本地检查。若三项全绿，问题不在 doctor 本身；若任一红，跳过所有“重启试试”类操作，直接进入修复流程。
第二步：逐项修复三类典型失败
方法一：Model 显示 red 或 missing
运行 hermes model 进入交互式模型配置向导，按提示选择 provider（如 dashscope）、填入正确 API Key，并确认模型 ID（如 qwen-max）拼写无误。填完后保存退出，再跑一次 hermes doctor。若仍红，加 --no-cache 参数重试：hermes doctor --deep --no-cache，强制跳过缓存读取 config.yaml 实时内容。
方法二：Memory 显示 red
检查 ~/.hermes/state.db 文件权限：执行 ls -l ~/.hermes/state.db，若显示 -rw-r--r-- 且属主不是当前用户，说明文件被 root 创建或权限锁死。立即修复：chown $USER:$USER ~/.hermes/state.db && chmod 600 ~/.hermes/state.db。注意：【不要手动删除 state.db】，否则会丢失全部历史会话摘要。
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
方法三：Tools 显示 red
进入 ~/.hermes/tools/ 目录，执行 ls -l 查看内置工具二进制是否齐全（如 curl、rg、jq）。若缺失 rg（ripgrep），Ubuntu 用户运行 sudo apt install -y ripgrep，macOS 用户运行 brew install ripgrep。装完后确认其有执行权限：chmod +x ~/.hermes/tools/rg（若存在但无 x 权限）。
第三步：强制刷新环境与缓存
第一步：重新加载 shell 配置
执行 source ~/.bashrc（zsh 用户用 source ~/.zshrc），确保 HERMES_HOME 和 PATH 已生效。这步漏掉会导致 doctor 找不到 ~/.hermes 下的资源目录。
第二步：清除插件与配置缓存
运行以下两条命令彻底清空可能污染的快照：rm -f ~/.hermes/cache/plugin_index.jsonrm -f ~/.hermes/cache/config.yaml.cache
第三步：触发自动修复（仅限 v0.19.1+）
执行 hermes doctor --fix。该命令会自动检测缺失依赖、修复 SQLite 表结构、重写工具符号链接，并尝试重建记忆库索引。它不会覆盖你的 API Key 或 config.yaml，但会修正底层可执行路径和权限。
