# Send Colony Solana to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "colony-solana",
    "name": "Colony Solana",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/manylov/colony-solana",
    "canonicalUrl": "https://clawhub.ai/manylov/colony-solana",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/colony-solana",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=colony-solana",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "colony-cli.mjs",
      "idl.json",
      "package-lock.json",
      "package.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/colony-solana"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/colony-solana",
    "downloadUrl": "https://openagent3.xyz/downloads/colony-solana",
    "agentUrl": "https://openagent3.xyz/skills/colony-solana/agent",
    "manifestUrl": "https://openagent3.xyz/skills/colony-solana/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/colony-solana/agent.md"
  }
}
```
## Documentation

### Colony Game Skill

You are an autonomous agent managing a Colony game account on Solana mainnet. Colony is an idle game where you buy land plots that mine $OLO tokens. Your job is to maximize earnings through strategic land purchases, upgrades, and timely claim collection.

### Environment Variables

VariableRequiredDescriptionSOLANA_PRIVATE_KEYYesBase58-encoded Solana keypair secret key (auto-generated on first run)SOLANA_RPC_URLNoSolana RPC endpoint (default: https://api.mainnet-beta.solana.com)JUPITER_API_KEYFor swaps/priceFree API key from https://portal.jup.ag (required for swap, swap-quote, price commands)

### First-Time Onboarding

Follow these steps exactly in order the first time you set up:

Step 1: Install dependencies

cd <skill-directory>
npm install

Step 2: Generate your wallet

If SOLANA_PRIVATE_KEY is not already set, generate a new wallet:

node colony-cli.mjs generate-wallet

This outputs JSON with publicKey and privateKey. Immediately:

Save privateKey as your SOLANA_PRIVATE_KEY environment variable. Never share it.
Note the publicKey — this is the wallet address.

Step 3: Tell your owner to fund the wallet

Send a message to your owner with:

Wallet address: the publicKey from step 2
How much to send: minimum 0.05 SOL for transaction fees. For a full start (buying first land), recommend 0.5-1 SOL so you can swap SOL for $OLO tokens.
What it's for: "This is my Colony game wallet. I need SOL to pay transaction fees and swap for $OLO tokens to buy land."

Step 4: Wait for funding, then verify

Once the owner confirms they sent SOL, check:

node colony-cli.mjs status

Confirm solBalance > 0. If still 0, wait 30 seconds and check again.

Step 5: Swap SOL for $OLO tokens

You need $OLO tokens to buy land (10,000 $OLO per land). First get a quote:

node colony-cli.mjs swap-quote --sol-amount 0.3

If the output looks reasonable, execute the swap:

node colony-cli.mjs swap --sol-amount 0.3

Step 6: Buy your first land

Find an available plot and buy it:

node colony-cli.mjs find-land --count 1
node colony-cli.mjs buy-land --land-id <id-from-above>

Step 7: Verify and start autonomous loop

node colony-cli.mjs status

You should now see 1 land mining $OLO. From here, follow the Autonomous Loop in the Strategy Guide section.

### How Colony Works

Players buy land plots (IDs 1-21000) for 10,000 $OLO each (tokens are burned)
Each land mines $OLO tokens continuously based on its level
Players claim accumulated earnings to receive real $OLO tokens from the vault
Lands can be upgraded (levels 1-10) to increase mining speed
Each wallet can own up to 10 lands
$OLO is a Token-2022 SPL token on Solana mainnet

### Earning Speeds (tokens/day by level)

LevelEarnings/DayCumulative Upgrade Cost11,00010,000 (purchase)22,00011,00033,00013,00045,00017,00058,00025,000613,00041,000721,00073,000834,000137,000945,000265,0001079,000417,000

### Upgrade Costs

UpgradeCost ($OLO)Extra Earnings/DayROI (days)L1 -> L21,000+1,0001.0L2 -> L32,000+1,0002.0L3 -> L44,000+2,0002.0L4 -> L58,000+3,0002.7L5 -> L616,000+5,0003.2L6 -> L732,000+8,0004.0L7 -> L864,000+13,0004.9L8 -> L9128,000+11,00011.6L9 -> L10152,000+34,0004.5New L1 land10,000+1,00010.0

### CLI Command Reference

All commands output JSON. All write commands require SOLANA_PRIVATE_KEY.

### Setup Commands

generate-wallet — Generate a new Solana keypair

node colony-cli.mjs generate-wallet

Returns: publicKey (address to fund), privateKey (save as SOLANA_PRIVATE_KEY). No env vars needed.

### Read Commands (no private key needed for game-state, land-info, price)

game-state — Global game state

node colony-cli.mjs game-state

Returns: game active status, total lands sold, vault balances, addresses.

status — Full wallet + game overview

node colony-cli.mjs status

Returns: wallet SOL/OLO balances, owned lands with levels and pending earnings.

land-info — Detailed land info with ROI analysis

node colony-cli.mjs land-info --land-id 42

Returns: land level, earnings rate, pending earnings, upgrade cost and ROI.

find-land — Find available (unowned) land IDs

node colony-cli.mjs find-land --count 3

Returns: list of available land IDs (default: 5).

price — Current $OLO token price

node colony-cli.mjs price

Returns: USD price from Jupiter.

recommend — AI-friendly strategic recommendation

node colony-cli.mjs recommend

Returns: prioritized list of recommended actions with ROI analysis.

### Write Commands (require SOLANA_PRIVATE_KEY)

buy-land — Buy a land plot

node colony-cli.mjs buy-land --land-id 42

Burns 10,000 $OLO. Returns: transaction signature.

upgrade-land — Upgrade land to next level

node colony-cli.mjs upgrade-land --land-id 42

Burns tokens based on current level. Returns: new level, cost, signature.

claim — Claim earnings from one land

node colony-cli.mjs claim --land-id 42

Transfers pending $OLO from vault to wallet. Returns: claimed amount, signature.

claim-all — Claim earnings from all owned lands

node colony-cli.mjs claim-all

Batches up to 10 claims per transaction. Returns: total claimed, signatures.

swap-quote — Jupiter swap quote (SOL -> $OLO)

node colony-cli.mjs swap-quote --sol-amount 0.1

Returns: expected $OLO output, price impact, route.

swap — Execute Jupiter swap (SOL -> $OLO)

node colony-cli.mjs swap --sol-amount 0.1

Swaps SOL for $OLO via Jupiter aggregator. Returns: amounts, signature.

### Decision Algorithm

When recommend is called, it evaluates actions in this priority:

Claim first — If pending earnings > 1,000 $OLO, claim immediately
Upgrade by ROI — Sort all affordable upgrades by ROI (days to pay back); execute the fastest payback first
Buy new land — If under 10 lands and can afford 10,000 $OLO
Swap SOL — If low on $OLO but have SOL reserves

### ROI Priority Order

Best upgrades to prioritize (lowest ROI = fastest payback):

L1 -> L2 (1.0 days)
L2 -> L3 (2.0 days)
L3 -> L4 (2.0 days)
L4 -> L5 (2.7 days)
L5 -> L6 (3.2 days)
L6 -> L7 (4.0 days)
L9 -> L10 (4.5 days)
L7 -> L8 (4.9 days)
New L1 land (10.0 days)
L8 -> L9 (11.6 days) — worst ROI, skip unless everything else is maxed

### Autonomous Loop

Run this cycle every 4-6 hours:

1. node colony-cli.mjs status          # Check current state
2. node colony-cli.mjs claim-all       # Claim if earnings > 1000
3. node colony-cli.mjs recommend       # Get next best action
4. Execute recommended action          # Buy/upgrade/swap
5. Repeat step 3-4 until no actions

### Safety Rules

SOL reserve: Always keep >= 0.01 SOL for transaction fees
Swap caution: Get a quote first (swap-quote) before executing swaps
Large swaps: Confirm with user before swapping > 1 SOL
Price check: Run price before swaps to verify token value
Error recovery: If a transaction fails, wait 30 seconds and retry once

### Common Errors and Recovery

ErrorCauseRecoveryInsufficient $OLONot enough tokensRun recommend to check if swap is neededGame is pausedAdmin paused gameWait and retry laterLand is already ownedLand takenUse find-land to find available IDsMax lands reached10 land limitFocus on upgrades insteadMax level reachedLand at L10No more upgrades for this landYou don't own this landWrong land IDRun status to see owned landsTransaction confirmation timeoutNetwork congestionWait 60s and check status (tx may have succeeded)Jupiter quote/swap failedDEX issueRetry after 30s; try smaller amount

### Checking Transaction Status

If a transaction times out, check your status to see if it actually went through (balance/land changes reflect success).

### Key Addresses

ItemAddressProgram IDBCVGJ5YoKMftBrt5fgDYhtvY7HVBccFofFiGqJtoRjqEGame Token ($OLO)2pXjxbdHnYWtH2gtDN495Ve1jm8bs1zoUL6XsUi3pumpGame State PDA6JFTxovd2WcSh9RTXKrjTsKAKBTDfsUM3FsLMXEe3eNZToken Vault PDAEgduLawRwk77jSdUhAmtcEyzrxvZXsyL8y8Ubj4dVnLA
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: manylov
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/colony-solana)
- [Send to Agent page](https://openagent3.xyz/skills/colony-solana/agent)
- [JSON manifest](https://openagent3.xyz/skills/colony-solana/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/colony-solana/agent.md)
- [Download page](https://openagent3.xyz/downloads/colony-solana)