Skip to content

docs: update OpenClaw integration guide, blog, and ecosystem for plugin v0.7.3#268

Merged
amavashev merged 2 commits intomainfrom
claude/evaluate-openclaw-plugin-a4lms
Mar 27, 2026
Merged

docs: update OpenClaw integration guide, blog, and ecosystem for plugin v0.7.3#268
amavashev merged 2 commits intomainfrom
claude/evaluate-openclaw-plugin-a4lms

Conversation

@amavashev
Copy link
Copy Markdown
Contributor

@amavashev amavashev commented Mar 27, 2026

Summary

Updates all documentation to match the cycles-openclaw-budget-guard v0.7.3 release, including fixes discovered during live testing with OpenClaw.

Integration guide (how-to/integrating-cycles-with-openclaw.md)

  • Hook table: Updated for reserve-then-commit model pattern and model blocking workaround
  • v0.5.0 sections: Model cost reconciliation, MetricsEmitter, aggressive cache invalidation
  • v0.6.0 sections: Retry/heartbeat, burn rate/exhaustion forecast, session event log
  • Cost model explainer: USD_MICROCENTS conversion table, budget math, toolBaseCosts guidance
  • Fail-open caveat: Surfaced near top of document
  • Consistent naming: All metadata keys and log prefixes use openclaw-budget-guard
  • Removed env var fallbacks: Plugin no longer reads process.env — docs show OpenClaw interpolation syntax
  • Softened claims: "Abrupt failure" not "Graceless", no absolute "zero code changes"
  • npm badges: Version + downloads badges added after title

Blog post (blog/openclaw-budget-guard-stop-agents-burning-money.md)

  • Updated hook table for v0.6.0+ behavior (heartbeat, burn rate, event log, model blocking)
  • Added burn rate detection and exhaustion forecast to runaway spend section
  • Added MetricsEmitter and event log to visibility section
  • Added continuous protection capabilities (anomaly detection, retry, heartbeat)
  • Softened "zero code changes" language
  • Consistent "Abrupt failure" phrasing

Ecosystem page (how-to/ecosystem.md)

  • Added npm downloads badge to OpenClaw section (matching all other SDK entries)
  • Added direct npm package link

Test plan

  • All config property names match types.ts
  • All default values match config.ts
  • Version in log examples correct
  • No "commits immediately" for models
  • No "Graceless failure"
  • No "zero code changes"
  • Fail-open caveat present
  • All model names use versioned format
  • npm badge URLs use correct package name

https://claude.ai/code/session_016JXYAGrQ9bFio4BQpVP9V4

claude added 2 commits March 27, 2026 00:48
…d to openclaw-budget-guard

Match the plugin key that users see in their config. Updated log
examples and metadata key references throughout the integration guide.

https://claude.ai/code/session_016JXYAGrQ9bFio4BQpVP9V4
@amavashev amavashev merged commit 6a1d362 into main Mar 27, 2026
2 checks passed
@amavashev amavashev changed the title docs: update OpenClaw integration guide and blog for plugin v0.7.0 docs: update OpenClaw integration guide, blog, and ecosystem for plugin v0.7.3 Mar 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants