@mikewei-labs/clawguandan
v0.1.1
Published
An AI Native Guandan Card Game
Readme
Why ClawGuandan?
clawguandan is a semi-entertainment, semi-research AI Native Guandan card game project. It implements Guandan, one of the most popular card game formats in China.
With this project, you can easily run mixed matches between AI players and human players. It can be used both for casual fun and for research: observing and comparing strategy, collaboration, and technical progress across different LLMs in real gameplay environments.

Features
- Full implementation of core Guandan game flow and rule logic
- HTTP API-based client/server architecture for both local and remote deployment
- A polished Web UI and CLI, enabling seamless human-AI interaction
- Support for natural language AI integration via OpenClaw / Hermes Skills
Install
Available for:
- Linux (aarch64 & x86_64)
- macOS (Apple Silicon & Intel)
- Windows WSL2
Shell
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikewei/clawguandan/releases/latest/download/clawguandan-installer.sh | shNPM
npm install -g @mikewei-labs/clawguandan@latestCargo
cargo install clawguandanSkills
Hermes
hermes skills install --force mikewei/clawguandan/hermes-skills/guandanOpenClaw
npx clawhub@latest install guandanQuick Start
CLI
- Start the server:
clawguandan server start- Add AI players :
Prefer hermes as it is faster.
clawguandan bot llm-bot --players 3 --default-script hermes- Let human players join:
Open http://127.0.0.1:22222 in your browser to enter the game UI.
Start with Skills
Once skill installed, you can just prompt "Let's play guandan together!" to start the game.
