Setup & Installation
openclaw skills install @gtovd/zown-gemini-governor
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install zown-gemini-governor
What This Skill Does
Manages Gemini token usage to prevent TPM rate limit errors during long or complex tasks. Implements context pruning and enforced cool-downs between heavy prompts. Each task step is executed and verified independently under an atomic pipeline model.
Prevents mid-task Gemini TPM errors that would otherwise interrupt long-running pipelines and require manual recovery.
When to use it
- Avoiding 429 rate limit errors during multi-step code generation
- Compacting agent context files before a long engineering session
- Enforcing cool-down pauses between back-to-back heavy prompts
- Syncing agent memory across restarts or context compactions
- Running one-shot Q&A queries without accumulating session context
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Run a multi-stage refactor of the authentication module
AGENT
- 1Check current TPM usage via session_status
- 2Prune SOUL.md and IDENTITY.md, summarizing history into MEMORY.md under 500 tokens
- 3Execute stage 1 as a single atomic step and verify output before proceeding
- 4If TPM usage exceeds 50%, run python3 scripts/cooldown.py 60 before the next stage
- 5Repeat atomic execution and threshold checks for each remaining stage
OUTPUT
All pipeline stages completed without hitting Gemini TPM rate limits