Hummingbot 安装¶

运行 Hummingbot 的官方且推荐方式是通过 Hummingbot API，它提供了一个完整的交易平台，支持三种交互方式：

• 🤖 MCP（AI 助手） - 使用自然语言通过 Claude、ChatGPT 或 Gemini 控制您的交易
• 📊 仪表盘 - 用于机器人管理和监控的可视化网页界面
• 🔧 Swagger UI - 为开发者和高级用户提供完整的 REST API 访问

如需其他安装选项，请参阅 Docker（仅客户端）和 源码安装（适用于开发者）。

系统要求¶

云服务器或本地机器¶

Docker Compose¶

Hummingbot 使用 Docker Compose，这是一个用于定义和运行多容器 Docker 应用的工具。

快速开始（推荐：Hummingbot API）¶

Hummingbot API 是官方推荐的安装方式，提供 MCP AI 助手集成、仪表盘网页界面以及完整的 REST API 访问功能。

安装¶

克隆仓库并运行设置脚本：

git clone https://github.com/hummingbot/hummingbot-api.git
cd hummingbot-api
chmod +x setup.sh
./setup.sh

安装脚本将：

• 提示您输入凭据（默认： admin/admin）
• 询问是否启用仪表盘（可选的网页界面）
• 启动所有必需的 Docker 容器

安装内容说明¶

核心服务（始终安装）：

• ✅ Hummingbot API（端口 8000）- REST API 后端
• ✅ PostgreSQL - 用于存储交易数据的数据库
• ✅ EMQX - 实时通信的消息代理
• ✅ Swagger UI（端口 8000/docs）- API 文档

可选服务（在设置期间启用）：

• 📊 仪表盘（端口 8501）- 网页界面

访问您的平台¶

设置完成后：

• Swagger UI：http://localhost:8000/docs（始终可用）
• 仪表盘：http://localhost:8501（如已启用）

连接 AI 助手（可选）¶

设置完成后，您可以连接 AI 助手，通过自然语言控制 Hummingbot。

有关连接的完整说明，请参阅 MCP 安装指南：

• Claude Code（推荐）—— 一行 CLI 命令完成设置
• Gemini CLI —— Google 的 AI 终端代理
• Codex CLI —— OpenAI 的编程助手
• Claude Desktop —— 图形化桌面应用
• Docker MCP 目录 —— 通过 Docker Desktop 进行可视化设置

独立版 Hummingbot¶