OpenHermit Agent 运行平台

将 AI Agent 部署为可集中管理、持久运行并隔离执行的生产服务。

Star 数
★ 90
最近更新
3 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具自托管服务网页应用
可在哪里用
通用 · 跨平台OpenAI API(部分支持)
费用
软件免费,模型调用费用自付
上手难度
高 · 需要较重的基础设施
开始前需要
Node.jsPostgreSQLDocker 或受支持的云沙箱提供商LLM 提供商或兼容 OpenAI 的本地服务器Shell / 命令行网络访问本地文件系统MCP Server
典型场景
需要为多个团队或客户分别部署 Agent,并集中维护其会话状态、密钥和配置的内部平台团队。
不适合
  • 需要免维护托管式 Agent 服务的团队
  • 不希望管理数据库和网关的个人用户

这个 Agent 能做什么,适合哪些场景?

OpenHermit 是一个开源平台,用于部署和管理多组 AI Agent。Gateway 使用 Hono 提供控制平面、API、认证、路由、生命周期管理和调度,管理界面位于 /admin/。Agent 的会话、记忆、指令、技能、MCP 配置、计划任务和密钥等内部状态存储在 PostgreSQL,工作区文件则放在每个 Agent 的独立沙箱中。沙箱可使用自托管 Docker,也可使用 E2B、Daytona 或 Tenki。用户可通过 CLI、Web UI,以及 Telegram、Discord 和 Slack 等渠道与 Agent 交互;部署需要自行配置数据库、网关和模型提供方。

管理员先用 hermit setup 配置数据库连接和 Gateway 凭据,再通过 hermit agents create、start 等命令建立并运行 Agent。Agent 将会话事件、记忆、说明、技能、MCP 服务器、密钥和计划任务等数据保存在按 agent_id 作用域管理的 PostgreSQL 状态中,并在自己的沙箱工作区执行代码。Gateway 提供 /api/agents/{agentId} 会话接口,支持同步请求、SSE、WebSocket RPC、审批和检查点;渠道适配器将消息转入对应 Agent。管理员可以通过 CLI 或管理 UI 推送指令、启用技能和 MCP 服务器、配置计划任务并查看运行状态;Agent 的回复会通过 CLI、Web UI 或已启用的渠道返回。

  1. 需要为多个团队或客户分别部署 Agent,并集中维护其会话状态、密钥和配置的内部平台团队。
  2. 希望把定期摘要或其他定时任务交给 Agent,并通过 cron 计划管理运行记录的运营团队。
  3. 需要让用户从 Telegram、Discord 或 Slack 与同一平台上的 Agent 交互的产品团队。
  4. 希望在隔离的每 Agent 工作区中运行代码,并选择自托管 Docker 或 E2B、Daytona、Tenki 沙箱的工程团队。
  5. 需要为会话提供持久化网页研究流程、人工审阅计划、带证据引用的报告,并能暂停后恢复的研究团队。

如何安装或部署这个 Agent?

需要安装 Node.js/npm,并准备 PostgreSQL、Gateway 凭据和可用的模型提供方配置。可以全局安装 npm 包:

npm install -g openhermit

也可以从源码安装:

git clone https://github.com/HCF-S/openhermit.git
cd openhermit
npm install

选择 Docker、E2B、Daytona 或 Tenki 作为沙箱后端时,还需按所选后端配置其运行环境。README 未指定 Node.js 版本。

如何使用这个 Agent?

先配置 DATABASE_URL、GATEWAY_ADMIN_TOKEN 和 GATEWAY_JWT_SECRET,再启动 Gateway 和 Web 应用并创建 Agent:

hermit setup
hermit gateway start
hermit web start
hermit status
hermit doctor
hermit agents create main
hermit agents start main
hermit chat --agent main

Gateway 默认地址为 http://127.0.0.1:4000,管理 UI 位于 /admin/;面向用户的 Web 应用默认运行在 http://127.0.0.1:4310。模型提供方需要在配置中设置,并通过 hermit config secrets set 提供相应密钥;例如:

hermit config set model.provider openai
hermit config set model.model gpt-5-mini
hermit config secrets set OPENAI_API_KEY sk-...

客户端可向 POST /api/agents/{id}/sessions 创建会话,再向 /api/agents/{id}/sessions/{sessionId}/messages 发送消息;也可使用 ?stream=true 获取流式响应或连接该 Agent 的 WebSocket RPC。

这个 Agent 有哪些优点和局限?

优点
  • 把会话、记忆、指令、技能、MCP、计划任务和密钥集中存入 PostgreSQL,便于按 Agent 管理并执行全体推送。
  • 每个 Agent 可使用隔离沙箱,支持自托管 Docker 及 E2B、Daytona、Tenki 后端。
  • 提供 Telegram、Discord、Slack 适配器,并支持 CLI、Web UI、HTTP/SSE 和 WebSocket 交互。
  • 计划任务支持超时、并发策略、错误退避;Deep Research 运行可持久化、暂停并恢复,研究结果附带证据摘录引用。
局限
  • 自托管部署需要配置 PostgreSQL、Gateway 认证密钥、模型提供方,并维护运行中的服务。
  • Deep Research 会产生大量模型调用和输入 token;README 给出最坏情况预算,免费模型额度通常不足。
  • Deep Research 目前只支持 HTML/文本网页来源;PDF、不支持上传文件或 MCP 作为研究来源,非正常重启后需手动恢复。
  • README 没有说明 Node.js 的最低版本;E2B、Daytona 等云沙箱还需要各自的提供方配置。

这个 Agent 与同类方案有什么区别?

README 将 OpenHermit 与 Claude Code、OpenClaw、Hermes 等以文件保存状态的 CLI Agent 作了对比:OpenHermit 把内部状态集中放在 PostgreSQL,并提供多 Agent 的集中运维;这些工具的具体功能和迁移路径未作比较。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
OpenHermit Agent 运行平台 当前 54 · 缺口较多 命令行工具免费 + 模型费 ★ 90 3 天前 TypeScript —
Dorothy 智能体工作台 48 · 缺口较多 桌面应用免费 + 模型费 ★ 357 16 天前 TypeScript Claude Code
SuperAgentX 工作流框架 43 · 缺口较多 代码库 / SDK免费 + 模型费 ★ 207 4 个月前 Python OpenAI API
OpenClaw 汉化发行版 53 · 缺口较多 命令行工具免费 + 模型费 ★ 3.8k 今天 JavaScript OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
54/ 100 五分制 2.7 / 5
信任安全 14/29
可靠稳定 8/14
适用触发 10/18
规范维护 10/18
有效结果 9/13
证据核验 3/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

least_privilege:文档明确区分 host/docker/e2b/daytona/tenki 沙箱,host 后端被标注为仅限 devops 特权代理并须配合 private 访问,角色与策略分层清晰,但默认策略仍需操作者自行收紧,故扣分。user_confirmation:策略与审批章节给出 allow/deny/require_approval 三态、最严格优先、审批超时视为拒绝,证据充分。data_flow_transparency:README 与 Internal State 表说明状态存于 PostgreSQL、密钥加密、附件存储后端与凭据走环境变量,透明度较好。sensitive_data_handling:AES-256-GCM 加密 agent_secrets 与渠道凭据、凭据不入 config,但缺少密钥轮换与审计细节,扣分。dependency_security:仅见 package.json 顶层依赖,未见锁文件审计、漏洞扫描或 SBOM,证据薄弱。external_effects:存在 exec、MCP、渠道外发等外部副作用,虽有策略层但默认未强制审批,扣分。rollback:有 checkpoint 路由与沙箱软删除,但软删除不回收 e2b/daytona 远端资源,回滚语义不完整。source_attribution:README 指向 Amiko 与仓库,但发布者身份未经验证,且 FAQ 称许可证“operator-known”与 MIT 声明不一致,扣分。

可靠稳定8 / 14 · 2.9/5

self_consistency:README、SKILL.md、manual 对 CLI 命令、环境变量、状态模型的描述基本一致,但 FAQ 中“许可证由操作者知晓”与 LICENSE 冲突,且 skill 中 exec 后端列表(docker/host/e2b)与 sandbox 文档(五种)不一致,扣分。dependency_availability:依赖 Node>=20、PostgreSQL、模型 API key、可选 E2B/Daytona/Tenki/S3/Supabase SDK,安装说明清楚,但未提供锁文件或版本固定证据,扣分。failure_messages:troubleshooting 章节按症状给出排查步骤,代码中 CLI/gateway 有错误捕获与退出码,doctor 命令存在,证据较好但未覆盖全部失败路径。

适用触发10 / 18 · 2.8/5

audience_and_scenarios:区分管理员(openhermit-admin)与终端用户(openhermit-guide)两类技能,manual 覆盖快速上手到运维,场景清晰。capability_boundaries:技能描述明确指向各自范围并互相引用,工具表列出默认授权角色,边界清楚。trigger_precision:技能 description 为单句触发描述,但 skill-creator 自身示例与规则较泛,触发精度依赖模型判断,扣分。environment_fit:支持本地、Docker、云沙箱、多模型提供商与本地 Ollama,环境适配面广。

规范维护10 / 18 · 2.8/5

information_architecture:README 结构完整,docs/ 与 manual 分章编号,导航清晰。install_notes:npm 全局安装、setup 向导、docker compose 起 Postgres、环境变量表齐全。naming_stability:仓库名在 README 中为 HCF-S/openhermit,而技能文件写 HCF-STUDIOS/openhermit,命名不一致,扣分。examples_and_faq:有 Quick Start、CLI 参考、FAQ、troubleshooting 与配方示例,覆盖充分。known_limitations:Deep Research 明确列出 PDF 不支持、仅网页源、重启后需手动恢复等限制,host 后端风险也有警示。license:LICENSE 为 MIT,package.json 声明 MIT,一致。versioning_changelog:monorepo 版本为 0.0.0,未见 CHANGELOG 或发布版本策略,扣分。maintenance_responsibility:README 指向 Amiko 与贡献指南,但发布者未经验证,维护责任归属不明确,扣分。

有效结果9 / 13 · 3.5/5

output_usability:CLI、API、Web UI、渠道适配器齐备,输出可直接用于部署与运维。marginal_value:解决多代理集中状态与沙箱执行的运维痛点,相对文件式代理有明确增量价值。cost_benefit:Deep Research 章节给出按深度的 token 与费用上限表及本地模型方案,成本可预估,但整体部署需 Postgres 与模型费用,扣分有限。

证据核验3 / 8 · 1.9/5

claim_traceability:README 声明多可追溯到 docs/ 与源码文件,但部分性能与成本数字未标注测量方法。cross_source_corroboration:README、SKILL.md、manual 多处互相印证,但仓库名与许可证表述存在不一致,扣分。fact_inference_separation:文档大体区分设计与现状,但“verified registry ids”等表述缺乏可复核来源,扣分。

风险与缓解建议
  • 发布者身份未经验证,仓库名在 README(HCF-S)与技能文件(HCF-STUDIOS)之间不一致,部署前应核实来源。
  • host 沙箱后端提供对网关主机的无隔离 shell 访问,必须配合 private 访问与严格策略,切勿用于通用代理。
  • 默认策略不会自动要求审批 exec 或 MCP 调用,需操作者显式配置 require_approval 与 deny 规则。
  • 沙箱软删除不会回收 e2b/daytona 远端资源,需手动清理以避免持续计费。
  • Deep Research 为模型密集型流程,单次提取可达约 5 万输入 token,免费额度通常不足,需预算与付费密钥。
  • FAQ 称许可证“由操作者知晓”,与 MIT 声明不一致,合规使用前应确认许可条款。
  • 未见锁文件审计、依赖漏洞扫描或 SBOM,生产部署前应自行做依赖安全审查。
证据充分度:低 评估于 2026年11月7日 审查版本 c48bc7e2b4a5
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/openhermit.svg?lang=zh)](https://followagents.com/zh/agents/openhermit)
<a href="https://followagents.com/zh/agents/openhermit"><img src="https://followagents.com/badge/openhermit.svg?lang=zh" alt="FARS 评测"></a>

常见问题

运行 OpenHermit 需要哪些基础设施?
快速开始要求配置 DATABASE_URL、GATEWAY_ADMIN_TOKEN 和 GATEWAY_JWT_SECRET,并启动 Gateway;还需要配置模型提供方。Agent 工作区需要 Docker 或受支持的云沙箱后端。
使用 Deep Research 会产生多少模型费用?
费用取决于深度和模型。README 列出的最坏情况示例从 quick 使用 gpt-5-mini 的约 $0.14 到 thorough 使用 claude-sonnet-4-5 的约 $4.50,搜索费用另计。
密钥如何保存?
数据库中的 Agent 密钥和渠道凭据使用 OPENHERMIT_SECRETS_KEY 通过 AES-256-GCM 加密。没有该密钥时,Gateway 会为本地开发密钥回退到每 Agent 的 secrets.json,但数据库渠道凭据不可用。
Agent 可以通过哪些方式接收消息?
README 列出 CLI、Web UI 和 Telegram、Discord、Slack 适配器;Signal、WeChat、WhatsApp 适配器需通过包安装。
Deep Research 能否从 PDF 或上传文件中查证信息?
目前不能。Deep Research 使用网页 HTML/文本来源;PDF 会被标记为不支持,上传文件和 MCP 来源也尚未支持。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。