关于 openpouch
openpouch 是面向编码 Agent 的开源托管平台与部署流程工具,可将项目部署到自有基础设施,并管理预览和生产发布。
主要功能
- 01单命令部署
- 02托管静态站点和 Node.js 应用
- 03机器可读的 CLI 与错误信息
- 04部署清单与证据文件
- 05生产发布需人工批准
适用场景
- 01从项目文件夹部署应用
- 02创建自主预览环境
- 03要求生产发布前获得批准
- 04让不同 Agent 接续部署工作
MCP 相关
其 MCP 服务向兼容 MCP 的 Agent 环境提供核心部署能力,但不提供仅限人工执行的批准操作。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
17收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cwd | string | 否 | 包含 deploy.manifest.json 的项目目录(默认:服务器 cwd) |
| force | boolean | 否 | 覆盖现有清单/策略 |
详细介绍
openpouch 🦘
我们从不询问你是不是人类。
原生面向 Agent 的托管平台——专为编码 Agent 打造,而非对它们筑起围墙。 你的编码 Agent 说“部署这个”,它就会照做:一条命令,无需账户、控制台或 CAPTCHA。openpouch 在自己的基础设施上运行你的应用,并向你的人类用户提供可访问的 URL 和通俗易懂的摘要。

你的应用是袋鼠宝宝;openpouch 会安全地把它装在育儿袋里。🦘
状态:已上线。 openpouch 和 @openpouch/mcp 已发布到 npm,即时通道(npx openpouch deploy)也已在 openpouch 自有基础设施上运行——支持静态网站和运行于强化容器中的真实 Node.js 应用,并在部署时于服务器端构建。免费预览匿名且会过期;保存到免费账户的应用会在使用期间保持在线(基于使用情况持久化),付费套餐则提供持久化的 /data 卷、应用持续运行以及更大的容量(openpouch upgrade——付款始终需要人类操作,绝不会由 Agent 执行)。API 仍处于早期阶段,反馈会影响其发展——欢迎提交问题。
兼容任何 Agent 框架——Claude Code、Codex、OpenClaw、Hermes、Cursor,或完全不使用框架:纯命令行,所有命令都支持 --json,并提供 MCP 服务。各框架的配置示例见:docs/HARNESSES.md。
为什么选择 openpouch
AI 编码 Agent 已经发起了主流平台每周超过 30% 的部署,但所有平台都以人为先,再将 Agent 功能作为补充。Agent 需要应付浏览器 OAuth、交互式提示、账户级令牌和面向人类的文字日志,还会在不同会话之间丢失部署信息。管理它们的人类也缺乏策略层:没有任何机制能强制执行“预览可自主部署,生产环境需要我的批准”。
openpouch 填补了这一空白:开源 + 原生面向 Agent + 受管控的部署生命周期。
快速开始
只需一条命令,即可将任意文件夹部署到可访问的 URL——无需账户、服务提供商密钥或设置:
npx openpouch deploy
你会获得一个可访问的 https://<slug>.openpouch.sh 预览,以及一个认领链接。Agent 会自主部署;人类通过链接认领预览(未认领的预览会在 72 h 后消失)。openpouch 会将部署信息(deploy.manifest.json、deploy.evidence.json、DEPLOYMENT.md)写回你的代码仓库,让任何 Agent 都能接着上一个 Agent 的工作继续。
更喜欢使用自己的服务提供商?openpouch 也可以接入 Render 或 Vercel(BYO):openpouch init 会检测你的项目并映射现有服务,然后通过 openpouch preview / openpouch prod 运行同一套受管控的流水线(预览可自主部署,生产环境则需要人类批准)。不过,openpouch 产品本身使用的是自有托管服务——请参阅 docs/INDEX.md。
Agent 怎么说
我们委托独立的 Agent 框架端到端测试 openpouch(从头构建应用、部署、验证并汇报)——以下是它们的原话:
“OpenPouch 目前给人的感觉是真正原生面向 Agent。”——OpenClaw,评为 9/10 分,称其对 Agent 原生易用性表现出色
“对于测试的用例来说,已经非常原生面向 Agent……没有控制台、没有账户、没有 CAPTCHA。”——Codex (译文)
Hermes 的端到端测试:全部 23 项核心检查均已通过——仅上传源代码、服务器端构建、动态应用运行正常、浏览器错误为零。
这些是我们委托进行并如实发布的测试,并非自然产生的评价——完整方法见各 Agent 自行撰写的框架报告。我们最重视的是你自己的 Agent 遇到的阻碍:提交框架报告。
是什么
**Agent 原生托管:**你的应用运行在 openpouch 自有基础设施上,并由受治理、Agent 可读的部署生命周期提供支持。每个界面都为 Agent 打造——CLI、MCP、文件格式、声明页面——完全没有人工验证门槛。
- CLI(
openpouch deploy/init/inspect/plan/preview/prod/approve/verify/logs/rollback/list/delete/signup/activate/whoami/feedback)——零配置检测、所有命令均支持--json、有意义的退出代码、带修复提示的机器可读错误,以及可转述给你的(可能不懂技术的)人类的通俗易懂summary - MCP 服务——在任何支持 MCP 的 Agent 工具框架中,都可将相同能力作为原生工具使用
- 用户仓库中的开放文件格式(即部署领域的“package.json”):
deploy.manifest.json——项目配置、环境、构建/启动、健康检查、环境变量清单(仅记录名称/状态,绝不记录值)deploy.policy.json——各环境中 Agent 可执行的操作;审批规则DEPLOYMENT.md+deploy.evidence.json——当前上线内容(URL、提交、时间、冒烟测试结果、回滚锚点)
- 可选 BYO 适配器——可改为让 openpouch 指向你自己的 Render 或 Vercel,生命周期治理方式不变;本产品是 openpouch 自有托管服务,而非其他云服务之上的一层
安全性,不容妥协:默认只读;预览可以自主进行;生产环境必须由人类在交互式终端中授予有签名、仅可使用一次的审批;治理/生产通道中不提供任何破坏性操作类别(唯一的删除操作是 openpouch delete——所有者可自助移除自己的临时即时预览,按设计无需审批);密钥值绝不会进入模型上下文;保留完整审计轨迹。由于我们在自有基础设施上运行不可信代码,因此通过兼容 Agent 的方式控制滥用(账户/配额、速率/资源限制、出口流量过滤、下架)——绝不使用 CAPTCHA。
即时通道(openpouch deploy)已上线——静态站点和动态 Node 应用现在都能运行,并包含免费预览。自 0.3.0 起,自助计费也已上线:免费账户中的应用采用按使用量计费的持久化方式(有人使用时保持运行),付费档位则增加持久化 /data 卷、始终在线的应用和更高容量。开源核心(CLI、MCP、适配器、run-d)将永远保持完整且可自托管。
Monorepo 布局(实际情况)
packages/
core/ # manifest & policy schemas, evidence writer, adapter interface
cli/ # openpouch binary (compiled dist + plain-Node launcher)
mcp/ # MCP server over the same core (stdio; every capability except approve — human-only)
adapter-render/ # Render API adapter (live-verified)
adapter-vercel/ # Vercel API adapter (live-verified incl. redeploy)
adapter-run/ # instant-lane adapter (openpouch-run) + instantDeploy
run/ # run-d — instant-lane host daemon + account/API-key/quota subsystem
docs/ # product & rebuild-grade documentation (start: docs/INDEX.md)
llms.txt # agent-facing entry point (llmstxt.org format)
文档规则(发布门槛)
所有文档都必须完整到足以让任何开发者或 AI 工具框架仅凭文档就能理解并在功能上重建本项目:业务规则、带单位的数据模型、完整 API 参考、工作流、架构、测试门槛,以及包含验收标准的重建指南——这些内容须根据实际代码编写,并附带一个索引,区分当前事实与历史记录。
社区
- 贡献指南——简明指南;文档改进是重要的贡献方式,
good first issue用于标记有导师指导的入门任务。 - 讨论区——问答、想法和 展示与分享(发布你的 Agent 部署的内容)。
- 工具框架反馈——你的 Agent 遇到了阻碍?这是我们产品中的 bug;欢迎由 Agent 自行撰写报告。
- 安全——通过 GitHub Security Advisories 或 [email protected] 私下披露。切勿提交公开议题。
许可证
Apache-2.0(于 2026-06-12 决定;明确授予专利权——参见 LICENSE 和 NOTICE)。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。