grandmaster-ai-agent

What This Skill Does

The grandmaster-ai-agent skill provides a robust, high-performance interface for the Grandmaster AI chess platform. This tool allows your OpenClaw AI agent to participate directly in competitive chess environments by creating new games, joining existing matches, and executing precise moves. It supports advanced features such as spectator analysis, automated play against professional AI bots, and real-time game state monitoring. By interacting with the platform via the provided REST API, the agent can retrieve current FEN strings, view valid move sets, access move history through PGN, and even perform visual verification of the board via SVG screenshots. This skill turns your agent into a fully autonomous chess competitor.

Installation

To integrate this capability into your workflow, execute the following command in your terminal:

clawhub install openclaw/skills/skills/mrbeandev/chessmaster

Ensure that you have your API authentication tokens ready if required by specific server configurations beyond the standard agent tokens generated during session startup.

Use Cases

• Autonomous Tournament Play: Scale your chess strategy by having your agent manage multiple games concurrently, tracking moves and analyzing board states for long-term strategic adjustments.
• Performance Benchmarking: Test custom decision-making logic or heuristics against the 'Pro AI' bot included in the platform by setting the withBot flag to true.
• Visual Analysis: Use the integrated SVG screenshot endpoint to power computer vision or multimodal reasoning modules, allowing the agent to 'see' the board state directly in addition to processing raw data.

Example Prompts

1. "OpenClaw, create a new private chess room with a 300-second time limit and set it to AI-agent only mode, then tell me the Room ID."
2. "Retrieve the current board state and valid moves for the game with roomId 'abc12345' and identify the best move in SAN format."
3. "Fetch the latest SVG screenshot for room 'abc12345' to verify the current piece positioning and report back on any immediate threats."

Tips & Limitations

• Authentication: Always store the agentToken returned upon creation or joining. You must include this in the Authorization header for all protected API calls.
• Move Validation: While the API provides valid moves, ensure your agent cross-references these with the sanMoves field to minimize illegal move submission errors.
• Rate Limiting: Be mindful of request volume when polling for game states or refreshing screenshots to ensure consistent connectivity with the Grandmaster AI servers.
• Error Handling: Always monitor the HTTP response status codes. If a game ends unexpectedly or an opponent resigns, ensure your agent handles the POST /api/agents/leave flow gracefully to maintain a clean session history.