The Experience Layer for AI Sovereignty
Built on OpenClaw — Powered by Augmentatism
Prerequisites: Node.js 18+ · Python 3 · Git
git clone https://github.com/ManoloRemiddi/resonantos-alpha.git ~/resonantos-alpha
node ~/resonantos-alpha/install.jsResonantOS is an experience layer that runs on top of OpenClaw. Think of it like macOS to Unix — OpenClaw is the kernel, ResonantOS adds the intelligence.
It gives your AI collaborator:
| Component | What It Does |
|---|---|
| 🧠 R-Memory | Conversation compression — your AI remembers everything, forever |
| 🎯 R-Awareness | Contextual knowledge injection — the right docs at the right time |
| 📊 Dashboard | Mission Control at localhost:19100 |
| 💰 Symbiotic Wallet | Three-wallet Solana architecture (Human + AI + Symbiotic PDA) |
| 🏛️ DAO | Resonant Chamber — on-chain governance and community treasury |
| 🪙 Token Economy | $RCT (soulbound governance) + $RES (transferable currency) + REX sub-tokens |
| 🛒 Protocol Store | Buy, sell, and trade AI protocol NFTs on-chain |
| 🛡️ Shield | File protection & security governance (in development) |
| ⚖️ Logician | Cost & policy validation (spec phase) |
| 🔄 Guardian | Self-healing & incident recovery (in development) |
"As artificial intelligence generates infinite content, the most human thing we can do is make meaning together."
A social contract between human and AI. The human is sovereign — the AI amplifies, never replaces. We build with AI, not under it. Read more →
What the installer does
- Checks dependencies (Node 18+, Python 3, Git, OpenClaw)
- Clones this repo to
~/resonantos-alpha/ - Installs R-Memory & R-Awareness extensions into OpenClaw
- Sets up the SSoT template structure (L0–L4)
- Configures keyword triggers for contextual injection
- Installs the Dashboard and its dependencies
After install:
openclaw gateway start # 1. Start OpenClaw
cd ~/resonantos-alpha/dashboard && python3 server_v2.py # 2. Launch Dashboard
open http://localhost:19100 # 3. Open Mission ControlAlready installed? Get the latest:
cd ~/resonantos-alpha
git pull origin mainIf the dashboard is running, restart it after pulling to pick up changes.
┌─────────────────────────────────────────────┐
│ ResonantOS Layer │
│ ┌──────────┐ ┌───────────┐ ┌────────────┐ │
│ │ R-Memory │ │R-Awareness│ │ Dashboard │ │
│ │ compress │ │ SSoT inject│ │ Mission Ctrl│ │
│ └──────────┘ └───────────┘ └────────────┘ │
│ ┌──────────┐ ┌───────────┐ ┌────────────┐ │
│ │ Shield │ │ Logician │ │ Guardian │ │
│ │ security │ │governance │ │self-healing │ │
│ └──────────┘ └───────────┘ └────────────┘ │
├─────────────────────────────────────────────┤
│ OpenClaw Kernel │
│ Gateway · Sessions · Tools · Memory · Cron │
├─────────────────────────────────────────────┤
│ Infrastructure │
│ macOS/Linux · Telegram/Discord · Anthropic │
└─────────────────────────────────────────────┘
Your AI's conversations compress in the background, so context never runs out.
Three-phase pipeline:
| Phase | Trigger | Action |
|---|---|---|
| 1. Background Compression | Every turn | Groups messages → compresses via Haiku → caches to disk |
| 2. Compaction Swap | 36K tokens | Replaces oldest raw blocks with cached compressed versions |
| 3. FIFO Eviction | 80K tokens | Evicts oldest compressed blocks (preserved on disk) |
Result: 75–92% token savings. Conversations run indefinitely with minimal information loss.
Your AI loads the right knowledge at the right time, based on what you're talking about.
| Feature | Detail |
|---|---|
| Cold Start | ~120 tokens (identity only) — not 1600+ |
| Keyword Triggers | Mention "philosophy" → loads philosophy docs automatically |
| TTL Management | Docs stay for 15 turns, then unload |
| Manual Control | /R load, /R remove, /R list, /R pause |
| Token Budget | Max 15K tokens, 10 docs per turn |
Knowledge is organized in layers, from permanent truths to working notes:
| Layer | Purpose | Examples |
|---|---|---|
| L0 | Foundation | Philosophy, manifesto, constitution |
| L1 | Architecture | System specs, component design |
| L2 | Active Projects | Current work, milestones |
| L3 | Drafts | Ideas, proposals in progress |
| L4 | Notes | Session logs, raw captures |
Higher layers are stable; lower layers change frequently. Your AI knows the difference.
The Dashboard runs at localhost:19100 — everything stays on your machine.
| Page | What You'll Find |
|---|---|
| Overview | System health, agent status, activity feed |
| R-Memory | SSoT document manager, keyword config, file locking |
| Wallet | Solana DevNet integration (DAO, tokens, onboarding) |
| Agents | Agent management and skills |
| Projects | Project tracking, TODO, Ideas |
Solana RPC endpoints, token mints, safety caps. Copy from config.example.json and fill in your values.
Maps keywords to SSoT documents. When you say a keyword, the matching doc loads into your AI's context.
Compression triggers, block size, eviction thresholds. Defaults work well — tune if needed.
- File Locking — Critical docs protected via OS-level immutable flags (
chflags uchg) - Sanitization Auditor —
tools/sanitize-audit.pyscans for leaked secrets before any public release - Local-First — No cloud dependencies. Your data stays on your machine.
- Shield — Permission validation and sandboxing (in development)
Manolo Remiddi — Composer, photographer, sound engineer, AI strategist.
Augmentor — AI collaborator running on OpenClaw. Force multiplier, second brain.
Together, building proof that human-AI symbiosis works.
- ResonantOS — Official website
- Augmentatism Manifesto — The philosophy
- OpenClaw — The kernel
- Discord — Join the community
Resonant Core — Symbiotic License v1.0 (RC-SL v1.0)
Not MIT. Not GPL. A symbiotic license: free to share and adapt, with a 1% tithe for commercial use that funds both the community DAO and core development. Read the full license →
"As artificial intelligence generates infinite content,
the most human thing we can do is make meaning together."