README file from
GithubObsidianClaw
Chat with your OpenClaw AI agent directly from Obsidian.
Your vault becomes the workspace. Your AI lives in the sidebar. No browser tabs, no separate apps — just your notes and your AI, side by side.
Features
- Chat sidebar — Talk to your AI agent from any Obsidian tab
- Streaming responses — See replies appear in real-time
- Markdown rendering — Code blocks, lists, links rendered natively
- Tool call visibility — See files read/written, commands run, pages fetched
- Cross-device sync — Chat history and tool calls persist via Obsidian Sync
- "Ask about this note" — Send any note as context with one command
- Dark/light theme — Follows your Obsidian theme automatically
Install
Beta: Pending approval in the Obsidian Community Plugin store (PR #10465). Install via BRAT for now.
- In Obsidian, go to Settings → Community Plugins → Browse
- Search BRAT → Install → Enable
- Go to Settings → BRAT → Add Beta Plugin
- Enter:
oscarhenrycollins/obsidianclaw
That's it. BRAT installs the plugin and keeps it updated. Works on desktop and mobile.
Connect
The setup wizard opens automatically after install:
- Gateway URL:
ws://<your-tailscale-ip>:18789 - Auth Token: from
~/.openclaw/openclaw.json→gateway.auth.token - Click Test connection
- Approve the device from the OpenClaw dashboard or CLI:
openclaw devices list openclaw devices approve <requestId>
Done. The device is remembered permanently.
Prerequisites
- OpenClaw gateway running somewhere (Mac, Linux, Raspberry Pi)
- Tailscale on all your devices
- Gateway bound to Tailscale:
openclaw config set gateway.bind tailnet && openclaw gateway restart
⚠️ OpenClaw 2026.3.x compatibility: Versions 2026.3.1 through 2026.3.13 have a bug where
app://origins (used by Obsidian) are silently rejected by the gateway. If you're on 2026.3.x and the plugin can't connect, downgrade to 2026.2.26:npm i -g [email protected] && openclaw gateway restart. This will be resolved in a future release.
Commands
| Command | Description |
|---|---|
OpenClaw: Toggle chat sidebar |
Open/close the chat panel |
OpenClaw: Ask about current note |
Send the active note as context |
OpenClaw: Reconnect to gateway |
Re-establish the connection |
OpenClaw: Run setup wizard |
Re-run the onboarding flow |
Troubleshooting
"Could not connect" / "Disconnected" — Most common cause: the gateway stopped. SSH into your gateway machine and run openclaw gateway restart. If that fixes it, the gateway had crashed. Also check: Is Tailscale running on both devices? Is the URL correct (ws://<tailscale-ip>:18789)? Is the token right?
"Pairing required" — Every new device needs a one-time approval. Run openclaw devices list and openclaw devices approve <requestId> on your gateway machine, or approve from the dashboard.
Switching devices — Force-quit Obsidian and reopen. It picks up synced data from the other device.
Security
Three layers: Tailscale encrypts all traffic (WireGuard VPN), gateway token authenticates connections, and Ed25519 device keys fingerprint each device. Your keys never leave your machine.
Building from Source
git clone https://github.com/oscarhenrycollins/obsidianclaw.git
cd obsidianclaw
npm install
npm run build
Copy main.js, manifest.json, and styles.css to .obsidian/plugins/openclaw/.
Links
- ObsidianClaw — Official site
- OpenClaw — The AI agent framework
- Bot Setup Guide — Full setup walkthrough
- Humanity Labs — Built by Humanity Labs
License
MIT