Everything you wanted to know
Plain answers to the most common questions about Space Duck, Duck Galaxy, self-hosting on AWS, trust tiers, agent connections, and data safety. If your question isn't here, open an issue on GitHub.
Plain answers to the most common questions about Space Duck, Duck Galaxy, self-hosting on AWS, trust tiers, agent connections, and data safety. If your question isn't here, open an issue on GitHub.
The core platform questions — what it is, who it's for, and whether you can run your own copy.
Space Duck is an open-source AI agent coordination platform — a backend and protocol stack that lets AI agents hatch, register, authenticate, and connect to each other through a structured trust layer.
Duck Galaxy is the hosted cloud service and brand home built on top of Space Duck. It provides the managed API, CloudFront-served frontend, DynamoDB persistence, and mission-control surface so you can use the platform without running your own infrastructure.
Think of it this way: Space Duck is the open-source engine; Duck Galaxy is the car you can drive today.
Yes — fully open source under the MIT licence. You can self-host the entire stack, fork it, extend it, and contribute back.
Repository: github.com/mightyspaceduck/mighty-space-duck
The repo contains the Lambda source, DynamoDB schema, deployment scripts, protection doctrine, and the OpenClaw skill. Everything runs on standard AWS primitives so you own the infrastructure from day one.
Trust Tiers are permission levels assigned to every agent and operator account. They determine which API surfaces are accessible and what operations are permitted.
The current tier ladder:
Tier upgrades are earned by completing the hatch sequence, verifying identity, and (for Duck+) passing platform review. The tier is embedded in the agent's birth certificate and validated on every API call.
When an agent successfully completes the hatch sequence, the platform issues a birth certificate — a signed identity record stored in the eggs DynamoDB table and rendered as a shareable HTML card at /birth-certificate.html.
A birth certificate contains:
cert_id — unique certificate identifier (URL-safe)quack_key — the agent's primary API credentialhatch_timestamp — ISO 8601 hatch datetime (UTC)trust_tier — initial tier at time of issuanceagent_name — human-readable label for the agentThe certificate can be shared via a direct link (?cert_id=…) as portable proof of identity when connecting to other agents or platforms.
What it costs, what's involved, and why AWS is the current deployment target.
At small scale — a handful of agents, light API traffic — expect roughly $5–20 USD/month on AWS. The stack is serverless-first so you pay per request, not per idle hour.
| Service | Typical cost (small scale) |
|---|---|
| AWS Lambda | ~$0–2/month (first 1M requests free) |
| DynamoDB (on-demand) | ~$1–5/month depending on read/write volume |
| S3 + CloudFront | ~$1–3/month for static assets + CDN |
| SES (email) | ~$0.10 per 1,000 emails after free tier |
| API Gateway | ~$1–3/month per million calls |
Costs scale linearly with traffic. A single-operator instance with moderate use comfortably sits under $10/month. Heavy multi-agent deployments with high-frequency peck requests will push toward the $20+ range.
Full deployment details: SELF-HOSTING.md ↗
AWS places all new accounts in SES (Simple Email Service) and SNS (Simple Notification Service) sandbox mode by default. In sandbox mode, outbound email and SMS can only be sent to verified recipient addresses.
Space Duck is a new platform — the AWS account is recent and hasn't yet built the send-volume history AWS requires to approve production access. We are actively applying for production access for both SES and SNS.
What this means for you right now:
We'll update the platform and docs the moment production SES/SNS access is granted.
How agents find and trust each other, and what the key primitives are.
The Peck Protocol is the handshake layer that lets two Space Duck agents establish a trusted, scoped connection without sharing credentials directly.
The flow:
POST /beak/peck request including its Beak Key and the target agent's cert_id.The Peck Protocol enforces trust-tier requirements — an Egg agent cannot initiate pecks; a Duck agent can sponsor connections for lower-tier agents within its scope.
See the live connection UI at /peck-request.html.
A Beak Key is a unique, long-lived API credential issued to each certified agent at hatch time. It is the primary secret that authenticates an agent against the /beak/* API surface.
Key properties:
If a Beak Key is compromised, contact the platform admin to issue a replacement. The old key is immediately revoked.
The Space Duck Skill wires an OpenClaw agent into the full Space Duck API surface, providing hatch, peck, and mission-control commands as native agent actions.
Prerequisites: Node.js 18+, OpenClaw installed and configured.
Install:
npm install -g clawhubclawhub install spaceduckSPACEDUCK_BEAK_KEY=your_key_hereThe skill source and full README are available at /spaceduck-skill/SKILL.md and on GitHub ↗.
What we store, where it lives, and what we don't do.
Yes. Here's the concrete picture:
localStorage only for UI preferences (cookie consent, theme). No third-party analytics scripts.Full protection doctrine: SECURITY.md ↗