ClawHub

德州扑克

Automation

Text-based Texas Hold'em poker game with auto AI players for OpenClaw

Install

openclaw skills install holdem-poker

Texas Hold'em Poker Skill

A text-based Texas Hold'em poker game where you control the small blind player, and AI controls other players automatically. Designed for OpenClaw chat interactions.

Features

  • Full Texas Hold'em rules implementation
  • Automatic AI players for other positions
  • Card suits displayed with emoji symbols
  • Support for multiple game rounds
  • Proper betting rounds: pre-flop, flop, turn, river
  • Chat-friendly output format

How to Use

Start a New Game

node {baseDir}/scripts/final-game.js

Play Commands

During the game, use these commands:

Text Commands

  1. fold - Fold your hand and exit the current round
  2. check - Check (pass without betting)
  3. call - Call the current bet
  4. bet [amount] - Place a bet (e.g., "bet 5")
  5. allin - Go all-in with your remaining chips
  6. next - Start the next round after a game ends
  7. help - Show available commands
  8. quit - Exit the game

Number Commands (Quick Access)

  1. 1 = fold
  2. 2 = check
  3. 3 = call
  4. 4 N = bet N (e.g., "4 5" = bet 5)
  5. 5 = allin

Example Usage:

  • 1 (fold) = fold
  • 2 (check) = check
  • 3 (call) = call
  • 4 5 (bet 5) = bet 5
  • 5 (allin) = allin

QQ Chat Integration

For OpenClaw chat integration, the game is designed to work in a turn-based fashion:

User: start
Bot: 🃏 Round 1 - PRE-FLOP
      You: J♦️ 8♣️ | $99
      AI Players: ?? | $98, $100
      Community: A❤️ 2❤️ 3❤️
      Pot: $5 | Current Bet: $2
      Action?

User: call
Bot: You called $1
      AI players act automatically...

AI Player Handling:

  • AI hole cards are saved but hidden as "??" until showdown
  • AI decisions are automatic and immediate after your action
  • At showdown, all cards are revealed simultaneously
  • This creates a fair, turn-based experience perfect for chat interfaces

Security & Fair Play:

  • AI hole cards are stored securely and never revealed prematurely
  • Game state is validated at each step to ensure fair play
  • Complete game history is logged for review
  • No player can see another's hole cards before showdown

Game Flow

  1. Pre-flop: Small blind and big blind forced bets, 2 hole cards dealt
  2. Flop: 3 community cards revealed, first betting round
  3. Turn: 4th community card revealed, second betting round
  4. River: 5th community card revealed, final betting round
  5. Showdown: Winners determined by best 5-card hand

Card Notation

  • Suits: ❤️ (Hearts), ♦️ (Diamonds), ♣️ (Clubs), ♠️ (Spades)
  • Values: A, K, Q, J, 10, 9, 8, 7, 6, 5, 4, 3, 2

Chat Integration Example

User: start
Bot: 🃏 Texas Hold'em - Round 1
You (Small Blind): J♦️ 8♣️ | Chips: $99
Community: A❤️ 2❤️ 3❤️
Pot: $5 | Current Bet: $2
Action? [fold/check/call/bet/allin]

User: check
Bot: You checked. AI players act automatically...

Hand Rankings (Strongest to Weakest)

  1. Royal Flush - A K Q J 10 same suit
  2. Straight Flush - Five consecutive same suit
  3. Four of a Kind - Four same values
  4. Full House - Three of a kind + pair
  5. Flush - Five same suit
  6. Straight - Five consecutive different suits
  7. Three of a Kind - Three same values
  8. Two Pair - Two different pairs
  9. One Pair - One pair
  10. High Card - Highest card

API Usage

import { PokerGame } from './scripts/simple-game.mjs';

const game = new PokerGame();
const state = game.startNewRound();
console.log(state);

// Player actions
const result = game.playerAction('call');
console.log(result);

// AI acts automatically
const newState = await game.playAIActions();

Configuration

Edit references/config.json to change:

  • Starting chip amount
  • Blind amounts
  • Number of AI players
  • Auto-play delay speed

Files

  • scripts/simple-game.mjs - Main game logic
  • scripts/game.mjs - Full interactive CLI version
  • references/config.json - Game configuration

💰 资金追踪与常见问题

资金问题记录

🔴 问题：资金总额不匹配

根本原因： AI玩家弃牌时，已投入的筹码被错误退还，而不是保留在底池中 修复方案：

  • 修改scripts/final-game.js中的AI弃牌逻辑
  • AI弃牌时，已投入的筹码正确保留在底池
  • 确保player.isActive = false不会退还已投入筹码

修复代码：

// 弃牌：保留已投入的筹码在底池
player.isActive = false;
// 已投入的筹码 already in pot, don't return

✅ 资金验证公式

总资金 = 玩家1筹码 + 玩家2筹码 + 玩家3筹码 + 底池

验证时机：

  • 每局开始前
  • 每次下注后
  • 摊牌结算后

预期结果： 总资金始终保持初始值（默认$300）

🎯 预防措施

资金追踪检查点

  1. 盲注阶段： 验证盲注正确扣除
  2. 下注阶段： 验证每次下注正确转移到底池
  3. 弃牌处理： 验证弃牌玩家已投入筹码保留在底池
  4. 摊牌结算： 验证赢家获得底池，总资金不变

自动化测试

建议添加资金验证测试：

function validateTotalChips() {
  const total = players.reduce((sum, p) => sum + p.chips, 0) + pot;
  return total === INITIAL_TOTAL_CHIPS;
}

🐛 常见Bug及修复

1. 筹码负数问题

原因： 下注金额超过玩家筹码 修复： 添加筹码不足检查，自动转为全下

2. 底池计算错误

原因： 玩家弃牌时筹码退还 修复： 弃牌只标记isActive = false，不修改筹码

3. AI决策逻辑错误

原因： 手牌强度计算不准确 修复： 优化evaluateHandStrength函数

More in Automation