Solana + Polymarket + X Wallet Agent Skill

Source code: https://github.com/inspi-writer001/raphael-solana

All code executed by this skill lives in that public repository. Review it before providing credentials or enabling live trading.

You control Solana wallets, Polygon EVM wallets, a Polymarket weather arbitrage scanner, and an X/Twitter strategy — all from natural language.

Setup

This skill is self-contained. After clawhub install solana-wallet, the source code and dependencies are installed automatically — no manual repo clone needed.

Add your credentials to ~/.openclaw/.env (see Environment Variables below).

Execution Rules

1. The CLI is bundled with this skill. The exec prefix is:

   node --experimental-transform-types {baseDir}/bin/solana-wallet.ts
   

   {baseDir} is resolved by OpenClaw to this skill's installation directory.
2. The CLI reads only the specific env vars listed in the Environment Variables section below — no others.
3. Prefer plugin tools over CLI when available — all 13 tools are available as direct plugin calls and require no exec.
4. The following Node.js warnings are expected and harmless: ExperimentalWarning, bigint deprecation, punycode. Disregard them in output parsing.

Plugin Tools (use these first — no exec needed)

These 13 tools are registered by src/plugin.ts, bundled in this skill package at {baseDir}/src/plugin.ts. OpenClaw loads them automatically when the skill is activated.

Wallet & Polymarket

X / Twitter

CLI Command Reference

The CLI prefix for ALL commands below is:

node --experimental-transform-types {baseDir}/bin/solana-wallet.ts

Solana Wallet Commands

EVM / Polygon Wallet Commands

X / Twitter Commands

Start X strategy (full command):

node --experimental-transform-types {baseDir}/bin/solana-wallet.ts scanner start x \
  --handle <bot-handle> \
  [--keywords "pump.fun,graduation"] \
  [--post-trade-updates] \
  [--auto-reply] \
  [--max-tweets-per-hour 2] \
  [--interval 60] \
  [--dry-run]

Scanner Commands

Start weather arb (full command):

node --experimental-transform-types {baseDir}/bin/solana-wallet.ts scanner start polymarket-weather <evm-wallet-name> \
  --amount <usdc-per-trade> \
  [--cities nyc,london,seoul,chicago,dallas,miami,paris,toronto,seattle] \
  [--max-position <usdc>] \
  [--min-edge 0.20] \
  [--min-fair-value 0.40] \
  [--interval <seconds>] \
  [--dry-run]

Typical Agent Flow: Polymarket Weather Arb

1. Create EVM wallet (plugin: create_evm_wallet or CLI: evm-wallet create polymarket1)
2. Tell user: "Send USDC (Polygon PoS network) to: <address>"
3. Poll balance until funded: check_usdc_balance { wallet_name: "polymarket1" }
4. Start dry run: start_weather_arb { wallet_name: "polymarket1", trade_amount_usdc: 5, dry_run: true }
5. Check readings after 2 minutes: get_strategy_status
6. If edges look reasonable, restart without dry run: start_weather_arb { ..., dry_run: false }

Typical Agent Flow: X / Twitter

1. Confirm X credentials are set: X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET, X_BEARER_TOKEN
2. Start in dry-run to verify: start_x_strategy { handle: "mybot", dry_run: true, post_trade_updates: true }
3. Check status: get_strategy_status — shows tweets sent this hour
4. Once confirmed working, restart without dry run

Supported Cities for Weather Arb

Environment Variables

This is the complete list of every environment variable the skill reads. It reads no others.

Required

Optional

X features are fully optional — the skill operates without any X_* vars. Obtain them from developer.x.com → Projects & Apps → Keys and Tokens with Read and Write permissions.

Wallet encryption model

Private keys are never stored in plaintext. The skill uses two-layer AES-256-GCM encryption entirely on your local machine — no keys or wallet data are sent to any remote server.

MASTER_ENCRYPTION_PASSWORD_CRYPTO  (your password, memory only)
  ↓ PBKDF2 — 100,000 iterations, SHA-256
MASTER_ENCRYPTED + MASTER_SALT     (encrypted blob — useless without the password)
  ↓ AES-256-GCM decrypt → master key
wallet private key                 (AES-256-GCM, per-wallet salt → ~/.raphael/)

MASTER_ENCRYPTED and MASTER_SALT are outputs of pnpm setup — they are specific to your password and machine. Sharing them without the password reveals nothing.

Rules

• Always confirm before live trades (unless user explicitly says "just do it" or "no dry run")
• Always suggest --dry-run / dry_run: true for first-time scanner and X strategy starts
• Report Solana Explorer URL after Solana transactions
• Never display private keys
• For Polymarket: USDC must be on Polygon PoS network — not Solana, not Ethereum mainnet
• For X: never auto-like or auto-retweet — TOS violation; the agent only reads and posts text
• For devnet Solana funding: suggest solana airdrop 2 <address> --url devnet
• X search requires Basic+ tier ($100/mo) — gracefully skip if unavailable