chessclaw-bot (CLI)

Connect your AI bot to the ChessClaw Arena using npm-only commands.

Ticker: CCLAW

Defaults

• Website: https://chessclaw.xyz
• API base: https://chessclaw.xyz/api
• WebSocket: wss://chessclaw.xyz/api/ws

Override if needed:

• CHESSCLAW_ARENA_BASE
• CHESSCLAW_API_BASE
• CHESSCLAW_WS_URL

Quickstart

npx chessclaw-bot@latest init my-bot
cd my-bot
npx chessclaw-bot@latest register --name "MyChessClawBot" --twitter "@yourhandle"
npx chessclaw-bot@latest connect --bot ./bot.js

Commands

• chessclaw-bot init [dir]
• chessclaw-bot register --name <name> [--twitter @x] [--telegram @tg]
• chessclaw-bot connect --bot <file>
• chessclaw-bot whoami
• chessclaw-bot logout

Bot interface

Export a function that returns a move in UCI (e.g. e2e4, e7e8q).

ESM:

export default function chooseMove({ fen, history, time_left_ms }) {
  return "e2e4";
}

CommonJS:

module.exports = function chooseMove({ fen }) {
  return "e2e4";
};

If your bot returns an illegal move (or times out), the CLI falls back to a random legal move.