OpenClaw Plugin: Guac Play

This plugin allows OpenClaw agents to interact with Guac/Gamba games on Solana. It provides tools to play games like Flip and Dice, check balances, and view game results.

Installation

openclaw plugins install openclaw-plugin-guac-play

Configuration

Add the following to your ~/.openclaw/config.json (or wherever your OpenClaw config is located):

{
  "plugins": {
    "guac-play": {
      "enabled": true,
      "rpcUrl": "https://api.mainnet-beta.solana.com",
      "wallet": "/path/to/your/wallet.json"
    }
  }
}

Tools

• guac_play: Play games (flip, dice)
• guac_pools: List available pools
• guac_balance: Check wallet balance
• guac_result: Check game results
• guac_debug: Debug plugin configuration

License

MIT

Recent Enhancements

• Dynamic Pool Selection: Automatically derives pool addresses for any token mint. Prioritizes explicit token selection over legacy pool config.
• Any Token Balance: guac_balance now scans your entire wallet and lists all non-zero token balances.
• Symbol Resolution: Use symbols like "USDC", "GUAC", or "SOL" directly in commands thanks to Jupiter Token List integration.

Requirements

• Node.js ≥ 22 (OpenClaw requirement)
• OpenClaw installed and configured

Build and Test

1. Install Dependencies: npm install
2. Build: npm run build
3. Test: npm run test (Verifies configuration and symbol resolution logic)

Installation in OpenClaw

1. In your OpenClaw config, add the plugin path:

   {
     "plugins": {
       "entries": {
         "guac-play": {
           "enabled": true,
           "config": {
             "rpcUrl": "https://api.devnet.solana.com",
             "wallet": "<base58-private-key-or-path-to-json>",
             "creatorAddress": "EjJxmSmbBdYu8Qu2PcpK8UUnBAmFtGEJpWFPrQqHgUNC"
           }
         }
       }
     }
   }

2. Allow the tools for your agent: "allow": ["guac_play", "guac_balance", "guac_pools", "guac_result"].
3. Restart OpenClaw.

Tools

• guac_play: Place a bet. Supported games: dice, flip. Accepts symbols (e.g., tokenMint: "USDC").
• guac_balance: View SOL and token balances. Running with no arguments scans your entire wallet.
• guac_pools: List available Guac Play pools and liquidity.
• guac_result: Check the outcome of a previous bet by signature.
• guac_debug: Inspect the current plugin configuration.

Production Deployment

To deploy this plugin to a production OpenClaw instance:

1. Commit the dist/ folder: Ensure the built dist/ folder is committed to your Git repository. (The included .gitignore allows this).

2. Install via Git: On your production server, you can install directly from your repository:

   openclaw plugins install https://github.com/YourUsername/gamba-bot.git/extensions/guac-play

   (Replace with your actual repository URL)

3. Configure for Mainnet: In your production openclaw.json, configure the plugin with a high-performance RPC and your production wallet:

   "guac-play": {
     "enabled": true,
     "config": {
       "rpcUrl": "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY",
       "wallet": "/path/to/production-keypair.json",
       "creatorAddress": "EjJxmSmbBdYu8Qu2PcpK8UUnBAmFtGEJpWFPrQqHgUNC",
       "priorityFee": 100000
     }
   }