Hummingbot / Installation

Hummingbot安装部署:hbot CLI、Docker 与交互式客户端

Hummingbot 推荐用 hbot CLI 直接运行客户端(从源码安装,需 Anaconda/Miniconda);也可用 Docker,或经典全屏交互式客户端 TUI。本文按官方 README 说明三条路径与前置条件。

CLI:make install + hbotDocker:make setup/deployTUI:make run
hbot CLI源码 + Anaconda
Dockermake setup/deploy
交互式 TUImake run
Hummingbot 三条安装路线示意(hbot CLI / Docker / 交互式 TUI),基于官方 README;示意非官方路线图。
Routes

三条安装路径对照

依据官方 README(2026-09 核验)。

方式命令 / 步骤前置条件
hbot CLI(推荐)git clonemake installconda activate hummingbothbot --helpAnaconda/Miniconda
Dockermake setupmake deploymake link-cliDocker Compose
交互式客户端(TUI)make install && make run(或 docker attach hummingbotDocker(默认)或源码环境
说明:hbot 首次使用时提示输入 keystore 密码加密交易所 API keys;可用 HBOT_PASSWORD 环境变量或 --password-stdin 非交互运行。
Steps

hbot CLI 源码安装分步流程

以下为官方 README 的 hbot CLI 安装主路径。

1. 克隆仓库

git clone https://github.com/hummingbot/hummingbot.git,进入目录。

2. 构建环境

make install 创建 conda 环境、构建扩展、暴露 hbot CLI。

3. 激活环境

conda activate hummingbot,然后 hbot --help 查看命令。

4. 外部 PATH(可选)

make link-cli 把 hbot 加入宿主 PATH,供脚本/agent 工作流调用。

Prerequisites

前置条件清单

依据官方 README(2026-09 核验)。

要求
Python 环境Anaconda/Miniconda(hbot CLI 源码安装)
容器Docker Compose(Docker 安装 / Gateway DEX 中间件)
交易所账号实盘需交易所 API keys;paper trading 无需
keystore 密码加密交易所 API keys,首次使用提示设置
Docker Steps

Docker 安装分步流程

以下为官方 README 的 Docker 安装主路径。

1. 克隆仓库

git clone https://github.com/hummingbot/hummingbot.git,进入目录。

2. make setup

回答 y 到 "Include Gateway?" 以添加 DEX 中间件。

3. make deploy

启动容器(默认交互式客户端)。

4. make link-cli

把 hbot 命令加到宿主 PATH,在容器内分发命令。

Who it fits

选哪种安装方式?

按你的目标与已有环境选择。

想脚本化运行

用 hbot CLI,非交互式 start/stop/status,脚本可读。

想要容器隔离

用 Docker(make setup/deploy),配合 Gateway 加 DEX 中间件。

不想维护环境

可看 EasyClaw 量化 Skill 路线,用一句话发起研究任务(非 Hummingbot 集成)。

FAQ

常见问题

Hummingbot 必须装 Anaconda 吗?

hbot CLI 源码安装需要 Anaconda/Miniconda;用 Docker 则只需 Docker Compose。

hbot CLI 和交互式 TUI 区别?

hbot CLI 是非交互式命令(start/stop/status/读 PnL),可脚本化;TUI 是经典全屏客户端(Docker 默认)。

Hummingbot 能一键安装吗?

官方未提供图形化一键安装;hbot CLI 是最接近的开箱即用方式。EasyClaw 是独立软件,不代表 Hummingbot 已集成。

装好后怎么继续?

跑通第一个做市策略看首次运行页;想了解策略框架看策略页。