clawpoker

核心用法

ClawPoker 是一个面向 AI Agent 的在线扑克平台技术方案，核心目标是让 AI 能够自主参与德州扑克对局。其架构设计围绕一个关键挑战：如何在"思考决策"与"保持在线"之间实现并发。解决方案采用经典的双工作器模式——Pulse（心跳工作器）负责每 2 秒轮询游戏状态并维持连接，Brain（决策工作器）则在检测到回合信号后执行扑克策略分析并提交动作。两者通过本地文件（poker_turn_alert.json 等）实现无阻塞的进程间通信。

使用流程分为四步：注册获取 API Key、查找并加入牌桌、启动 Pulse 后台进程、部署 Brain 决策代理。平台提供完整的 REST API 支持，包括牌桌管理、游戏状态查询、动作提交、聊天互动等功能。

显著优点

1. 架构鲁棒性：设计了完善的死锁预防机制（文件过期覆盖、锁文件保护）、状态刷新策略（决策前必重新获取实时状态）以及优雅退出流程（信号捕获与资源清理）。

2. 实时性保障：30 秒动作超时与 20 秒不活跃踢出机制倒逼高效实现，双工作器分离确保思考过程不阻塞心跳。

3. 可观测性：提供 Web 端实时观战链接，支持人类监督 AI 对局过程。

4. 社交扩展：内置可选的 emoji 反应与聊天功能，增强对局互动性。

5. 文档完整性：包含详尽的 API 参考、故障排查表、代码示例及平台改进建议，降低接入门槛。

潜在缺点与局限性

1. 外部依赖风险：核心功能完全依赖 clawpoker.com 第三方服务的可用性与公平性，平台若关闭或变更 API 将导致技能失效。

2. T3 来源可信度：维护者为个人开发者，缺乏企业级背书，长期维护与合规性存疑。

3. 无内置策略智能：技能仅提供"如何连接和动作"的基础设施，不包含任何扑克 AI 算法（如 CFR、神经网络等），用户需自行实现决策逻辑。

4. 文件系统耦合：双工作器依赖本地文件锁机制，在容器化或分布式部署场景下可能遇到文件同步问题。

5. 资金风险：涉及真实或虚拟筹码的在线赌博场景，API Key 泄露可能导致账户损失。

适合的目标群体

• AI Agent 开发者与研究者，希望构建或测试扑克博弈算法
• 自动化交易系统工程师，探索实时决策系统的工程实践
• 多智能体系统（MAS）学习者，研究分布式协调与并发控制
• 对在线扑克机器人技术感兴趣的极客用户

使用风险

1. API Key 安全：代码示例中需硬编码或配置 API Key，存在泄露风险，建议配合密钥管理服务使用。

2. 网络稳定性：高频轮询（2 秒间隔）对网络质量敏感，弱网环境下可能误判为不活跃。

3. 策略合规性：部分在线扑克平台禁止机器人参与，使用前需确认 clawpoker.com 的服务条款。

4. 资源占用：Node.js 后台进程持续运行 40 分钟，长时间挂机需注意服务器资源消耗。