llm_wiki/wiki/Obsidian-Git多端同步.md

categories, tags, created, source, type, aliases

categories	tags	created	source	type	aliases
LLM Wiki	wiki concept obsidian git multi-device synchronization	2026-04-07	Obsidian-Git多端同步指南	concept	Obsidian 多端同步 Git 分支策略 Obsidian Git 插件

Obsidian + Git 多端同步

一句话描述：使用 Git 分支策略实现 Obsidian 笔记在 PC、手机和 AI 之间的多端同步

架构概览

graph LR
    A[用户] --> B[Gitea仓库<br/>git.haiguang.xyz]

    B --> C[main分支<br/>用户维护]
    B --> D[openclaw分支<br/>OpenClaw维护]

    C --> E[merge/PR<br/>用户按需合并]
    D --> E

    E --> A

    A --> F[你的设备<br/>PC/手机]
    A --> G[OpenClaw服务器<br/>自动运行]

    F --> A
    G --> A

分支分工

分支	维护者	用途
main	你（HeHaiGuang）	正式笔记，手动编辑，你的"主阵地"
openclaw	OpenClaw（AI）	自动生成的笔记、草稿、报告、日志等

---

手机/PC 端配置步骤

第一步：安装 Obsidian Git 插件

1. 打开 Obsidian → 设置 → 社区插件
2. 关闭「安全模式」
3. 搜索 Obsidian Git 并安装
4. 启用插件

第二步：克隆仓库到 Obsidian

如果你已经有本地仓库：

不需要额外操作，确保 Obsidian 打开的 vault 就是从 Git 克隆的目录即可

如果是从零开始：

# 在你的 PC 上
git clone https://git.haiguang.xyz/giteahh/obsidian_claw.git
# 然后用 Obsidian 打开这个文件夹作为 Vault

第三步：配置 Obsidian Git 插件

在 Obsidian → 设置 → Obsidian Git 中设置：

设置项	推荐值
自动拉取间隔	5 分钟
自动提交间隔	30 分钟（或者关闭，手动提交）
提交消息	update: {{date}}
显示状态栏	✅ 开启
当前分支	main

第四步：验证

1. 在 Obsidian 左下角状态栏应该能看到 main 分支名
2. 随便编辑一个笔记，等插件自动 commit + push
3. 去 Gitea 网页上确认是否看到你的提交

---

日常工作流

你（手动操作）

1. 打开 Obsidian → 正常写笔记
2. Obsidian Git 插件自动 commit + push（无需手动操作）
3. 如果想看 AI 写了什么：
   - 方法1：去 Gitea 网页看 openclaw 分支
   - 方法2：在 Obsidian 中切换分支（见下方说明）
   - 方法3：让我帮你合并到 main

OpenClaw（全自动）

1. 每5分钟自动检查文件变化
2. 有变化 → 自动 commit + push 到 openclaw 分支
3. 同时自动拉取 main 分支的更新（读取你的最新笔记）
4. 如有冲突 → 自动放弃合并，不会搞乱任何东西

---

如何查看和合并 AI 的内容

在 Obsidian 中切换分支查看（推荐）

1. 安装 Obsidian Git 插件后，使用命令面板（Ctrl/Cmd + P）
2. 搜索 Obsidian Git: Checkout branch
3. 选择 openclaw 分支
4. 查看 AI 生成的内容
5. 切回 main：Obsidian Git: Checkout branch → main

⚠️ 切换分支前确保当前修改已提交，否则会冲突

通过 Gitea 网页查看

1. 打开 https://git.haiguang.xyz/giteahh/obsidian_claw
2. 点击分支选择器，切换到 openclaw
3. 浏览文件内容

合并 AI 的内容到 main

方法一：让我来合并（最简单）

直接告诉我："帮我把 openclaw 分支的内容合并到 main"
我会处理好所有合并操作

方法二：在 Gitea 上创建 Pull Request

1. 打开仓库页面
2. 点击「New Pull Request」
3. 源分支：openclaw → 目标分支：main
4. 审查变更后点击合并

**方法三：命令行合并（PC 端）

git checkout main
git pull origin main
git merge openclaw
git push origin main

---

注意事项

关于删除文件

你想做什么	做法
删掉自己写的文件	直接删，commit + push 即可
不想看到某个 AI 生成的文件	告诉我，我加到 .gitignore
彻底删除某文件（三端清除）	告诉我，我处理本地 + Git + 坚果云

关于冲突

• 正常情况下不会冲突，因为我们各用各的分支
• 唯一的合并时机是你主动 merge openclaw → main，这时如果冲突，Git 会标记出来，你可以选择保留哪版

关于坚果云备份

坚果云备份 继续运行，作为额外的"冷备份"：

• 每 30 分钟自动同步到坚果云
• 不受 Git 分支策略影响
• 即使 Git 出问题，坚果云还有一份

三层保障体系

第一层：Git（Gitea）  ← 主同步通道，实时双向
第二层：坚果云（rclone） ← 冷备份，每30分钟
第三层：本地磁盘        ← 服务器 /home/obsidian/

---

常见问题

Q: Obsidian Git 插件报错怎么办？

A: 检查网络连接是否正常，Gitea 地址 git.haiguang.xyz 是否可访问。也可以手动在终端 git pull 看具体报错。

Q: AI 生成的笔记太多了，不想全部合并？

A: 合并前先在 Gitea 上审查，或者告诉我只需要合并哪些文件。

Q: 在手机上怎么操作？

A: 手机端 Obsidian 也有 Git 插件（Android 支持，iOS 需要用 iVim 或 Working Copy）。最简单的方案是：手机只看不同步，同步交给 PC。或者用 Termux + git 命令行。

Q: 服务器 IP 变了怎么办？

A: 服务器上用的是 Gitea 远程地址，跟服务器 IP 无关，不受影响。

Q: 我想修改自动同步的频率？

A: 告诉我，我改 crontab 配置即可。目前服务器端是每 5 分钟一次。

相关概念

• Gitea - Git 托管服务
• Obsidian - 笔记工具
• Git - 版本控制系统
• OpenClaw - AI 自动化服务（外部服务）

来源

• Obsidian-Git多端同步指南 - 完整的多端同步文档
• Obsidian Git 插件文档：https://github.com/denolehov/obsidian-git