OpenArm 导航指南：仓库里有什么，从哪儿动手

OpenArm 导航指南：仓库里有什么，从哪儿动手

【免费下载链接】openarmA fully open-source humanoid arm for physical AI research and deployment in contact-rich environments.项目地址: https://gitcode.com/GitHub_Trending/op/openarm

这份 OpenArm 导航指南写给想在十分钟里摸清仓库门道的新人。OpenArm 是一个面向物理 AI 研究和接触丰富场景部署的 7 自由度人形机械臂开源项目，仓库本身不是一堆代码，而是站点加全套资料库：硬件图纸、零件清单、接线图、软件教程、仿真配置都在这里。

上图帮你确认项目的两种硬件形态：左侧是立柱底座上的双臂系统，右侧是装进评测单元（OpenArm Cell）的臂体——背景、灯光、相机位置统一，是项目"评测可复现"的主张所在。

先看 OpenArm 资料地图：仓库里 5 个功能区块

不用逐目录翻，先按用途把仓库切成 5 块，需要时再回来查 📦：

这张规格页是确认这条臂性能边界最快的方式：单臂 7 自由度、峰值负载 6.0 kg、CAN-FD 上 1kHz 控制频率、双臂整套物料成本 6,500 美元——想核实"够不够用"先看这里。

硬件搭建区是仓库里篇幅最大的部分，website/static/img/hardware/ 下给每个组装页配了高清步骤图；website/static/file/hardware/ 目录还放了电气部分的 Gerber 制造文件和电机数据手册，需要打样 PCB 或核对电机参数时直接取用。

这是 J1–J2 关节的装配细节，图里明确标注了左右两种镜像方向——组装主从臂时先对着图核对朝向，能避免装反返工。

软件党上手路线：从电机 ID 到 Demo 把臂跑起来

按软件视角走，主线就一条：先让电脑和电机通信，再让关节动，最后接遥操作。每一步都是动词开头的短句 🛠️：

1. 确认系统环境。用 Ubuntu 22.04/24.04 或带 SocketCAN 支持的 Linux 发行版，硬件前置条件查 website/docs/setup/openarm-setup/。
2. 分配电机 ID。用 USB CAN 调试器连上 Damiao 电机，逐个读取信息并写入规划好的编号。
3. 接入 CAN 总线。把通信设备插到电脑，按教程确认 Linux 下能看到 can 接口。
4. 跑配置测试。执行测试脚本，所有电机都应答后才进下一步。
5. 加载 demo 程序。观察各关节在机械限位内运动，即算部署完成。

接线前先对照这张图：哪根线进电机、哪根接 24V 电源、哪根走 USB to CAN 转换，照图插一遍能省掉后面大量的排查时间。

卡住时按顺序查三处：website/docs/setup/openarm-setup/ 里编号 1 到 6 的独立步骤页；website/docs/faq/ 的高频问题；协议层面的报文和参数去 website/docs/api-reference/can/ 查。

遥操作与仿真：臂跑起来之后读什么

臂能动了，下一步是采集数据。想用主从臂就翻 website/docs/teleop/leader-follower/，单向控制和双边力反馈两种模式的区别、接线与配置都写在里面；想用头显设备，看 website/docs/teleop/vr.mdx 的 VR 采集流程。KER 无电机主臂的校准页把安装到锁定的过程拆成了小节，第一步就是确认各关节在支架上落位：

渲染图里能看到校验要点：关节必须完全压入卡槽并锁紧，这一步不扎实，后面所有校准数据都会偏。

不碰真机也能先进仿真：website/docs/simulation/mujoco.mdx 和 website/docs/simulation/isaac-lab.mdx 各自给出模型加载到任务配置的完整走法，website/static/video/simulation/ 里还有对应平台的演示录像可对照预期效果。URDF/xacro 描述文件说明在 website/docs/api-reference/description.mdx，文档里给的 RViz 预览就是首次加载应有的样子：

截图展示单臂模型加载进 RViz 后的初始姿态，如果你渲染出来的关节错位或缺件，说明描述文件有问题，回上面链接对照排查。

OpenArm 文档环境本地跑起来的 4 步

整个文档站由 Docusaurus 构建，本地跑起来之后查资料、改文档、提 PR 都很顺手：

git clone https://gitcode.com/GitHub_Trending/op/openarm cd openarm/website npm install npm run start

环境要求 Node.js 20 以上；npm run start会直接打开浏览器，文档改动实时生效，不用重启服务。

卡住了去哪查、找谁问

提 Issue 之前先过一遍 CONTRIBUTING.md：bug 报告、功能建议、代码改动各走固定通道，发 PR 前还要确认 LICENSE；互动规范见 CODE_OF_CONDUCT.md。仓库的 Issue 和 Discussion 之外，项目还有 Discord 社区做实时答疑，入口在 README 的快速链接里。

先把本地文档跑起来，再从软件党路线挑一步走到通。遇到问题就开 Issue，把系统版本、硬件配置和复现步骤写全，社区响应会快得多。

【免费下载链接】openarmA fully open-source humanoid arm for physical AI research and deployment in contact-rich environments.项目地址: https://gitcode.com/GitHub_Trending/op/openarm