tbot-controller

What this skill does

• Query TBOT sqlite DB for alerts/orders/errors/portfolio (DB-first)
• Start/stop TradingBoat/TBOT (docker compose or systemd)
• Fetch health/status (containers, ports, basic checks) only when explicitly requested
• Read recent logs only when explicitly requested

Safety rules

• Default to read-only operations (status/logs) unless user explicitly requests a control action.
• For any state-changing action (start/stop/restart/send), require explicit confirmation via the flag --run-it or environment variable RUN_IT=1. The controller will refuse execution otherwise.
• Never print secrets (webhook keys, tokens). Redact them.

Refusal criteria (must-stop conditions)

The agent MUST stop and ask for user action if any of the following is true:

• Runtime location is unknown and discovery cannot uniquely resolve it.
• The TBOT database path cannot be found or opened read-only.
• A request would start/stop/restart services or send signals without --run-it / RUN_IT=1.
• A request implies destructive DB changes (DROP/TRUNCATE/ALTER) or “run arbitrary SQL”.

Prerequisites (first-time users)

This skill controls a separate TBOT runtime stack. The reference/runtime implementation is:

• openclaw-on-tradingboat (TBOT runtime stack): https://github.com/PlusGenie/openclaw-on-tradingboat

This tbot-controller skill does not download or install the runtime for you. If the runtime is missing, the skill will run read-only DB helpers where possible, but status/logs/control actions will fail until the runtime exists.

Install the runtime (recommended)

1. Clone the runtime repo:

git clone https://github.com/PlusGenie/openclaw-on-tradingboat.git
cd openclaw-on-tradingboat

2. Ensure you can start it manually (outside this skill). For Docker Compose based installs, this typically means:

docker compose up -d

3. Tell this skill where the runtime lives (recommended):

• Set TBOT_COMPOSE_DIR to the folder that contains docker-compose.yml or compose.yaml.

Examples:

export TBOT_COMPOSE_DIR="$HOME/develop/github/openclaw-on-tradingboat"

Or add it to ~/.openclaw/.env / your skill env block in openclaw.json.

Configure runtime secrets (outside this skill)

• TBOT typically uses a .env file for broker credentials and webhook keys.
• Do not commit secrets to git.
• If you are unsure whether the runtime is set to paper or live, this skill must refuse to execute any trade/action until you confirm which it is.

Install / script permissions

This skill is invoked via a bash entrypoint script. Ensure it is executable:

chmod +x scripts/tbot.sh

Python deps (OpenClaw-native)

This skill uses uv to run Python scripts in an isolated environment and auto-install dependencies from:

• {baseDir}/scripts/requirements.txt

Install uv (macOS):

brew install uv