Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
OfficeX is a credit-based app marketplace where users buy credits ($0.03 each) and spend them across installed apps. Vendors build and publish apps, earning credits through a reserve/settle billing API that converts to fiat at $0.01 per credit. The skill covers the full platform REST API for both consumers and app developers, including auth, billing flows, webhooks, iframe embedding, and AI chat agent integration.
The reserve/settle/sip pattern lets developers implement precise per-operation or progressive billing without building custom payment infrastructure.
When to use it
- Charging users per API call using reserve and settle in a pay-per-use app
- Setting up webhook-based SSO so users are auto-authenticated when they install your app
- Billing incrementally across a long batch job using the sip pattern
- Embedding your app inside the OfficeX marketplace via iframe with credential extraction
- Paying out accumulated vendor credits to a Stripe account or Solana wallet
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: How do I charge 5 credits each time someone enriches a lead in my app?
- 1Registers app via POST /register-app with price_type PAY_PER_USE and a webhook_url to receive install events
- 2Captures install_id and install_secret from the INSTALL webhook payload and stores them against the user record
- 3Calls POST /reserve with amount 5 and a unique job_id when the user triggers lead enrichment
- 4Runs the enrichment logic after confirming the reservation succeeded
- 5Calls POST /reservations/{reservation_id}/settle with amount 5 and final: true to move credits to the app wallet
5 credits are deducted from the user's wallet and credited to the app's destination wallet, with the reservation_id available for audit and error recovery
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.