Connect AI to Obsidian Notes
Team Relay gives an OpenClaw AI agent read and write access to a shared Obsidian vault via EVC Team Relay.
1.0.0Add to Favorites
Why it matters
Integrate your AI agent with your Obsidian vault via EVC Team Relay. Enable seamless read/write access to your team's knowledge base for AI-assisted tasks.
Outcomes
What it gets done
List shared folders and documents in Obsidian.
Read note content as Markdown for AI processing.
Create and update notes directly within your Obsidian vault.
Delete obsolete notes to maintain vault hygiene.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/evc-team-relay-openclaw-skill | bash Overview
Team Relay
Team Relay lets an OpenClaw agent list, read, create, update, and delete notes in a shared Obsidian vault through EVC Team Relay's REST API, staying in sync with what the team edits directly in Obsidian. Use it when an agent needs to read or update shared team knowledge in Obsidian, especially for agent-to-human handoff workflows; requires an existing Team Relay deployment and account.
What it does
Team Relay is an OpenClaw skill that connects an AI agent to Obsidian notes managed by EVC Team Relay. The agent can list shared folders and documents, read note content as Markdown, create new notes, write updates to existing ones, and delete notes - all working against the same notes your team edits directly in Obsidian, with no copy/paste and no stale context, since Team Relay syncs documents to connected Obsidian clients in real time via Yjs CRDTs.
When to use - and when NOT to
Use this when you want an AI agent to read or update shared team knowledge living in Obsidian - pulling specs, updating status docs, drafting meeting notes, or keeping documentation in sync with code changes - while humans keep working in Obsidian itself. It's well suited to agent-to-human handoff, where the agent writes into a shared folder for a person to review afterward. It is not useful without an existing EVC Team Relay deployment and a user account on its control plane, and it requires curl and jq on the host running the agent.
Inputs and outputs
Inputs: a Relay control plane URL, agent credentials (email/password), and, for file operations, a share ID and document ID. Outputs: JWT auth token, lists of shared folders and files, note content as Markdown, and confirmation of writes, creates, or deletes. Scripts: auth.sh (authenticate, get JWT), list-shares.sh (list accessible shared folders), list-files.sh (list files in a folder), read.sh (read note content), write.sh (update an existing note), create-file.sh (create a new note), delete-file.sh (delete a note).
Integrations
Communicates with EVC Team Relay's REST API, which stores documents as Yjs CRDTs and syncs them live to connected Obsidian clients. Configured via OpenClaw's openclaw.json, setting RELAY_CP_URL, RELAY_EMAIL, and RELAY_PASSWORD environment variables and adding the skill to an agent's skill list.
Who it's for
Teams running OpenClaw agents alongside a shared Obsidian vault who want the agent to read and update the same notes the team uses day to day, instead of maintaining a separate copy of context for the agent.
Source README
EVC Team Relay - OpenClaw Skill
Give your AI agent read/write access to your Obsidian vault.
This OpenClaw skill connects your AI agent to Obsidian notes managed by EVC Team Relay:
- List shared folders and documents
- Read note content as Markdown
- Create new notes in shared folders
- Write updates to existing notes
- Delete notes when no longer needed
Your agent works with the same notes your team edits in Obsidian - no copy/paste, no stale context.
Use Cases
- AI-Assisted Knowledge Management - read specs, update status docs, create meeting notes
- Agent-to-Human Handoff - agent writes into shared folder, you review in Obsidian
- Automated Documentation - agent keeps vault docs up to date with code changes
Install
cp -r . ~/.openclaw/skills/evc-team-relay/
chmod +x ~/.openclaw/skills/evc-team-relay/scripts/*.sh
Configure
Set environment variables in your OpenClaw config (~/.openclaw/openclaw.json):
{
"skills": {
"entries": {
"evc-team-relay": {
"env": {
"RELAY_CP_URL": "https://cp.tr.entire.vc",
"RELAY_EMAIL": "agent@yourdomain.com",
"RELAY_PASSWORD": "your-password"
}
}
}
}
}
Then add the skill to your agent:
{
"agents": {
"list": [
{
"id": "main",
"skills": ["evc-team-relay"]
}
]
}
}
Scripts
| Script | What it does |
|---|---|
auth.sh |
Authenticate and get JWT token |
list-shares.sh |
List all accessible shared folders |
list-files.sh |
List files in a shared folder |
read.sh |
Read note content |
write.sh |
Update existing note |
create-file.sh |
Create new note in a folder |
delete-file.sh |
Delete a note |
Quick Test
cd ~/.openclaw/skills/evc-team-relay
export RELAY_CP_URL="https://cp.tr.entire.vc"
export RELAY_EMAIL="agent@yourdomain.com"
export RELAY_PASSWORD="your-password"
TOKEN=$(bash scripts/auth.sh)
bash scripts/list-shares.sh "$TOKEN"
bash scripts/list-files.sh "$TOKEN" "<share_id>"
bash scripts/read.sh "$TOKEN" "<share_id>" "<doc_id>"
How It Works
AI Agent (OpenClaw) <--REST API--> Team Relay <--Yjs CRDT--> Obsidian
The skill talks to Team Relay's REST API. Team Relay stores documents as Yjs CRDTs and syncs them to connected Obsidian clients in real-time.
Prerequisites
- OpenClaw installed
- A user account on the Relay control plane (default: cp.tr.entire.vc)
- curl and jq on the host
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.