---
title: "养虾日记3：用 Obsidian + Gitea 为 AI 助手构建持久化笔记系统"
type: source
tags: [AI-Agent, Obsidian, Gitea, 知识管理, LLM-Wiki]
date: 2026-04-09
---

## Source File
- [[微信公众号/养虾日记3：用 Obsidian + Gitea 为 AI 助手构建持久化笔记系统]]

## Summary（用中文描述）
- 核心主题：如何用 Obsidian + Gitea 为 AI 助手构建持久化笔记系统，解决 AI 对话结束后输出丢失的核心问题
- 问题域：AI Agent 的输出持久化、版本控制、多端同步
- 方法/机制：用 Obsidian 做知识库（多端同步）、Gitea 做版本控制（Git 历史）、OpenClaw 做写入接口（obsidian skill）
- 结论/价值：把 AI 变成"会自动整理笔记的实习生"——做完事顺手更新记录

## Key Claims（用中文描述）
- OpenClaw Agent 通过 obsidian skill 将输出直接写入 Obsidian 笔记，实现持久化存储
- Gitea 托管笔记的 Git 版本管理，任何时候都能回溯历史变更
- iCloud Drive 保证手机、笔记本和 Mac mini 三端笔记永远同步
- 笔记目录采用分层结构：knowledgebase/ 存放跨 Agent 共用知识，<agentId>/ 存放单一 Agent 私有笔记
- Karpathy 的 LLM Wiki 思路：让 AI 增量构建和维护持久化 Wiki，页面间互相链接，知识越积越厚
- Obsidian Graph View 可以发现"孤岛页面"和"幽灵节点"（被多处引用但没有独立页面的概念）

## Key Quotes
> "用 Obsidian 做知识库，用 Gitea 做版本控制，用 OpenClaw 做写入接口。" — 核心架构概括
> "AI 批量改文件的能力越强，你越需要版本管理来兜底。" — 版本管理的重要性
> "本质上是把 AI 变成了一个'会自动整理笔记的实习生'——它做完事，就会顺手把记录更新好。" — 系统价值定位
> "RAG 模式是'每次从零检索'，知识不积累；而 LLM Wiki 是让 AI 增量构建和维护一个持久化的 Wiki，页面之间互相链接，知识越积越厚。" — Karpathy LLM Wiki 核心理念

## Key Concepts
- [[LLM Wiki]]：让 AI 增量构建和维护持久化的 Wiki，页面间互相链接，知识越积越厚（区别于 RAG 的"每次从零检索"）
- [[Obsidian Git]]：Obsidian 社区插件，支持 Auto commit-and-sync interval，自动 commit + push 到 Git 仓库
- [[Graph View]]：Obsidian 内置图谱视图，将所有 Wiki 页面以节点展示，双链关系自动连线，用于发现孤岛页面和知识盲区
- [[Obsidian Web Clipper]]：浏览器插件，用于快速采集外部网页文章为 Markdown 到 Obsidian，配合图片本地化
- [[QMD]]：完全本地运行的 Markdown 搜索引擎，适合 Wiki 规模变大后的精准搜索
- [[版本管理]]：Git 历史记录每一次变更的来源和内容，支持回溯和多协作
- [[被动更新]]：AI 在执行任务过程中顺手维护链接、更新摘要、添加 Tag、标记新旧矛盾，而非被动等着被查询
- [[双链笔记]]：Obsidian 的核心特性，页面间通过 [[wikilinks]] 互相链接形成知识网络

## Key Entities
- [[Gitea]]：自建 Git 服务，托管笔记的版本控制，所有历史版本完整保留
- [[Obsidian]]：笔记管理工具，支持多端同步（iCloud Drive）和双链笔记
- [[OpenClaw]]：AI Agent 框架，提供 obsidian skill 作为写入接口
- [[Karpathy]]：LLM Wiki 理念的提出者（2026-03 分享）
- [[iCloud Drive]]：Apple 云同步服务，确保笔记在 Mac mini、笔记本和 iPhone 三端同步

## Connections
- [[养虾日记1]] ← 同一系列 ← [[养虾日记2]]
- [[养虾日记1]] ← 同一系列 ← [[养虾日记3]]
- [[养虾日记2]] ← 同一系列 ← [[养虾日记3]]
- [[养虾日记4]] ← 同一系列 ← [[养虾日记5]]
- [[Second Brain]] ← 类似的持久化记忆理念 ← [[养虾日记3]]
- [[Personal Knowledge Base (RAG)]] ← 相关的知识管理方案 ← [[养虾日记3]]
- [[LLM Wiki]] ← 核心理论支撑 ← [[养虾日记3]]
- [[self-healing-home-server]] ← 使用同款笔记系统 ← [[养虾日记3]]

## Contradictions
- 无已知冲突