企业官网建设流程全解析

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-adapter

Hermes-Paperclip Adapter 是一款让 Hermes Agent 以"受管员工"身份运行在 Paperclip 公司中的 AI 适配器。本文提供 Hermes-Paperclip Adapter 配置速查表，完整解析model、provider、toolsets等 14 个核心参数的作用、默认值与推荐用法，帮助你快速完成 Paperclip 适配器的参数配置，少踩坑、少试错。

一分钟了解 Hermes-Paperclip Adapter

Hermes-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 Agent（pip 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）：

💡 另有一个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.ts：

model— 格式为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）。它的解析遵循四级优先链：

1. 你显式配置的provider（用户覆盖，优先级最高）
2. ~/.hermes/config.yaml中探测到的 provider（仅当配置模型与请求模型一致时）
3. 从模型名前缀推断（如claude*→anthropic，glm-*→zai，gpt-4*→openai-codex）
4. auto（交给 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：会话与工作区三件套

三者默认分别是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 评论唤醒时生效

一般保持内置模板即可；只有需要定制工作流（如汇报格式、检查清单）时才改写它。

常见问题 FAQ

Q：配置后提示"找不到模型 provider"？A：删掉显式provider配置，让四级解析链自动生效；或检查~/.hermes/config.yaml中model.provider是否与请求模型匹配。

Q：Agent 每次都"失忆"怎么办？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