跳到正文
已核查原始资料

MicroDuck 排障:升级配对、摄像头与策略

MicroDuck 0.20.1:先分清访问方式再恢复. Wi-Fi SSH 需要本地决定。先核对 daemon/API 和 Setup Code,不把连接被拒直接当成升级失败。

官方 MicroDuck 的 daemon 0.20.1 取代 0.20.0,撤回 system.openWifiSsh。仅 Wi-Fi SSH 被拒,不能据此判定升级失败。

官方 MicroDuck 升级与恢复

  1. 更新前记录已装版本和 health 输出,保存能正常工作的镜像与配置。
  2. 按下面的症状找到对应版本的检查。连接、服务、传感器反馈和策略兼容是不同条件。
  3. 更改后回读版本和设置,再核对 health 与策略选择。检查失败时按同一镜像和硬件的恢复流程处理。

MicroDuck 0.20.1:先分清访问方式再恢复

仅适用于官方机器人:daemon-v0.20.1 于 2026-11-12 发布,固定修订 7fba12ed,API 55。本页核对发布说明、固定源码和发布压缩包,没有启动或升级实机。HD1910 个人复刻及 Open Duck Mini 使用不同软件。

先读实际版本和升级状态

在已有授权访问的电脑上,执行下方只读版本与升级状态命令,记录 release、revision、API 和升级结果。升级会重启蓝牙服务,连接断开后先重连,再判断是否故障。

Setup Code 只留在自己的设备

兼容 App 使用本机的二维码或代码。电脑端 duckctl 的 setup-code add 从标准输入读取代码并保存在本地。已配置凭据的机器拒绝旧 PIN;旧密钥可能表现为握手后静默断连,先核对机器身份和客户端版本,再考虑重置配对。

Wi-Fi SSH 被拒要单独判断

0.20.0 曾允许用 Setup Code 经蓝牙开启 Wi-Fi SSH,但 SSH 随后接受共享操作员密码。0.20.1 撤回该方法及 duckctl ssh-wifi。开启 Wi-Fi SSH 要在机器打开时经本地 USB-C 明确操作,或使用开发镜像。先看原始访问说明,不反复重试已删除的命令。v54 客户端请求 system.openWifiSsh 会被 API 55 按方法名明确拒绝。

duckctl --name <robot-name> version
duckctl --name <robot-name> update status

此稳定标签的策略安装器以 v9 为最低要求,并非强制覆盖为 v9:按来源规则保留更新的官方策略集和自定义策略集。HF v10 及后续 main 的 API 56 属于另一版本范围,不能写成 0.20.1 已具备的功能。

求助时写明访问路径(BLE / USB-C / Wi-Fi SSH)、daemon 和客户端版本、第一条脱敏错误。Setup Code、二维码密钥、PIN 和网络凭据不公开。下方保留 0.19.0 的配对与视频检查。

官方 MicroDuck 0.20.1 编辑核对图:实际版本、本地 Setup Code 与独立的 Wi-Fi SSH 访问条件。
依据固定 0.20.1 源码绘制的编辑原创图,不是实机照片、仿真结果或硬件测试。

MicroDuck 0.19.0 配对和视频排查

适用 2026-11-10 发布的官方 daemon 0.19.0。此处核查固定源码和发布附件。作者报告的 iOS 扫码、安全蓝牙和相机验证使用 face-board-v1 beta 实机。

有 Setup Code,扫本机二维码

在支持 Setup Code 的 App 中扫这台机器的二维码。凭据来自 ID EEPROM 或开发板已安装的密钥。改显示名称不会改动 Setup Code 使用的原始 duck-xxxx 标识。

无有效凭据,走机身 PIN

没有有效凭据时,btd 使用机身 PIN,duck-gateway 没有可用密钥。若有标签却扫码失败,先核对标签是否属于本机、App 是否支持该配对方式,再改设置。

蓝牙已连,分开查视频

安全蓝牙已连但看不到画面,先查机器人 Wi-Fi 和手机的本地网络权限。iOS 刚允许本地网络时,可回到 App 重试视频。已配置 Setup Code 的机器人通过 duck-gateway 认证后访问仅本机监听的 mediad。

官方 0.19.0 固定策略集 v9。VelStand 在 v9 使用 v7 的检查点,microduck_rl 新增的偏航重映射实验另行核对。

改配对或做恢复前,记录实际 daemon、手机 App 版本和首次出错环节。已有授权访问时可用下列只读状态命令。发帖只附脱敏错误,二维码、PIN、密钥和 Wi-Fi 凭据留在本地。

robotctl update status

MicroDuck 第一次连接:先找机,再配 Wi-Fi 和打开控制台

官方实体机初次连接时,用电脑端 duckctl 分清蓝牙已找到、暂无 IP、Wi-Fi 入网,以及网页 8080 与信令 8443 两种故障。

MicroDuck 0.18.3:遥测关闭、手柄重连与SSH核对

核对MicroDuck 0.18.3默认开启的使用遥测、关闭后状态和SSH地址缓存,以及0.18.2手柄重连修复;先确认官方与DIY系统适用范围。

MicroDuck 官方策略 v8:确认 walk 覆盖、更新与单槽恢复

10 月 12 日官方 velstand v8 已发布。先核对 policy list 与 check,再分开更新策略集;说明手动覆盖为何仍生效,以及恢复官方 walk 的准确步骤。

网页能打开,但机器人不动

确认进入场景并聚焦画面;检查 Feet / Rollers 与已加载策略。R 在当前浏览器控制坐下和站立,不是翻滚。具体按键见仿真操作。

Python 或命令不对

在固定仓库内运行 uv run python --version,应为 3.12.x。找不到 train,或执行了另一个程序时,使用 uv run train 并重新同步同一版本;不要先改整个系统的 PATH。

GPU 存在,但 CUDA 为 False

使用环境检查中的同一个 Python 环境诊断。记录系统架构、驱动、PyTorch 版本和 CUDA 构建。Linux ARM 的安装来源可能不同;Jetson Thor 的问题 #38不能当成所有 NVIDIA 设备的通用处方。

ARM 下载超时

官方快速开始给出延长下载超时的办法,适用于大依赖下载中断,不修复驱动或二进制不兼容。

可复制示例
UV_HTTP_TIMEOUT=600 uv sync --locked --python 3.12

模型报输入维度不匹配

当前 MicroDuck 接口为 61 个观测、14 个动作。旧 51 输入策略需要匹配旧布局。不要用补零强行改维度;关节顺序、归一化和时序同样重要。回到策略导出确认来源。

实体机手柄没反应:先查哪一层

以下只针对官方 MicroDuck 的 0.17.2 固定源码。该正式版原于 10 月 13 日发布,本站 14 日复核;蓝牙配对与掉线原指南和链路历史脚本不是 0.17.2 才出现的新功能。本站未连接手柄或操作实体机器人。发布记录。

先在机器人上保存只读基线:

可复制示例
robotctl version
robotctl configure --list
systemctl is-active padd netpadd
robotctl pad status
robotctl pad bindings
robotctl logs padd -n 100
robotctl logs bluetooth -n 100

按输出顺序判断:

观察下一步
padd inactive、netpadd active当前选择 UDP,蓝牙手柄此时不接管。先查配置,不要为此重新配对;0.17.2 新闻另讲 UDP 的新停走时序。
padd active、pad 未连接驱动在运行,但蓝牙输入未到。若状态写 paired but NOT trusted,本次可用却可能重启后不自动回连;先保存状态和日志,再按原配对说明处理信任。
pad connected、padd inactive蓝牙已连接与驱动可用是两项检查。对照两个服务状态和 padd 首条报错,不要只凭蓝牙图标判断。
两项都正常、某个键无动作看 pad bindings 与当前模式。0.16.2 起 X/Y/LB/RB 默认无动作;0.17.2 还允许调整摇杆轴、方向、增益和限制。固定配置说明。
驾驶时偶发卡住先看 padd 日志;robotctl monitor 按 p 可读原始 evdev 报告间隙。padd 可能以 50 Hz 重发上次摇杆值,下游“新意图”不等于蓝牙新报告。静止手柄本来不发报告;只有在机体受支撑、明确可安全运动时才考虑实时摇杆观察。

configure --list 只列出偏离默认值的覆盖,空白不等于命令失败。蓝牙已连却无输入的 Pro Controller 还可能是手工配对顺序错;不要先批量忘记所有手柄或盲改 BlueZ Privacy。固定配对指南按具体错误原因区分恢复办法。历史脚本的 --history 只读 padd 与内核已有日志:0x08 指监督超时,0x13/0x16 多为主动关机;没有历史记录不证明链路可靠。公开报告先遮去手柄地址、局域网 IP、序列号与账号。0.17.2 的 stale_ms 停走、timeout_ms 离线是 UDP netpadd 的分段行为,不能套到蓝牙配对问题。固定 UDP 指南。

提问时一次提供这些信息

可复制示例
目标与最后成功的步骤:
原教程 URL 与源码提交号:
系统 / 架构 / 浏览器或 Python 版本:
GPU / 驱动 / PyTorch / CUDA:
完整执行命令:
第一条错误及上下文:
已经试过的改动:

通过讨论入口提交时,删除 token、密码和个人路径中的敏感信息。优先描述最后成功的一步,而不是只贴“不能运行”。

继续之前先确认

升级官方 MicroDuck 0.20.1 后 Wi-Fi SSH 被拒怎么办?

先从已有授权连接读取版本和升级状态。官方 0.20.1/API 55 已移除 system.openWifiSsh 与 duckctl ssh-wifi;Wi-Fi SSH 按上游说明走本地 USB-C 或开发镜像路径。仅被拒不能证明升级失败。本说明不适用于 HD1910 复刻或 Open Duck Mini。

适用范围: Pollen Robotics MicroDuck. 把模型、镜像、软件和驱动版本一起记录。各日期段落保留原有验证范围。

资料核查于:

来源与核查 (21)
  1. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/e81974b932c7ca1819843b7bb3dcd42e2993e98e/README.md
  2. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/e81974b932c7ca1819843b7bb3dcd42e2993e98e/app/src/game/controls/keyboard.js
  3. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/pyproject.toml
  4. docs.pytorch.org/docs/stable/generated/torch.cuda.is_available.html
  5. github.com/pollen-robotics/microduck_rl/issues/38
  6. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/infer_policy.py
  7. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/export.py
  8. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/hf/README.md
  9. huggingface.co/docs/hub/jobs-manage
  10. github.com/pollen-robotics/microduck/releases/tag/daemon-v0.17.2
  11. github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/docs/robot/pair-a-gamepad.md
  12. github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/docs/robot/cheatsheet.md
  13. github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/scripts/pad-link-test.sh
  14. github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/docs/robot/udp-pad.md
  15. github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/netpadd/src/receiver.rs
  16. github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/netpadd/src/main.rs
  17. github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/robotd-params/src/pad_axes.rs
  18. github.com/pollen-robotics/microduck/releases/tag/daemon-v0.20.1
  19. github.com/pollen-robotics/microduck/pull/574
  20. github.com/pollen-robotics/microduck/blob/7fba12ed048d0d3a1c306ba8a2787a1a407b9974/docs/robot/duckctl.md
  21. github.com/pollen-robotics/microduck/blob/7fba12ed048d0d3a1c306ba8a2787a1a407b9974/scripts/seed-policies.sh

接下来读这些教程

MicroDuck 第一次连接:先找机,再配 Wi-Fi 和打开控制台

官方实体机初次连接时,用电脑端 duckctl 分清蓝牙已找到、暂无 IP、Wi-Fi 入网,以及网页 8080 与信令 8443 两种故障。

MicroDuck 0.18.3:遥测关闭、手柄重连与SSH核对

核对MicroDuck 0.18.3默认开启的使用遥测、关闭后状态和SSH地址缓存,以及0.18.2手柄重连修复;先确认官方与DIY系统适用范围。

MicroDuck 官方策略 v8:确认 walk 覆盖、更新与单槽恢复

10 月 12 日官方 velstand v8 已发布。先核对 policy list 与 check,再分开更新策略集;说明手动覆盖为何仍生效,以及恢复官方 walk 的准确步骤。