---
name: cacheforge-ops-cb54ed6da88e
version: 1.0.0
description: CacheForge operations — check balance, top up, manage upstream, API keys. Pay-as-you-go with Stripe or crypto.
author: CacheForge
license: MIT
homepage: https://app.anvil-ai.io
user-invocable: true
tags:
  - cacheforge
  - billing
  - operations
  - ai-agents
  - token-optimization
  - llm
  - api-keys
  - discord
  - discord-v2
metadata: {"openclaw":{"emoji":"💰","homepage":"https://app.anvil-ai.io","primaryEnv":"CACHEFORGE_API_KEY","requires":{"bins":["python3"],"env":["CACHEFORGE_API_KEY"]}}}
---

## When to use this skill

Use this skill when the user wants to:
- Check their CacheForge balance
- Top up credits (Stripe or crypto)
- Enable/configure auto top-up
- View or change upstream provider
- Manage API keys
- Handle 402 Payment Required errors

## Autonomous Billing Protocol

When you encounter a 402 error from CacheForge:
1. Run `ops.py balance` to check current balance
2. If balance is $0 or negative, run `ops.py topup --amount 10` to create a payment link
3. Share the payment URL with the user
4. After payment, retry the original request

## Commands

```bash
# Check balance and billing status
python3 skills/cacheforge-ops/ops.py balance

# Create a top-up payment link ($10 USD)
python3 skills/cacheforge-ops/ops.py topup --amount 10

# Enable auto top-up ($10 when balance drops below $2)
python3 skills/cacheforge-ops/ops.py auto-topup --enable --threshold 200 --amount 1000

# View upstream provider config
python3 skills/cacheforge-ops/ops.py upstream

# Set upstream provider
python3 skills/cacheforge-ops/ops.py upstream --set --kind openrouter --api-key sk-or-...

# List API keys
python3 skills/cacheforge-ops/ops.py keys

# Create a new API key
python3 skills/cacheforge-ops/ops.py keys --create

# View tenant info
python3 skills/cacheforge-ops/ops.py info
```

## Environment Variables

- `CACHEFORGE_BASE_URL` — CacheForge API base (default: https://app.anvil-ai.io)
- `CACHEFORGE_API_KEY` — Your CacheForge API key (required)

## API Contract (current)

This skill uses:
- `GET /v1/account/billing`
- `POST /v1/account/billing/topup`
- `PATCH /v1/account/billing/auto-topup`
- `GET /v1/account/info`
- `GET /v1/account/upstream`, `POST /v1/account/upstream`
- `GET /v1/account/keys`, `POST /v1/account/keys`, `POST /v1/account/keys/{keyID}/revoke`


---
Source attribution: CacheForge
Original project: https://github.com/meghal86/stacksignal/blob/54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44/.agents/skills/cacheforge-ops/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: CacheForge
Original project: https://github.com/meghal86/stacksignal/blob/54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44/.agents/skills/cacheforge-ops/SKILL.md
Attribution basis: Source repository record

Fields of work: Marketing, Sales
Roles: Growth Marketer, Product Marketer, Sales Operations
Specialties: API
Tools: Stripe, Crypto
Country applicability: Country not specified
Classification basis: Source category, role and specialization labels
Instruction SHA-256: d61880d0f4f1e72ae0ece72e6b675ed7ff4d5cc873f933031acc38a11030a409