Skip to content

Commit 75f4833

Browse files
Merge pull request #22 from OnlyTerp/devin/1782940894-july-2026-refresh
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2 parents 3668541 + 0f6f9b0 commit 75f4833

9 files changed

Lines changed: 163 additions & 203 deletions

AWESOME.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
**A curated list of resources for getting the most out of OpenClaw.** Skills, guides, talks, templates, tools, research. Contributions welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md).
44

5-
> This list is opinionated. Inclusion here means we've actually used it on a production OpenClaw deployment or seen it solve a real problem. Broken or abandoned links are removed aggressively. Last curated: **June 2026, tracking OpenClaw 2026.6.4 stable + 2026.6.11-beta.1**.
5+
> This list is opinionated. Inclusion here means we've actually used it on a production OpenClaw deployment or seen it solve a real problem. Broken or abandoned links are removed aggressively. Last curated: **July 2026, tracking OpenClaw 2026.6.11 stable**.
66
77
## Contents
88

@@ -35,7 +35,7 @@
3535
## Guides & tutorials
3636

3737
- **[OpenClaw Optimization Guide](./README.md)** — this repo. 33 parts, refreshed for the June 2026 release wave.
38-
- **[June 2026 Field Guide](./part33-late-april-2026-field-guide.md)** — the fast catch-up map from 2026.5.22 to the 2026.6.4 stable baseline (2026.6.11-beta.1 tracked).
38+
- **[June 2026 Field Guide](./part33-late-april-2026-field-guide.md)** — the fast catch-up map from 2026.5.22 to the 2026.6.11 stable baseline.
3939
- **[Official "Getting Started" path](https://clawdocs.org/start)** — the minimum-viable setup. Read this first if you're brand new.
4040
- **[The OpenClaw CVE flood, Feb–Mar 2026](https://www.tryopenclaw.ai/blog/openclaw-cve-flood-march-2026/)** — the definitive writeup on the **ClawHavoc** supply-chain campaign.
4141
- **[Migration Guide — v3 → v4 → June 2026](./part26-migration-guide.md)** — opinionated upgrade paths.
@@ -69,8 +69,8 @@ See [Part 23 — ClawHub Skills Marketplace](./part23-clawhub-skills-marketplace
6969
- **[memory-core](https://github.com/openclaw/memory-core)** — the built-in memory plugin with native dreaming (3 phases). Replaced the custom-autoDream patterns in v4.
7070
- **[memory-lancedb](https://github.com/openclaw/memory-lancedb)** — LanceDB vector store. 2026.4.15-beta.1 added cloud storage mode.
7171
- **Active Memory filters** — current builds support per-conversation `allowedChatIds` / `deniedChatIds`, partial recall on timeout, and people-aware wiki provenance views.
72-
- **Meeting Notes plugin** — 2026.5.22 source-only external plugin for date-sharded meeting transcripts, manual imports, CLI reads, and Discord voice as the first live source. 2026.6.4 adds Google Meet live capture plus `meetingNotes.retentionDays`/redaction. Define retention before enabling.
73-
- **Recall + dreaming tuning**2026.6.4 ships `memory promote --dry-run` (review what dreaming would promote before it mutates); 2026.6.11-beta.1 adds `memory.recall.maxParallel` and scheduled dreaming (`memory.dreaming.schedule`) so consolidation runs off-hours.
72+
- **Meeting Notes plugin** — 2026.5.22 source-only external plugin for date-sharded meeting transcripts, manual imports, CLI reads, and Discord voice as the first live source. Define retention and redaction policy before enabling any live capture.
73+
- **Memory promotion review**`openclaw memory promote` is dry-run by default; preview candidates, use `memory promote-explain "<query>"` to understand scoring, then `--apply` deliberately. `memory status --deep` probes vector-store and embedding readiness; `--fix` repairs stale recall locks.
7474
- **Generic embedding provider contract** — 2026.5.22 plugin SDK surface (`contracts.embeddingProviders`, `api.registerEmbeddingProvider`) that should make explicit OpenAI-compatible embedding providers cleaner.
7575
- **[Ollama](https://ollama.com/)** — local embedding runtime. `qwen3-embedding:0.6b` is the right default for most setups.
7676
- **[LightRAG](https://github.com/HKUDS/LightRAG)** — graph + vector hybrid RAG. The right upgrade once your vault crosses ~500 files. See [Part 18](./part18-lightrag-graph-rag.md).
@@ -94,8 +94,8 @@ See [Part 23 — ClawHub Skills Marketplace](./part23-clawhub-skills-marketplace
9494
## Observability & evaluation
9595

9696
- **OpenClaw native diagnostics** — late-May builds add sanitized `secrets.prepare` spans, bounded skill usage metrics, tool source/owner labels, Prometheus smoke aliases, and richer `tasks maintenance --json`.
97-
- **Per-agent budget caps** — 2026.6.4 `agents.list[].budget` (`dailyUsd`/`monthlyUsd`, `onExceed: warn|degrade|stop`) turns cost governance into config instead of after-the-fact token-report reading. See [Part 33](./part33-late-april-2026-field-guide.md).
98-
- **`/context map --diff`** — 2026.6.11-beta.1 compares the current prompt treemap against the previous run's snapshot to catch context regressions.
97+
- **Per-agent cost visibility** — 2026.6.11 `openclaw gateway usage-cost --agent <id>` / `--all` shows spend per configured agent; cron it daily and diff. Pair with `/usage full` footers for in-channel per-turn cost. See [Part 33](./part33-late-april-2026-field-guide.md).
98+
- **Automatic fast mode** — 2026.6.10 `/fast auto` runs short conversational turns in the provider's fast lane and returns to normal mode for longer work; `/fast status` shows the effective state through fallback switches.
9999
- **[LangFuse](https://langfuse.com/)** — the lightest-weight LLM tracing that actually works end-to-end with OpenClaw surfaces.
100100
- **[OpenTelemetry LLM instrumentation](https://opentelemetry.io/docs/specs/semconv/gen-ai/)** — the standards track. Pair with LangFuse or Grafana Tempo.
101101
- **Canvas Model Auth status card** — built into 2026.4.15-beta.1+. The one dashboard you actually read every day.
@@ -114,8 +114,8 @@ See [Part 23 — ClawHub Skills Marketplace](./part23-clawhub-skills-marketplace
114114

115115
- **[Task Brain](./part24-task-brain-control-plane.md)** — OpenClaw's control plane. Semantic approval categories, agent-initiated denies, unified task flow registry.
116116
- **Approval policy reference**[templates/openclaw.example.json](./templates/openclaw.example.json) ships with a starting-point policy block.
117-
- **Policy plugin** — bundled in 2026.5.20. Run `openclaw policy check` for channel conformance checks, attestations, doctor findings, and opt-in repair. 2026.6.4 adds `--export` attestations you can schedule and diff for drift gating.
118-
- **Provider health checks** — 2026.6.4 `models.providers.<id>.health` adds interval probes with bounded automatic lane demotion, so a failing provider routes around itself instead of failing every turn.
117+
- **Policy plugin** — bundled in 2026.5.20. Run `openclaw policy check` for channel conformance checks, doctor findings, and opt-in repair; `policy check --json` emits stable attestation hashes you can schedule, store, and diff for drift gating.
118+
- **Per-job cron fallbacks** — 2026.6.11 `openclaw cron edit <job> --fallbacks ...` gives individual scheduled jobs their own fallback models (or a strict no-fallback run with `--fallbacks ""`), so overnight provider incidents degrade instead of killing the schedule.
119119
- **Task maintenance JSON**`openclaw tasks maintenance --json` now explains stale-running retention/reconcile decisions for cron, CLI, backing sessions, and wedged sub-agents.
120120

121121
## UI surfaces & clients

README.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2,31 +2,31 @@
22

33
**Make your OpenClaw AI agent faster, smarter, cheaper, and actually safe to run in production.**
44

5-
[![Current sweep: 2026.6.11 beta](https://img.shields.io/badge/OpenClaw-2026.6.11--beta.1-2ea44f)](./part33-late-april-2026-field-guide.md)
6-
[![Stable baseline: 2026.6.4](https://img.shields.io/badge/stable-2026.6.4-blue)](./part26-migration-guide.md)
5+
[![Current sweep: July 2026](https://img.shields.io/badge/OpenClaw-2026.6.11-2ea44f)](./part33-late-april-2026-field-guide.md)
6+
[![Stable baseline: 2026.6.11](https://img.shields.io/badge/stable-2026.6.11-blue)](./part26-migration-guide.md)
77
[![33 parts](https://img.shields.io/badge/parts-33-blue)](#full-table-of-contents)
88
[![Scorecard](https://img.shields.io/badge/scorecard-50_items-8957e5)](./SCORECARD.md)
99
[![Awesome](https://img.shields.io/badge/awesome-list-fc60a8)](./AWESOME.md)
1010
[![Benchmarks](https://img.shields.io/badge/benchmarks-reproducible-0a7bbb)](./benchmarks/METHODOLOGY.md)
1111
[![License: MIT](https://img.shields.io/badge/license-MIT-lightgrey)](./LICENSE)
1212
[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](./CONTRIBUTING.md)
1313

14-
> **June 2026 sweep.** Stable baseline: **OpenClaw 2026.6.4**. Beta tracked: **2026.6.11-beta.1**. This refresh advances the late-May guidance to the current line: per-agent budget caps, scheduled Policy attestations with drift gating, provider health checks with automatic failover, Google Meet live capture for Meeting Notes with retention/redaction, recall/dreaming tuning, `/context map --diff`, sandbox egress allowlists, and `openclaw doctor` secret-rotation + MCP-scope lint.
14+
> **July 2026 sweep.** Stable baseline: **OpenClaw 2026.6.11** (released 2026-06-30). This refresh covers the 2026.6.8–2026.6.11 trains — automatic fast mode, working failover, per-agent cost visibility, prompt-cache retention, cron fallback controls, and channel-delivery self-recovery — and **corrects the previous revision**, which referenced a "2026.6.4" release and several config keys that were never shipped. See the correction note in [Part 33](./part33-late-april-2026-field-guide.md).
1515
1616
*By Terp — [Terp AI Labs](https://x.com/OnlyTerp)*
1717

1818
---
1919

20-
## Start With The June 2026 Reality Check
20+
## Start With The July 2026 Reality Check
2121

22-
The late-May betas are now stable, and early-June added four cost/safety levers worth wiring in. If you last read this guide around 2026.5.22/2026.5.24, these are the new rules:
22+
The June trains (2026.6.8 → 2026.6.11) were about making OpenClaw dependable. If you last read this guide in mid-June, these are the new rules:
2323

2424
1. **Claude subscription-era advice is dead.** Anthropic's April 4 policy change broke the old "Claude Pro/Max covers OpenClaw" path. Treat Claude as paid API / Bedrock / provider-routed usage unless your own install proves otherwise.
25-
2. **Budgets belong in config.** 2026.6.4 makes per-agent `agents.list[].budget` caps first-class with `onExceed: warn|degrade|stop`. Give the orchestrator a cap and let `degrade` reroute routine work to cheap lanes automatically.
26-
3. **Policy checks should be scheduled, not one-shot.** `openclaw policy check --export` produces diffable attestations; schedule it (and wire it into CI) so channel-policy drift is caught instead of discovered. Opt-in repair stays a human step.
27-
4. **Provider routing now self-heals.** Add `models.providers.<id>.health` checks so a failing lane demotes itself for a bounded window instead of failing every turn — but only if you configured fallback lanes.
28-
5. **Voice/meetings need retention, not just capture.** Discord voice and the new Google Meet live source feed Meeting Notes; set `meetingNotes.retentionDays` and redaction rules before auto-capture so transcripts expire and scrub sensitive fields.
29-
6. **Memory and context got tunable.** `memory.recall.maxParallel`, scheduled dreaming, `memory promote --dry-run`, and `/context map --diff` let you tune recall, consolidation, and context regressions deliberately instead of by feel.
25+
2. **Cost visibility is per-agent now.** `openclaw gateway usage-cost --agent <id>` (or `--all`) shows spend per configured agent; cron it daily and treat spend jumps as context regressions. (There is no per-agent budget-cap config key — an earlier revision of this guide claimed one in error.)
26+
3. **Failover actually fires.** Provider overloads are classified correctly, usage-limit responses route to fallbacks, and individual cron jobs can carry their own `--fallbacks` list (or run strict with `--fallbacks ""`). None of it helps without at least two configured lanes.
27+
4. **Fast mode is automatic.** `/fast auto` (2026.6.10) runs short conversational turns in the provider's fast lane and returns to normal mode for longer work, with correct status through retries and fallback switches.
28+
5. **Long sessions got cheaper.** Tool-heavy sessions now retain prompt-cache savings as results accumulate (2026.6.11) — one more reason to keep sessions long-lived and compaction healthy instead of resetting constantly.
29+
6. **Stuck channels self-recover.** Telegram/WhatsApp queues that wedge after a crash or long-running task resume automatically in 2026.6.11. "Restart the gateway" should leave your runbooks.
3030

3131
Read **[Part 33 — June 2026 Field Guide](./part33-late-april-2026-field-guide.md)** first if you want the latest tricks before the deep dives.
3232

@@ -156,14 +156,13 @@ Alongside the 33 parts themselves, this repo now includes the tooling that turns
156156

157157
---
158158

159-
## What Changed In This Release (June 2026 Refresh)
159+
## What Changed In This Release (July 2026 Refresh)
160160

161-
- **Updated [Part 33 — June 2026 Field Guide](./part33-late-april-2026-field-guide.md)** — advances the catch-up map to the current **2026.6.4 stable** baseline (2026.6.11-beta.1 tracked) and adds four new tips: budget caps, scheduled Policy attestations, provider health checks/failover, and recall/dreaming tuning.
162-
- **Cost governance is now first-class** — per-agent `agents.list[].budget` caps with `onExceed: warn|degrade|stop` replace "read the token report afterward." The orchestrator gets a cap; `degrade` reroutes routine work to cheap lanes.
163-
- **Policy and routing self-audit**`openclaw policy check --export` produces diffable, schedulable attestations, and `models.providers.<id>.health` checks demote a failing provider for a bounded window instead of failing every turn.
164-
- **Voice/meetings gain retention** — Google Meet joins Discord voice as a Meeting Notes live source, with `meetingNotes.retentionDays` and redaction rules so transcripts expire and scrub sensitive fields.
165-
- **Memory/context tuning**`memory.recall.maxParallel`, scheduled dreaming, `memory promote --dry-run`, and `/context map --diff` make recall, consolidation, and context-regression checks deliberate.
166-
- **Security additions** — sandbox egress allowlists (`sandbox.network.allow`), secret-rotation reminders, and unscoped-Codex-MCP lint are now `openclaw doctor` findings.
161+
- **Correction.** The June refresh referenced a "2026.6.4 stable" release and config keys (`agents.list[].budget`, `models.providers.<id>.health`, `policy check --export`, `memory promote --dry-run`, `memory.recall.maxParallel`, `sandbox.network.allow`, `/context map --diff`, `secrets.rotation.maxAgeDays`, `meetingNotes.retentionDays`) that do not exist in any published OpenClaw release. Those sections have been rewritten around shipped features, and the templates have been fixed. Details in the correction note at the top of [Part 33](./part33-late-april-2026-field-guide.md).
162+
- **Rebaselined on [2026.6.11 stable](https://github.com/openclaw/openclaw/releases)** — the version map now tracks the real June trains: 2026.6.8, 2026.6.9, 2026.6.10, 2026.6.11.
163+
- **New Part 33 tips** — per-agent cost visibility (`openclaw gateway usage-cost`), scheduled `policy check --json` attestations, working failover + per-cron-job `--fallbacks`, safe-by-default `memory promote` / `--apply` workflow, and automatic fast mode (`/fast auto`).
164+
- **Security guidance updated** — secrets redacted from debug output, admin-only HTTP session/model overrides, package-source redirect/lookalike-path hardening, actionable `plugins.allow` trust warnings, `@owner/<slug>` skill verification, and key-free web-search providers staying opt-in.
165+
- **Ops quality-of-life** — official `openclaw/openclaw` Docker Hub mirror, Slack router relay mode for multi-gateway deployments, `openclaw agent --message-file`, and cron `deleteAfterRun` transcript cleanup.
167166

168167
### Previous Late-May 2026 refresh
169168

@@ -265,7 +264,7 @@ Not every part applies to every reader. Jump directly to the pillar that matches
265264
13. [Memory Bridge](./part13-memory-bridge.md) — give Codex / Claude Code access to your vault
266265
22. [Built-In Dreaming (memory-core)](#part-22-built-in-dreaming) — official 3-phase consolidation, DREAMS.md, memory-you-can-afford (LightMem + vbfs)
267266
31. [The LLM Wiki Pattern In OpenClaw](./part31-the-llm-wiki-pattern-in-openclaw.md) — Karpathy's three-tier pattern mapped onto SOUL/AGENTS/MEMORY/skills
268-
33. [June 2026 Field Guide](./part33-late-april-2026-field-guide.md)budget caps, scheduled Policy attestations, provider health/failover, Meeting Notes retention, recall/dreaming tuning
267+
33. [June 2026 Field Guide](./part33-late-april-2026-field-guide.md)per-agent cost visibility, scheduled Policy attestations, working failover + cron fallbacks, memory promotion review, automatic fast mode
269268

270269
**🤝 Orchestration & models**
271270
5. [Orchestration](#part-5-orchestration-stop-doing-everything-yourself) — sub-agents-as-GC, Anthropic's 5 coordination patterns, CEO/COO/Worker, verification

SCORECARD.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# The OpenClaw Production Readiness Scorecard
22

3-
**Score your OpenClaw setup against the patterns in the [OpenClaw Optimization Guide](./README.md). 50 items across 5 pillars. 2 points each. 100 possible. Updated for OpenClaw 2026.6.4 stable and 2026.6.11 beta.**
3+
**Score your OpenClaw setup against the patterns in the [OpenClaw Optimization Guide](./README.md). 50 items across 5 pillars. 2 points each. 100 possible. Updated for OpenClaw 2026.6.11 stable.**
44

55
> Share your score: *"My OpenClaw Production Readiness Scorecard: XX / 100 — [github.com/OnlyTerp/openclaw-optimization-guide](https://github.com/OnlyTerp/openclaw-optimization-guide)"*
66

mkdocs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
site_name: OpenClaw Optimization Guide
2-
site_description: Make your OpenClaw AI agent faster, smarter, cheaper, and actually safe to run in production. Updated for OpenClaw 2026.6.4 stable and 2026.6.11 beta.
2+
site_description: Make your OpenClaw AI agent faster, smarter, cheaper, and actually safe to run in production. Updated for OpenClaw 2026.6.11 stable.
33
site_url: https://onlyterp.github.io/openclaw-optimization-guide/
44
repo_url: https://github.com/OnlyTerp/openclaw-optimization-guide
55
repo_name: OnlyTerp/openclaw-optimization-guide

0 commit comments

Comments
 (0)