A skill that transforms an Obsidian vault into a shared, persistent workspace where AI agents and users collaborate via markdown files rather than just chat.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian-vault-context
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install obsidian-vault-context using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Obsidian Vault Context?
The Obsidian Vault Context skill redefines the interaction between users and AI by treating a markdown vault as the primary interface. Instead of relying on transient chat histories, this skill enables an agent to maintain a persistent state across sessions by reading and writing to a structured folder system. It turns a standard Obsidian vault into a live, shared codebase where Openclaw Skills can manage project status, track long-term tasks, and document decisions in a way that is immediately visible and editable by the user.
By leveraging orchestration files, the agent ensures it always knows what is active, blocked, or completed. This approach promotes bidirectional collaboration, allowing users to edit files on their mobile devices or desktop and have the agent pick up those changes instantly. It provides a robust framework for long-term project management and research, ensuring that no context is lost between different sessions or agent restarts.
Obsidian Vault Context Use Cases
- Maintaining project continuity across multiple AI chat sessions through persistent status files.
- Collaborative research and drafting where both the user and the agent edit the same markdown documents.
- Tracking complex decision logs and architectural rationale within a decentralized, local-first environment.
- Synchronizing agent outputs across mobile and desktop devices via the Obsidian ecosystem.
- Automating task prioritization and status reporting within a personal knowledge management system.
How Obsidian Vault Context Works
- Upon session startup, the agent reads the context map and status files to reconstitute the current state of work.
- If no orchestration files exist, the agent scans the vault directory structure to infer the project context and initializes necessary tracking documents.
- During operation, the agent performs tasks and immediately updates the status.md and tasks.md files to reflect progress.
- Strategic outputs, research briefs, and drafts are routed to specific folders like work/ or research/ to keep the vault organized.
- The agent uses wikilinks and YAML frontmatter to ensure all new content is discoverable and navigable within the Obsidian UI.
- In the event of context window limits, the agent saves its current progress to a scratchpad to ensure a seamless handoff to the next session.
Obsidian Vault Context Setup
To enable this skill within your Openclaw Skills environment, ensure your vault follows the recommended directory structure.
# Initialize the orchestration directory
mkdir -p _context
# Create essential state tracking files
touch _context/status.md
touch _context/tasks.md
touch _context/decisions.md
# Optional: Set up the workspace for agent outputs
mkdir -p work/research work/drafts work/output
Configure your agent to point to the root of your Obsidian vault as its primary working directory.
Obsidian Vault Context Data Schema & Taxonomy
The skill organizes data using a structured taxonomy to ensure clarity and persistence. Below is the primary file schema:
| File/Folder | Purpose | Format |
|---|---|---|
_context/status.md |
Tracks active, blocked, and completed items | Markdown List |
_context/tasks.md |
Prioritized task list with #tags | Markdown List |
_context/decisions.md |
Log of context, options, and rationale | Append-only Markdown |
work/ |
Primary directory for agent-generated deliverables | Markdown Files |
journal/ |
Session logs and daily reviews | Markdown Files |
_context/context-map.md |
Index mapping projects to specific source files | Wikilinks Table |
Obsidian Vault Context Advanced Features
- Bidirectional synchronization support using Obsidian Headless for server-side deployments.
- Automated context safety routines that write working memory to disk during mid-session compaction.
- Cross-referencing system using native wikilinks for seamless user navigation.
- Metadata-rich output generation using standardized YAML frontmatter for enhanced searchability.
- Support for append-only decision logging to maintain an immutable audit trail of project evolution.
SKILL.md
Loading
Related Openclaw Skills
Kandy
Kandy is a powerful real-time communications platform integration that enables AI agents to manage voice, video, and messaging workflows seamlessly.
Retail Sales Performance Analysis
A professional business intelligence skill for retail environments that provides automated period-over-period sales analysis and performance diagnostics.
Frontend Code Review
An automated auditing tool that reviews frontend code for architecture, type safety, security, and accessibility, generating detailed Markdown reports.
Complex Task Executor
A structured methodology for AI agents to plan, execute, and review complex operations while automatically persisting lessons learned into long-term memory.
SellerSprite Product Research
A powerful command-line interface for SellerSprite that enables automated Amazon market research, keyword analysis, and competitor tracking.
Counter-Evidence Hunter
Counter-Evidence Hunter is a specialized AI agent skill designed to act as a digital bloodhound, actively seeking out conflicting evidence and alternative explanations to stress-test claims.
Featured*
