A specialized automation interface for the TradingBoat stack that prioritizes DB-first queries and secure lifecycle management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tbot-controller
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tbot-controller using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TBOT Controller?
The TBOT Controller is a technical interface designed to bridge the gap between AI agents and the TradingBoat (TBOT) runtime stack. As part of the ecosystem of Openclaw Skills, it provides a safety-first approach to managing Interactive Brokers (IBKR) automated trading setups. It emphasizes a DB-first strategy, meaning it queries the local SQLite database for portfolio and order data before attempting more intrusive discovery actions.
Built with reliability in mind, this skill handles everything from monitoring container health to generating schema-validated TradingView-style JSON payloads. It serves as an essential tool for developers using Openclaw Skills to maintain high-frequency or algorithmic trading environments without manual intervention through a professional CLI-based workflow.
TBOT Controller Use Cases
- Monitoring real-time portfolio snapshots and unrealized P&L from the TBOT database.
- Controlling TBOT service lifecycles via Docker Compose or systemd with explicit confirmation.
- Troubleshooting trading errors by tailing and grouping logs from active containers.
- Generating and sending TradingView-style webhook JSON signals for automated trade execution.
How TBOT Controller Works
- Discovery: The skill identifies the TBOT runtime location by checking environment variables like TBOT_COMPOSE_DIR or searching for docker-compose files.
- Inspection: It queries the local SQLite database to retrieve the latest alerts, orders, and system status without interrupting the runtime.
- Validation: For trade signals, it generates a JSON payload and validates it against the alert_webhook_schema.json to ensure broker compatibility.
- Execution: It performs lifecycle actions such as start, stop, or restart only when the explicit --run-it flag is provided, ensuring human-in-the-loop safety.
TBOT Controller Setup
To integrate this with your Openclaw Skills workflow, ensure you have the tbot-runtime installed and the uv package manager ready.
# Install the required uv package manager
brew install uv
# Clone the recommended runtime stack
git clone https://github.com/PlusGenie/openclaw-on-tradingboat.git
# Configure the skill location
export TBOT_COMPOSE_DIR="$HOME/path/to/openclaw-on-tradingboat"
# Set permissions for the entrypoint script
chmod +x scripts/tbot.sh
TBOT Controller Data Schema & Taxonomy
The skill interacts with core SQLite tables and generates structured JSON signals based on a specific taxonomy.
| Table/Entity | Description |
|---|---|
| orders | Tracks historical and active IBKR orders and fill status |
| alerts | Logs TradingView signals received via the webhook interface |
| errors | Categorizes and stores system and broker-level error logs |
| tbot | Manages core runtime state and heartbeat metadata |
Signal payloads follow the TradingView webhook standard, including mandatory fields like ticker, direction (e.g., strategy.entrylong), contract type, and a metrics array for price and quantity.
TBOT Controller Advanced Features
- Multi-mode support for both Docker Compose stacks and native systemd service environments.
- Automated discovery logic to prevent checking obsolete paths or inactive runtime folders.
- Non-interactive JSON signal generation with intelligent field inference for tickers and quantities.
- Security-hardened design that redacts sensitive API keys and requires explicit confirmation for state-changing commands.
- Integrated health checks to verify HTTP connectivity to the TBOT backend.
SKILL.md
Loading
Related Openclaw Skills
Workflow Orchestrator
A structural skeleton for managing deterministic, queue-driven AI orchestration and multi-phase state transitions.
Web Markdown Navigator
A deterministic tool for converting complex webpages into clean, LLM-ready markdown with intelligent fallback mechanisms.
Report Generator
An automated reporting engine designed to transform structured data files into professional, decision-ready executive summaries and visualizations.
Recursive Swarm
A bounded recursive orchestration skill that decomposes massive tasks into manageable, trackable sub-task trees with explicit state management.
Venice.ai Supreme Router
A smart model router for Venice.ai that optimizes API costs and privacy by automatically selecting the ideal model tier for any given prompt.
Daily Digest
An automated tool that synthesizes daily agent interactions into structured journals for better knowledge retention.
Featured*
