tbot-controller

tbot-controller 是专为 TradingBoat/TBOT 运行时栈设计的自动化控制接口，采用"DB-first"架构，优先通过 SQLite 数据库查询交易订单、持仓、警报和错误日志。用户可通过 Docker Compose 或 systemd 控制服务生命周期，并生成 TradingView 风格的 Webhook JSON 信号。所有操作通过 bash scripts/tbot.sh 入口脚本执行，分为 ctl（控制）、json（信号生成）和 status（状态查询）三种模式。

该技能的显著优点在于其严谨的安全设计：默认只读操作，任何状态变更（启动/停止/重启）必须通过 --run-it 标志或 RUN_IT=1 环境变量显式确认，有效防止误操作导致的交易中断。本地优先架构确保所有数据处理在本地完成，从本地 .env 读取配置，不向远程上传敏感信息，充分保护交易隐私。同时支持 Docker Compose 和 systemd 两种部署方式，自动发现运行时位置，适应不同用户的部署习惯。完善的输入验证机制对参数进行类型检查和范围限制（如 --limit 限制 1-5000），并使用参数化查询防止 SQL 注入。

潜在局限性包括：该技能本身不安装 TBOT 运行时，若未预先部署 openclaw-on-tradingboat 项目，控制功能将无法使用；发现机制在识别运行中的 Docker Compose 栈时可能存在遗漏，建议优先使用 DB-first 命令；作为个人开发者（PlusGenie）维护的项目，长期维护能力存在不确定性；且功能仅针对 TBOT 生态设计，不适用于其他交易平台。

该技能适合使用 TradingBoat/TBOT 进行自动化量化交易的个人投资者、需要通过 OpenClaw 控制本地交易环境的开发者，以及使用 Interactive Brokers（IBKR）进行程序化交易的技术用户。使用者需具备 Docker 或 systemd 基础知识。

使用过程中需警惕以下风险：首先，虽然控制操作需要确认，但错误的交易信号生成仍可能导致实盘交易损失，使用前务必确认运行时是模拟盘还是实盘；其次，重启或停止操作会中断正在运行的交易策略，可能导致错过交易信号或持仓风险暴露；再次，若 TBOT_COMPOSE_DIR 或数据库路径配置错误，可能操作错误的环境或读取过期数据；最后，技能依赖 uv 和特定 Python 环境，依赖项变更可能影响正常运行。