官方 MicroDuck 升级与恢复
- 更新前记录已装版本和 health 输出,保存能正常工作的镜像与配置。
- 按下面的症状找到对应版本的检查。连接、服务、传感器反馈和策略兼容是不同条件。
- 更改后回读版本和设置,再核对 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.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- daemon 0.15.2 · 提起暂停等于断电吗?
- daemon 0.16.1 · 旧手柄映射可以不检查就沿用吗?
- daemon 0.15.0 · 升级前应该保存哪些输出?
- daemon 0.17.1 · 切换到 UDP 就能证明手柄链路可用吗?
- daemon 0.17.2 · 300 毫秒和 1000 毫秒表示同一件事吗?
- daemon 0.17.4 · 找不到旧名字就代表机器人离线吗?
- daemon 0.17.6 · 出现 response too large 就应立即刷机吗?
- daemon 0.17.8 · 电脑发声就证明机器人回包了吗?
- daemon 0.17.9 · 服务在线就代表相机数据是最新的吗?
- daemon 0.18.1 · 服务可用、IMU 已识别与策略可运行是一回事吗?
- daemon 0.18.3 · 修改遥测同意设置能修复重连吗?
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)
- huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/e81974b932c7ca1819843b7bb3dcd42e2993e98e/README.md
- huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/e81974b932c7ca1819843b7bb3dcd42e2993e98e/app/src/game/controls/keyboard.js
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/pyproject.toml
- docs.pytorch.org/docs/stable/generated/torch.cuda.is_available.html
- github.com/pollen-robotics/microduck_rl/issues/38
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/infer_policy.py
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/export.py
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/hf/README.md
- huggingface.co/docs/hub/jobs-manage
- github.com/pollen-robotics/microduck/releases/tag/daemon-v0.17.2
- github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/docs/robot/pair-a-gamepad.md
- github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/docs/robot/cheatsheet.md
- github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/scripts/pad-link-test.sh
- github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/docs/robot/udp-pad.md
- github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/netpadd/src/receiver.rs
- github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/netpadd/src/main.rs
- github.com/pollen-robotics/microduck/blob/35b71a2a4499eb22216b3417e19e97db602561d4/robotd-params/src/pad_axes.rs
- github.com/pollen-robotics/microduck/releases/tag/daemon-v0.20.1
- github.com/pollen-robotics/microduck/pull/574
- github.com/pollen-robotics/microduck/blob/7fba12ed048d0d3a1c306ba8a2787a1a407b9974/docs/robot/duckctl.md
- 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 的准确步骤。