OpenClaw作为近期热门开源项目，凭借简洁的操作逻辑与强大的适配能力，成为机械臂控制领域的关注焦点。其可实现AI指令与设备执行的全流程联动，大幅降低机械臂操控门槛。本文将聚焦实操，结合pyAgxArm SDK，带大家完成OpenClaw的下载、安装与配置，实现对NERO七轴机械臂的高效控制。

## 视频DEMO

!video[【养虾记】让openclaw小龙虾帮我控制七轴臂](https://cloud.tencent.com/developer/video/85144)




## 一、下载与安装openclaw

- 打开openclaw官网:[https://openclaw.ai/](https://openclaw.ai/)

- 找到`Quick Start`标签并执行一键安装脚本

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11444437/889dee2ad3a45f67f289b4c37a171486.png)

## 二、开始配置OpenClaw
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11444437/6f402a269dbf5b90d720e1d2f17098d3.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11444437/8d237f4c1eedcf0573d48ce73864f02f.png)
- 推荐选择QWEN模型
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11444437/fc6b63d201d1728ce2b006995690fc0b.png)
- 全选hook
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11444437/a46c34a764586bf4c338ecae37b6aacd.png)
- 打开web端网页
![外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传](https://developer.qcloudimg.com/http-save/yehe-11444437/63bf3485d9a4bb310a10dbe5db89ce28.png)


## 二、告诉OpenClaw学会Skill以及控制机械臂的规则

- 在skill目录创建`agx_arm_codegen`目录，然后创建使用下面的skill文件：

- SKILLS.md

```bash
---
name: agx-arm-codegen
description: 引导 OpenClaw 根据用户自然语言生成基于 pyAgxArm 的机械臂控制代码。当用户用提示词描述机械臂动作且现有脚本无法直接满足时，根据本技能提供的 API 与示例自动组织并生成可执行的 Python 脚本。
metadata:
  {
    "openclaw":
      {
        "emoji": "烙",
        "requires": { "bins": ["python3", "pip3"] },
      },
  }
---

## 功能概览

- 本技能用于**根据用户自然语言描述**，引导 OpenClaw **生成**可执行的 pyAgxArm 控制代码（Python 脚本），而不是仅调用现成 CLI。
- 参考 SDK：pyAgxArm（[GitHub](https://github.com/agilexrobotics/pyAgxArm)）；参考示例：`pyAgxArm/demos/nero/test1.py`。

## 何时使用本技能

- 用户说「写一段代码控制机械臂」「根据我的描述生成控制脚本」「让机械臂按顺序做多个动作」等。
- 用户明确要求「生成 Python 代码」或「给我可运行的脚本」来控制 Nero/Piper 等 AgileX 机械臂。

## 使用本技能生成代码
   - 根据用户提示词，结合本技能的 `references/pyagxarm-api.md` 中的 API 与模板，生成一段完整、可运行的 Python 脚本。
   - 生成后说明：脚本需在已安装 pyAgxArm 和 python-can 的环境中运行，且需 CAN 已激活、机械臂上电；提醒用户注意安全（工作区域无人、可先小幅度测试）。

## 生成代码时的规则

1. **连接与配置**
   - 使用 `create_agx_arm_config(robot="nero", comm="can", channel="can0", interface="socketcan")` 创建配置（Nero 示例；Piper 可用 `robot="piper"`）。
   - 使用 `AgxArmFactory.create_arm(robot_cfg)` 创建机械臂实例，再 `robot.connect()` 建立连接。
2. **使能与运动前**
   - CRITICAL: The robot MUST BE ENABLED before switching modes. If the robot is in a disabled state, you cannot switch modes.
   - 运动前需切换为普通模式，让后使能：`robot.set_normal_mode()`，然后轮询 `robot.enable()` 直到成功；可设 `robot.set_speed_percent(100)`。
   - 运动模式：每当需要使用move_*时或需要切换为*模式时候，需要显式的设置`robot.set_motion_mode(robot.MOTION_MODE.J)`（关节）、`P`（点到点）、`L`（直线）、`C`（圆弧）、`JS`（关节快速响应，慎用）。
3. **运动接口与单位**
   - 关节运动：`robot.move_j([j1, j2, ..., j7])`，单位为**弧度**，Nero 为 7 关节。
   - 笛卡尔：`robot.move_p(pose)` / `robot.move_l(pose)`，pose 为 `[x, y, z, roll, pitch, yaw]`，位置单位**米**，姿态**弧度**。
   - 圆弧：`robot.move_c(start_pose, mid_pose, end_pose)`，每个 pose 为 6 个浮点数。
   - CRITICAL: All movement commands (move_j, move_js, move_mit, move_c, move_l, move_p) must be used in normal mode
   - 运动完成后应轮询 `robot.get_arm_status().msg.motion_status == 0` 或封装 `wait_motion_done(robot, timeout=...)` 再执行下一步。
4. **模式切换**
   - Switching modes (master, slave, normal) requires 1s delay before and after the mode switch
   - Use `robot.set_normal_mode()` to set normal mode
   - Use `robot.set_master_mode()` to set master mode
   - Use `robot.set_slave_mode()` to set slave mode
   - CRITICAL: Enable the robot FIRST with `robot.enable()` BEFORE switching modes
5. **安全与结尾**
   - 在生成脚本中可注明：执行前确认工作区域安全；首次建议小幅度移动；紧急时使用物理急停或 `robot.electronic_emergency_stop()` / `robot.disable()`。
   - 若用户要求「完成后失能」，在脚本末尾调用 `robot.disable()`。
6. **实现细节**
   - When waiting for motion to complete, use shorter timeout (2-3 seconds)
   - After each mechanical arm operation, add a small sleep (0.01 seconds)
   - Motion completion detection: `robot.get_arm_status().msg.motion_status == 0` (not == 1)

## 参考文件

- **API 与最小可运行模板**：`references/pyagxarm-api.md`  
  生成代码时请结合该文件中的接口说明与代码片段，保证与 pyAgxArm 及 test1.py 用法一致。

## 安全注意事项

- 生成的代码会驱动真实机械臂，必须提醒用户：执行前确认工作区域内无人员和障碍物；建议先小幅度、低速度测试。
- 高风险模式（如 `move_js`、`move_mit`）应在代码注释或对用户说明中标注风险，并建议仅在了解后果后使用。
- 本技能只负责「引导生成代码」，不直接执行运动；实际运行环境、CAN 激活、pyAgxArm 安装由用户自行准备（可参考 agx-arm 技能中的环境准备）。
```

- pyagxarm-api.md

```bash
# pyAgxArm API 速查与最小可运行模板
供 OpenClaw 根据用户自然语言生成机械臂控制代码时参考。SDK 来源：pyAgxArm（[GitHub](https://github.com/agilexrobotics/pyAgxArm)）；示例参考：`pyAgxArm/demos/nero/test1.py`。
```

## 1. 连接与配置
```python
from pyAgxArm import create_agx_arm_config, AgxArmFactory
# 配置：robot 可选 nero / piper / piper_h / piper_l / piper_x；channel 如 can0
robot_cfg = create_agx_arm_config(
    robot="nero",
    comm="can",
    channel="can0",
    interface="socketcan",
robot = AgxArmFactory.create_arm(robot_cfg)
robot.connect()
```

- `create_agx_arm_config(robot, comm="can", channel="can0", interface="socketcan", **kwargs)`：创建配置字典；CAN 相关参数通过 kwargs 传入（如 channel、interface）。
- `AgxArmFactory.create_arm(config)`：返回机械臂驱动实例。
- `robot.connect()`：建立 CAN 连接并启动读取线程。

## 2. 使能与模式

```python
robot.set_normal_mode()   # 普通模式（单臂控制）
# 使能：轮询直到成功
while not robot.enable():
    time.sleep(0.01)

robot.set_speed_percent(100)   # 运动速度百分比 0–100
# 失能
while not robot.disable():
    time.sleep(0.01)
```

- 主从模式（Nero/Piper 等）：`robot.set_master_mode()`（零力拖拽）、`robot.set_slave_mode()`（跟随主臂）。


## 3. 运动模式与运动接口

| 模式 | 常量 | 接口 | 说明 |
|------|------|------|------|
| 关节位置速度 | `robot.MOTION_MODE.J` | `robot.move_j([j1..j7])` | 7 个关节角（弧度），有平滑 |
| 关节快速响应 | `robot.MOTION_MODE.JS` | `robot.move_js([j1..j7])` | 无平滑，慎用 |
| 点到点 | `robot.MOTION_MODE.P` | `robot.move_p([x,y,z,roll,pitch,yaw])` | 笛卡尔位姿，米/弧度 |
| 直线 | `robot.MOTION_MODE.L` | `robot.move_l([x,y,z,roll,pitch,yaw])` | 直线轨迹 |
| 圆弧 | `robot.MOTION_MODE.C` | `robot.move_c(start_pose, mid_pose, end_pose)` | 每 pose 6 个浮点数 |

- 单位：关节角为**弧度**；笛卡尔位姿为**米**（x,y,z）和**弧度**（roll, pitch, yaw）。
- Nero 为 7 关节；Piper 为 6 关节，`move_j`/`move_js` 参数数量需与机型一致。

示例（关节运动 + 等待完成）：
```python
import time

def wait_motion_done(robot, timeout: float = 3.0, poll_interval: float = 0.1) -> bool:  # Shorter timeout (2-3s)
    time.sleep(0.5)
    start_t = time.monotonic()
    while True:
        status = robot.get_arm_status()
        if status is not None and getattr(status.msg, "motion_status", None) == 0:
            return True
        if time.monotonic() - start_t > timeout:
            return False
        time.sleep(poll_interval)

robot.set_motion_mode(robot.MOTION_MODE.J)
robot.move_j([0.01, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0])
wait_motion_done(robot, timeout=3.0)  # Shorter timeout
```

## 4. 读取状态

- `robot.get_joint_angles()`：当前关节角（返回值带 `.msg` 属性时为数组）。
- `robot.get_flange_pose()`：当前法兰位姿 `[x, y, z, roll, pitch, yaw]`。
- `robot.get_arm_status()`：运动状态等；`status.msg.motion_status == 0` 表示运动完成。
- 注意：运动完成后检测 `robot.get_arm_status().msg.motion_status == 0`（不是 == 1）

## 5. 其他

- 回零：`robot.move_j([0] * 7)`（Nero 为 7 关节）。
- 急停：`robot.electronic_emergency_stop()`；恢复需 `robot.reset()`。
- MIT 阻抗/力矩控制（高级）：`robot.set_motion_mode(robot.MOTION_MODE.MIT)`，`robot.move_mit(joint_index, p_des, v_des, kp, kd, t_ff)`，参数范围见 SDK，慎用。

## 6. 最小可运行模板（生成代码时可基于此扩展）

```python
#!/usr/bin/env python3
import time
from pyAgxArm import create_agx_arm_config, AgxArmFactory


def wait_motion_done(robot, timeout: float = 3.0, poll_interval: float = 0.1) -> bool:  # Shorter timeout (2-3s)
    time.sleep(0.5)
    start_t = time.monotonic()
    while True:
        status = robot.get_arm_status()
        if status is not None and getattr(status.msg, "motion_status", None) == 0:
            return True
        if time.monotonic() - start_t > timeout:
            return False
        time.sleep(poll_interval)


def main():
    robot_cfg = create_agx_arm_config(
        robot="nero",
        comm="can",
        channel="can0",
        interface="socketcan",
    )
    robot = AgxArmFactory.create_arm(robot_cfg)
    robot.connect()

    # Mode switching requires 1s delay before and after
    time.sleep(1)  # 1s delay before mode switch
    robot.set_normal_mode()
    time.sleep(1)  # 1s delay after mode switch
    
    # CRITICAL: The robot MUST BE ENABLED before switching modes
    while not robot.enable():
        time.sleep(0.01)
    robot.set_speed_percent(80)

    # After each mechanical arm operation, add a small sleep (0.01 seconds)
    # CRITICAL: All movement commands must be used in normal mode
    robot.set_motion_mode(robot.MOTION_MODE.J)
    robot.move_j([0.05, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0])
    time.sleep(0.01)  # Small delay after move command
    wait_motion_done(robot, timeout=3.0)  # Shorter timeout

    # 可选：退出前失能
    # while not robot.disable():
    #     time.sleep(0.01)


if __name__ == "__main__":
    main()
```

生成代码时请根据用户描述替换或增加运动步骤（`move_j` / `move_p` / `move_l` / `move_c` 等），并保持连接、使能、`wait_motion_done` 和单位（弧度/米）一致。

- 接下来告诉OpenClaw学会这个skill
![1.png](https://developer.qcloudimg.com/http-save/yehe-11444437/11a5395e4501f50cc1eaa5a4b7c0caf0.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11444437/1ef7caedece552ee67052fbcddb0d813.png)


#### 配置好机械臂CAN通信和python环境后，便可以让OpenClaw自动调用SDK驱动，生成控制代码控制机械臂

![2.png](https://developer.qcloudimg.com/http-save/yehe-11444437/e1d4749d20beb58d69fd9d58690a468b.png)
看到这里，相信你已经对OpenClaw控制Nero机械臂的实操逻辑了如指掌，也get到了这波开源热点的核心玩法。

OpenClaw的爆火，从来不是偶然——它让AI从“云端建议者”变成“本地执行者”，而机械臂作为AI连接物理世界的重要载体，两者的结合必将解锁更多无限可能。 希望这篇教程能成为你入门的敲门砖，也希望你能带着学到的技能，去探索更多“AI+机械臂”的创新场景，无论是日常实操、项目开发，还是技能提升，愿你都能学有所成。 

实操过程中如果遇到问题，欢迎在评论区留言交流，后续我们也会持续更新OpenClaw的更多实操教程，带你解锁这只“开源龙虾”的全部潜力，一起在技术热点里稳步成长， 评论区留言，***你还想看松灵机器人用openclaw做点什么？***




OpenClaw作为近期热门开源项目，凭借简洁的操作逻辑与强大的适配能力，成为机械臂控制领域的关注焦点。其可实现AI指令与设备执行的全流程联动，大幅降低机械臂操控门槛。本文将聚焦实操，结合pyAgxArm SDK，带大家完成OpenClaw的下载、安装与配置，实现对NERO七轴机械臂的高效控制。

养虾记|让小龙虾帮我控制七轴臂

本文将聚焦实操，结合pyAgxArm SDK，带大家完成OpenClaw的下载、安装与配置，实现对NERO七轴机械臂的高效控制。

人工智能

OpenClaw开源项目简化机械臂控制流程，通过pyAgxArmSDK实现AI指令与NERO七轴机械臂的高效联动。本文提供详细安装配置指南，涵盖模型选择、技能创建、代码生成等关键步骤，助力开发者快速掌握机械臂控制技术。

Python

GitHub

2026新春采购季

tione

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

养虾记|让小龙虾帮我控制七轴臂-腾讯云开发者社区-腾讯云

养虾记|让小龙虾帮我控制七轴臂

养虾记|让小龙虾帮我控制七轴臂

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐