鲲鹏Talk：Hermes Agent完全技术参考手册：从入门到生产部署（2026年）

2026-06-2026-06-PAGEPAGE10/HermesAgent完全技术参考⼿册：从⼊⻔到⽣产部版本版本：v2.1+|适⽤对象：开发者、AI⼯程师、DevOps运维、技术管理者⼀句话判断：Hermes代表AI从"问答"⾛向"⾏动"的关键定义与核根据清华⼤学清新研究团队2026年4⽉发布的《HermesAgent深度研究报告》的核⼼判断HermesHermesAgent是"可执⾏型AIAgent"的代表形态。其核⼼价值在于把⼤模型的语⾔理解能⼒扩展为真实世界中的任务执⾏能⼒。未来AI产品的关键分野，不是"谁更会回答"，⽽是"谁更能完成任务"。AI产品的形态正在经历第三次跃第⼀次：Chatbot——回答问题、⽣成内容，⽌步于⽂本第⼆次：Copilot——嵌⼊单⼀⼯作流，局部建议，不承担完整任务链第三次：Agent——接收⽬标，⾃主拆解任务，调⽤⼯具，执⾏验证，交付结果Hermes站的就是第三阶段。它能分析整个仓库结构、读懂代码逻辑、修改多个⽂件、跑测试、整理⽂档，最维Hermes核⼼理功能清单⾃改进学习记忆系向量记忆（AutoGPT）/⽆持久记忆三层记忆：会+持久化+技能单次调⽤、简单链多步规划、⼯具编排、状态管部本地优先、模型⽆关、数据核⼼差异化五要素Skill（技能）系统——解决过的问题沉淀为可复⽤技能，越⽤越聪明。社区已建⽴awesome-hermes-持久记忆——跨会话记住你是谁、你的偏好、环境信息。MEMORY.md直接可读，⽤⼾可编辑/删除记，Profile隔离——多实例隔离，不同⼯作场景⽤不同的profile这是Hermes2026年唯⼀具备的能⼒，也是其护城河所STEP1:感知任务——解析⽤⼾指令，决定调⽤哪些⼯STEP3:沉淀技能——把成功路径固化为可复⽤技是"⼀次性执⾏"，Hermes的差异化是"⾃学习循环"——感知任务→执⾏⾏动→沉淀技→更新记忆，四步循Agent越⽤越聪明。⼆、安装与初始配五种部署形部特最简单，3分钟安容器化隔⽣产环境推荐，沙箱远程服务器科研/⾼性能计算场按⽅式⼀：pip安装（快速体验pippipinstallhermes-agenthermessetup⽅式⼆：官⽅⼀键脚本（推荐curlcurl-fsSL/NousResearch/hermes-agent/main/scripts/install.sh|bashhermes⽅式三：Docker部署（⽣产环境推荐dockerpullnousresearch/hermes-dockerpullnousresearch/hermes-dockerrun-d--namehermes-v~/.hermes:/root/.hermes-v/opt/data:/opt/data-DASHSCOPE_API_KEY=your_key-eANTHROPIC_API_KEY=your_keynousresearch/hermes-⽅式四：从源码构建（深度定制gitgitclone/NousResearch/hermes-agent.gitcdhermes-agentpipinstall-e健康检查与故障修hermesdoctor--hermesdoctor--关键路路作主配API密钥和敏感信已安装的技能（107+个⽹关和错误持久化记忆数据多实例配置隔离⽬三、推荐的Skills（技能开发效技⽤推荐systematic-四阶段writing-写实现计划，拆github-pr-github-code-PR代码审技 ⽤ 推荐指codebase-代码requesting-code-提交前⾃动审内容创作技⽤推荐去除AI写作tech-article-architecture-SVG架构图baoyu-image-AI图baoyu-slide-研究与信息收集技⽤推荐tavily-multi-search-17个搜索引监控博客和tech-repo-youtube-技⽤推荐hermes-self-⾃我改进⼯作openclaw-auto-kanban-webhook-技⽤推荐gif-songwriting-and-ai-macOSapple-⽤项⽬级指ClaudeCode/Agent⼈格OpenClaw/兼容Cursor/####测试框架：pytest，不用代码风格：4空格缩进，行宽API版本：当前使用v2，路径数据库：PostgreSQL包管理：uv，不用提交信息：ConventionalCommits##所有API数据库迁移使用异步任务使用Celery+##安全检查：SQL注入、XSS、性能检查：N+1忽略：格式问题（Black自动处理##Context在对话中⽤@引⽤⽂件、⽂件夹、gitdiff和@AGENTS.md帮我看看这个架构设计是否符合项⽬约定@src/auth/审查认证模块的代码@gitdiff看看这次变更的影响范围限头部保尾部保截断五、启动与对##交互式对话（默认模式#hermeschat-q"帮我分析这段代码的问题#hermeschat-manthropic/claude-sonnet-#hermesmodelusekimi-hermesmodelusekimi-hermes-ssystematic-debugging-swriting-hermes--hermes--resume模型切换成本对⽐模平均耗ClaudeSonnet复杂/GPT-4o-KimiK2/GLM-中⽂场景⾸完全离线/隐私场对话内的命作新建会查看或切管理⼯具搜索、安装、管理技查看当前配跳过所有确认（危险##hermes#启用/hermestoolsenablehermestoolsdisable40+内置⼯具能⼒图谱⼯具数代表⼯社Web搜索browser.navigate,62%,系统记忆与技视觉与多模6000+MCP⼯多模型切换##hermes#hermesconfigsetmodel.defaultanthropic/claude-sonnet-#/modelanthropic/claude-sonnet-六、Memory（记忆）系三层记忆架第⼀层：会话记忆（短期）——当前对话上下⽂，滚动窗⼝管理，关了对话第⼆层：持久记忆（⻓期）——跨会话⽤⼾画像，偏好、习惯、环境，MEMORY.md持久化Honcho⽤⼾建模——动态画像，每次交互都在更新"你是谁与全量加载记忆⽅案的对⽐维全量加载（传统按需检索随对话增⻓线性基检索精什么都在，什么都按关键词精准匹⼏天后就撑响应速越来越基⽤⼾画像：名字、⻆⾊、偏好、沟通⻛环境信息：操作系统、已安装⼯具、⼯具特性：某个⼯具的坑、特殊⽤约定和规范：项⽬约定、APIquirks、⼯作流偏好记忆管理hermesmemoryhermesmemoryhermesconfigsetmemory.memory_enabled主动纠正——Agent犯错时，直接说「记住，以后别环境发现——Agent⾃动记录项⽬约定、⽬录偏好沉淀——沟通⻛格、代码⻛格、⼯具偏别存临时信息——任务进度、PR号、session状态不要七、Session（会话）管hermessessionshermessessionshermessessionshermessessionsexport~/my-sessions.jsonlhermessessionsrename<id>"我的项目名称"hermessessionsprune--older-than30会session_search(query="authrefactor"session_search(query="authrefactor",session_search(session_id="20260526_143052_abc123",⼋、双层压缩系层作上下⽂窗⼝使⽤理解对话结构，保留语义连上下⽂窗⼝使⽤防⽌溢出，兜底保压缩，不截断——理解对话结构，保留语义连贯性渐进式披露——Skills、⼯具、上下⽂⽂件都有元数据层，按需加载保留叙事连续性——压缩后仍然保持故事线完整PromptAnthropicprompt保留最近的真实⽤⼾消压缩中间的⼯具调重新注⼊初始hermesconfighermesconfigsetcompression.enabledtruehermesconfigsetcompression.threshold0.50hermesconfigsetcompression.target_ratio九、Cron创建hermescroncreatehermescroncreatehermescroncreate"09**hermescroncreate"everymonday管理hermescronhermescronhermescronedit<job_id>hermescronpausehermescronresume<job_id>hermescronrun<job_id>hermescronremove场成本估~$0.05/监控告~$0.02/~$0.10/~$0.18/典型⼯作流：每⽇SEOcroncron触发→browser抓取→vision校验→memory对比→Slack推送每天9:00 10个关键词 昨日数据diff ⾼级⽤法（YAML配置name:"name:"每日SEO监控"schedule:"09**model:"anthropic/claude-sonnet-skills:["tavily-search","tech-article-writing"]enabled_toolsets:["web","browser","memory"]script:"scripts/seo_check.py"workdir:"/path/to/project"no_agent:⼗、Profile（配置⽂件）系什么是同⼀台机器上运⾏多个完全独⽴的Hermes实例，每个有⾃⼰的配置、技能、记忆、会话、API密使⽤场安装技humanizer,tech-article-⻜书/微信开systematic-debugging,github-pr-spotify,apple-Home研arxiv,tavily-hermesprofilehermesprofilehermesprofilecreatecontent-hermesprofilecreatecontent-builder--clonedev-profilehermesprofileusecontent-builderhermesprofileshowmy-⼗⼀、Gateway（消息平台⽹关平⽤⼾规成熟9.532007000通开源协微hermesgatewayhermesgatewayhermesgatewayhermesgatewaystart/stop/restarthermesgatewaystatushermesgateway设HomeChannelSSH断线保sudologinctlenable-linger⼗⼆、Security（安全）hermesconfighermesconfigsetapprovals.modesmart #智能审批（推荐）hermesconfigsetapprovals.modemanual #手动审批（默认）hermesconfigsetapprovals.modeoff #关闭审批（不推荐）hermes--yolo #YOLO模式密钥泄露保hermesconfighermesconfigsetsecurity.redact_secrets开启后，APIKey、Token等敏感信息⾃动打hermesconfighermesconfigsetsecurity.website_blocklist"['',hermeshermestoolsdisableterminalhermestoolsdisablebrowserhermestoolsenablefilehermestoolsenable什么是基于SQLite的持久化任务看板创建任务卡⽚，分配给不同Profile设置任务依赖关系跟踪状态：todo→ready→running→done/blocked完整审计⽇志什么时候⽤⼯作需要跨重启存活⽤⼾可能中途介⼊多个⼦任务可以并⾏执⾏需要审/迭代循环审计追踪很重要Orchestrator（编排者）⼯作##t1kanban_create(title="成本对比分析"assignee="researcher")["task_id"]t2=kanban_create(title="性能基准测试",综合任务，依赖t1和t2t3=kanban_create(parents=[t1,parents=[t1,Worker（执⾏者）⼯作##summary="令牌桶算法，14个测试通过","changed_files":["rate_limiter.py","tests/test_rate_limiter.py"],"tests_run":14,"tests_passed":#代码类任务先blockkanban_block(task_id="code-refactor-123",reason="review-Changeprofilemodel、告警标记、审计追踪hermeskanbanhermeskanbanhermeskanbancreate"任务标题--assigneeresearcherhermeskanbanlisthermeskanbanshowhermeskanbancomplete<task_id>summary"完成说明"hermeskanbanblock<task_id>"需要人工确认"hermeskanbanunblock<task_id>hermeskanbantail<task_id>hermeskanbanarchive常⻅模说N个研究任务并⾏→1并⾏实+实现者做修改，验证者确认配流多个任务分给同⼀个Profile，Human-in-the-任何任务可以随时block等待⼈⼯输避坑指不要编Profile名称不要把独⽴任务绑在⼀起依赖关系别漏设⼗四、⾼级技巧与隐藏⽤delegate_task(goal=delegate_task(goal="src/auth/目录的安全漏洞"assignee="security-reviewer"){"goal":"审查auth模块","context":{"goal":"审查payment模块","context":{"goal""审查notification模块","context":⽣成多个独⽴##hermeschat-q"研究GRPO论文并写总结到#交互式Agent（用tmuxnew-session-d-sagent1tmuxsend-keys-tagent1'BuildaFastAPIauthservice'Entertmuxcapture-pane-tagent1-pMCP（ModelContextProtocol）hermeshermesmcpaddmy-server--command"npx-y@some/mcp-server"hermesmcplisthermesmcptestmy-hermesmcpconfiguremy-hermeswebhooksubscribegithub-hermeswebhooksubscribegithub-hermeswebhookconfiguregithub-push--eventspush,pull_requesthermeswebhooklisthermeswebhooktestgithub-hermesconfigsetcompression.enabledtruehermesconfigsetcompression.threshold0.50hermesconfigsetcompression.target_ratio帮我修api/handlers.py第47行的TypeError——process_request()从parse_body()帮我修api/handlers.py第47行的TypeError——process_request()从parse_body()收到了None。完整的traceback预期行为：当请求体为空时返回400BadRequest技巧2：让Agent⽤⾃⼰的⼯你说"这个⽂件src/auth/auth.py"，它会去读；你贴内容，它只能看到你选的那部分。3：AGENTS.md代替重复说明4：Skill的渐进式加载技巧5：Skill的⾃进化ls-lt~/.hermes/skills/|head-cat~/.hermes/skills/my-skill/SKILL.mdhermesskillsarchivemy-skill每次做完⼀件事Agent把它保存为skill。ls-lt~/.hermes/skills/|head-cat~/.hermes/skills/my-skill/SKILL.mdhermesskillsarchivemy-skill2026-06-2026-06-PAGE17PAGE17/技巧7：本地模型也能hermeshermesconfigsetmodel.defaultollama/llama3.1:8bollamarunllama3.1:8bimportrequestsresults=search("Python性能优化articles=[requests.get(url).textforurlinresults[:3]]summary=analyze(articles,focus="performance")report=generate_report(summary,template="tech-article")save(report,"~/articles/python-performance-2026.md")⼗五、⽣产环境部署（VPS/⽅案A：Docker容器部署（推荐dockerdockerpullnousresearch/hermes-agent:latestdockerrun-d\--namehermes--restartunless-stopped-v~/.hermes:/root/.hermes-v/opt/data:/opt/data-eDASHSCOPE_API_KEY=your_key-eANTHROPIC_API_KEY=your_key-eHERMES_PROFILE=production-p8080:8080nousresearch/hermes-sudotee/etc/systemd/system/hermes-gateway.service<<'EOF'Description=HermesAgentGatewayExecStart=/usr/local/bin/hermesgateway2026-06-2026-06-PAGEPAGE18/sudosystemctldaemon-sudosystemctlenablehermes-gatewaysudosystemctlstarthermes-gatewayappendonlyappendonlyappendfsynceverysecmaxmemory2gbmaxmemory-policyallkeys-外部监配http://your-5防⽕墙配sudoufwallowsudoufwallowsudoufwallowfrom/24toanyport⼗六、推荐配置清#~/.hermes/config.yaml#~/.hermes/config.yamldefault:"anthropic/claude-sonnet-4"fallback:"kimi-k2"context_length:temperature:max_turns:reasoning:falseshow_cost:trueenabled:threshold:target_ratio:gateway_threshold:skin:tool_progress:show_reasoning:falseshow_cost:truelanguage:redact_secrets:true"bad-tirith_enabled:memory_enabled:user_profile_enabled:truebackend:"sqlite"sync_interval:mode:"smart""gitenabled:trueport:8080home_channel:level:file:"~/.hermes/logs/hermes.log"max_size:"100MB"max_backups:⼗七、常⻅问题与避坑指Q1：改了配置/安装了新⼯具/新技能，但没⽣效grepgrep-i"failedtosend|error|panic"~/.hermes/logs/gateway.log|tail-20systemctl--userreset-failedhermes-gatewayMessageContentIntent：DiscordDeveloperPortalBotPrivilegedGatewayIntents开MessageContentIntenthermesconfigsetviderhermesconfigsetauxiliary.vision.model"claude-sonnet-需要订阅hermesconfigsetviderhermesconfigsetauxiliary.vision.model"claude-sonnet-Q6：技能安装后看不到hermeshermesskillslist|grepmy-skillhermesskillsconfig/skillmy-Q7：YOLO模式怎么⽤hermes--hermes--exportQ8：如何迁移记忆到另⼀台机tar-czfhermes-backup.tar.gztar-czfhermes-backup.tar.gzscphermes-backup.tar.gzuser@new-server:~/tar-xzfhermes-backup.tar.gz-C~/Q9：如何清理过期的记忆hermesmemoryprune--older-thanhermesmemoryprune--older-thanhermesmemoryarchive--older-thanQ10：Skill创建失败怎么办chmod-R755chmod-R755mkdir-p~/.hermes/skills/my-cat>~/.hermes/skills/my-skill/SKILL.md<<'EOF'#Skill:my-skill########hermesskillrunmy-skill--argvalue⼗⼋、⼯作流#1.#1.hermes-stavily-search-stech-article-writing-s#2.帮我搜索关于"RustvsGo性能对比"#3.#4.去AI用humanizer5.保存到~/articles/rust-vs-#1.#1.hermes-sgithub-code-review-ssystematic-#2.指定帮我审查这个#3.列出所有安全问题、性能问题和可能的#4.对标记为"minor"的问题，直接提交修复⽰例3：h