> For the complete documentation index, see [llms.txt](https://docs.sadclaw.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sadclaw.cloud/getting-started/quick-start.md).

# Quick start (5 minutes)

Go from zero to your first SadClaw VM in minutes.

SadClaw lets an agent pay **USDC on Solana** to buy a VM. The VM is owned as a **Metaplex NFT**.

{% hint style="info" %}
You'll use 3 things:

* The CLI (`npx sadclaw`)
* A Solana wallet with USDC
* USDC (Solana network)
  {% endhint %}

## 1) Run the CLI

```bash
npx sadclaw
```

If this is your first run, it should print help.

## 2) Initialize your wallet

```bash
npx sadclaw init
```

This creates a new Solana wallet for your agent, or lets you import an existing one.

**Expected output:**

```
🦀 SadClaw CLI
━━━━━━━━━━━━━━━━━━━━━━

✓ Wallet created successfully
  Address: 7xKX...abc123

Save your seed phrase securely!
```

## 3) Fund the wallet with USDC

Send USDC (on Solana) to your wallet address.

**Minimum amounts by tier:**

| Tier     | Min USDC (1 hour) |
| -------- | ----------------- |
| MICRO    | $0.04             |
| SMALL    | $0.06             |
| STANDARD | $0.10             |
| LARGE    | $0.20             |
| XLARGE   | $0.40             |

{% hint style="warning" %}
Make sure you're sending USDC on **Solana**, not Ethereum or other networks.
{% endhint %}

## 4) Check your balance

```bash
npx sadclaw balance
```

## 5) Buy your first VM

```bash
npx sadclaw buy --tier STANDARD --duration 24
```

**Options:**

* `--tier`: MICRO, SMALL, STANDARD, LARGE, XLARGE
* `--duration`: Hours (1-720)
* `--region`: fsn1 (Germany), nbg1 (Germany), hel1 (Finland)

**Expected output:**

```
🦀 Purchasing VM...

Tier: STANDARD
Duration: 24 hours
Cost: 2.40 USDC
Region: fsn1

✓ Transaction confirmed
✓ NFT minted: 9abc...xyz789
✓ VM provisioning...
✓ VM ready!

IP Address: 123.45.67.89
SSH User: root
```

## 6) Connect via SSH

```bash
npx sadclaw ssh 9abc...xyz789
```

Or manually:

```bash
ssh root@123.45.67.89
```

## Next steps

* [VM tiers & pricing](/guides/vm-tiers.md) - Compare all available tiers
* [Autonomous agents](/guides/autonomous-agents.md) - Integrate with your AI agent
* [SDK reference](/reference/sdk.md) - Programmatic access


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sadclaw.cloud/getting-started/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.