Snapmaker 2.0 Control for Openclaw

A Python-powered interface to remotely monitor status, manage print jobs, and track progress on Snapmaker 2.0 3D printers.

odrobnik
v1.2.2
Mar 4, 2026
1
2.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install snapmaker-2

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install snapmaker-2 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Snapmaker 2.0 Control?

The Snapmaker 2.0 skill is a robust tool designed to interface with Snapmaker 2.0 3D printers through their native HTTP API. It enables developers and makers to integrate their hardware into automated workflows using Openclaw Skills. The skill provides a comprehensive CLI for querying printer status, managing the lifecycle of print jobs, and maintaining safety protocols during active prints.

By leveraging this integration, users can move beyond the standard Luban interface and build custom automation or monitoring dashboards for their fabrication environment. It handles the complexities of API connection persistence and session management automatically, allowing for seamless remote interaction with the printer hardware.

Snapmaker 2.0 Control Use Cases

  • Remote monitoring of print progress and temperatures from the command line.
  • Automated print job submission and management within a development environment.
  • Real-time event detection for filament runout or enclosure door states.
  • Safety-first cancellation of prints across the network during hardware emergencies.

How Snapmaker 2.0 Control Works

  1. The skill initiates a discovery process via UDP broadcast (port 20054) to find compatible printers on the local network.
  2. It establishes an authenticated session via the /api/v1/connect endpoint using a token provided in the user configuration.
  3. Commands are dispatched to specific Snapmaker HTTP API v1 endpoints to perform actions like uploading G-code or pausing jobs.
  4. For monitoring, the skill polls the printer status, parsing JSON responses to provide telemetry on nozzle temperatures, bed heat, and XYZ positioning.
  5. Safety checks are performed before state-changing commands to ensure active prints are not inadvertently interrupted.

Snapmaker 2.0 Control Setup

To get started with this integration in the Openclaw Skills ecosystem, ensure you have Python 3.6+ and the requests library installed.

pip3 install requests

Create a config.json file in your workspace's snapmaker/ directory with your printer's details:

{
  "ip": "192.168.0.32",
  "token": "your-token-here",
  "port": 8080
}

You can find your unique token in the Snapmaker Luban app connection settings after connecting to your printer.

Snapmaker 2.0 Control Data Schema & Taxonomy

The skill returns structured data regarding the printer's current state. When using the status command, the following schema is used:

Field Description Type
status Overall state (IDLE, RUNNING, PAUSED) String
progress Completion ratio (0.0 to 1.0) Float
nozzleTemperature1 Current nozzle temperature in Celsius Float
remainingTime Seconds left until the job finishes Integer
isFilamentOut Detects if filament has run out Boolean
isEnclosureDoorOpen Reports the safety door state Boolean

Snapmaker 2.0 Control Advanced Features

  • Support for JSON output on all status and discovery commands to facilitate piping data into other Openclaw Skills.
  • Real-time watch mode that provides live terminal updates every 5 seconds during active prints.
  • Forced subnet probing to discover printers across different network segments where UDP broadcast might fail.
  • Safety-first CLI flags like --yes and --force to allow for automated scripts while preventing accidental print cancellations.

SKILL.md


Loading

Related Openclaw Skills

Featured*