Hermes Agent启动时报“API Key 无效”通常是因配置中api_key值含首尾不可见空格或换行符；需用hermes config show检查，hermes config edit手动清除所有空白字符，确保格式为api_key: sk-xxx，再重启服务验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在启动Hermes Agent时收到“API Key 无效”报错，却确认密钥本身没输错，大概率是复制粘贴过程中带入了肉眼不可见的首尾空格或换行符——这类空白字符会让YAML解析器直接拒绝加载配置，且错误提示不明确，极易卡住整个部署流程。
检查当前生效的API Key是否含隐藏空格
打开终端，执行：
hermes config show
重点观察输出中 api_key 行的值：如果两端能看到空格（例如显示为" sk-xxx "而非"sk-xxx"），就坐实了问题根源。注意：空格可能出现在引号外、冒号后、甚至换行符之后，仅靠肉眼很难识别全貌。
手动编辑配置文件清除空格
运行以下命令进入配置编辑界面：
hermes config edit
定位到 api_key 字段所在行，【必须删除该字段值前后所有空格及换行符】，确保其格式严格为：
api_key: sk-xxx
（冒号后仅一个空格，无引号，无缩进，无换行）
保存并退出。这一步不能用复制粘贴替代——编辑器自带的“粘贴为纯文本”功能仍可能保留不可见字符，务必手动逐字删空格。
验证清除效果
执行 hermes config show 再次查看，确认 api_key 值已无任何首尾空白。
重启 Hermes Agent：
sudo systemctl restart hermes
若服务正常启动且不再报 401 错误，则说明空格已清除干净。
