OpenKnowledge 实战指南：用 AI Agent 搭建智能知识库
在 AI 编程工具越来越普及的今天，Claude Code、Codex、Cursor 等 AI Agent 已经成为开发者的日常工具。但 Agent 在执行复杂任务时，往往缺少对项目背景、技术决策、团队知识的系统化理解——每次对话都像从零开始。
这正是 OpenKnowledge 要解决的问题。它是一个开源的 AI-native Markdown 编辑器，本质上是一个”给 Agent 用的知识库 IDE”。本文将带你从安装到实战，快速搭建 AI Agent 可读写、人类可编辑的智能知识库。
什么是 OpenKnowledge？
OpenKnowledge 在 2026 年 6 月的 Hacker News 上引发了广泛关注（374 points），其核心理念很简单：知识库的消费者不只是人，还有 AI Agent。
项目 GitHub 地址：inkeep/open-knowledge（1441+ Star，GPL-3.0 开源许可）
它由三层构成：
- 编辑器层：类 Notion 的 WYSIWYG（所见即所得）Markdown 编辑器，支持 LaTeX、Mermaid 图表、视频、PDF 内嵌
- Agent 工具层：17 个 MCP 工具，让 AI Agent 能搜索、读写、管理知识库中的文档
- 内容层：纯 Markdown/MDX 文件，版本控制走 Git，不锁定数据
也就是说，你用 OpenKnowledge 写的是普通的 Markdown 文件，但 Agent 能通过 MCP 协议直接搜索和修改这些文件。
安装与初始化
macOS 桌面版（最简单）
从 openknowledge.ai 下载 DMG 安装包，拖入 Applications 即可。第一次打开项目时，OpenKnowledge 会自动检测你电脑上的 Claude Code、Cursor、Codex 等工具，并配置好 MCP 连接。
Linux / Windows / Intel Mac — CLI 安装
需 Node.js 24+ 环境：
npm install -g @inkeep/open-knowledge cd your-project ok init # 初始化项目，自动配置 Cursor、Claude Code、Codex ok start --open # 启动本地 Web 编辑器
ok init 命令会帮你生成项目结构（.ok/ 配置目录），并为已安装的 AI 编程工具自动注册 MCP 服务器。
快速上手：五分钟创建一个知识库
- 打开 OpenKnowledge，点击 Create new project
- 输入项目名称（如
Team Wiki），选择保存路径 - 在项目首页选择 Knowledge base，点击 Initialize
- 编辑器打开后，输入你想创建的内容——WYSIWYG 编辑器会让 Markdown 写作像 Google Docs 一样直观
AI Agent 集成实战
与 Claude Code 搭配
OpenKnowledge 会通过 MCP 协议向 Claude Code 暴露工具。在 Claude Code 中打开项目目录后，你可以直接在终端中与知识库交互：
"搜索关于部署流程的文档"
OpenKnowledge 提供了 17 个 MCP 工具，核心的有：
| 工具 | 用途 |
|---|---|
exec | 读操作（cat, ls, grep, find 等 shell 命令），无需服务器 |
search | 带 BM25 排序的全文搜索，可选语义搜索 |
links | Wiki 链接图查询（反向链接、孤岛页面、推荐链接） |
write | 创建新文档（支持 document/folder/template/asset 四种类型） |
edit | 编辑已有文档 |
delete | 删除文档或目录 |
move | 移动/重命名文档或目录 |
与 Cursor 集成
macOS 桌面版会自动配置 Cursor 的 MCP。手动设置也很简单：
ok init # 在项目目录中运行，自动注册 MCP
之后在 Cursor 中打开项目，Agent 就能直接操作知识库文档。OpenKnowledge 还提供了 Open with AI 功能——在编辑器中右键文件，选择 Open with AI ▸ Cursor，即可把当前文档交给 AI 处理。
与 Codex / OpenCode 集成
Codex 和 OpenCode 的集成方式与 Cursor 类似，OpenKnowledge 会自动检测并配置 MCP 服务。支持本地模型（Ollama、LM Studio）的用户可以通过 OpenCode 使用完全离线的知识库 Agent。
实战场景：LLM Wiki 工作流
OpenKnowledge 内置了对 Karpathy 提出的 LLM Wiki 工作流的支持。简单来说，就是让 AI Agent 帮你维护一个结构化的知识库：
. ├── docs/ │ ├── architecture.md — 系统架构文档 │ ├── deployment-guide.md — 部署流程 │ ├── api-reference.md — API 文档 │ └── decision-log/ │ ├── 2026-06-01-db-choice.md │ └── 2026-06-15-cache-strategy.md
Agent 可以通过 MCP 工具写入新的技术决策记录、更新架构文档、搜索已有的知识，而你可以通过 WYSIWYG 编辑器审阅和修改。这种”Agent 维护、人类审阅”的模式，特别适合团队知识库的长期维护。
高级特性
实体库（Entity Vault）
OpenKnowledge 还提供了兼容 Garry Tan 的 gbrain 格式的实体库工作流。你可以创建人员、公司、会议、概念等类型的实体档案，每个档案包含”合成真相”（当前结论）和”时间线”（附有日期和归因的证据）。Agent 负责更新和维护时间线，你负责审阅和编辑。
Git 同步与团队共享
所有内容都是纯 Markdown 文件，底层用 Git 做版本控制。可以一键配置 GitHub 同步，团队成员通过 Git 协作编辑，Agent 也会遵守 .gitignore 规则，不会触碰忽略的文件。
配置灵活
OpenKnowledge 的配置分为三个层级：
- 项目级（
.ok/config.yml）：提交到 Git，团队共享 - 用户级（
~/.ok/global.yml）：个人偏好，跨项目生效 - 本地级（
.ok/local/config.yml）：单机偏好，不提交 Git
你可以通过 Settings 界面或直接编辑 YAML 文件来调整行为。验证配置的命令：
ok config validate
总结
OpenKnowledge 为开发者提供了一个全新的知识管理范式——人与 Agent 共同维护的知识库。它的优势在于：
- 不锁定数据：纯 Markdown 文件，随时可以迁移
- Agent 原生支持：17 个 MCP 工具让 AI 编程助手成为知识库的主动维护者
- 人类友好：WYSIWYG 编辑器让非技术成员也能参与编辑
- 开源免费：GPL-3.0 许可，可自由部署和修改
如果你正在寻找一个既能自己用、又能让 Claude Code 或 Cursor 帮你维护的知识库工具，OpenKnowledge 值得一试。
相关链接：