← Back to Skills Marketplace
qujingyang28

JAKA Robotics Control Skill

by Robot_Qu · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
254
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install jaka-robotics-control
Description
Control Zu20/Zu12/Zu7 collaborative robots via gRPC/TCP with joint, linear, and circular motion, real-time state monitoring, and simulation support.
README (SKILL.md)

JAKA Robotics Control Skill

节卡机器人控制技能,支持 Zu20/Zu12/Zu7/MiniCobo 全系列协作机器人。

功能特性

  • ✅ 关节运动控制
  • ✅ 直线运动控制
  • ✅ 状态读取
  • ✅ 末端工具 I/O 控制
  • ✅ gRPC 通信(低延迟、高可靠)

快速开始

1. 安装 JAKA SDK

pip install jaka-sdk

或访问 JAKA 官网下载: https://www.jaka.com/docs/guide/SDK/introduction.html

2. 配置机器人 IP

编辑 jaka_cmd.py,修改:

ROBOT_IP = "192.168.57.128"  # 改成你的 MiniCobo IP

3. 使用 Python API

from jaka_skill import JAKARobot

robot = JAKARobot("192.168.57.128", use_grpc=True)
robot.connect()

# 关节运动 (弧度)
robot.move_joint([0, 0, 0, 0, 0, 0], speed=0.5)

# 直线运动 (mm, rad)
robot.move_linear([300, 0, 200, 3.14, 0, 0], speed=100)

# 读取状态
state = robot.get_state()
print(state['joints_deg'])

robot.disconnect()

4. 命令行工具

# 读取状态
python jaka_cmd.py state

# 回零
python jaka_cmd.py home

# 关节运动 (角度)
python jaka_cmd.py joint 90 90 90 90 90 90

# 直线运动 (mm, 度)
python jaka_cmd.py linear 300 0 200 180 0 0

支持机型

  • JAKA Zu20(实验室主力)
  • JAKA Zu12
  • JAKA Zu7
  • JAKA MiniCobo(本技能测试机型)

环境要求

  • Python 3.8+
  • JAKA SDK V2.3.1+
  • Windows

安全提示

⚠️ 首次使用前请确保:

  • 工作空间内无人
  • 急停按钮可用
  • 先在低速环境测试
  • T1 模式调试

作者

JMO / Robotqu (青岛)

  • 网站:robotqu.com
  • B 站:Robot_Qu 机器人社区

许可证

MIT-0

Usage Guidance
This skill appears to be what it claims: a thin Python wrapper around the JAKA SDK. Before installing or using it, verify the source of the JAKA SDK and the pip package (use the official JAKA website links shown), and only copy native binaries (jkrc.pyd, jakaAPI.dll) obtained from the vendor. Set the robot IP to a local, isolated network address and do not expose robot control to the public Internet. Follow the listed physical safety steps (empty workspace, e-stop, low-speed testing). If you are unsure about the pip package name or the downloaded SDK, obtain SDK binaries directly from JAKA support or your robot vendor and inspect them in a secure environment first.
Capability Analysis
Type: OpenClaw Skill Name: jaka-robotics-control Version: 1.0.1 The skill is a legitimate wrapper for the JAKA Robotics SDK, providing tools to control Zu and MiniCobo series robots via gRPC. It includes a CLI (jaka_cmd.py) and a core library (jaka_skill.py) that interact with the robot hardware using the official 'jkrc' library. No malicious behavior, data exfiltration, or prompt injection attempts were detected, and the documentation includes appropriate safety warnings for physical hardware operation.
Capability Assessment
Purpose & Capability
The name/description claim (control JAKA Zu/MiniCobo robots via SDK) matches the included Python wrapper and CLI (jaka_skill.py, jaka_cmd.py, example). The files call the expected jkrc SDK functions (login, joint_move, linear_move_extend) and the README/SKILL.md document the required native SDK artifacts—so required artifacts are explainable by the stated purpose.
Instruction Scope
Runtime instructions only cover installing the JAKA SDK, setting the robot IP, and running the provided Python scripts. The SKILL.md does not instruct reading unrelated files, leaking secrets, or contacting unexpected endpoints. It does ask the user to place vendor SDK binaries (jkrc.pyd, jakaAPI.dll) into the skill directory, which is necessary for the native SDK but worth noting.
Install Mechanism
There is no automated install spec; users are told to pip install jaka-sdk or download the SDK from the vendor and copy jkrc.pyd/jakaAPI.dll into the skill folder. This is expected for native-extension SDKs but carries the usual trust risk of installing native binaries or an unverified pip package—verify the package and vendor site before installing.
Credentials
The skill requires no environment variables, credentials, or config paths. It requires network access to a local robot IP (user-provided). No unrelated secrets or service tokens are requested.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide settings, and is user-invocable only. It does ask the user to copy SDK binaries into the skill workspace (normal for native SDK usage) but does not attempt to persist credentials or enable autonomous privileged behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install jaka-robotics-control
  3. After installation, invoke the skill by name or use /jaka-robotics-control
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Expanded supported models to include JAKA MiniCobo and updated documentation accordingly. - Added multiple new example and test scripts for linear, joint, and circular movements. - Integrated JAKA SDK installation instructions and simplified setup steps. - Removed outdated demo scripts to focus on direct API usage and testing. - Improved feature list and clarified safe operation guidelines in documentation.
v1.0.0
JAKA Robotics Control Skill 1.0.0 – Initial Release - Supports motion control for JAKA Zu20/Zu12/Zu7 collaborative robots. - Features precise joint and linear motion, arc interpolation, and real-time status monitoring. - Includes both gRPC and TCP communication modes, simulation synchronization, and a command-line tool. - Provides demonstration scripts for various movements and tasks. - Requires Python 3.8+, JAKA SDK V2.3.1+, and Windows environment.
Metadata
Slug jaka-robotics-control
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is JAKA Robotics Control Skill?

Control Zu20/Zu12/Zu7 collaborative robots via gRPC/TCP with joint, linear, and circular motion, real-time state monitoring, and simulation support. It is an AI Agent Skill for Claude Code / OpenClaw, with 254 downloads so far.

How do I install JAKA Robotics Control Skill?

Run "/install jaka-robotics-control" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is JAKA Robotics Control Skill free?

Yes, JAKA Robotics Control Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does JAKA Robotics Control Skill support?

JAKA Robotics Control Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created JAKA Robotics Control Skill?

It is built and maintained by Robot_Qu (@qujingyang28); the current version is v1.0.1.

💬 Comments