OpenWiki 最值得看的地方是它把 Agent 需要的上下文整理成可以持續更新的本地 wiki，對每天用 Codex、Claude Code、Hermes 或其他 coding agent 的人來說，真正麻煩的不是模型不夠聰明，而是每次開工都要重新解釋專案背景、設計理由、檔案位置和過去踩過的坑。
OpenWiki 的定位很清楚，它是一個 CLI，會替 codebase 或個人知識來源寫出 agent wiki，更精準一點說，它不是給人類慢慢翻的漂亮文件站，而是替 Agent 準備的第二大腦。
內容目錄
先講結論
OpenWiki 解決的是上下文斷裂，Code mode 會在目前 repository 產生 `openwiki/` 文件，並維護 `AGENTS.md` 和 `CLAUDE.md`，讓 coding agent 知道要先看 wiki。Personal mode 則把本地 repo、Notion、Gmail、Web Search、Hacker News、X 等來源整理成 `~/.openwiki/wiki`，比較像個人知識庫。
我會把它放在 Codex 與 GPT-5.6 合體成 AI 代理 之後的下一步，Agent 能不能做事，除了模型能力，也取決於它拿到的記憶是不是乾淨、穩定、可追溯。OpenWiki 就是在補這一層。
OpenWiki 是什麼
OpenWiki 是 LangChain 推出的 CLI，官方 README 的描述是，它會替 codebase 或 purpose memory 寫出並維護 agent wiki，也能透過內建 connectors 或 git repositories 擷取本地知識來源，再合成成本地 wiki。
它有兩種主要模式。Code mode 是針對目前程式碼倉庫，建立 repository documentation。Personal mode 是針對個人知識來源，建立本地 personal brain wiki。這兩個模式很像，但適合的工作不一樣。
| 模式 | 輸出位置 | 適合用途 | 我會怎麼用 |
|---|---|---|---|
| Code mode | `openwiki/` | 替單一 repo 建立 Agent 文件 | 每個專案都放一份，搭配 Codex 和 Claude Code |
| Personal mode | `~/.openwiki/wiki` | 整理個人知識、郵件、Notion、Web Search | 做跨專案的研究記憶與決策索引 |
它不是 Obsidian 換皮
如果只看個人知識庫，Obsidian 加 Git 加 Claude CLI 確實能做到很多事情，但 OpenWiki 真正有差異的地方是 code mode，它會跟 repository 放在一起，程式碼變動後可以更新文件，甚至透過 CI 開 PR 或 merge request，讓文件跟著專案一起走。
這和一般筆記最大不同在於責任邊界。Obsidian 很適合人類整理想法，但 coding agent 更需要可被任務流程穩定引用的專案上下文。OpenWiki 會維護 `AGENTS.md` 和 `CLAUDE.md` 裡自己的區塊，讓 Agent 進 repo 後知道要先參考 wiki，而不是每次都重新掃整個專案。
資料飛輪怎麼形成
OpenWiki 的資料飛輪可以拆成四步。
第一，把本地 repo、Notion、Gmail、Web Search、Hacker News 或 X 這些來源接進來。
第二，connector 先把 raw data 和 manifest 寫到本機。
第三，由 Agent 把來源資料整理成 wiki。
第四，下一次 Codex 或 Claude Code 做事時，先讀 wiki，再開始改 code。
這個流程可以降低「每次都從零開始理解專案」的成本，你之前如果有把 Claude Code、Codex、Hermes 放進同一個 AI 工作流，OpenWiki 就像是替這些工具加上一個共用的專案記憶層。
支援 ChatGPT login 這點很關鍵
OpenWiki 官方 README 裡有一段很重要。它支援 `openai-chatgpt` provider，可以透過 ChatGPT login 呼叫 OpenAI 的 Codex backend。也就是說，如果你有 ChatGPT Plus、Pro 或 Team 的 Codex 使用量，可以走訂閱方案裡的額度，而不是每次都用 OpenAI API token 計費。
OpenWiki 的設定方式是用 `OPENWIKI_PROVIDER=openai-chatgpt openwiki code –init` 或 `OPENWIKI_PROVIDER=openai-chatgpt openwiki personal –init` 進入 setup wizard，完成瀏覽器登入後，token 會存在 `~/.openwiki/.env`。refresh token 要當成密碼看待，不要同步到 Git，也不要放進任何公開筆記。
本地模型能不能拿來整理 wiki
個人 wiki 可能包含私密資料，全部丟給閉源模型不一定舒服，而且資料量一大，token 成本也會變成長期開銷。OpenWiki 支援 openai-compatible provider，所以理論上可以接 LiteLLM gateway、本地推理服務或任何 OpenAI 相容 endpoint。
但本地模型不是只看能不能跑。wiki 任務真正需要的是長上下文理解、文件分段、引用來源、去重、摘要穩定度和低幻覺。我的測法會很簡單：拿同一個 repo 跑 code mode，檢查它產出的模組邊界、安裝步驟、資料流、風險說明是否和實際程式一致。再拿一組故意放錯的文件，看模型會不會照抄錯誤資訊。
如果要走本地模型，我會先從 Qwen、DeepSeek 或其他長上下文模型開始，並搭配 本地大模型推理框架比較 裡提到的推理服務來測延遲和成本。若知識庫偏圖表、截圖或 PDF，再把 Docling 文件解析 這類工具放到前處理層。
資料要放同一個 wiki 還是分開
不是所有資料都應該塞進同一個知識庫。Code mode 的 wiki 應該跟 repo 綁定，保存專案架構、重要決策、開發流程、CI 和部署資訊。Personal mode 則放跨專案知識，例如研究筆記、工具比較、常用 prompt、會議記錄和文章素材。
如果全部混在一起，Agent 很容易在錯誤上下文裡找答案，比較好的做法是把 wiki 當成多個 source instance，而不是一個巨大雜物箱。OpenWiki 的 connector 設計也支援這種想法，例如可以建立不同的 Web Search source，一個追 AI research，一個追別的主題。
CI 自動更新才是重點
OpenWiki 支援把 update workflow 放進 GitHub Actions、GitLab CI 或 Bitbucket Pipelines。對我來說，這比第一次產生 wiki 更重要。因為文件真正會壞掉的地方，不是第一天沒寫，而是第三十天程式已經改了五輪，文件還停在舊狀態。
如果你的工作流已經開始讓 AI Agent 直接改程式，那文件也應該跟著 PR 更新，這可以和 讓 AI Agent 開工前先問清楚需求 放在一起看。前者讓需求更清楚，OpenWiki 則讓專案記憶更穩定。
第一次可以這樣試
安裝方式很直接。
npm install -g openwiki
針對目前 repository 建立 code wiki。
openwiki --init openwiki --update
如果要測 ChatGPT login，則用 provider 指定。
OPENWIKI_PROVIDER=openai-chatgpt openwiki code --init
如果要更新個人知識庫，用 personal mode。
openwiki personal --init openwiki personal --update
我的判斷
OpenWiki 比較像 Agent 工作流裡的基礎設施，而不是單純的筆記產品，如果你只有一個人、一個小專案，Obsidian 加 Git 可能已經夠用。但只要你開始讓多個 Agent 工具輪流碰同一個 repo，或想讓個人研究資料變成可重複使用的任務上下文，OpenWiki 就值得試。
我最看重的是 code mode、CI 更新、ChatGPT login 和 openai-compatible provider，這四個點合在一起，代表它可以同時服務雲端模型、本地模型、訂閱制 Codex 使用量，以及團隊裡的多 Agent 協作。
延伸資源
FAQ
OpenWiki 和 Obsidian 最大差異是什麼？
Obsidian 偏人類筆記，OpenWiki 偏 Agent 可讀的工作上下文。OpenWiki 的 code mode 會和 repository 綁定，並維護讓 Agent 參考 wiki 的提示文件。
OpenWiki 可以不用 OpenAI API key 嗎？
可以。官方支援 `openai-chatgpt` provider，可以用 ChatGPT login 走 Codex backend。它也支援 openai-compatible provider，可以接相容 endpoint。
個人資料適合放進 OpenWiki 嗎？
可以，但要先想清楚 provider 和資料邊界。私密資料建議優先測本地模型或可信任的私有 endpoint，並避免把 `~/.openwiki/.env` 同步到 Git。
OpenWiki 適合團隊使用嗎？
適合用在程式碼專案。搭配 GitHub Actions 或 GitLab CI，可以讓文件跟著程式碼更新，降低 Agent 和新人讀錯舊文件的機率。
近期留言