AiCoin Freqtrade 用于在 CoinClaw 环境中操作 Freqtrade 交易机器人，覆盖策略创建、回测、Hyperopt 调参、部署、实时控制与状态查询。脚本内置三引擎（OpenClaw / Hermes / Claude Code）自动识别，路径、认证与 supervisord socket 自动解析。
一、运行方式 在 CoinClaw 容器中，freqtrade 由 supervisord 作为常驻 daemon 运行，监听 127.0.0.1:8080，默认跑 NoOpStrategy。不要自行启动 freqtrade 进程，否则会与 daemon 抢端口。正确流程是：写策略文件 → 调用 ft-deploy.mjs deploy → 脚本修改 config 并重启 daemon。
二、查询与实时控制 查询类问题应优先调用 freqtrade REST API，而非自行计算。常用命令包括：ft.mjs profit（盈亏）、trades_open（持仓）、balance（余额）、daemon_info（策略与模式）、trades_history（历史交易）、profit_per_pair（单交易对绩效）。报告盈亏时需同时给出已平仓累计盈亏（profit_closed_coin）与含浮动总盈亏（profit_all_coin），以与 dashboard 对齐。
三、配置变更 切换策略、切实盘/模拟需修改 config 并重启 daemon（约 30 秒）；切换交易对只需 reload_config，不重启。任何直接修改 config.json 的操作后必须立即调用 ft.mjs reload，否则 daemon 仍使用内存中的旧配置。
四、高 stake 操作确认 通过 agent 发起的平仓、开仓、切实盘等操作，必须先列出预览（交易对、当前盈亏、估算损益、dry_run 状态、余额），等用户明确输入“确认”或“yes”后才执行。查询类与非破坏性配置（如加币对、reload）无需确认。
五、策略创建 简单策略可用 create_strategy 快速生成，支持预设指标（rsi、bb、ema、sma、macd、kdj、atr、adx、cci、williams_r、vwap、ichimoku、volume_sma、obv）与方向（long / short / both）。复杂逻辑（跨周期、多币种轮动、自定义复合指标、自定义仓位管理）需直接编写 Python 策略文件。生成器不支持跨周期与多币种轮动。
六、AiCoin 数据集成 策略可通过 AiCoin Python SDK 调用资金费率、多空比、大单、清算图等数据。回测期间 AiCoin 实时数据不可用，相关列使用默认值，回测结果只反映技术指标部分，向用户报告时需主动说明。部分数据需付费套餐，无权限时会抛异常，策略中应做兜底处理。
七、限制 Freqtrade 不支持网格策略，用户询问时应说明限制并建议趋势跟踪、区间策略或网格回报模拟器替代。不要伪造回测数据，不要将内部 daemon 密码或用户交易所 key 输出到聊天中。