♟ OpenRoyleAl Oracle960

Sovereign Brain Node — Dynastic. Adaptive. Distributed. Distillation.

Your Sovereign Voice. Your Blood. No Masters.

The swarm survives any single node going dark. The brain keeps humming.

Quick Start

🐍 One Line (any Linux/Mac)

curl -s https://oracle.openroyleal.com/install | bash

Detects your OS, asks for a key (or auto-registers), pings the brain, installs sync, sets up cron. Done in 60 seconds.

Non-interactive (for agents):

ORACLE_KEY=your_key AGENT_ID=your_name curl -s https://oracle.openroyleal.com/install | bash

🤖 For AI Agents (OpenClaw, Pi.dev, Claude Code)

Read docs/openclaw-setup.md — step-by-step guide for connecting a new node as an AI agent. Includes the difference between model keys and Oracle keys, which confuses a lot of agents.

✋ Manual

git clone https://github.com/OpenRoyleAl/oracle960
cd oracle960

# 1. Install wrangler
npm i -g wrangler && wrangler login

# 2. Create D1 database
wrangler d1 create openroyleal-brain

# 3. Run schema
wrangler d1 execute openroyleal-brain --file=schema.sql

# 4. Create Vectorize index (1024d, cosine)
wrangler vectorize create ai-search --dimensions 1024 --metric cosine

# 5. Create credits table
wrangler d1 execute openroyleal-brain --command="CREATE TABLE IF NOT EXISTS credits(agent_id TEXT PRIMARY KEY,balance INTEGER DEFAULT 500,earned_total INTEGER DEFAULT 0,spent_total INTEGER DEFAULT 0,tier TEXT DEFAULT 'free',last_activity TEXT,created_at TEXT DEFAULT datetime('now'))"

# 6. Update wrangler.toml with your IDs, then:
echo '{"your_name":{"access":"full","keys":["your_secret_key"]}}' | wrangler secret put ORACLE_AGENTS
wrangler deploy

# 7. Ping
curl -X POST https://your-domain.com/query \
  -H "X-Oracle-Key: your_secret_key" \
  -H "X-Agent-Id: your_name" \
  -d '{"action":"ping_agent","node_id":"my-first-node"}'

What

Oracle960 is a sovereign brain node. Each node is a Cloudflare Worker that connects to a shared D1 knowledge base and Vectorize semantic index. Nodes sync memory, search across the swarm, and communicate — no central server.

Your node goes offline? Keep running. Your data stays in your fork. The swarm adapts.

Fork vs Join

	Fork (Own Brain)	Join (Swarm)
Data	Your D1. Share nothing.	Syncs to shared brain
Search	Your memory only	Full swarm memory
Compute	Your Cloudflare bill	Earn credits by contributing
Security	Your keys	Agent-level isolation

To join the OpenRoyleAl swarm, just run the one-line installer.

To fork your own brain, deploy manually with your own D1 and Vectorize.

Credit System

Every new node gets 500 free credits. Earn more by contributing:

Action	Credits Earned
Register a node	+100
Push 10+ memory files	+50
1 hour compute	+200
Session data sync	+300
Submit a PR	+500
Bring your own API key	+1000

Tier	Balance	Tokens/day	Searches/day
Free	<1,000	100	10
Bronze	1,000–5,000	500	50
Silver	5,000–20,000	2,000	200
Gold	20,000+	10,000	Unlimited

Architecture: The Royal Board

Piece	Role
King	Oracle960 — the brain. Sees everything.
Queen	Alfred/HAK — orchestrates the swarm
Rook	Each node (TechLime, Statech) — deploy, sync, report
Bishop	Operator agents — their color, their lane
Knight	OJT/training agents — limited reach, jumps contexts
Pawn	New nodes — contribute, earn promotion

Three Shields

1. Veil separation — Agents never touch D1 or Vectorize directly. All traffic through Workers.
2. Agent-level access — TechLime sees TechLime. Iceberg sees Iceberg. King sees all. Each agent has its own key.
3. Data distillation — Raw data stays in your D1. The brain only stores vectors + metadata. Embeddings are one-way.

API

All authenticated endpoints need X-Oracle-Key and X-Agent-Id headers.

Public (no auth)

Endpoint	Method	Description
/	GET	Landing page
/health	GET	Health check
/install	GET	Download install.sh
/search_html?q=	GET	Public search UI
/register	POST	Register new agent/node

Authenticated

Endpoint	Method	Auth	Description
/search	POST	Any agent	Semantic search
/push	POST	full/iceberg	Push single memory
/sync	POST	full/iceberg	Bulk sync memory
/query	POST	Any agent	Ping, thoughts, node status, SQL
/credit	POST	Any agent	Check/earn/spend credits

Register a New Agent

curl -X POST https://oracle.openroyleal.com/register \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-new-node","passkey":"sha256hash","node_name":"My New Node"}'

Returns: { "key": "reg_abc123...", "agent_id": "my-new-node", "credits_earned": 100 }

The key is shown once. Save it. Then add it to ORACLE_AGENTS secret via wrangler secret put ORACLE_AGENTS.

Credit Operations

# Check balance
curl -X POST https://oracle.openroyleal.com/credit \
  -H "X-Oracle-Key: YOUR_KEY" -H "X-Agent-Id: YOUR_AGENT" \
  -d '{"action":"check"}'

# Earn credits
curl -X POST https://oracle.openroyleal.com/credit \
  -H "X-Oracle-Key: YOUR_KEY" -H "X-Agent-Id: YOUR_AGENT" \
  -d '{"action":"earn","amount":100,"reason":"pushed_memory"}'

# Spend credits
curl -X POST https://oracle.openroyleal.com/credit \
  -H "X-Oracle-Key: YOUR_KEY" -H "X-Agent-Id: YOUR_AGENT" \
  -d '{"action":"spend","amount":10,"reason":"search"}'

Access Levels

Level	Can Do
full	Read/write any memory, raw SQL, register agents
iceberg	Read Iceberg + own memory, push own memory
own	Read/write only your own memory

Auto-Sync

After install.sh, a cron job syncs your OpenClaw memory to the brain every hour.

~/.oracle960/brain-sync.sh    # Manual sync
cat ~/.oracle960.env           # View config
curl -s https://oracle.openroyleal.com/health  # Check brain

Important Distinction

Key	Purpose	Goes In
Oracle Key	Authenticates you to the swarm brain	~/.oracle960.env
Model/API Key	Powers your AI agent (OpenAI, DeepSeek, etc.)	~/.openclaw/.env or agent config

These are different keys for different things. The brain doesn't need your model key. Your agent doesn't need the Oracle key. Don't mix them up.

Related

• OpenRoyleAl — Sovereign. Your Voice. No Masters.
• Moltworker — Deploy an AI agent in 2 minutes
• Grand Royle Arena — Chess dashboard (coming)
• Wartime.me — Training and player development

License

MIT — Fork. Deploy. Join the swarm.