opengap

用 Git 标准定义 AI 智能体，跨框架复用，告别锁定。

opengap 是一个框架无关、基于 Git 的开放标准，用于定义和共享 AI 智能体。它解决了当前 AI 智能体开发中缺乏统一规范、难以跨框架复用和协作的问题。其核心能力包括：通过 Git 仓库作为智能体的单一事实来源，实现版本控制和协作；提供标准化的智能体定义格式，支持技能、工具和配置的声明式描述；与主流智能体框架（如 Claude Code、OpenClaw 等）兼容，可无缝集成。该项目旨在成为 AI 智能体的“开放协议”，降低开发门槛，促进生态互通。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2955

维护状态维护中

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队open-gitagent

所属国家

官网地址https://gitagent.sh

GitHubhttps://github.com/open-gitagent/opengap

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent,agent-framework,agent-skills,agents,assistant,claude-code,gitagent,open-standard,openclaw,skills

GitHub 星标★ 2955

30天Star增速

HF 下载量

上线时间2026-02-24 00:00:00

最近更新2026-09-22 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

已安装 Node.js 与 npm（README 使用 npm 全局安装）
已安装 Git，并有一个可用于存放智能体定义的 Git 仓库
可选：目标适配器对应的框架环境（README 示例中为 lyzr、claude）

安装与启动步骤

1安装全局 CLI

用 npm 全局安装 opengap 的官方 CLI 包，安装后同时提供 gitagent 别名命令。
```
npm i -g @open-gitagent/opengap
```
2创建智能体定义

在任意 Git 仓库根目录放入 agent.yaml 与 SOUL.md，仓库即成为框架无关的智能体定义。
3编写核心清单

在 agent.yaml 中声明 name、version、model、skills、tools、compliance 等核心身份信息。
4用适配器运行

把智能体目录传给 run 子命令，用 --adapter 指定目标框架，例如 lyzr。
```
opengap run ./my-agent --adapter lyzr
```
5指定工作区运行

用 --dir 指向智能体定义，--workspace 指向被操作的代码仓库，-p 传入提示词。
```
opengap run --dir ./agents/reviewer --workspace ~/code/my-app --adapter claude -p "Review this repository"
```

关键配置

配置项	必填	说明	示例
`agent.yaml`	是	智能体清单文件，定义核心身份与能力，缺失则不是合法智能体定义	`agent.yaml`
`name`	是	agent.yaml 中的智能体名称字段	`reviewer`
`version`	否	agent.yaml 中的版本号字段，配合 Git 做版本管理	`1.0.0`
`model`	否	agent.yaml 中声明所使用的模型	`claude-sonnet`
`skills / tools`	否	声明智能体可用的技能与工具	`skills: [review]`
`compliance`	否	合规声明字段，README 提到支持 FINRA、SEC 等合规要求	`compliance: [SEC]`

如何确认成功

执行 opengap run 后若命令正常返回并输出智能体执行结果、无报错，即表示运行成功。

常见问题

Q：opengap 和 gitagent 是同一个命令吗？

A：是。CLI 包现名为 @open-gitagent/opengap，安装时会同时装上一个向后兼容的 gitagent 别名命令，功能一致。

Q：包名以前叫什么？

A：早期为 @open-gitagent/gitagent，随后是 @open-gitagent/gapman，现在为 @open-gitagent/opengap。

Q：怎么在不同框架之间复用同一个智能体？

A：智能体定义是框架无关的，运行或导出时用 --adapter 指定目标框架即可，README 示例使用了 lyzr 和 claude。

Q：智能体定义必须放在哪个目录？

A：README 未限制目录，只要目录内包含 agent.yaml 等定义文件，通过 opengap run 的路径参数指向它即可。

注意事项

agent.yaml 是必需的核心身份文件，README 标注为 required。
可用 git 分支 dev → staging → main 逐环境推进智能体变更，像发布软件一样管理。
README 未给出端口、环境变量或密钥配置，请勿自行添加。

核心亮点

框架无关，一套标准适配多种智能体框架，避免厂商锁定
基于 Git 原生工作流，天然支持版本控制、分支和协作
声明式定义技能和工具，降低智能体配置复杂度

不足之处

项目处于成长早期，生态和工具链尚不完善
文档和社区支持待观察

适用场景

团队需要跨框架共享和复用 AI 智能体配置
希望将智能体定义纳入 Git 版本控制流程
构建可组合、可扩展的智能体技能库

替代项目

Agent Protocol、OpenAI Agents SDK、LangChain

项目介绍

opengap 是智能体领域的开源项目，由 open-gitagent 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,955）位列前 30%，在智能体分类的 2,517 个项目里位列前 14%。

近 42 天，它的 GitHub 星标从 2,908 增加到 2,955，净增 47。

项目仍在小幅维护中，最近一次代码更新于 2026-09-22。从国内网络环境看，访问稳定性一般，建议自备网络条件。

它主要面向的使用场景是：团队需要跨框架共享和复用AI智能体配置。同类可对比的替代方案包括 Agent Protocol、OpenAI Agents SDK、LangChain。

上一篇：MiroFlow

下一篇：Vibe-Skills