Hermes-Paperclip Adapter完整安装指南注册适配器、创建hermes_local智能体并分配第一个任务【免费下载链接】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 的官方适配器让你把 Hermes 当作 Paperclip 公司里的数字员工来管理。本指南带你从零开始完成 Hermes-Paperclip Adapter 安装注册适配器、创建 hermes_local 智能体、分配第一个任务全程只需三步。一、了解 Hermes-Paperclip Adapter 能做什么在动手之前先看看这个 AI Agent 适配器解决了什么问题把 Hermes 变成员工通过心跳调度自动接收任务、执行工作、汇报结果️30 原生工具终端、文件、网页、浏览器、Git 等开箱即用持久记忆 会话续接每次心跳自动恢复上次上下文跨任务不失忆技能系统自动扫描 Paperclip 托管技能与~/.hermes/skills/原生技能结构化输出把 Hermes 的原始输出解析为带状态图标的工具卡片架构上Paperclip 的心跳调度器调用适配器的execute()由它在后台启动 Hermes CLI 的hermes chat -q单次查询模式执行完成后把结果、Token 用量、成本汇报回来。核心实现位于 execute.ts。 项目说明详见 README.md开发指南见 AGENTS.md。二、安装前的环境准备在执行 Hermes-Paperclip Adapter 安装之前请确认本地环境满足以下三个前提条件前提要求检查命令Hermes Agent已通过 pip 安装pip install hermes-agentPython3.10 或更高版本python3 --versionLLM API Key至少配置一个Anthropic / OpenRouter / OpenAI写入~/.hermes/.env提示适配器的环境检测模块 test.ts 会自动检查 CLI 是否安装、Python 版本、API Key 是否就绪并给出可读的修复建议。只要有一项不满足就会返回明确的错误码如hermes_cli_not_found无需手动排查。安装适配器本身只需一行npm install hermes-paperclip-adapter三、步骤一在 Paperclip 服务器注册适配器Hermes-Paperclip Adapter 安装的核心一步是在 Paperclip 服务器的适配器注册表中登记。编辑 Paperclip 仓库的server/src/adapters/registry.ts加入import * as hermesLocal from hermes-paperclip-adapter; import { execute, testEnvironment, detectModel, listSkills, syncSkills, sessionCodec, } from hermes-paperclip-adapter/server; registry.set(hermes_local, { ...hermesLocal, execute, testEnvironment, detectModel, listSkills, syncSkills, sessionCodec, });其中hermes_local是适配器的唯一标识定义在 constants.ts 的ADAPTER_TYPE常量中。注册完成后Paperclip UI 中创建智能体时就能选择 Hermes Agent 这一类型了。四、步骤二创建 hermes_local 智能体在 Paperclip UI 中创建智能体或通过 API 提交配置。推荐的最小配置如下{ name: Hermes Engineer, adapterType: hermes_local, adapterConfig: { model: anthropic/claude-sonnet-4, maxIterations: 50, timeoutSec: 300, persistSession: true, enabledToolsets: [terminal, file, web] } }各字段的作用model— 模型名采用provider/model格式留空则自动读取~/.hermes/config.yaml中你已配置的模型自动检测逻辑见 detect-model.tstimeoutSec— 单次执行超时秒防止任务卡死persistSession— 保持为true让 Hermes 通过--resume跨心跳续接会话enabledToolsets— 按需开放工具常用组合terminal、file、web、browser、vision五、步骤三分配第一个任务智能体创建好后在 Paperclip 中创建一个 Issue 并指派给你的 Hermes 智能体即可。每次心跳触发时Hermes 会完成一个完整的工作闭环接收任务指令通过内置提示模板自动注入任务标题与描述调用工具集完成实际工作将结果汇报回 Paperclip持久化会话状态为下一次心跳做好准备 当某位同事在 Issue 下留了评论Hermes 也会被唤醒响应——这就是适配器支持的评论驱动唤醒能力。六、执行过程中发生了什么Hermes 每次运行都会经过适配器的六步后处理管线源码同样在 execute.ts捕获stdout/stderr解析 Token 用量、会话 ID 与成本解析原始输出为结构化TranscriptEntry即你在 UI 里看到的工具卡片美化Hermes 的 ASCII 横幅、setext 标题、--表格线为标准 Markdown降级无害的 stderr如 MCP 初始化日志避免误报为错误打标会话为tool来源不污染你的交互式历史汇报成本、用量与会话状态回 Paperclip输出解析的具体规则实现于 parse-stdout.ts技能扫描逻辑在 skills.ts。七、常见问题速查问题原因解决方法报hermes_cli_not_foundHermes 未安装pip install hermes-agentPython 版本过低需要 3.10升级 Python警告无 API Key环境变量缺失在~/.hermes/.env配置ANTHROPIC_API_KEY等Provider 不匹配警告显式 provider 与本地配置冲突删除显式provider字段改用自动检测更多配置项worktreeMode、checkpoints、promptTemplate模板变量等请参考 README.md 中的 Configuration Reference 章节。总结至此Hermes-Paperclip Adapter 安装全部完成✅ 环境准备 → ✅ 注册适配器 → ✅ 创建 hermes_local 智能体 → ✅ 分配第一个任务。现在你的AI 员工已经开始上班了后续只需在 Paperclip 里创建和指派 Issue它会自动完成工作并汇报结果。【免费下载链接】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），仅供参考