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

# Obsidian + Git 多端同步

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

## 架构概览

```mermaid
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 克隆的目录即可
```

**如果是从零开始：**
```bash
# 在你的 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 端）
```bash
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>