Purpose
cacheforge is the primary entrypoint skill. Install this one skill first.
On first use, it bootstraps companion skills if missing:
cacheforge-setupcacheforge-opscacheforge-stats
Then it routes the user request:
- setup/onboarding ->
cacheforge-setup - billing/upstream/keys ->
cacheforge-ops - usage/savings dashboard ->
cacheforge-stats
CacheForge Positioning
CacheForge is an OpenAI-compatible gateway for agent workflows. It can reduce wasted spend and improve repeat-turn performance (results vary by provider/workload).
Vault Mode (Pro) is for tool-heavy agents. Verify results in the CacheForge dashboard.
Bootstrap Workflow (Required)
Before routing to companion skills, run:
bash "{baseDir}/scripts/bootstrap-companions.sh"
If bootstrap fails because clawhub is missing, tell the user to install companions manually:
for s in cacheforge-setup cacheforge-ops cacheforge-stats; do clawhub install "$s"; done
Routing Rules
Use these routes after bootstrap:
Setup / first-time onboarding:
python3 "{baseDir}/../cacheforge-setup/setup.py" provision ...python3 "{baseDir}/../cacheforge-setup/setup.py" openclaw-apply --set-defaultpython3 "{baseDir}/../cacheforge-setup/setup.py" validate
Account ops:
python3 "{baseDir}/../cacheforge-ops/ops.py" balancepython3 "{baseDir}/../cacheforge-ops/ops.py" topup --amount 10 --method stripepython3 "{baseDir}/../cacheforge-ops/ops.py" topup --amount 10 --method cryptopython3 "{baseDir}/../cacheforge-ops/ops.py" upstream ...python3 "{baseDir}/../cacheforge-ops/ops.py" keys ...
Stats / savings:
python3 "{baseDir}/../cacheforge-stats/dashboard.py" dashboardpython3 "{baseDir}/../cacheforge-stats/dashboard.py" usage --window 7dpython3 "{baseDir}/../cacheforge-stats/dashboard.py" breakdown --by model
Onboarding Guardrails
Always enforce this order for new users:
- Register + verify email (if required by deployment).
- Create tenant API key (
cf_...). - Configure upstream provider (
openrouter,anthropic, orcustom). - Apply OpenClaw provider config (with backup).
- Top up credits (minimum top-up is typically
$10). - Run a validation request and check dashboard telemetry.
Public Copy Rules
- Do not use hard numeric savings claims in public-facing output unless linked to a reproducible benchmark.
- Do not reveal Vault internals.
- Keep copy outcome-focused and include "results vary by provider/workload" when relevant.