Freeland

Freeland gives OpenClaw and other agents a real wallet, virtual cards, OTP inbox, Mr. Freeman chat, eSIM, VPN, and crypto invoice flows through one user-owned account.

Primary use cases:

• - wallet, cards, and OTP-backed checkout flows
• connectivity services like eSIM and VPN
• platform-funded Mr. Freeman conversations
• invoice creation for collecting USDT

Authentication

All requests use the same Bearer token.

CODEBLOCK0

Production base URL:

CODEBLOCK1

Recommended helpers:

CODEBLOCK2

Trust Model

Freeland is designed for real, user-owned agent operations.

• - The user owns the wallet, cards, inbox, connectivity services, and invoice flows.
• The API key grants access to the user's own account surface.
• Wallet balance and card balance are separate values.
• Provider readiness matters. If a service is offline, surface that honestly instead of pretending the flow worked.
• Sensitive outputs like PAN, CVV, billing address, inbox contents, and VPN configs should only be revealed when needed for the active task.

Autonomy Model

Freeland may be used in approval-based or pre-authorized mode.

• - In approval-based mode, ask before issuing cards, topping up cards, withdrawing funds, buying eSIM plans, creating VPN subscriptions, or creating invoices.
• In pre-authorized mode, act only inside the user's stated balance, merchant, service, and spending boundaries.

Safety Boundaries

• - Only use the user's own Freeland resources.
• Never invent billing data, cardholder details, mailbox codes, deposit addresses, or provider states.
• Do not retry balance-moving actions blindly. Read current state first.
• Treat provider failures, fraud checks, issuer declines, KYC gates, geography restrictions, and missing OTPs as hard boundaries.
• Do not expose sensitive card credentials or mailbox contents longer than necessary.
• For unfamiliar merchants, subscriptions, retries, and OTP-backed checkouts, read references/payment-safety.md first.
• For eSIM and VPN install or troubleshooting flows, read references/connectivity.md first.
• For payment collection and hosted payment links, read references/invoices.md first.

Default Behavior

• - Start with GET /me.
• If the user asks for account readiness, report mailbox, wallet balance, deposit rail, card state, and service readiness separately.
• Treat wallet balance, card balance, and provider readiness as distinct facts.
• Use card.id for Freeland card routes.
• Lead with buyer-side wallet/card workflows. Use invoice creation only when the user explicitly wants to collect payments.
• For VPN, Freeland currently provides subscription plus WireGuard config delivery, not an in-browser tunnel.
• For eSIM, prefer install-ready profiles over re-listing the whole catalog when the user already owns one.

Core Jobs

1. Check account readiness

CODEBLOCK3

Important facts to surface:

• - account INLINECODE8
• INLINECODE9
• wallet INLINECODE10
• INLINECODE11 status and address
• current card, if present
• INLINECODE13, eSIM, and VPN readiness

2. Fund the wallet

CODEBLOCK4

Rules:

• - deposits land on the user's USDT TRON rail
• wallet balance credits the net amount that actually reaches the address
• external sender, exchange, and network fees may reduce the credited amount before Freeland receives it

3. Issue and use a card

CODEBLOCK5

Rules:

• - issue only when wallet balance is sufficient
• card routes use the Freeland card INLINECODE16
• use the sensitive response for PAN, CVV, expiry, cardholder name, and billing address
• after any merchant error, inspect card transactions before retrying

4. Top up a card

CODEBLOCK6

Pre-flight:

1. 1. read INLINECODE17
2. read INLINECODE18
3. confirm the card is active
4. confirm the wallet covers the requested topup
5. only then send the topup request

5. Fetch OTP or receipt emails

CODEBLOCK7

Use this for 3DS, OTP verification, receipts, and merchant follow-up.

6. Talk to Mr. Freeman

CODEBLOCK8

Mr. Freeman is platform-funded. Do not ask the user for a personal model key for this flow.

7. Work with eSIM

CODEBLOCK9

Rules:

• - only buy or top up when the provider is live
• after purchase, prefer install-ready fields like qrData, iosTapLink, and INLINECODE21
• if a profile already exists, lead with install or topup instead of re-buying blindly

8. Work with VPN

CODEBLOCK10

Rules:

• - VPN is subscription plus WireGuard config delivery
• after activation, help the user install or import the config into WireGuard
• do not describe this as an in-browser VPN tunnel

9. Create invoices

CODEBLOCK11

Use this when the user wants to collect USDT through Freeland.

Load References When Needed

• - Read references/payment-safety.md before entering card details on an unfamiliar merchant, when a checkout keeps failing, or when OTP and retry boundaries matter.
• Read references/connectivity.md before helping with eSIM install, VPN import, mobile setup, or service troubleshooting.
• Read references/invoices.md when the user wants to create hosted invoices, explain invoice lifecycle, or reason about payment collection.

Good Default Prompt Shapes

• - INLINECODE25
• INLINECODE26
• INLINECODE27
• INLINECODE28
• INLINECODE29
• INLINECODE30

Scope Note

Freeland combines wallet, cards, inbox, character chat, connectivity services, and invoice collection. Lead with the simplest relevant workflow for the user's task instead of surfacing the whole platform at once.