How do I install the Octoclaw skill?

Run npx skillmds@latest add modbender/octoclaw in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Octoclaw safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Octoclaw?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Octoclaw free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Octoclaw?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Octoclaw by modbender — Agent Skill

Name: Octoclaw
Rating: 4.666666666666667 (3 reviews)
Author: modbender

Octoclaw

Control OctoPrint 3D printer — monitor status, capture webcam snapshots, manage prints, analyze gcode, and detect errors. Use when the user asks about their 3D printer, print status, filament, temperatures, or wants to start/pause/cancel a print.

modbender Updated Sep 9, 2026 12 repo stars

File contents

OctoClaw — OctoPrint Control

Helper script: scripts/octoprint.py (relative to this skill directory). Config: config.json (same directory) with octoprint_url and api_key.

Resolve all paths relative to this skill's directory.

Commands

All commands: python3 <skill-dir>/scripts/octoprint.py <command> [args]

Status

status-pretty — Formatted status with temps, progress bar, ETA (show this to users)
status — Raw JSON
check-errors — Returns JSON with errors/warnings (temp anomalies, stalls, connection issues)

Print Control

print <filename> — Start a print
control <pause|resume|cancel> — Control active print
temp <tool0|bed> <temperature> — Set temperature

Files

list-files — List uploaded files
upload <local-path> [remote-name] — Upload gcode
analyze <filepath> — Extract gcode metadata (layers, time, filament, temps, dimensions)

Webcam

snapshot [output-path] — Capture webcam image (default: /tmp with timestamp)

Telegram (if configured)

telegram-status — Send formatted status to Telegram
telegram-snapshot — Send webcam snapshot with progress caption
telegram-msg "message" — Send custom message

Workflows

Check on a print: status-pretty → optionally snapshot → check-errors

Start a print: status-pretty (verify Operational) → list-files or upload → optionally analyze → print <file>

Error detection: check-errors returns critical errors (>15°C deviation, connection lost) and warnings (5-15°C deviation, stalled prints). Recommend pausing on temp issues, cancelling on critical errors.

Formatting

Use status-pretty output for user display
Always show progress %, time remaining, ETA for active prints
Include temperature actual/target

---name: octoclawdescription: Control OctoPrint 3D printer — monitor status, capture webcam snapshots, manage prints, analyze gcode, and detect errors. Use when the user asks about their 3D printer, print status, filament, temperatures, or wants to start/pause/cancel a print.--- # OctoClaw — OctoPrint Control Helper script: `scripts/octoprint.py` (relative to this skill directory). Config: `config.json` (same directory) with `octoprint_url` and `api_key`. Resolve all paths relative to this skill's directory. ## Commands All commands: `python3 <skill-dir>/scripts/octoprint.py <command> [args]` ### Status - `status-pretty` — Formatted status with temps, progress bar, ETA (show this to users) - `status` — Raw JSON - `check-errors` — Returns JSON with errors/warnings (temp anomalies, stalls, connection issues) ### Print Control - `print <filename>` — Start a print - `control <pause|resume|cancel>` — Control active print - `temp <tool0|bed> <temperature>` — Set temperature ### Files - `list-files` — List uploaded files - `upload <local-path> [remote-name]` — Upload gcode - `analyze <filepath>` — Extract gcode metadata (layers, time, filament, temps, dimensions) ### Webcam - `snapshot [output-path]` — Capture webcam image (default: /tmp with timestamp) ### Telegram (if configured) - `telegram-status` — Send formatted status to Telegram - `telegram-snapshot` — Send webcam snapshot with progress caption - `telegram-msg "message"` — Send custom message ## Workflows **Check on a print:** `status-pretty` → optionally `snapshot` → `check-errors` **Start a print:** `status-pretty` (verify Operational) → `list-files` or `upload` → optionally `analyze` → `print <file>` **Error detection:** `check-errors` returns critical errors (>15°C deviation, connection lost) and warnings (5-15°C deviation, stalled prints). Recommend pausing on temp issues, cancelling on critical errors. ## Formatting - Use `status-pretty` output for user display - Always show progress %, time remaining, ETA for active prints - Include temperature actual/target

Frequently asked questions