从零上手 Microduck让 AI 鸭子机器人听摇杆走路的完整教程【免费下载链接】microduckA Tiny biped duck robot 项目地址: https://gitcode.com/GitHub_Trending/mi/microduckMicroduck 是一台约 25 厘米、重 800 克的双足 AI 鸭子机器人RK3566 上的守护进程以 50 Hz 控制循环驱动 15 个舵机实时运行神经网络策略。这份快速上手指南带你从开机自检走到摇杆驱动它走路约 10 分钟。三分钟定心丸快速上手前的三个问题它适合谁适合手里有一台 Microduck 本体、想开终端就把它开走的人全程不写代码、不编译只跑命令。没有硬件也别慌——最后一节的duck-sim用同样的守护进程驱动 MuJoCo 里的鸭子身体体验完全一致。要备什么硬件Microduck 本体Rockchip RK3566 板、15 个 Dynamixel 舵机、头部 ToF 深度传感器一个蓝牙游戏杆Xbox、DualSense 或 Switch 风格的 Pro Controller 均可一个 Wi-Fi 路由器可省——鸭子可以纯蓝牙直连软件出厂镜像已预装全部守护进程无需编译走模拟路线的话另需Rust 工具链 一份microduck_rl检出提供 MuJoCo 身体进程duck-body架构你只需要一段话能记住robotd拥有控制循环和电机总线updaterd做签名更新与健康回滚configd管 Wi-Fi 与身份btd是蓝牙通道padd读游戏杆mediad用 WebRTC 推摄像头画面tofd供深度传感器——它们之间走同一套 Unix socket 上的 JSON-RPC。下面每条命令都是你在以客户端身份问这些守护进程要东西。最可能卡在哪游戏杆配对。它是全文唯一强烈依赖硬件的一步凶手通常是板载蓝牙无线电或Privacy配置不是你的操作。配不上就查配对专页里面有完整的判断表如果全查完还是配不上那真不是文章写得不好——这块 aic8800 无线电确实经常搞事。 自检通过两条命令确认硬件与版本做完这一步你会确切知道硬件是否在线、软件版本是否一致。先登录HDMI 接屏键或 Wi-Fi 通了之后走 SSH——第一次用 HDMI因为配网是下一节的事。先跑自检。它把硬件与软件状态一次报齐电机总线是否在线、策略是否加载、电池与温度。为什么先跑它不健康时它返回非零退出码脚本可以直接用它做门禁。robotctl health成功信号退出码为 0。过热电机、被 pin 住的组件只会被如实报告不影响退出码——报告归报告判断归判断。再跑版本对照把正在运行和已安装放在一起看robotctl version成功信号两者一致、没有警告。为什么要在相信任何诊断之前先跑它更新之后还在跑旧代码的守护进程和你刚修好的 bug 长得一模一样。不一致就先更新再继续。 桌面测试时电机没上电robotd报告不健康是诚实答案不是安装失败。 鸭子上线Wi-Fi 一步到位手柄一次配对做完本节鸭子既在你网络里游戏杆也从此免维护——两件事都是一次性的。连网断线就是成功信号扫一遍网络等上几秒——它等的是无线电真正扫完而不是上次扫描的缓存robotctl net scan接着连接。用--psk-stdin让口令从标准输入读而不是变成命令行参数——后者会让ps里的每个用户在命令存活期间都看得见你的密码sudo robotctl net connect 你的 SSID --psk-stdin成功信号你的 SSH 会话断开。切换网络会切断原连接这正是操作成功的表现——掉线不是故障。用新网络地址重连继续。完全不想配 Wi-Fi 也成立duckctl让笔记本通过蓝牙直接摸到鸭子不需要网络和 SSH命令清单在仓库文档docs/robot/duckctl.md。配手柄一次配对开机自动重连配对每个手柄只做一次配好之后padd从开机起就驱动任何连上来的杆你的 SSH 会话挂了它也不受影响。第 1 步让手柄进入配对模式Xbox短按 Xbox 键开机按住反而关机再按顶部小 Sync 键直到灯快闪——慢闪是已开机但未配对DualSense按住 Create PS 直到灯条闪烁Pro Controller按住顶部 Sync 键直到玩家指示灯来回扫第 2 步在机器人上配对。不需要 MAC 地址机器人自己搜索处于配对模式的手柄找到就接手sudo robotctl pad pair成功信号输出出现paired Xbox Wireless Controller MAC。再查一次状态robotctl pad status应看到两行pad … connected和padd active。为什么是两行——它们可以各自失败手柄连着但驱动死了和机器人坏掉在你眼里长得一模一样。⚠️ 死活配不上多半是蓝牙Privacy设置或 aic8800 无线电的问题排障全流程见 docs/robot/pair-a-gamepad.md。 摇杆驱动鸭子站起来开始走路做完这一步鸭子听你的摇杆走。先把鸭子放在支架上——第一次站立务必。流程以 Start 键为枢纽按 Start电机上电2 秒斜坡进入站立姿态再按一次 Start策略接管鸭子开始听杆左摇杆前后 → 前进/后退横移 → 侧走move 模式方向键左默认右摇杆→ 转向松开摇杆鸭子原地站定。注意没有急停按钮——这是刻意设计robotd的 deadman 机制保证手柄进程挂掉时机器人自动停下。Select 按下 2–4 秒再松开是 rest电机断电、全部舵机重启鸭子会趴下扶稳。成功信号它真的走了。或者开robotctl monitor看终端实时画出姿态、关节【免费下载链接】microduckA Tiny biped duck robot 项目地址: https://gitcode.com/GitHub_Trending/mi/microduck创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考