← Back to Skills Marketplace
takao-mochizuki

OpenClaw Usage Manager

by Takao-Mochizuki · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ⚠ suspicious
344
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install openclaw-usage-manager
Description
Monitors dual Claude Max accounts' 5h/7d usage, shows real-time dashboard, and auto-switches when utilization exceeds 80%.
Usage Guidance
What to check before installing: - Inspect the repository your install will clone (the SKILL.md references a GitHub URL). Confirm the code matches what you were shown. - Understand token handling: the tool requires two Anthropic API tokens. You can use 1Password (recommended) or tokens.json (plaintext on disk). Prefer 1Password; if you use tokens.json, keep it chmod 600 and ensure the machine is trusted. - Backup ~/.openclaw/agents/main/agent/auth-profiles.json before running the auto-switcher. The checker overwrites that file to swap tokens; if misconfigured it could lock your agent or expose credentials. - Confirm dependencies: Node.js >=18 is required and the dashboard uses the 1Password CLI ('op') if you choose that setup path. The registry metadata did not declare these — the omission is a red flag. - Run the dashboard and scripts locally (not on a production machine) first and review network activity (they call api.anthropic.com and run local commands like lsof/kill). The dashboard is designed to bind to localhost only, but verify that behavior in your environment. - If you are not comfortable having a tool rewrite OpenClaw agent auth files, do not install. Consider manual switching or a version that only reads usage and reports but does not alter agent configuration. - If you decide to proceed: inspect setup scripts (setup-tokens.sh / setup-tokens-simple.sh), review how tokens are passed to child processes, and ensure your 1Password CLI is logged in and secure. Keep a copy of the original auth-profiles.json and restrict file permissions.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-usage-manager Version: 1.1.0 The bundle provides a dashboard and auto-switching utility for managing multiple Anthropic accounts within OpenClaw by monitoring usage headers and updating the 'auth-profiles.json' configuration. While it performs high-risk operations such as modifying authentication tokens and executing shell commands (via execSync in server.mjs for 1Password CLI and process management), these actions are strictly aligned with its stated purpose. The implementation includes proactive security measures such as CSRF protection, host/origin validation for the local dashboard, atomic file writes, and restrictive file permissions (chmod 600) for token storage. No evidence of data exfiltration or malicious intent was found.
Capability Assessment
Purpose & Capability
The claimed purpose (monitor two Claude Max accounts and auto-switch) matches the included scripts: a local dashboard that fetches usage and a checker that can swap API tokens. However the registry metadata lists no required binaries or credentials whereas SKILL.md and the code require Node.js and (optionally) the 1Password CLI and Anthropic API tokens; that mismatch is an integrity/metadata issue.
Instruction Scope
Runtime instructions direct the user to copy files into ~/.openclaw/workspace/tools and run setup scripts. The checker script reads tokens.json and reads/writes the OpenClaw agent config at ~/.openclaw/agents/main/agent/auth-profiles.json to swap the active token — this modifies another agent's credential file. The dashboard server executes shell commands (op via execSync, lsof/kill) and posts to the Anthropic API. Those actions go beyond innocuous monitoring and require careful review and backups.
Install Mechanism
There is no install spec; the package is instruction-only with code files you copy locally (git clone). No remote downloads or extracted archives are used by the skill itself. That lowers installation risk, but the registry metadata omits that Node.js/op are required.
Credentials
The tool legitimately needs Anthropic API tokens for both accounts and suggests optionally using 1Password to retrieve them. Those credentials are sensitive and the skill stores them either in tokens.json (plaintext on disk, albeit with chmod 600) or accesses them via the 1Password CLI. The checker then overwrites OpenClaw's agent auth file with one of those tokens — giving the tool privilege over which account the agent uses. The registry declared no required env/credentials, which is inconsistent.
Persistence & Privilege
The skill does not set always:true, but it does modify another agent's configuration file (~/.openclaw/agents/main/agent/auth-profiles.json). Per the guidelines, a skill that writes credentials/config for other agents or system-wide agent settings should be treated as higher privilege — this increases blast radius if the script is compromised or misused.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-usage-manager
  3. After installation, invoke the skill by name or use /openclaw-usage-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
fix: replace hardcoded user paths with $HOME — no more /Users/sonia hardcode
v1.0.0
Initial release of openclaw-usage-manager. - Real-time browser dashboard for monitoring dual Claude Max account utilization (C1/C2) - Auto-switches between accounts when 5-hour or 7-day usage exceeds 80% - Includes cron-based checker running every 3 hours - Secure token storage using 1Password CLI recommended - Audited for security, local dashboard with CSRF protection
v0.1.0
Initial release of openclaw-usage-manager. - Real-time dashboard for monitoring dual Claude Max account usage (5h/7d limits). - Browser UI displays C1 and C2 utilization side-by-side. - Automatic account switching when either account exceeds 80% of any rate limit. - Includes cron-based auto-switcher (checks every 3 hours). - Strong security practices: 1Password integration, token protection, local-only dashboard. - Simple setup and usage instructions provided.
Metadata
Slug openclaw-usage-manager
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is OpenClaw Usage Manager?

Monitors dual Claude Max accounts' 5h/7d usage, shows real-time dashboard, and auto-switches when utilization exceeds 80%. It is an AI Agent Skill for Claude Code / OpenClaw, with 344 downloads so far.

How do I install OpenClaw Usage Manager?

Run "/install openclaw-usage-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenClaw Usage Manager free?

Yes, OpenClaw Usage Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does OpenClaw Usage Manager support?

OpenClaw Usage Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenClaw Usage Manager?

It is built and maintained by Takao-Mochizuki (@takao-mochizuki); the current version is v1.1.0.

💬 Comments