← Back to Skills Marketplace
yuyoujiang

soarm-control

by yuyoujiang · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
466
Downloads
2
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install soarm-control
Description
Control the robotic arm through the OpenClaw SOARM API. Use this skill when reading current joint state, moving by joint angles, moving by XYZ coordinates, o...
Usage Guidance
This skill appears to implement a local SOARM robot controller (Flask API, IK, vision). Before installing: 1) Do not run the server unless you are on the machine that actually hosts the robot and camera; the code will attempt to open /dev/ttyACM0 and camera devices and will move hardware. 2) Verify the missing files referenced in SKILL.md (references/so101_new_calib.urdf and the YOLO weights 'best.pt')—they are referenced but not present in the manifest; ask the publisher where to obtain them. 3) Prepare an isolated test environment (separate machine or network) and a conda env named 'lerobot' or update start_server.sh to point to your conda; dependencies (pinocchio, ultralytics, opencv, lerobot package) must be installed manually. 4) Inspect the full soarm_api.py (the provided copy was truncated) to ensure no unexpected network endpoints or hidden behavior; confirm YOLO/model loading uses local files only. 5) If you need higher assurance, request from the publisher: (a) a complete dependency/install script, (b) the referenced URDF and model files or their trusted sources, and (c) the full untruncated source of soarm_api.py. Given missing files and lack of install guidance, treat this package as potentially unreliable or unsafe to run on production hardware until those gaps are resolved.
Capability Analysis
Type: OpenClaw Skill Name: soarm-control Version: 1.0.1 The soarm-control skill bundle is a legitimate robotics control suite designed to interface with a SOARM 101 robotic arm via the lerobot and pinocchio libraries. It provides a Flask-based API (soarm_api.py) for joint control, inverse kinematics, and vision-guided pick tasks using YOLO. The code follows standard robotics programming patterns, lacks any indicators of data exfiltration, persistence, or malicious execution, and the instructions in SKILL.md are consistent with the stated purpose of hardware control.
Capability Assessment
Purpose & Capability
Name/description align with included code: the repository provides a local Flask API, joint/X/Y/Z motion scripts, IK via Pinocchio, and a YOLO-based detection routine. The functionality (robot control + vision) is coherent with the stated purpose.
Instruction Scope
SKILL.md instructs running a local server and curling endpoints on http://127.0.0.1:8000 which matches the included soarm_api.py. However the README references additional files (references/so101_new_calib.urdf and a YOLO model 'best.pt' inside scripts) that are not present in the file manifest; the SKILL.md also leaves 'prepare lerobot env' vague. The API and scripts access local hardware (serial device /dev/ttyACM0 and a camera), so running this skill will operate hardware and camera—expected for a robot-control skill but high-impact. The instructions do not document dependency installation or how model/URDF files are supplied.
Install Mechanism
No install spec is provided (instruction-only), but start_server.sh requires conda and a 'lerobot' conda environment. The code depends on heavy native and Python packages (pinocchio, OpenCV, ultralytics/YOLO, numpy). There is no automated install, no pinned package list, and no guidance for obtaining model weights/URDF; this mismatch increases the chance of runtime failures or manual misconfiguration.
Credentials
The skill does not request secrets or unrelated credentials. start_server.sh uses environment variables for configuration (SOARM_API_HOST/PORT, SOARM_PORT, LEROBOT_ROOT, CONDA_BIN) which are reasonable for a local hardware-control tool. No suspicious credential exfiltration is present in the visible code.
Persistence & Privilege
Flags show always:false and normal autonomous invocation. The skill does not request forced inclusion or claim to modify other skills or system-wide configuration. No persistence escalation observed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install soarm-control
  3. After installation, invoke the skill by name or use /soarm-control
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Significant update: Migrated to a new SOARM API-based control system, simplified scripts, and updated documentation. - Replaced older joint-control scripts with a unified SOARM API approach. - Added scripts for reading joints, moving by XYZ and joint angles, launching server, and running yolo11n detection. - Removed legacy scripts for manual control, status reporting, and device enabling/disabling. - Updated sample calibration data and documentation to reference the new system. - SKILL.md rewritten for concise, API-focused usage with quick command examples and updated setup steps.
v1.0.0
Initial release of soarm-control. - Provides control of the SOARM101 robotic arm via XYZ positioning or direct joint angle commands. - Includes scripts for moving the arm, setting preset positions, viewing status, and disabling the arm. - Offers clear instructions for dependency setup and calibration file configuration. - Supports connection management with `--keep-connected` parameter for smoother operation. - Documentation includes coordinate conventions, safety tips, and example commands.
Metadata
Slug soarm-control
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is soarm-control?

Control the robotic arm through the OpenClaw SOARM API. Use this skill when reading current joint state, moving by joint angles, moving by XYZ coordinates, o... It is an AI Agent Skill for Claude Code / OpenClaw, with 466 downloads so far.

How do I install soarm-control?

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

Is soarm-control free?

Yes, soarm-control is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does soarm-control support?

soarm-control is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created soarm-control?

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

💬 Comments