Add OpenClaw integration guide for Cycles budget enforcement#32
Merged
Add OpenClaw integration guide for Cycles budget enforcement#32
Conversation
New integration guide covering the cycles-openclaw-budget-guard plugin: - Installation and minimal configuration - Budget levels and model downgrading - Tool cost estimation - Prompt budget hints - Fail-open vs fail-closed behavior - Verification with debug logging - Full config reference - Comparison with manual client integration - Cross-links to related guides Also adds the guide to the sidebar navigation. https://claude.ai/code/session_0115sU3TqN2tsqKWBiC8J3HD
- Remove misleading CYCLES_TENANT env var (plugin doesn't read tenant from env) - Add Node.js >= 20.0.0 to prerequisites - Add missing config fields: defaultModelActionKind, defaultToolActionKindPrefix - Fix example log field name: reservations -> totalReservationsMade - Add "Current limitations (phase 1)" section https://claude.ai/code/session_0115sU3TqN2tsqKWBiC8J3HD
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds comprehensive documentation for integrating the
cycles-openclaw-budget-guardplugin with OpenClaw agents, enabling automatic budget enforcement without custom code.Changes
New guide:
how-to/integrating-cycles-with-openclaw.md— complete integration documentation covering:modelFallbackstoolBaseCostsUpdated navigation: Added link to the new guide in
.vitepress/config.tsunder the "How-to" sectionImplementation Details
The guide documents the plugin's automatic handling of the Cycles reserve → commit → release lifecycle across five OpenClaw hooks (
before_model_resolve,before_prompt_build,before_tool_call,after_tool_call,agent_end), with emphasis on zero-custom-code operation and sensible defaults for all configuration options.https://claude.ai/code/session_0115sU3TqN2tsqKWBiC8J3HD