Connect Your Obsidian Vault to ClawCloud

Your Obsidian vault is where your thinking lives. Your ClawCloud agent is where your execution lives. Connecting them creates something neither has alone: an AI that actually knows your context, your projects, and your notes — and can update them in real time.

This guide walks through setting up Git sync between your Obsidian vault and your ClawCloud workspace.

What you'll build

After this guide:

• Your Obsidian vault syncs to your ClawCloud server via Git
• Your agent can read any note when you reference it in chat
• Your agent can write new notes and append to existing ones
• Changes flow back to your local Obsidian on the next pull

Prerequisites

• Active ClawCloud deployment (server ACTIVE status)
• Obsidian installed with your vault set up
• A GitHub or GitLab account (free)
• Obsidian Git plugin installed in Obsidian

Step 1: Push your vault to GitHub

If your vault isn't in a Git repo yet:

cd ~/path/to/your/vault
git init
echo ".obsidian/workspace.json" >> .gitignore
echo ".obsidian/workspace-mobile.json" >> .gitignore
git add .
git commit -m "Initial vault commit"
git remote add origin https://github.com/yourusername/my-vault.git
git push -u origin main

Make the repo private — this is your personal notes.

Step 2: Clone your vault onto your ClawCloud server

SSH into your server (find the SSH command in your ClawCloud dashboard):

ssh root@your-server-ip

Then clone into the OpenClaw workspace:

# Backup existing workspace first
mv /home/openclaw/.openclaw/workspace /home/openclaw/.openclaw/workspace.bak 2>/dev/null || true
 
# Clone your vault as the workspace
git clone https://github.com/yourusername/my-vault.git \
  /home/openclaw/.openclaw/workspace
 
# Fix permissions
chown -R openclaw:openclaw /home/openclaw/.openclaw/workspace

For private repos, create a GitHub Personal Access Token with repo scope and use it in the clone URL:

git clone https://yourusername:YOUR_TOKEN@github.com/yourusername/my-vault.git \
  /home/openclaw/.openclaw/workspace

Step 3: Configure Obsidian Git

In Obsidian, open Settings → Obsidian Git and configure:

• Auto pull interval: 5 minutes
• Auto push interval: 5 minutes
• Commit message: vault: auto-sync {{date}}
• Pull on startup: ✅ enabled

This ensures your local vault picks up any notes the agent creates or modifies.

Step 4: Test the connection

In your Discord or Telegram, message your agent:

"Read my vault and tell me what projects you see"

The agent will scan your workspace Markdown files and give you a summary. It's now aware of everything in your vault.

Try a write test:

"Create a new note called 'ClawCloud setup complete' with today's date and a summary of what ClawCloud can do for me"

Open Obsidian, wait for the Git auto-pull, and you'll see the new note appear.

What your agent can do with your vault

Read context automatically — When you ask about a project, the agent checks your notes without you having to paste them.

Append to daily notes — "Add to today's note: meeting with Sarah at 3pm, discuss Q2 roadmap"

Create structured notes — "Turn our conversation about the landing page into a project brief note"

Search across everything — "Find all notes where I mentioned the Alpha Mesh project"

Keep a running log — The agent's heartbeat system can write daily summaries to your vault automatically

Advanced: Set up auto-sync on the server

For fully automatic bidirectional sync, add a cron job on the server:

# Run as root
crontab -e
 
# Add this line — pulls and pushes every 10 minutes
*/10 * * * * su - openclaw -c 'cd /home/openclaw/.openclaw/workspace && git pull --rebase origin main && git add -A && git commit -m "agent: auto-sync" 2>/dev/null && git push origin main 2>/dev/null' >> /var/log/vault-sync.log 2>&1

Now changes from either end sync within 10 minutes, automatically.

Your notes are now your agent's memory. Ask it anything about your vault, have it update your notes, and watch Obsidian sync the changes back in real time.