无噪 logo
本文档翻译于 2025-10-20
  • 文档更新翻译历史
  • 2025-10-20 常规更新
Hummingbot
FTX 中国债权 我的
跳至内容

故障排除

安装

Docker：权限被拒绝错误

docker: 在尝试连接到 Docker 守护进程套接字时权限被拒绝 unix:///var/run/docker.sock...

上述错误信息表明在尝试访问 Docker 守护进程套接字时出现权限问题。当以非 root 用户身份运行 Docker 命令时，这是一个常见问题。要将您的用户添加到 docker 用户组，请使用以下命令：

sudo usermod -aG docker $USER  # 运行上述命令后请重启终端，如果仍然无效，请尝试下面的命令  sudo chmod 666 /var/run/docker.sock

源码：conda 命令未找到

$ conda -bash: conda: 未找到命令

请确保已安装 Anaconda、Miniconda 或 Miniforge（适用于 arm64 系统）。如果您刚刚安装，请重启终端以刷新命令行环境。

源码：./install: 第 40 行 ... 已终止

正在收集包元数据 (repodata.json)：/ ./install: 第 40 行：14981 已终止...
此错误通常出现在内存为 2GB 或更少的系统上安装过程中。请将系统的 RAM 增加至至少 4GB，或者在无法升级硬件的情况下考虑添加交换文件。

源码：找不到 conda 环境：hummingbot

Alt text

此问题与上述问题相关。请检查运行 ./install 脚本后是否有任何错误。如果有，请先解决这些错误，否则创建 hummingbot conda 环境将会失败。

源码：无法执行 gcc：没有此类文件或目录

Alt text

如果遇到此错误，您需要安装 build-essential 包。运行以下命令进行安装 - 

sudo apt update && sudo apt upgrade -y && sudo apt install -y build-essential

仪表盘

MQTT Bridge 连接失败：

00:21:16 - hummingbot_application - Failed to connect MQTT Bridge:  [Errno 111] Connection refused. Retrying in 10.0 seconds.

如果出现此错误，通常意味着 Hummingbot Broker 未运行，请从“实例”页面启动 Broker，然后重新启动所有 Hummingbot 客户端实例。

Docker 未运行。请启动 Docker 并刷新页面。

Alt text

请确保已安装 Docker。在 Windows 和 MacOS 设备上，请确认 Docker Desktop 已在后台运行。

No module named hummingbot

Alt text

注意：缺失模块的名称可能是其他内容，例如 st_pages 等。如果出现此提示，说明环境未正确安装。请在终端中按以下步骤重新安装 - 

conda deactivate make env_remove make env_create conda activate dashboard make run

认证页面未在仪表盘中显示

默认情况下，认证系统是禁用的。

在 CONFIG.py 文件中找到变量 AUTH_SYSTEM_ENABLED，并将其设置为 True 以启用认证页面。

V1 策略

V2 策略

AttributeError: 'hummingbot.connector.exchange.kraken.kraken_exchan' 对象没有属性 '_order_tracker'

Traceback (most recent call last):  File "hummingbot/core/pubsub.pyx", line 165, in hummingbot.core.pubsub.PubSub.c_trigger_event  typed_listener.c_call(arg)  File "hummingbot/core/event/event_listener.pyx", line 25, in hummingbot.core.event.event_listener.EventListener.c_call  self(arg)  File "/home/hummingbot/hummingbot/core/event/event_forwarder.py", line 24, in __call__  self._to_function(self.current_event_tag, self.current_event_caller, arg)  File "/home/hummingbot/hummingbot/smart_components/executors/position_executor/position_executor.py", line 338, in process_order_created_event  self.open_order.order = self.get_in_flight_order(self.exchange, event.order_id)  File "/home/hummingbot/hummingbot/smart_components/smart_component_base.py", line 65, in get_in_flight_order  order = connector._order_tracker.fetch_order(client_order_id=order_id) AttributeError: 'hummingbot.connector.exchange.kraken.kraken_exchan' object has no attribute '_order_tracker' 2023-12-02 12:56:07,012 - 15 - hummingbot.core.event.event_reporter - EVENT_LOG - {"timestamp": 1701521767.0,  "type": "OrderType.LIMIT", "trading_pair": "ETH-USDT", "amount": "0.01192817", "price": "2095.87", "order_id": "buy-ETH-USDT-1701521766935688", "creation_timestamp": 1701521766.0, "exchange_order_id": null, "leverage": 1, "position": "NIL", "event_name": "BuyOrderCreatedEvent", "event_source": "kraken"}

如果 Kraken 或其他交易所出现此错误，是因为该交易所连接器目前不支持市价单，而 PositionExecutor 需要市价单来平仓。

连接器

ValueError: 不存在 'BTC-USD' 的订单簿。

 2024-01-25 21:19:12,916 - 111864 - hummingbot.connector.exchange.kraken.kraken_api_user_stream_data_source - ERROR - Kraken WebSocket 连接出现意外错误。30 秒后重试... Traceback (most recent call last):  File "/home/martin_kou/Development/hummingbot/hummingbot/connector/exchange/kraken/kraken_api_user_stream_data_source.py", line 100, in listen_for_user_stream  self._current_auth_token = await self.get_auth_token()  File "/home/martin_kou/Development/hummingbot/hummingbot/connector/exchange/kraken/kraken_api_user_stream_data_source.py", line 89, in get_auth_token  return response_json["result"]["token"] KeyError: 'result'   File "hummingbot/connector/exchange_base.pyx", line 158, in hummingbot.connector.exchange_base.ExchangeBase.c_get_price  OrderBook order_book = self.c_get_order_book(trading_pair)  File "hummingbot/connector/exchange/kraken/kraken_exchange.pyx", line 1050, in hummingbot.connector.exchange.kraken.kraken_exchange.KrakenExchange.c_get_order_book  raise ValueError(f"No order book exists for '{trading_pair}'.") ValueError: No order book exists for 'BTC-USD'.

如果出现此错误，请确保在创建 API 密钥时勾选了 Access Websockets API 选项。

网关

客户端卡在 "script_strategy_base - uniswap_ethereum_mainnet is not ready. Please wait..."

您需要批准交易中使用的代币。例如，在以太坊主网上交易 WETH 时，请参考以下命令：

gateway approve-tokens uniswap_ethereum_mainnet WETH

注意

在批准代币时，如果出现“Token not Supported”错误，请手动在代币列表中添加代币地址。代币列表位于 ./conf/list 文件夹中

在 balance 命令中未显示代币余额

Alt text

使用以下命令显示不同网络上的代币余额。

>>> gateway connector-tokens uniswap_ethereum_goerli WETH,DAI

杂项

无法粘贴，出现错误消息

 Pyperclip could not find a copy/paste mechanism for your system.  For more information, please visit https://pyperclip.readthedocs.io/en/latest/introduction.html#not-implemented-error

此错误是因为 CTRL + V 在 Hummingbot 中不起作用。请尝试以下任一快捷方式粘贴。

Shift + Insert CTRL + SHIFT + 右键单击 CTRL + SHIFT + V

如何退出配置

Alt text

如果想取消配置，请按 CTRL + X

余额已显示但“总计（$）”未显示

Alt text

如果一个或多个代币的 总计（$） 显示为 0，请使用以下命令更改您的汇率来源。默认情况下，rate_oracle_source 设置为 Binance，如果该代币在 Binance 上不可用，则 总计（$） 将显示为 0。

config rate_oracle_source