← Back to Skills Marketplace
OctoClaw
by
peterhanily
· GitHub ↗
· v1.0.0
715
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install octoclaw-print
Description
Control OctoPrint 3D printer — monitor status, capture webcam snapshots, manage prints, analyze gcode, and detect errors. Use when the user asks about their...
Usage Guidance
This skill appears to do what it says (control OctoPrint and related tasks). Before installing: 1) Inspect the full scripts/octoprint.py (we only saw a truncated excerpt) to confirm there are no hidden network endpoints or unexpected behaviors. 2) Ensure the Python runtime has the 'requests' package available or install it in a controlled environment. 3) Keep config.json (which stores your OctoPrint API key and any Telegram tokens) private and only place trusted credentials there. 4) Be cautious with 'analyze' or 'upload' commands — they read local files, so don't point them at sensitive system files. 5) If you will enable Telegram features, verify the destination chat/token are correct and intended. If you want higher assurance, run the script in an isolated environment (container or VM) and review the complete source file for any network calls beyond OctoPrint/Telegram endpoints.
Capability Analysis
Type: OpenClaw Skill
Name: octoclaw-print
Version: 1.0.0
The `scripts/octoprint.py` skill bundle is classified as suspicious due to several high-risk capabilities that, while presented as legitimate functionality, create significant attack surfaces for an AI agent. Specifically, the `upload <local-path>` command allows reading arbitrary local files and uploading them to the configured OctoPrint instance. The `snapshot [output-path]` command allows writing webcam images to arbitrary local paths. Furthermore, the `telegram-msg` and underlying `send_telegram_photo` functions could be misused to exfiltrate arbitrary data or files to a configured Telegram chat. These capabilities, if exploited via prompt injection against the AI agent, could lead to unauthorized data exfiltration or arbitrary file manipulation, despite no explicit malicious intent being found in the code or `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description match the observed behavior: the script talks to an OctoPrint URL, provides status, print controls, webcam snapshots, gcode analysis, and optional Telegram integration. No unrelated credentials or cloud services are requested in metadata.
Instruction Scope
Runtime instructions only invoke the provided script for OctoPrint operations. The script will read config.json (containing octoprint_url, api_key, and optional Telegram tokens) and can read local files when running 'analyze' or 'upload' — which is expected but means users must avoid pointing it at sensitive system files. The SKILL.md instructs resolving paths relative to the skill dir; be aware analyze/upload accept arbitrary file paths.
Install Mechanism
This is an instruction-only skill (no install spec), requiring python3 which is declared. The script depends on the 'requests' library but the skill does not declare Python package dependencies; that may cause runtime failures and is a packaging/hygiene omission rather than a malicious artifact.
Credentials
No environment variables or additional credentials are requested by the skill metadata. The tool uses a local config.json for the OctoPrint API key and optional Telegram tokens, which is reasonable and proportional to the functionality.
Persistence & Privilege
The skill does not request persistent/always-on inclusion and does not appear to change other skills or system settings. Normal autonomous invocation is allowed (platform default) and not by itself a problem.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install octoclaw-print - After installation, invoke the skill by name or use
/octoclaw-print - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — OctoPrint monitoring, control, webcam snapshots, gcode analysis, Telegram integration
Metadata
Frequently Asked Questions
What is OctoClaw?
Control OctoPrint 3D printer — monitor status, capture webcam snapshots, manage prints, analyze gcode, and detect errors. Use when the user asks about their... It is an AI Agent Skill for Claude Code / OpenClaw, with 715 downloads so far.
How do I install OctoClaw?
Run "/install octoclaw-print" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OctoClaw free?
Yes, OctoClaw is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OctoClaw support?
OctoClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OctoClaw?
It is built and maintained by peterhanily (@peterhanily); the current version is v1.0.0.
More Skills