openclaw-optimization-guide/SCORECARD.md at master · OnlyTerp/openclaw-optimization-guide · GitHub
Skip to content

Latest commit

 

History

History
128 lines (95 loc) · 11.8 KB

SCORECARD.md

File metadata and controls

128 lines (95 loc) · 11.8 KB

The OpenClaw Production Readiness Scorecard

Score your OpenClaw setup against the patterns in the OpenClaw Optimization Guide. 50 items across 5 pillars. 2 points each. 100 possible. Updated for OpenClaw 2026.6.11 stable.

Share your score: "My OpenClaw Production Readiness Scorecard: XX / 100 — github.com/OnlyTerp/openclaw-optimization-guide"

How to use this

  1. Fork / clone this repo or copy this file into your own setup.
  2. Walk the 50 items. Check the ones you've genuinely done.
  3. Add up your score: each checked box = 2 points, max 100.
  4. Post the total. Tag us. Argue about which items matter most.

Every item links to the part of the guide that covers it. If you're about to check something and can't explain why it matters, go read the linked part.


Pillar 1 — Speed (20 points)

Do your agents respond in seconds, not minutes? If every turn feels sluggish, context bloat is almost always the reason.

  • SOUL.md is under 1 KB. → Part 2
  • AGENTS.md is under 2 KB. → Part 2
  • MEMORY.md is under 3 KB and is a pure index, not a content store. → Part 4
  • TOOLS.md uses one-liners per tool, not full JSON schemas. → Part 2
  • Total injected context per message is under 8 KB, verified by logging a turn or reviewing /context map. → Part 1
  • contextPruning.mode: "cache-ttl" with a 5-minute TTL. → Part 2
  • Reasoning mode is OFF on the default model, ON only for orchestration. → Part 6
  • Compaction runs on a cheap non-reasoning model (e.g. Cerebras gpt-oss-120b), not on Gemini Flash or an Opus/GPT key. → Part 15
  • Cron output is isolated (memory/cron/ or suppressed) so bulk scheduled runs don't flood session memory. → Part 3
  • For small local worker agents (≤14B), agents.list[].experimental.localModelLean: true is set only on those workers. → Part 6

Pillar 2 — Memory (20 points)

Can your agent remember what it did yesterday, what you decided last week, and where the relevant code lives?

  • Vault structure is claim-named (what-a-b-testing-tells-you-about-activation.md), not date-named (2026-04-16-notes.md). → Part 9
  • At least one MOC (Map of Contents) exists under vault/01_thinking/. → Part 9
  • memory_search is used (by rule, enforced in AGENTS.md) before the agent claims it doesn't remember. → Part 4
  • Embeddings run locally on Ollama (e.g. qwen3-embedding:0.6b), not on a cloud provider. → Part 10
  • Search latency on your live vault is under ~150ms on a warm cache. → Part 4, Part 10
  • Memory-core built-in dreaming is enabled with a nightly schedule. → Part 22
  • Dream phase blocks live under memory/dreaming/{phase}/ (dreaming.storage.mode: "separate", the current default). → Part 22
  • DREAMS.md has at least one real sweep entry from the last 7 days. → Part 22
  • Auto-capture hook is wired to extract claim-named notes from session transcripts. → Part 11
  • LightRAG is enabled if your vault has ≥500 files. (Otherwise, credit this item.) → Part 18

Pillar 3 — Orchestration (20 points)

Does the frontier model plan while cheap workers execute, or is your orchestrator doing everything itself?

  • Orchestrator uses a frontier model (Opus / GPT-5 / Gemini Pro). → Part 6
  • Workers use cheaper/faster models (Sonnet / GPT-5-mini / Flash / Cerebras). → Part 6
  • AGENTS.md has an explicit "spawn sub-agent if …" rule. → Part 5
  • Independent tasks are spawned in parallel, not serially. → Part 5
  • You've used the Coordinator Protocol (Research → Synthesis → Implement → Verify) at least once on a real task. → Part 5
  • Each worker's prompt is self-contained (no "based on the above / your findings / the plan"). → Part 5
  • At least 2 fallback models are configured; you've verified failover works. → Part 6
  • Ralph-style implement→test→loop pattern is wired somewhere (or you've consciously decided it's overkill). → Part 5
  • If you ship code: Repowise (or an equivalent structural index) feeds workers instead of re-reading files every spawn. → Part 19
  • Memory Bridge injects your vault into external coding agents, and Codex workers use canonical openai/gpt-* app-server routes. → Part 13, Part 33

Pillar 4 — Security & Control Plane (20 points)

If a compromised skill ships tomorrow, how much of your system does it reach?

  • Task Brain is live (openclaw tasks list and openclaw tasks maintenance --json return useful output). → Part 24
  • Approval policy is set at the control-plane choke point — by semantic intent, not raw tool names or skill-shell preludes. On 2026.4.15+ verify the shipping knobs (tools.exec.security, tools.exec.ask, tools.fs.workspaceOnly) with openclaw exec-policy show. → Part 24
  • control-plane.* is set to deny for every non-admin agent. → Part 24
  • write.fs.outside-workspace is deny by default, and tools.toolsBySender strips mutation/runtime/Codex/MCP tools from public senders. → Part 24
  • skills.autoUpdate is OFF. → Part 23
  • Every installed ClawHub skill/plugin is pinned to a commit or tag, not a branch, and typed tool plugins pass openclaw plugins validate. → Part 23
  • You've read the source/manifest of every ClawHub skill or plugin you have installed, including embedding/source-provider contracts. → Part 23
  • Credentials live in environment variables or OS keychain, not in openclaw.json, AGENTS.md, or memory/. → Part 15
  • Approval UI shows redacted secrets (sk-***) — you upgraded to 2026.4.15+. → Part 15
  • Canvas Model Auth status card shows all providers green; you've tested auth hot-reload and Codex OAuth repair if used. → Part 15

Pillar 5 — Observability & Reliability (20 points)

When something breaks at 3am, can you answer "what ran, with what permissions, and why did it fail" in under 5 minutes?

  • Every ACP call, cron job, and sub-agent spawn shows up in openclaw tasks list / openclaw tasks flow list (i.e. nothing runs outside Task Brain). → Part 24
  • Gateway startup script has stale-process cleanup so a zombie doesn't block port 18789. → Part 15
  • Compaction reserveTokens is capped to the model's context window (auto in 2026.4.15+; verify anyway). → Part 15
  • You run openclaw doctor and openclaw policy check after every upgrade/shared-channel change and archive the output. → Part 26
  • Native diagnostics plus LangFuse / OpenTelemetry / equivalent LLM tracing are enabled for at least one agent. → Part 20
  • Auto-capture hook is running; you've confirmed it produces inbox notes. → Part 11
  • Self-improving system is on: .learnings/corrections.md, .learnings/ERRORS.md, .learnings/LEARNINGS.md are being written to. → Part 12
  • Real-time knowledge sync (file watcher → vector index) is running. → Part 21
  • You have a one-command rollback plan from your current version to the previous one, including plugin/Meeting Notes/voice rollout. → Part 26
  • You've tested rollback at least once, active-run queue mode is documented for shared channels, and Meeting Notes retention is documented if enabled. → Part 26

Scoring

Count your checked boxes and multiply by 2:

Score Band What it means
90–100 Production-grade You are running OpenClaw the way it wants to be run. Talk at a conference.
70–89 Solid Real production deployment, one or two pillars still soft. Use the unchecked boxes as a backlog.
50–69 Working but leaky Works day-to-day; one bad skill or one upgrade gone wrong is a bad weekend.
30–49 Stock-plus You've done some of the basics; most of the wins in this guide are still on the table.
0–29 Stock Fine for tinkering. Do not point it at anything production until you close the Security pillar.

Rules for honest scoring

  • Don't check an item because you mean to do it — only because it's live right now.
  • "Almost" is a zero. If your MEMORY.md is 3.4 KB, that pillar item is zero, not half.
  • If an item doesn't apply (e.g. you don't ship code, so Repowise is irrelevant), grant yourself the 2 points — but only once you've genuinely confirmed it doesn't apply, not because it sounded complicated.
  • Retake the scorecard after every OpenClaw upgrade. The items don't move, but the defaults do.

Why these 50

This is not a vendor checklist. Every item is here because skipping it burned us at least once on a real deployment. The ranking — Speed, Memory, Orchestration, Security, Observability — roughly matches the order in which things start to hurt as you move from toy to production:

  • Speed is the first thing users notice.
  • Memory is the first thing you notice (the agent "forgets" a decision and you re-explain).
  • Orchestration is where costs explode.
  • Security is where you stop sleeping well.
  • Observability is what lets you recover when one of the other four fails.

See Part 25 — Architecture Overview for the 15-minute primer on why the pieces fit this way.


Contributions and corrections welcome. Open an issue at github.com/OnlyTerp/openclaw-optimization-guide or see CONTRIBUTING.md.