核心用法
SOARM Control Skill 是一套基于 REST API 的机械臂控制方案，专为 OpenClaw SOARM 机械臂设计。开发者可通过 HTTP 请求实现三大核心功能：状态读取（/joints 端点返回当前关节角度与末端执行器 XYZ 位置）、关节空间控制（/move/joints 接受 6 轴角度数组，前 5 轴为度、夹爪为 0-100）以及笛卡尔空间控制（/move/xyz 以米为单位指定目标位置）。此外还内置 /pick 端点一键触发预编程抓取任务，自动处理碰撞检测与任务队列管理。
显著优点
- 零 SDK 依赖：纯 HTTP/cURL 交互，任何语言均可调用，大幅降低集成门槛
- 双空间控制：同时支持关节空间精确操控与笛卡尔空间直观定位，适应不同场景
- 预置安全位姿：内置
initial（归中）与top_down（俯视）两种常用位姿，减少调试时间 - 任务队列机制：
/pick端点自动排他（409 冲突响应），避免多任务抢占导致的安全风险 - 本地部署友好：默认监听
127.0.0.1:8000，适合边缘计算与离线环境
潜在缺点与局限性
- 网络单点故障：API 服务宕机则完全失控，无降级硬件急停方案
- 无实时反馈：HTTP 轮询延迟（典型 10-100ms）难以满足高速动态跟踪需求
- 运动学黑盒：逆解算法封装于
pinocchio脚本，用户无法干预奇异点规避策略 - 安全边界缺失：文档未提及软限位、碰撞检测灵敏度或工作空间约束配置
- 平台锁定：URDF 与校准文件依赖 TheRobotStudio 生态，迁移成本较高
适合人群
- 机器人教育/科研团队快速验证抓取算法
- 已有 OpenClaw 生态的中小自动化项目
- 熟悉 Python/HTTP 但无 ROS 经验的开发者
常规风险
- 机械伤害：未经验证的 XYZ 坐标可能使机械臂撞击自身或环境，需始终在初始位姿附近测试
- 网络暴露风险：默认绑定本地回环，若配置为
0.0.0.0且暴露公网，存在未授权操控风险 - 夹爪过压：0-100 的抽象映射未说明对应实际力矩，易导致物体滑脱或结构损伤
- 并发任务冲突：虽有 409 响应，但客户端需正确处理，否则可能引发状态不一致