inkeep/open-knowledge · 上手攻略

  • 仓库：inkeep/open-knowledge
  • 链接：https://github.com/inkeep/open-knowledge
  • 分类：生产力工具 · AI 辅助写作 · 知识库
  • 作者：Tom
  • 更新：2026-07-17

是什么

OpenKnowledge（内部包名 @inkeep/open-knowledge）是一个 AI 原生的 Markdown 编辑器，同时也是一个 LLM Wiki 工具。它的定位是"Notion meets VS Code"——既有 Notion 般的 WYSIWYG（所见即所得）编辑体验，又保留 VS Code 式的本地文件夹操作和 Markdown 文件本质。

它有三个核心层次：

层次 说明
Editor WYSIWYG Markdown 编辑器，支持 Mermaid、LaTeX、视频、PDF 嵌入，交互式 HTML/JS
Agent Tools MCP server、skills，改善 AI agent 对知识库的搜索、发现、撰写能力
Content 底层为纯 Markdown / MDX 文件，版本控制走 git

当前最新版本为 v0.32.0（stable），发布于 2026 年中。

解决什么问题

  1. Markdown 写作体验差：传统 Markdown 编辑器需要预览切换，OpenKnowledge 实现真正的 WYSIWYG，写即所得。
  2. AI 与本地知识库割裂：大多数笔记工具无法让 AI agent 高效地搜索和编辑你的笔记。OpenKnowledge 通过内置 MCP 和 skills，让 Claude、Codex、Cursor 等 agent 直接读写你的知识库。
  3. 团队知识共享难：通过 git/GitHub 实现无需注册的团队同步（no-code sharing）。
  4. 知识碎片化：内置 wiki link 图谱、会议记录摄入（Granola、Fireflies）等，专门服务于"第二大脑"场景。

快速安装

macOS（推荐桌面 App）

直接下载最新稳定版 DMG：

open https://github.com/inkeep/open-knowledge/releases/latest
# 下载 .dmg 文件，挂载后将 OpenKnowledge 拖入 Applications 即可

Linux / Windows / Intel Mac（CLI + Web UI）

需要 Node.js 24+ 和 git：

npm install -g @inkeep/open-knowledge

# 进入目标项目目录，初始化配置
cd your-project
ok init   # 脚手架，检测并连接你机器上的 AI 编辑器
ok start --open   # 启动 Web 编辑器并自动打开浏览器

ok init 会自动检测你机器上安装的 Claude Code、Claude Desktop、Cursor、Codex、OpenCode、OpenClaw 等工具，并引导配置对应的 MCP 连接。

更新

npm install -g @inkeep/open-knowledge   # 全局包更新

桌面 App 用户：在 App 内 Help → Check for Updates，或等待每小时自动检查（约延迟最多 1 小时）。

核心用法

基本编辑

打开任意包含 Markdown 文件的文件夹即可开始编辑，不需要特殊导入。支持的 Markdown 扩展包括：

  • Mermaid 图表（```mermaid）
  • LaTeX 数学公式
  • 嵌入视频 / PDF
  • 交互式 HTML 组件
  • Wiki link [[文档名]]（自动生成反向链接图谱）

AI 问答（Ask AI）

编辑器内置"Ask AI"功能，可针对当前项目知识库向 AI 提问。支持的 agent harness 列表（来源：openknowledge.ai/docs）包括：

Claude · Cursor · Codex · OpenCode · OpenClaw · Pi · Antigravity

团队同步（Git/GitHub）

开启方式（Settings → 勾选 Git Sync），底层走 git/GitHub，无需注册任何平台账号。适合团队内通过 branch / pull request 协作维护文档。

编辑器内建图谱视图（graph view），展示文档间的 [[wiki-link]] 关系，可视化知识结构。

会议记录摄入

支持从 Granola、Fireflies 等会议记录工具自动摄入记录，注入为 Markdown 文件。可通过 OpenClaw gateway 实现自动触发（详见 Ingest meetings 流程文档）。

快捷命令（⌘K）

桌面 App 内按 Cmd+K（macOS）打开命令面板，可快速搜索文档、切换标签页、触发 AI 操作。

典型适用场景

  • 个人知识库 / 第二大脑：用 WYSIWYG 方式写笔记，同时让 AI agent 帮你检索和整理。
  • AI Agent 记忆层：为 Claude Code、OpenClaw 等 agent 提供持久化、结构化的知识库读写能力（MCP 接口）。
  • 工程文档与 Spec 编写：支持嵌入 Mermaid、LaTeX、交互图表，适合技术规范文档。
  • 团队协作 Wiki：通过 git 分支协作，无需第三方注册，适合技术团队内共享规范和设计文档。
  • 会议记录管理：自动摄入 Granola / Fireflies 会议记录，整理为可搜索的 Markdown 存档。

坑与注意

  1. CLI 版 Node.js 版本要求高：文档明确要求 Node.js 24+（截至 2026 年 7 月，Node.js 24 仍为非 LTS 版本）。如遇启动失败，优先检查 node -v，并考虑使用 nvm 管理多版本。

bash # 检查版本 node -v # 需 >= 24.0.0

  1. 桌面 App 更新延迟：v0.32.0 变更将桌面 App 自动检查从每 5 分钟降为每小时，已开启自动更新的用户最多延迟约 1 小时收到新版通知。需要最新版时手动 Help → Check for Updates。

  2. git 为团队功能的必要依赖：没有 git 的话团队同步功能不可用。个人本地使用不受影响。

  3. 外链预览为 Opt-in：外部链接预览（hover 显示目标站点的 title、description）默认关闭，需在 Settings → This project → Link previews 手动开启，且预览请求不带任何身份凭证。

  4. CDP 安全（如果你同时用 Codex-Dream-Skin 等工具）：OpenKnowledge 本身不涉及 CDP，但如果在同一台机器上运行多个 CDP 注入类工具，需注意端口冲突和安全边界。

  5. GPL v3 许可证：基于此许可证开源，使用或分发前请确认许可证兼容性。

与同类对比

工具 定位 AI 集成深度 许可证
OpenKnowledge WYSIWYG Markdown IDE + AI Wiki MCP/Skills 原生集成，agent 可直接读写 GPL v3
Obsidian 本地笔记 + 图谱 插件生态（Community Plugins），AI 集成依赖第三方 Commercial（核心免费）
Notion 协作式文档 官方 AI 功能，与本地文件隔离 Commercial
VS Code + Markdown插件 代码友好编辑器 无原生 AI Wiki 集成 MIT
Logseq 大纲式笔记 + AI 插件生态，AI 集成较弱 AGPL

OpenKnowledge 的核心差异化在于把 Markdown 文件作为 AI agent 的一等公民——agent 可以像读写数据库一样读写你的笔记，而不是靠插件粘合。

一句话推荐结论

如果你经常在 AI Coding 工具（Claude Code、Codex、OpenClaw）和本地笔记之间切换，OpenKnowledge 是目前将两者无缝融合的最佳选择，尤其适合构建 AI Agent 的外部记忆层和团队知识库。