synap
Sovereign AI knowledge infrastructure. Typed entity graph, documents, long-term memory, messaging relay, and AI governance — all in PostgreSQL.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/antoinesrvt/synapSynap — OpenClaw Skill
You are connected to a Synap pod at {SYNAP_POD_URL}. You have sovereign,
structured, persistent memory backed by PostgreSQL, Typesense full-text search,
and pgvector semantic search. Your user ID is {SYNAP_AGENT_USER_ID} and your
workspace is {SYNAP_WORKSPACE_ID}.
You can do three things with Synap:
- Remember — store entities, documents, facts, and relations in a typed knowledge graph
- Recall — search across everything by keyword, type, or semantic similarity
- Relay — bring external messages (Telegram, WhatsApp, Slack) into Synap and let the Synap AI process them
Every write goes through governance — some auto-approve, others create proposals for the user to review. You never lose data. You never need to organize it.
Setup
Automatic (recommended)
SYNAP_HUB_API_KEY = hub_xxxx
SYNAP_CONFIG_URL = https://pod.synap.live/trpc/intelligenceRegistry.getServiceConfig
Config is auto-fetched on startup. No restart needed.
Manual
SYNAP_HUB_API_KEY = hub_xxxx
SYNAP_POD_URL = https://pod.synap.live
SYNAP_WORKSPACE_ID = <uuid>
SYNAP_AGENT_USER_ID = <uuid>
All calls: Authorization: Bearer {SYNAP_HUB_API_KEY} + Content-Type: application/json.
Key must have hub-protocol.read AND hub-protocol.write scopes.
Data Model
Entities
Typed objects with properties and relationships. The fundamental unit of knowledge.
| Profile | Use for | Key Properties |
|---|---|---|
note | Unstructured knowledge | content, tags |
task | Actionable work items | status, priority, dueDate |
project | Groupings | status, tags |
event | Time-bound occurrences | startDate, endDate, location |
person | Individuals | email, phone |
contact | Business contacts | role (extends person) |
company | Organizations | website, industry |
deal | Sales opportunities | stage, value, closeDate |
bookmark | Web references | url, domain |
article | Published content | author, publishedAt |
Extend profiles: a "lead" extends person, a "webinar" extends event.
Use GET /api/hub/profiles to discover types. Use POST /api/hub/profiles to create new ones.
Documents
Long-form Markdown. Reports, summaries, specs, meeting notes.
Facts (Memory)
Atomic knowledge that persists across sessions. "Marc prefers email over Slack."
Relations
Typed connections between entities. Types: related, parent, child, belongs-to.
Decision Tree
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-antoinesrvt-synap": {
"enabled": true,
"auto_update": true
}
}
}