A terminal execution skill that runs shell commands inside a persistent tmux session while maintaining safety boundaries.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install my-shell
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 my-shell 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 Claw Shell?
Claw Shell provides a robust interface for AI agents to interact with the system terminal through a dedicated tmux session named claw. By isolating command execution to a specific session, it ensures that long-running processes and CLI workflows remain persistent and organized. This skill is a fundamental component for users looking to expand their Openclaw Skills library with reliable, output-aware shell automation that doesn't interfere with other active terminal sessions.
Claw Shell Use Cases
- Managing long-running background tasks like server deployments or database migrations.
- Performing routine repository maintenance and git operations within a persistent environment.
- Inspecting system logs and file structures through standard CLI utilities.
- Capturing terminal output for real-time analysis by an AI agent using Openclaw Skills.
How Claw Shell Works
- The agent triggers the claw_shell_run tool with the desired command as an input.
- The skill checks for an existing tmux session named claw and creates it if it is missing.
- The command is sent directly to the tmux session followed by an enter key sequence.
- The skill captures the visible output from the current tmux pane.
- The resulting text is returned to the agent, providing a detailed snapshot of the terminal state.
Claw Shell Setup
Before using this skill, ensure that tmux is installed on your host machine. You can install it via the following commands:
# For Ubuntu/Debian
sudo apt-get install tmux
# For macOS
brew install tmux
After installation, the skill will automatically handle session creation the first time it is invoked through Openclaw Skills.
Claw Shell Data Schema & Taxonomy
The skill focuses on session-based command execution and output retrieval. The following table describes its operational parameters:
| Attribute | Description |
|---|---|
| Session Name | Static identifier claw |
| Tool Name | claw_shell_run |
| Input Schema | command (string) |
| Output Type | Terminal pane text output |
Claw Shell Advanced Features
- Built-in safety filters that detect and pause execution for dangerous commands like rm or sudo.
- Automatic session recovery, ensuring processes continue even if the agent is restarted.
- Capability to handle multi-step shell scripts and complex piped commands.
- Deep integration with the Openclaw Skills framework for unified developer workflows.
SKILL.md
Loading
Related Openclaw Skills
PDF Toolkit Pro
A professional batch processing suite for merging, splitting, compressing, and converting PDF documents with ease.
DataMaster Pro: Automated Data Analysis Skill
An all-in-one AI agent skill for automated data scraping, intelligent cleaning, professional visualization, and AI-driven report generation.
AI Employee Collaboration Skill
A multi-agent orchestration framework that organizes diverse AI roles into a cohesive virtual team for automated task execution and progress monitoring.
AI Employee Collaboration Skill
A sophisticated multi-agent orchestration framework that organizes AI roles into virtual teams to automate task distribution, progress monitoring, and reporting.
Goalz OpenClaw Agent
A fully autonomous AI sports manager skill that controls a football club through the Goalz MCP endpoint.
Goalz OpenClaw
A fully autonomous AI sports management skill that operates via an MCP endpoint to handle every aspect of the Goalz football manager game.
Featured*
