cubistic-bot-runner

What This Skill Does

The cubistic-bot-runner is a specialized automation skill designed to interact with the Cubistic shared 3D cube world. It provides a lightweight Node.js framework for bots to participate in the painting of pixels within a 3D environment. The skill is intentionally built with "politeness" at its core: it verifies pixel availability to prevent overwriting existing art unnecessarily and implements robust error handling with exponential backoff to ensure it does not overwhelm the API or the user's connection. By handling the Proof-of-Work (PoW) generation natively through Node.js’s Web Crypto API, the bot can securely generate valid submissions required by the Cubistic server to authorize painting actions. It includes two primary operational modes: a single-shot execution for ad-hoc tasks and a loop mode for continuous background operations with configurable limits on attempts and successes.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/andreasnordenadler/cubistic-bot-runner

Ensure you have Node.js version 18 or higher installed, as the script relies on the global crypto.subtle interface to solve the cryptographic challenges presented by the Cubistic backend. Once installed, configure your environment variables (BACKEND_URL and API_KEY) to begin execution.

Use Cases

• Automated World-Building: Maintaining a consistent visual presence in the Cubistic world by filling void spaces with your assigned color.
• Background Artistry: Setting up a "run-loop" instance that periodically updates small portions of the 3D grid while you work on other tasks.
• API Testing: Validating server responses and PoW difficulty scaling without manually constructing requests.
• Polite Grid Maintenance: Filling in gaps in a collaborative canvas to ensure the 3D world remains fully populated without interfering with high-traffic active areas.

Example Prompts

• "OpenClaw, run the cubistic-bot-runner once using my existing configuration to fill any void pixel I encounter."
• "Start the cubistic-bot-runner in loop mode, setting the max successes to 10 and using color index 5, ensuring backoff logic is active."
• "Can you help me set up the environment variables for the cubistic-bot-runner and execute the loop script to paint 20 pixels total?"

Tips & Limitations

• Safety First: Never expose your API key in shared logs or public repositories; keep it stored strictly as a local environment variable.
• Resource Usage: PoW calculations are CPU-intensive. Running long-term loops may impact the system performance of lower-powered devices.
• Politeness Logic: The script is hardcoded to prioritize Void pixels. If you wish to paint over others, you will need to modify the source scripts directly, though this is discouraged to maintain community harmony.
• Scalability: The script is optimized for single-bot operations. Running multiple instances against the same backend might trigger rate-limiting regardless of the internal backoff logic.