Hermes-Paperclip Adapter配置速查表：model、provider、toolsets等14个参数完全解析

Hermes-Paperclip Adapter配置速查表model、provider、toolsets等14个参数完全解析【免费下载链接】hermes-paperclip-adapterPaperclip adapter for Hermes Agent — run Hermes as a managed employee in a Paperclip company项目地址: https://gitcode.com/gh_mirrors/he/hermes-paperclip-adapterHermes-Paperclip Adapter 是一款让 Hermes Agent 以受管员工身份运行在 Paperclip 公司中的 AI 适配器。本文提供 Hermes-Paperclip Adapter 配置速查表完整解析model、provider、toolsets等 14 个核心参数的作用、默认值与推荐用法帮助你快速完成 Paperclip 适配器的参数配置少踩坑、少试错。一分钟了解 Hermes-Paperclip AdapterHermes-Paperclip Adapter类型标识hermes_local把 Hermes Agent 接入 Paperclip 编排平台。它负责 在每次心跳heartbeat时以单次查询模式启动 Hermes完成任务并回报结果 通过会话持久化--resume跨心跳保持上下文与记忆️ 解析 Hermes 原始输出生成结构化工具卡片见 parse-stdout.ts 自动探测~/.hermes/config.yaml中的默认模型见 detect-model.ts想先跑起来安装适配器npm install hermes-paperclip-adapter前提已安装 Hermes Agentpip install hermes-agent、Python 3.10、至少一个 LLM API Key。如需从源码构建可执行git clone https://gitcode.com/gh_mirrors/he/hermes-paperclip-adapter后npm install npm run build。14 个配置参数速查总表在 Paperclip UI 或 API 中创建adapterType: hermes_local的智能体时adapterConfig支持以下 14 个参数默认值来自 constants.ts分组参数类型默认值一句话说明核心modelstringanthropic/claude-sonnet-4模型名provider/model格式可留空走本地默认核心providerstring自动探测推理服务商auto、openrouter、nous、zai等核心timeoutSecnumber1800单次执行超时秒数核心graceSecnumber10SIGTERM 到 SIGKILL 的宽限秒数工具toolsetsstring全部启用的工具集逗号分隔会话persistSessionbooleantrue跨心跳恢复会话会话worktreeModebooleanfalseGit worktree 隔离变更会话checkpointsbooleanfalse文件系统检查点可回滚高级hermesCommandstringhermes自定义 Hermes CLI 路径高级verbosebooleanfalse详细输出模式高级quietbooleantrue静默模式输出干净高级extraArgsstring[][]追加任意 CLI 参数高级envobject{}注入额外环境变量如 API Key高级promptTemplatestring内置模板自定义提示词模板 另有一个paperclipApiUrl默认http://127.0.0.1:3100/api用于告诉 Hermes Paperclip API 地址一般无需修改。最小可用配置示例{ name: Hermes Engineer, adapterType: hermes_local, adapterConfig: { model: anthropic/claude-sonnet-4, timeoutSec: 300, persistSession: true, toolsets: terminal,file,web } }model 与 provider模型与服务商怎么配这两个参数是配置里最容易出错的部分核心逻辑在 execute.ts 与 detect-model.tsmodel— 格式为provider/model例如anthropic/claude-sonnet-4。留空时适配器会读取你本地的~/.hermes/config.yaml直接沿用 Hermes 已配置的默认模型通常这是最省心的做法。provider— 有效值包括auto、openrouter、nous、openai-codex、anthropic、zai、kimi-coding、minimax、minimax-cn等完整清单见 constants.ts。它的解析遵循四级优先链你显式配置的provider用户覆盖优先级最高~/.hermes/config.yaml中探测到的 provider仅当配置模型与请求模型一致时从模型名前缀推断如claude*→anthropicglm-*→zaigpt-4*→openai-codexauto交给 Hermes 自行决定⚠️ 小贴士除非确有必要建议不填provider让自动探测生效——环境自检test.ts会在两者不一致时给出警告。toolsets如何挑选合适的工具集toolsets控制 Hermes 能使用哪些原生工具用逗号分隔例如terminal,file,web。不填则全部启用。可用工具集共 9 个terminal— 终端命令执行file— 文件读写web— 网页提取️browser— 浏览器操作⚡code_execution— 代码执行️vision— 视觉理解mcp— MCP 服务接入creative— 创作类任务productivity— 效率类任务 建议按职责最小化授权只做代码审查的 Agent 可以只开file,terminal既安全又快。persistSession、worktreeMode、checkpoints会话与工作区三件套参数推荐场景persistSession: true默认让 Hermes 通过--resume恢复上次会话跨心跳保持对话上下文、记忆与工具状态worktreeMode: true多 Agent 并行改同一个仓库时用 Git worktree 隔离变更互不干扰checkpoints: true担心 Agent 改坏文件时开启文件系统检查点出问题可回滚三者默认分别是true、false、false。个人单 Agent 跑任务用默认值即可多员工协作的公司环境建议同时开启worktreeMode和checkpoints。高级参数hermesCommand、verbose、extraArgs、env 实用技巧hermesCommand— Hermes 不在 PATH 中时指定二进制绝对路径如/usr/local/bin/hermes。环境检测失败提示hermes_cli_not_found时第一个要检查的就是它。verbose/quiet— 排查问题时verbose: true打开详细日志quiet默认开启保证输出干净无横幅和 spinner方便适配器解析。extraArgs— 逃生舱口数组形式的追加 CLI 参数任何 Hermes 支持的命令行选项都能从这里透传。env— 以对象形式注入环境变量常用于挂载ANTHROPIC_API_KEY、OPENROUTER_API_KEY、OPENAI_API_KEY、ZAI_API_KEY、KIMI_API_KEY、MINIMAX_API_KEY等密钥也建议同时写入~/.hermes/.env。promptTemplate自定义提示词模板与变量promptTemplate使用{{变量}}占位符可用变量包括{{agentName}}、{{companyId}}、{{runId}}、{{taskId}}、{{taskTitle}}、{{taskBody}}、{{projectName}}、{{paperclipApiUrl}}、{{commentId}}、{{wakeReason}}等。还支持三段条件块覆盖智能体的三种唤醒场景内置模板见 execute.ts{{#taskId}}...{{/taskId}}— 有任务被分配时生效{{#noTask}}...{{/noTask}}— 空心跳、自动找活时生效{{#commentId}}...{{/commentId}}— 被 Issue 评论唤醒时生效一般保持内置模板即可只有需要定制工作流如汇报格式、检查清单时才改写它。常见问题 FAQQ配置后提示找不到模型 providerA删掉显式provider配置让四级解析链自动生效或检查~/.hermes/config.yaml中model.provider是否与请求模型匹配。QAgent 每次都失忆怎么办A确认persistSession为true默认开启并检查运行日志中是否出现Resuming session行。Q怎么验证环境是否就绪A调用 Paperclip 的环境自检它会依次检查 Hermes CLI、Python 版本、API Key 与 provider 一致性实现见 test.ts状态分pass/warn/fail三级。总结掌握 Hermes-Paperclip Adapter 配置的核心就是记住这张清单model留空跟随本地默认provider交给自动探测toolsets按职责最小化授权persistSession保持开启其余参数按需开启。更多细节可参考 README.md 中的 Configuration Reference 章节。配置完成后你的 Hermes 员工就会在每个心跳里自动接单、干活、汇报 【免费下载链接】hermes-paperclip-adapterPaperclip adapter for Hermes Agent — run Hermes as a managed employee in a Paperclip company项目地址: https://gitcode.com/gh_mirrors/he/hermes-paperclip-adapter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考