本指南用于在自己的电脑或服务器安装已发布的 CROT 机器人。连接 HTX 跟单服务不需要安装机器人。

来源:README,版本 8e061bec845c。原始安装说明于 2026 年 9 月 12 日核对,下列命令对应这个固定版本。

1. 准备与获取代码

需要 Git、终端和兼容版本的 Python。请查看所选版本的 pyproject.toml 获取 Python 要求。在新目录工作,与正在运行的机器人分开;安装和离线测试不需要交易所密钥。

git clone https://github.com/Lermont/Crot-Pro.git CROT-setup
cd CROT-setup
git checkout 8e061bec845c0ea18ee14c9e28b6c6cbab2dc9cb

pyproject.toml · build.sh

2. Windows:安装与测试

在 PowerShell 中直接调用虚拟环境的 Python,无需激活环境。安装和检查命令来自该版本 README。

python -m venv .venv
.\.venv\Scripts\python -m pip install --upgrade pip
.\.venv\Scripts\python -m pip install -e ".[dev]"

$env:HTXBOT_DISABLE_DOTENV = "1"
.\.venv\Scripts\python -m compileall .
.\.venv\Scripts\python scripts/check_imports.py
.\.venv\Scripts\python -m pytest -q
Remove-Item Env:HTXBOT_DISABLE_DOTENV

HTXBOT_DISABLE_DOTENV 禁止检查过程读取本地 .env。测试使用交易所替身对象;成功只说明安装和相关检查通过,不能证明盈利或已准备好实盘交易。

3. Linux 与 macOS:安装脚本

先阅读所选版本的 build.sh,然后在项目目录执行:

bash build.sh

根据 README,该脚本安装包括 TA-Lib 和编译工具在内的系统依赖,创建环境并运行一致性测试。安装系统包前会请求确认。首次安装不要跳过测试。

4. 配置与实际启动

离线检查完成后,阅读 .env.example。仅在确实需要连接 HTX 的环境中创建 .env,不要覆盖已有密钥。模板中的 DRY_RUN=true 在此版本用于阻止创建实盘客户端,并不是交易模拟器。

STRATEGY 用于选择策略;该版本的交易与风险设置位于 strategies/<STRATEGY>/settings.py。启动实盘前,检查密钥权限、账户模式、杠杆、交易品种映射、已有仓位与活动订单。按固定版本 README 的检查清单操作,不要复制其他账户的参数。

常见错误

现象需要检查
找不到 Python / Git确认程序已安装且 PATH 正确;安装后重新打开终端。
ModuleNotFoundError确认使用的是 .venv 中的 Python,并且 pip install 已成功完成。
TA-Lib / 编译错误检查本机依赖和 Python 兼容性,阅读对应版本的 build.sh 与 README,不要忽略失败。
DRY_RUN=true实盘客户端拒绝创建是预期行为。先完成 README 中的账户检查。
测试失败保存错误信息和版本号,提交不含 .env 或密钥的问题反馈;不要继续进入交易。

下一步

如何评估开源机器人 · 风险管理 · 作者与资料来源 · 报告错误