---
title: "OpenClaw Telegram Trading Bot"
description: "Trade prediction markets from Telegram using the Horizon OpenClaw skill."
icon: "paper-plane"
---

This example shows how a Telegram trading bot powered by OpenClaw + Horizon looks in practice. The same skill works identically on WhatsApp, Discord, and Slack.

## Setup

```bash
# 1. Install Horizon
pip install horizon-sdk   # or: uv pip install horizon-sdk

# 2. Copy skill to OpenClaw
cp -r skills/horizon-trader/ /path/to/openclaw/skills/

# 3. Set environment
export HORIZON_API_KEY="your-key"
export HORIZON_EXCHANGE="paper"  # or "polymarket" / "kalshi"
```

## Conversation: Full Trading Session

Here's a real conversation flow showing discovery, analysis, trading, and risk management through Telegram.

### Market Research

```
User: Hey, what bitcoin prediction markets are available?

Bot: Let me search for you.

     📊 Found 6 BTC markets on Polymarket:

     1. Will BTC hit $100k by March 2026?
        ID: will-btc-hit-100k | Active ✅

     2. Will BTC hit $120k by March 2026?
        ID: will-btc-hit-120k | Active ✅

     3. Will BTC close above $90k in February?
        ID: btc-above-90k-feb | Active ✅

     4. Will BTC dominance exceed 60%?
        ID: btc-dominance-60 | Active ✅

     Which one interests you?
```

```
User: Check Kalshi too for BTC markets

Bot: 📊 Found 3 BTC markets on Kalshi:

     1. KXBTC-26MAR31 - BTC above $100k on March 31
     2. KXBTC-26FEB28 - BTC above $95k on Feb 28
     3. KXBTC-26APR30 - BTC above $110k on April 30
```

### Kelly Analysis

```
User: I think there's a 68% chance BTC hits 100k by March.
      Market is at 52 cents. I have $3000 to work with.

Bot: 🧮 Kelly sizing analysis:

     Your edge: +16 cents (68% vs 52%)
     Quarter Kelly optimal: 100 contracts
     Edge per contract: $0.16

     At $0.52 per contract, you'd risk $52 total.
     Expected value: +$16 per contract × 100 = +$1,600

     ⚠️ This is quarter Kelly - conservative sizing.
     Full Kelly would be 400 contracts, but that's too aggressive.

     Want me to place the order?
```

### Placing Orders

```
User: Yeah, buy 100 at 0.52

Bot: ✅ Order submitted!

     📋 Details:
     • Order ID: p1
     • Market: will-btc-hit-100k
     • Side: BUY
     • Price: 0.52
     • Size: 100 contracts
```

```
User: Also set a stop loss at 35 cents and take profit at 75

Bot: ✅ Protection orders set!

     🛡️ Stop-loss:
     • Trigger: 0.35
     • Action: Sell 100 YES contracts
     • Max loss if triggered: ~$17

     🎯 Take-profit:
     • Trigger: 0.75
     • Action: Sell 100 YES contracts
     • Profit if triggered: ~$23

     Your position is now bracketed.
```

### Monitoring

```
User: How's everything looking?

Bot: 📊 Engine Status:

     💰 PnL: +$3.50 today
     • Realized: $0.00
     • Unrealized: +$3.50

     📈 Positions (1):
     • will-btc-hit-100k: 100 YES @ 0.52
       Unrealized: +$3.50

     📋 Open Orders: 0
     🛡️ Pending SL/TP: 2 armed

     ⏱️ Uptime: 25 minutes
     🔴 Kill switch: OFF
```

```
User: Show me my stop loss and take profit

Bot: 🛡️ Contingent Orders (2):

     1. Stop-Loss (pending)
        Market: will-btc-hit-100k
        Trigger: 0.35 → Sell 100 YES
        Status: Armed, waiting

     2. Take-Profit (pending)
        Market: will-btc-hit-100k
        Trigger: 0.75 → Sell 100 YES
        Status: Armed, waiting
```

### Adding to the Position

```
User: Market moved to 0.48, I want to average down. Buy 50 more at 0.48

Bot: ✅ Order submitted!

     📋 Details:
     • Order ID: p2
     • Market: will-btc-hit-100k
     • Side: BUY
     • Price: 0.48
     • Size: 50 contracts

     Your total position is now 150 YES contracts
     (avg entry will update once this fills).
```

### Emergency Stop

```
User: STOP EVERYTHING

Bot: 🚨 KILL SWITCH ACTIVATED

     All orders canceled immediately.
     Reason: user emergency request

     Your positions remain open but no new orders
     will be accepted until you resume.

     Send "resume trading" to deactivate the kill switch.
```

```
User: Ok resume trading

Bot: ✅ Kill switch deactivated.

     Trading is back to normal.
     Your positions and contingent orders are still intact.
```

### End of Day

```
User: Cancel all orders and show final status

Bot: 📋 Canceled 0 orders (none were open).

     📊 Final Status:
     💰 Daily PnL: +$7.20
     • Realized: $0.00
     • Unrealized: +$7.20

     📈 Position:
     • will-btc-hit-100k: 150 YES @ avg 0.507
       Unrealized: +$7.20

     🛡️ Stop-loss at 0.35 and take-profit at 0.75 still armed.

     Good day! 📈
```

## Multi-Platform Parity

The same skill works on every OpenClaw platform:

| Platform | Format | Notes |
|----------|--------|-------|
| Telegram | Full markdown, emojis | Best experience - supports tables and code blocks |
| WhatsApp | Plain text with emojis | No markdown rendering, but fully functional |
| Discord | Markdown with embeds | Rich formatting, channel-based trading |
| Slack | Markdown | Thread-based conversations, good for team trading |

## CLI Equivalent

Every bot conversation maps to CLI commands:

```bash
# Market research
python3 scripts/horizon.py discover polymarket "bitcoin"
python3 scripts/horizon.py discover kalshi "KXBTC"

# Kelly sizing
python3 scripts/horizon.py kelly 0.68 0.52 3000

# Trading
python3 scripts/horizon.py quote will-btc-hit-100k buy 0.52 100
python3 scripts/horizon.py quote will-btc-hit-100k buy 0.48 50

# Risk management
python3 scripts/horizon.py kill-switch on "user emergency"
python3 scripts/horizon.py kill-switch off

# Monitoring
python3 scripts/horizon.py status
python3 scripts/horizon.py positions
python3 scripts/horizon.py contingent
python3 scripts/horizon.py cancel-all
```

## Next Steps

<CardGroup cols={2}>
  <Card title="OpenClaw Skill Reference" icon="robot" href="/integrations/openclaw">
    Full command reference and installation guide.
  </Card>
  <Card title="MCP Portfolio Assistant" icon="wand-magic-sparkles" href="/examples/mcp-portfolio-assistant">
    Similar workflow using Claude Code instead of Telegram.
  </Card>
  <Card title="Bracket Orders" icon="shield-halved" href="/examples/bracket-orders">
    Deep dive into stop-loss and take-profit mechanics.
  </Card>
  <Card title="Kelly Sizing" icon="calculator" href="/examples/kelly-sizing">
    Kelly criterion theory and all sizing functions.
  </Card>
</CardGroup>
