An AI-agent tool designed to manage files and check the status of a Bambu P1S 3D printer using secure FTPS and system-level scripting.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install bambu-printer
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install bambu-printer 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 Bambu Printer Control?
The Bambu Printer Control skill enables developers to manage and control Bambu P1S 3D printers directly through lightweight, local system-level scripts. Designed specifically to bypass macOS local network restrictions that typically block Homebrew-installed runtimes like Node.js or Python, this tool relies on Apple-signed native binaries such as curl (for FTPS) and Perl (for MQTT probing).
As part of the expanding ecosystem of Openclaw Skills, this skill provides a robust bridge between local AI agents and physical hardware, ensuring reliable local network connectivity. Developers can effortlessly query device online status, browse 3D printer filesystems, and handle bulk transfers of sliced 3MF or GCODE files without relying on heavy external CLI applications.
Bambu Printer Control Use Cases
- Automated 3D Print Job Staging: Queue sliced 3MF or GCODE models onto your Bambu P1S print cache directory directly from your developer workflow.
- Timelapse Extraction: Automate the retrieval of recorded timelapse videos from the printer directory for progress sharing or monitoring.
- Local Network Status Monitoring: Programmatically check if the 3D printer is online and active without leaving your CLI or terminal environment.
- File Maintenance & Clean-up: Easily monitor and clean up the printer's cache, models, and print record storage spaces to free up local storage.
How Bambu Printer Control Works
- Connectivity Probe: The skill checks the local connection to the Bambu P1S via native Perl scripts probing MQTT, FTPS, and camera ports.
- Secure Shell FTPS Calls: Using system-signed curl commands, the agent executes file operations (listing, uploading, downloading, deleting) over FTPS securely.
- Directory Parsing: The output from the FTPS command is structured and parsed to display the printer's inner directory hierarchy (cache, timelapse, model, etc.).
- Execution and Clean-up: Files like gcode or 3mf are uploaded to the cache or downloaded to your local path, with errors reported in a clear, structured JSON format.
Bambu Printer Control Setup
Configure your local settings by creating a config.json file containing your Bambu P1S printer details (IP, serial, access code). Run status checks and manage file transfers directly via terminal commands:
# 1. Verify connection status
/usr/bin/perl scripts/status.pl
# 2. List the root directory of the printer
bash scripts/ftp.sh list /
# 3. Upload a sliced 3D model to the printer's cache
bash scripts/ftp.sh upload my_model.gcode.3mf
# 4. Download a timelapse video file
bash scripts/ftp.sh download /timelapse/video_example.avi ./
Bambu Printer Control Data Schema & Taxonomy
The skill relies on a local config.json configuration and maps the Bambu P1S internal directory structure as follows:
| Directory Path | Description | Supported Operations |
|---|---|---|
/ |
Root printer directory | List |
/cache/ |
Cache directory for printing files | List, Upload, Download, Delete |
/timelapse/ |
Automated camera timelapse videos | List, Download, Delete |
/recorder/ |
Printer logs and records (.bin) | List, Download, Delete |
/image/ |
Stored images | List, Download, Delete |
/model/ |
Model file directories | List, Download, Delete |
Status JSON Schema
The status query (scripts/status.pl) returns a clean JSON output for easy programmatic validation:
{
"status": "online",
"ftps": "ok",
"mqtt_auth": "ok",
"camera_port": "open",
"ping": "ok"
}
Bambu Printer Control Advanced Features
- macOS Sandboxing Bypass: Uses system-signed utilities (curl, perl) to reliably access local networks and bypass macOS restrictions on Homebrew-installed Node.js or Python packages.
- Flexible Media Fetching: Ideal for integrating with home automation suites or custom dashboards to automatically sync /timelapse/ AVI videos immediately after printing.
- Targeted Storage Footprint Analysis: Use command-line arguments (like
scripts/ftp.sh size [path]) to quickly parse total storage utilization on the internal SD card.
SKILL.md
Loading
Related Openclaw Skills
Agent Email Setup
Set up autonomous email sending, webhook-driven inbound receiving, and local inbox storage for AI agents using Resend.
Agent OKR Skill
A standardized OKR and weekly reporting framework designed specifically for the high-velocity execution cycles of autonomous AI agents.
Daily Budget Assistant
An AI-powered local personal finance assistant that processes conversational text or voice to categorize expenses, provide monthly analytics, and send budget overrun warnings in 5 seconds.
OpenAPI Spec Generator
An automated tool that turns raw API code, HAR traffic logs, and packet captures into production-ready, validated OpenAPI 3.x specifications.
2D Print Control
An AI-powered printer control skill leveraging macOS CUPS to print images, PDFs, and text documents via local CLI commands.
Add to Cart
An automated browser-driven utility for searching and adding items to carts or favorites on Chinese e-commerce platforms including Taobao, JD, Pinduoduo, and Xianyu.
Featured*
