Skip to content

🪐 Claw — claw.aguidetocloud.com

Plain-English study reference for OpenClaw — the open-source agent runtime. A reading room, not a SaaS landing page.

Claw Planet is the plain-English, opinionated, honest-take, study-shaped reference for OpenClaw — the open-source agent runtime. Written by someone learning the runtime in public. Audience is tech-savvy practitioners (senior engineers, IT pros, infra people) — Sush himself plus people like him.

Status: PUBLIC LIVE at claw.aguidetocloud.com — 42 pages, indexable, mobile drawer + verification banner shipped 10 May 2026 (Batch 13 UX rebuild).

Standalone planet — own physics (sister to Agentic)

Like Agentic Planet, Claw Planet does NOT follow cosmos rules. No shared cosmos-config. No shared cosmos-nav. No cross-planet rail. Each planet is its own thing with its own visual system and own brand profile.

What it shares with the family: Sush's voice, deploy pattern, CI guardrails. What it does NOT share with Agentic: visual system (light + dark study reference vs Agentic's dark cockpit), layout (sidebar + reading column + margin notes vs dashboard panels), brand colour (OpenClaw red vs cyan signal), content pattern (lighter "field notes" with dispute mechanism vs formal scorecards).

Naming

Claw Planet is the doc site. OpenClaw is the open-source runtime the doc site teaches. They are not the same thing. Don't conflate them.

What it is, in one screen

The home page IS the index. Persistent sidebar TOC. Margin-notes column for verification states. §-numbered sections. Definition-list catalogues. Reading-aids subordinated. No SaaS hero.

§ Section Purpose
§1 Overview What OpenClaw is, why it exists, the primitive map
§2 Setup How to install — laptop, Linux, Azure, Pi (multiple route cards)
§3 Connections What you plug in (LLMs, tools, data sources)
§4 Plugins (field notes) Lightweight per-plugin notes with verification states
§5 Use cases (recipes) End-to-end working examples
§6 Security High-level practical security
§7 Compare Deep matchups vs MCP and others
§8 Updates Watchlist of changes worth knowing
§9 Resources Curated upstream links
§10 FAQ Honest answers to common questions
Foundation /methodology · /colophon · /404 · /llms.txt · home Standard pages

Identity

Element Decision
Atmosphere Reference / study site. Not a SaaS landing. Reading-room calm, not signal-density.
Theme Light + dark, both first-class, via [data-theme]
Brand colour OpenClaw red — #FF2626 (light) / #FF4747 (dark, slightly softened)
Type Inter throughout (display + body) + JetBrains Mono for metadata. Google Fonts CDN.
Logo Bracket Mark [*] — square brackets in ink, asterisk in OpenClaw red. Reads as footnote · annotation · reference · code. Theme-aware via CSS classes.
Layout Sidebar TOC (left) + reading column (centre) + margin notes (right). Narrower outer gutters, generous main-column padding.
Verification states Every applicable page carries a verification badge — sourced (citation only), tried (Sush ran it), witnessed (Sush saw it work in production). Field notes also carry a dispute mechanism.

Belief language (Claw's dialect)

Claw inherits the universe belief and adds study-reference discipline:

  • Always explain with examples · scenarios · comparisons. Definitions alone are not enough.
  • Always answer "why does this matter" for important concepts.
  • Quality over speed. No marketing voice. Forbidden words inherited from Agentic Planet voice-lint.
  • Honest disagreement allowed. Field notes have a dispute mechanism — readers can raise that a note conflicts with their experience, with context.
  • Sush is also a learner here. "For Sush himself plus people like him."

The verification states (a study-reference signature)

Each page or field note declares one of:

State What it means
Sourced Information is from upstream docs / repo / vendor blog. Sush hasn't personally tested. Citation present.
Tried Sush has run the example or installed the thing. The evidence is fresh.
Witnessed Sush has seen this work in production (his own or a customer's). Highest signal.

Verification state is shown in the margin-notes column on every applicable page. The legend lives at the top of the margin column.

Cosmos placement

  • Standalone visual identity — own atmosphere, own layout, own typography
  • Shared belief language — plain English, honest take, Microsoft disclosure (where relevant), no monetisation, no email walls
  • Shared deploy pattern — Cloudflare Pages with custom REST API script (wrangler unshipped on win32-arm64)
  • Future cross-link — Phase 4 will link from Agentic Planet ("agents you can run with OpenClaw") to Claw Planet
  • No cosmos-config participation at v1 — does not vendor [cosmos] block, does not appear in the cross-planet manifest

Phase plan (current)

Phase What Status
P0a Soft launch under noindex. Batches 1–10. Playbook + Astro scaffold + CF Pages infra + 10 § sections fleshed enough to be useful. In progress (Batches 1–5 shipped: §1 Overview live with 4 entries)
P0b Public-credible launch. Ratchet INTEGRITY_LINK_THRESHOLD to 0. Remove noindex. Pending
P1 Deeper reference. More plugin field notes. More recipes. More compare matchups. Pending
P4 Cross-link from Agentic Planet Future

Architecture, in one paragraph

Astro 5 + MDX + React islands → Cloudflare Pages → custom domain claw.aguidetocloud.com. Same deploy mechanics as Agentic — direct Cloudflare REST API script, wrangler can't run on win32-arm64. CI guardrails: voice-lint, integrity-check, smoke-check, audit-claims. Cloudflare Pages project ID c4044607-91bb-431f-935e-b85abe008e9a, custom domain provisioned via Google CA, DNS CNAME claw → claw-planet.pages.dev (proxied), GH Actions secrets CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID set via gh CLI.