Description

Control Bambu Lab 3D printers (H2D, X1C, P1S, A1) via CLI. Print management, AMS filament control, temperature, fans, lights, calibration, file management, a...

README (SKILL.md)

Bambu Lab 3D Printer Control

Name: Bambu Lab 3D Printer
Author: g9pedro

Full control of Bambu Lab printers via MQTT + FTP. Agent-agnostic, local-only, no cloud.

Prerequisites

Printer must be in Developer Mode (Settings → LAN Only → Enable Developer Mode)
Need: IP address, serial number, LAN access code (from printer touchscreen)
CLI: @versatly/bambu installed globally (npm i -g @versatly/bambu)

Setup

bambu setup \x3Cip> \x3Cserial> \x3Caccess_code>
bambu ping  # verify connection

Config stored at ~/.bambu/config.json.

Progressive Loading Guide

Load ONLY what you need for the current task:

Level 1: Status Check (most common)

bambu status          # full status overview
bambu status --json   # programmatic access
bambu temp            # just temperatures  
bambu ams             # just AMS/filament info
bambu errors          # any active errors

Level 2: Print Operations

# Start a print from SD card
bambu print "filename.3mf"

# Upload and print in one step
bambu job upload-and-print ./my-part.3mf

# Control running print
bambu pause
bambu resume  
bambu stop

# Live monitoring (streams progress)
bambu watch

Level 3: Hardware Control

# Temperature
bambu heat nozzle:220 bed:60
bambu cooldown

# Fans (0-100%)
bambu fan part 80
bambu fan aux 50
bambu fan chamber 30

# Lights
bambu light on
bambu light off

# Movement
bambu home
bambu move x:10 y:20 z:5
bambu gcode "G28"

Level 4: AMS Filament Management

# Check what's loaded
bambu ams

# Load specific tray (0-3)
bambu load 0
bambu load 2

# Unload current filament
bambu unload

Level 5: File Management & Calibration

# SD card files
bambu files
bambu upload ./part.3mf
bambu delete old-print.3mf

# Calibration
bambu calibrate bed
bambu calibrate vibration
bambu calibrate flow
bambu calibrate all

Common Agent Workflows

"Print this file"

bambu job upload-and-print ./part.3mf
bambu watch  # monitor until done

"Check if printer is ready"

bambu status --json | jq '.gcode_state'
# IDLE = ready, RUNNING = busy, FAILED = needs attention

"What filament is loaded?"

bambu ams --json

"Preheat for PLA"

bambu heat nozzle:210 bed:60

"Preheat for ABS"

bambu heat nozzle:260 bed:100

"Something went wrong"

bambu errors --json   # check HMS error codes
bambu status          # full state overview

"Finish up and shut down"

bambu cooldown
bambu light off

Output Modes

Default: Human-readable, emoji-prefixed, compact. Optimized for LLM context windows.
--json: Raw JSON for programmatic parsing. Use with jq for field extraction.

Safety Notes

bambu status, bambu temp, bambu ams, bambu errors, bambu version, bambu files are read-only and always safe.
bambu print, bambu stop, bambu heat, bambu move, bambu gcode control the printer physically. The nozzle is 200°C+. Use judgment.
bambu calibrate moves the printer head. Ensure bed is clear.
bambu gcode sends raw G-code. Know what you're sending.

Troubleshooting

Issue	Fix
Connection timeout	Developer Mode enabled? Correct IP? Printer on?
Auth failed	Check LAN access code (it changes if you re-enable Developer Mode)
FTP error	Port 990, implicit TLS. Printer must be in LAN mode.
No AMS data	AMS connected and detected? Check printer touchscreen.
MQTT drops	WiFi signal weak? Check `bambu status` for wifi_signal field.

Usage Guidance

Before installing or allowing an agent to use this skill: 1) Verify the npm package publisher and source for @versatly/bambu (check npmjs.com, the package's repository, and recent release history). Do not run a global npm install of an untrusted package. 2) Ensure Node and npm are installed and the metadata is updated to declare those requirements. 3) Inspect the package code (or its Git repo) before installing, or run the CLI in an isolated VM/container or on a network segment that cannot reach sensitive hosts. 4) Be aware the CLI will store the printer IP/serial/LAN access code in ~/.bambu/config.json — restrict file permissions and consider encrypting or managing that secret carefully. 5) Test only read-only commands first (status, ams, temp) to verify behavior. 6) Do not grant unsupervised autonomous agent control of a physical printer; require explicit user confirmation before any command that heats, moves, or executes raw G-code. If you want a lower-risk setup, manually install a vetted CLI client from an official Bambu source or run the workflow from a controlled environment.

Capability Analysis

Type: OpenClaw Skill Name: bambu Version: 1.0.0 The skill is classified as suspicious primarily due to the instruction to install an external npm package globally (`npm i -g @versatly/bambu`) as a prerequisite. This introduces a significant supply chain vulnerability, as the integrity and behavior of this third-party package are not verifiable within the provided skill bundle. Additionally, the skill handles sensitive printer access credentials, allows local file system access for uploading files, and enables raw G-code execution, which are powerful capabilities that, while necessary for the stated purpose of 3D printer control, could be exploited if the agent or the external package were compromised. There is no direct evidence of malicious intent within the `SKILL.md` instructions themselves, but the inherent risks warrant a 'suspicious' classification.

Capability Assessment

ℹ Purpose & Capability

The skill's stated purpose (local control of Bambu Lab printers) aligns with the commands and workflows in SKILL.md. However the metadata lists no required binaries while the README explicitly requires installing a global npm CLI (@versatly/bambu) and therefore requires Node/npm; that mismatch is an unexplained omission. Also there is no source/homepage or publisher info for the referenced npm package, so provenance is unclear.

✓ Instruction Scope

SKILL.md is focused on printer control only (status, print jobs, AMS, temps, fans, lights, movement, file management). It does not instruct reading unrelated system files or exfiltrating data. It does instruct storing printer credentials (IP, serial, LAN access code) in ~/.bambu/config.json, which is expected for local control but is sensitive and worth protecting.

⚠ Install Mechanism

There is no install spec in the registry entry, but SKILL.md tells users to run `npm i -g @versatly/bambu`. A global npm install runs unreviewed code on the host and can be high risk if the package/publisher is untrusted. The skill also fails to declare required runtime binaries (node/npm), which is an inconsistency. Because there is no homepage/source provided, the package origin cannot be verified from the registry metadata.

ℹ Credentials

The skill requests no cloud credentials or extra environment variables, which is proportionate. It does require local printer credentials (LAN access code, IP, serial) and stores them in ~/.bambu/config.json — reasonable for the function but sensitive. Users should ensure the config file permissions are restrictive and understand that the CLI will use local network (MQTT/FTP) to talk to hardware.

ℹ Persistence & Privilege

always:false (default) and no install spec that modifies other skills or system settings. The CLI will create a config in the user's home when run; that is normal. Be aware that the skill enables physical control (heating, movement, raw G-code) which can be dangerous if run autonomously without supervision — autonomous invocation itself is normal but combine with hardware control it increases risk to physical equipment and safety.

Version History

v1.0.0

Full MQTT+FTP control of Bambu Lab printers. Agent-first CLI with progressive loading.

Metadata

Slug bambu

Version 1.0.0

License —

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Bambu Lab 3D Printer?

Control Bambu Lab 3D printers (H2D, X1C, P1S, A1) via CLI. Print management, AMS filament control, temperature, fans, lights, calibration, file management, a... It is an AI Agent Skill for Claude Code / OpenClaw, with 544 downloads so far.

How do I install Bambu Lab 3D Printer?

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

Is Bambu Lab 3D Printer free?

Yes, Bambu Lab 3D Printer is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Bambu Lab 3D Printer support?

Bambu Lab 3D Printer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Bambu Lab 3D Printer?

It is built and maintained by G9Pedro (@g9pedro); the current version is v1.0.0.

More Skills

Bambu Lab 3D Printer