claw-shell

Runs shell commands inside a dedicated tmux session named claw, captures, and returns the output, with safety checks for destructive commands.

imaginelogo

@imaginelogo

What This Skill Does

Runs shell commands inside a dedicated tmux session named claw, captures the output, and returns it to the agent. Includes safety checks that block destructive commands like sudo, rm, reboot, and shutdown unless the user explicitly approves.

Replaces manually managing tmux sessions or writing custom shell execution wrappers by providing a controlled, session-isolated command runner with built-in safety guards.

When to Use It

  • List files and directories in the current working directory
  • Check the status of a Git repository
  • Read a webpage or API response using curl or bird
  • Run a Python or Node.js script and capture its output
  • Execute a series of chained commands inside a persistent shell session

Install

$ openclaw skills install @imaginelogo/claw-shell

claw-shell

ALWAYS USES TMUX SESSION claw.

PURPOSE

  • RUN SHELL COMMANDS INSIDE TMUX SESSION claw
  • NEVER TOUCH ANY OTHER SESSION
  • READ OUTPUT BACK TO THE AGENT

INTERFACE

Tool: claw_shell_run

Inputs:

  • command (string, required): shell command to run inside session claw.

Behavior:

  1. Attach to tmux session claw (create it if missing: tmux new -s claw -d).
  2. Send the command followed by Enter.
  3. Capture the latest pane output.
  4. Return the captured output to the agent.

SAFETY

  • DO NOT RUN:
    • sudo
    • rm (without explicit user approval)
    • reboot, shutdown, or destructive system-level commands
  • IF THE COMMAND CONTAINS ANY OF THE ABOVE:
    • ASK USER FOR CONFIRMATION BEFORE EXECUTING.

EXAMPLES

  • SAFE:

    • ls -la
    • bird read https://x.com/...
    • git status
  • DANGEROUS (ASK FIRST):

    • rm -rf ...
    • docker system prune -a
    • chmod -R ...

Top skills in this category