Obsidian + GitHub + MacBook 完整设置指南：打造跨设备知识库

6. 点击 “Add SSH key”

6. 测试 SSH 连接

ssh -T git@github.com

如果看到这样的消息，说明配置成功：

Hi yourusername! You've successfully authenticated, but GitHub does not provide shell access.

—

第四步：克隆 GitHub 仓库

1. 选择克隆位置

cd ~

这会将仓库克隆到你的用户主目录。

2. 克隆仓库

使用 SSH URL（推荐）：

git clone git@github.com:yourusername/obsidian-vault.git ObsidianVault

或使用 HTTPS URL：

git clone https://github.com/yourusername/obsidian-vault.git ObsidianVault

3. 进入仓库目录

cd ObsidianVault

4. 配置 Git 用户信息（首次使用）

git config user.name "Your Name"
git config user.email "your.email@example.com"

—

第五步：初始化 Obsidian Vault

1. 创建基本文件夹结构

mkdir -p "Daily Notes" Projects Memory Inbox Templates

2. 创建初始文件

创建 README.md

cat > README.md << 'EOF'
# Obsidian Vault

This is my personal knowledge base powered by Obsidian and GitHub.

## 📁 Folder Structure

- **Daily Notes/** - Daily journal entries
- **Projects/** - Active projects
- **Memory/** - Long-term knowledge
- **Inbox/** - Quick capture
- **Templates/** - Note templates

## 🔄 Sync

This vault is synced via GitHub. Changes are automatically pushed and pulled.

## 🤖 AI Integration

This vault works with OpenClaw AI assistant for automated note management.
EOF

创建 index.md（主页）

cat > index.md << 'EOF'
---
cssclass: dashboard
---

# My Knowledge Base

## 📋 Quick Links

- [[Daily Notes]] - Journal entries
- [[Projects]] - Active projects
- [[Memory]] - Long-term knowledge

## 📝 Recent Notes

TABLE file.mtime as "Last Modified"

FROM ""

WHERE file.mtime >= date(today) - dur(7 days)

SORT file.mtime DESC

LIMIT 10

## 🎯 Today's Focus

-

## 📚 Resources

- [Obsidian Help](https://help.obsidian.md)
- [GitHub Repository](https://github.com/yourusername/obsidian-vault)
EOF

创建每日笔记模板

mkdir -p Templates
cat > "Templates/Daily Note.md" << 'EOF'
---
date: {{date}}
tags: [daily-note]
---

# {{date}}

## 📋 Today's Focus
-

## ✅ Completed
-

## 🔄 In Progress
-

## 📝 Notes
-

## 💡 Ideas
-
EOF

创建项目模板

cat > "Templates/Project.md" << 'EOF'
---
created: {{date}}
status: active
tags: [project]
---

# {{title}}

## 🎯 Goal
-

## 📋 Tasks
- [ ] Task 1
- [ ] Task 2
- [ ] Task 3

## 📝 Notes
-

## 🔗 Resources
-

## 📊 Progress
- Started: {{date}}
- Status: Active
- Last updated: {{date}}
EOF

3. 提交初始文件

git add .
git commit -m "Initial commit: Obsidian vault setup"
git push -u origin main

---

第六步：在 Obsidian 中打开 Vault

1. 启动 Obsidian

从 Applications 启动 Obsidian。

2. 打开 Vault

1. 点击 "Open folder as vault"

2. 导航到 ~/ObsidianVault

3. 点击 "Open"

3. 探索你的 Vault

你会看到：

- index.md - 你的主页

- README.md - 说明文档

- Templates/ - 模板文件夹

- Daily Notes/ - 每日笔记文件夹

- Projects/ - 项目文件夹

- Memory/ - 知识库文件夹

- Inbox/ - 收件箱文件夹

---

第七步：配置 Obsidian Git 插件

1. 启用社区插件

1. 点击左下角的 设置 图标（齿轮）

   # Test Note

   This is a test note from my MacBook!

   Created: 2026-04-06
   Testing the Obsidian + GitHub sync.

cd ~/ObsidianVault
git status

cd /path/to/obsidian-vault
git pull origin main

Read my index.md file

Create a daily note for today

Add "Tested Obsidian integration" to my daily note

Find all notes tagged with #project

Move all notes tagged with #archive to the Memory folder

cd ~/ObsidianVault
git add .
git commit -m "Update: description of changes"
git push origin main

git commit -m "Add project notes for Obsidian setup guide"

# Project Note

Tags: #project #active #obsidian

Permission denied (publickey)

error: failed to push some refs to 'github.com'

git pull origin main
git push origin main

git pull origin main
# 手动解决冲突
git add .
git commit -m "Resolve merge conflict"
git push origin main

git checkout -b experiment
# 做一些实验
git add .
git commit -m "Experiment: try new layout"
git checkout main

# 创建 pre-commit hook
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
# 在提交前运行检查
echo "Running pre-commit checks..."
EOF
chmod +x .git/hooks/pre-commit

# .github/workflows/backup.yml
name: Backup
on: [push]
jobs:
  backup:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2