Skip to content

Releases: Josefusan/PolyClaw

PolyClaw v1.0.0 - AI Trading Intelligence for Polymarket

Choose a tag to compare

@Josefusan Josefusan released this 23 Feb 02:17

🦞 PolyClaw v1.0.0

Your personal AI trading assistant for prediction markets. Run it locally. Own your alpha.

This is the first public release of PolyClaw — bringing OpenClaw-style AI assistance to Polymarket traders.


✨ Highlights

  • 🔍 Wallet Intelligence — Analyze any Polymarket wallet instantly with P&L, win rate, risk metrics
  • 🤖 AI Chat — Conversational assistant powered by Claude or GPT for strategy development
  • 📊 Whale Tracking — Real-time alerts when tracked wallets trade
  • 🏆 Leaderboard — Public rankings of top performers
  • 🔔 Multi-channel Alerts — Discord, Telegram, WebChat notifications
  • 📈 Strategy Detection — Automatically identify trading patterns (momentum, scalper, arbitrageur)
  • 🧠 Bot Factory — Generate trading bot configurations
  • 📥 Data Export — CSV, Excel, JSON formats
  • 🖥️ Terminal Mode — Power-user interface with live streaming
  • ⌨️ CLI Tool — Full polyclaw command for terminal users
  • 👁️ Background Daemon — Always-on monitoring with polyclaw daemon

🚀 Quick Start

# Clone and setup
git clone https://github.com/JdClarkGit/PolyClaw.git
cd PolyClaw
./setup.sh

# Or run the onboarding wizard
python cli.py onboard --install-daemon

# Start the gateway
python app.py
# Open http://localhost:8080

🔧 What's Included

Core Platform

Component Description
Gateway Flask control plane with sessions, API routes, WebChat
CLI polyclaw command with 30+ subcommands
AI Runtime Multi-provider (Anthropic/OpenAI) with context-aware prompts
Memory System Persistent conversation, entity, preference, and fact memory
WebSocket Gateway Real-time TUI communication

Channels

Channel Status
Discord ✅ Full (webhook + interactive bot)
Telegram ✅ Full (webhook + interactive bot)
WebChat ✅ Full (built-in UI)

Tools & Automation

  • Wallet Analysis — P&L, win rate, Kelly criterion, Sharpe ratio
  • Strategy Detection — Pattern classification with confidence scores
  • Market Scanner — Find momentum, value, and arbitrage opportunities
  • Comparison Engine — Side-by-side wallet analysis
  • Paper Portfolio — Test strategies risk-free

AI Agent System

  • 5 Built-in Agents — PolyClaw, Quant Analyst, Scout, Risk Manager, Teacher
  • Skills System — Enable/disable modular capabilities
  • Hooks System — Event-driven automation
  • Knowledge Base — Pre-trained prediction market expertise

📦 Installation Options

From Source (Recommended)

git clone https://github.com/JdClarkGit/PolyClaw.git
cd PolyClaw
./setup.sh

Docker

git clone https://github.com/JdClarkGit/PolyClaw.git
cd PolyClaw
docker-compose up -d

🛡️ Security

  • Local-first — All data stays on your machine
  • No tracking — Zero analytics or telemetry
  • API keys local — Stored only in .env, never transmitted
  • Public API only — Only Polymarket's public API is accessed

Run polyclaw doctor to check your configuration.


📚 Documentation


🙏 Acknowledgments

Inspired by OpenClaw — the personal AI assistant for messaging. PolyClaw brings the same vision to prediction market traders.


⚠️ Disclaimer

PolyClaw is for educational and research purposes only. Trading prediction markets involves risk. Always do your own research.


🦞 Happy trading!