LaunchKit · 2026
Back to Skills

tbot-controller

Operate TradingBoat/TBOT (TBOT runtime stack) via a controlled automation interface (DB-first queries; lifecycle.

0
732 downloads
by @plusgenie

Setup & Installation

openclaw skills install @plusgenie/tbot-controller

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install tbot-controller

What This Skill Does

Controls the TradingBoat/TBOT runtime stack via a DB-first interface, querying SQLite for orders, alerts, portfolio data, and errors. Manages container or systemd lifecycle and generates schema-validated TradingView-style webhook signals for IBKR-connected strategies.

DB-first querying lets you inspect orders and portfolio data without needing containers running, avoiding false 'system down' conclusions from stale discovery paths.

When to use it

  • Querying current portfolio positions from the TBOT SQLite database
  • Starting or stopping the TradingBoat Docker Compose stack
  • Sending a close order for a stock position via TBOT webhook
  • Reviewing grouped TBOT error logs to diagnose broker issues
  • Generating a schema-validated TradingView webhook payload for a futures trade

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: close 50 NFLX now

AGENT
  1. 1Infers close intent, ticker NFLX, qty 50, contract stock from natural language
  2. 2Reads WEBHOOK_KEY from TBOT runtime .env and uses default webhook URL http://127.0.0.1:5001/webhook
  3. 3Auto-generates orderRef as Close_NFLX_50_<epoch_ms>
  4. 4Runs bash scripts/tbot.sh json with strategy.close direction and qty=50 metric
  5. 5Validates output against alert_webhook_schema.json and sends to TBOT webhook
OUTPUT

Schema-validated close signal delivered to TBOT webhook for 50 shares of NFLX

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

uv package manager (brew install uv)openclaw-on-tradingboat runtime stack cloned and configuredInteractive Brokers (IBKR) account with broker credentialsTBOT_COMPOSE_DIR environment variable pointing to the runtime folderWEBHOOK_KEY (TVWB shared secret) configured in the TBOT runtime .env