Hermes Agent 完整配置指南：三步跑起来，按需定制你的 AI Agent

Hermes Agent 完整配置指南三步跑起来按需定制你的 AI Agent【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agentHermes Agent 是一款可自建的自改进 AI Agent跑在你自己的电脑或 VPS 上提供终端交互界面能接入 Telegram 等消息平台并跨会话记住你的偏好。这篇指南带你三步跑起来改掉最关键的几处配置让它长成贴合你工作习惯的样子。它能帮你做什么修一个跑挂的测试输入看下这个仓库里哪个测试挂了、为什么它会替你跑测试、读源码最后给出哪一行断言失败、原因是什么。定时无人值守任务输入每天早上九点汇总仓库变更并发到 Telegram之后由内置 cron 调度器按时投递不用你手动触发。记住你的习惯输入记住我的部署习惯先跑测试再发布写进本地记忆文件下个会话不再重复交代。 三步跑起来第一步克隆仓库git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent改完会发生什么项目落在当前目录后续升级、看源码都从这里出发。第二步装依赖uv pip install -e .[all]uv是个快的 Python 包管理器没有的话先装它。安装完成后终端里会多出一个hermes命令——看到命令能正常执行这步就算成功。第三步验证source ~/.bashrc hermes doctor终端出现hermes doctor全部项通过且直接输入hermes能进入交互界面可以打/help看命令列表即成功。报错时hermes doctor会直接告诉你是哪一环的问题。⚙️ 配置文件的5个关键项所有配置集中在~/.hermes/目录你只需要认识两个文件config.yaml所有行为设置和.env只放 API key。关键项如下位置作用是否要改config.yaml→model默认模型与提供商要首次必须选一个~/.hermes/.envAPI key仓库里的 .env.example 就是模板要至少填一个config.yaml→terminal命令工作目录与执行行为看情况默认对大多数人够用config.yaml→display界面皮肤与输出样式可选config.yaml→security命令审批与安全限制建议过一眼原则很简单非机密设置进config.yamlkey 只进.env。不用背字段名日常改配置用hermes config get和hermes config set两个命令就覆盖了。 按你的需求改这几处我想让它换用指定模型hermes model向导会引导你选提供商和模型结果写进model段。改完会发生什么下一次对话起回复就由新模型给出TUI 里打/usage能看到 token 消耗。不想走向导也可以直接hermes config set model.default 提供商:模型名一步到位。我想在 Telegram 里找它聊天hermes gateway setup hermes gateway start前者配置 bot后者启动常驻的 gateway 进程。看到终端显示 gateway 已启动、平台连接成功即算成功之后在 Telegram 私信 bot 就能对话和 CLI 共用同一份会话历史切平台不丢上下文。我想限制它能做什么不写代码也能做hermes tools打开工具清单把不放心开的工具比如浏览器、文件写入关掉。这一步可以先跳过默认设置对 90% 的人够用等你觉得它手太长再收紧。审批规则细节看 SECURITY.md。 跑得更快、更稳上下文压缩长对话会把整段历史塞进上下文token 越滚越多模型注意力也变差。在 TUI 里打/compress旧消息会被压缩成摘要策略可在config.yaml的compression段调。什么时候值得打开单次对话超过几十轮、或者 token 账单开始心疼时。定期体检跑一次hermes doctor一次查完 Python 版本、配置文件格式、各提供商连通性。什么时候值得打开遇到配置报错或者升级hermes update之后行为不对劲时。卡住了看这里装完终端提示 hermes: command not foundShell 没重载执行source ~/.bashrczsh 用户是source ~/.zshrc再试一次。API key 放哪里能写进 config.yaml 吗一律放~/.hermes/.env照仓库里的 .env.example 复制一份填。config.yaml是放非机密设置的key 写进去既不安全也不推荐。第一次运行不知道选哪个模型有自己厂商的 key 就选对应提供商没有可以先用免费档跑起来熟悉手感。hermes model随时可切换不用改任何代码。跑起来之后建议先花几天让它处理真实任务记忆和技能会慢慢沉淀成你自己的偏好。想继续深入从这几个入口看起README.md、agent/、apps/desktop/、SECURITY.md、CONTRIBUTING.md。【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考