opengap

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

开源 🏷️定价信息待确认 ✅ 目前可打开 智能体 🍴 复刻 354 🐛 待处理 30 👀 关注 18
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 2985
维护状态 低维护
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

opengap 项目界面预览图
图片来源:项目官网

项目数据

分类智能体
开发团队open-gitagent
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型agent,agent-framework,agent-skills,agents,assistant,claude-code,gitagent,open-standard,openclaw,skills
GitHub 星标★ 2985
上线时间2026-02-24 00:00:00
代码更新2026-07-02
仓库体积24.5 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2985

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

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

环境要求

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

安装与启动步骤

  1. 1安装全局 CLI

    用 npm 全局安装 opengap 的官方 CLI 包,安装后同时提供 gitagent 别名命令。

    npm i -g @open-gitagent/opengap
  2. 2创建智能体定义

    在任意 Git 仓库根目录放入 agent.yaml 与 SOUL.md,仓库即成为框架无关的智能体定义。

  3. 3编写核心清单

    在 agent.yaml 中声明 name、version、model、skills、tools、compliance 等核心身份信息。

  4. 4用适配器运行

    把智能体目录传给 run 子命令,用 --adapter 指定目标框架,例如 lyzr。

    opengap run ./my-agent --adapter lyzr
  5. 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

上一篇:MiroFlow

下一篇:Vibe-Skills

同类项目推荐

memex 开源

让 AI 编程代理拥有跨会话的长期记忆,无需数据库,纯 Markdown + Git 同步。

Zettelkasten-based persistent memory for AI coding agents. Works with Claude Code, C···

★ 144 2026-08-09
deep-researcher-agent 开源

接上企业数据,让 AI 自动做深度调研出结论

The NVIDIA Deep Researcher Agent Blueprint is an open reference example for building···

★ 925 2026-10-12
wx-assist 开源

本地微信 AI 助手,群聊摘要、关键词提醒、语义搜聊天

「摘星」· 微信助手 — AI Agent 智能助手 / AI 群聊摘要 / 关键词即时提醒 / 公众号摘要···

★ 140 2026-10-15
openmcp-client 开源

在 VS Code 里一站式开发、调试和测试 MCP 服务器,省去切换工具的麻烦。

All in one vscode plugin for mcp developer

★ 750 2026-08-09
n8n-claw 开源

用 n8n 可视化搭建自主 AI 代理,一个脚本搞定部署

OpenClaw-inspired autonomous AI agent built entirely in n8n. Adaptive RAG-powered me···

★ 562 2026-08-09
AgentDock 开源

拖拽编排 AI 代理,快速从原型到生产部署

Framework retired. Prompts and document generators moved to AgentDock/prompt-library···

★ 1774 2026-08-09
claudette 开源

给 Claude Code 配上好帮手,桌面端轻松编排智能体

Claude's missing better half — a companion tool for Claude Code usage.

★ 87 2026-08-09
LocalAGI 开源

本地跑自主AI,隐私安全不花钱

LocalAGI:Locally run AGI powered by LLaMA, ChatGLM and more. | 基于 ChatGLM, LLaMA···

★ 81 2026-08-09
moltis 开源

一个二进制文件,自托管安全智能体,支持多平台和多模型。

A secure persistent personal agent server in Rust. One binary, sandboxed execution, ···

★ 2952 2026-08-09