Local Task Runner for Openclaw

A streamlined execution engine for running Node.js scripts and code snippets locally without the overhead of full subagents.

d-wwei
v1.0.0
Feb 23, 2026
0
1.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install local-task-runner

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install local-task-runner 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 Local Task Runner?

The Local Task Runner is a foundational component of the Openclaw Skills ecosystem, designed to execute Node.js code snippets or full scripts directly on a host machine. This skill serves as the primary execution path when spawning full subagents is either unavailable or unnecessary due to resource constraints.

By providing a secure and managed environment for code execution, it ensures that technical operations are handled efficiently. It bridges the gap between simple command execution and complex agent logic, making it an essential tool within the Openclaw Skills framework for developers who need fast, reliable, and isolated script processing.

Local Task Runner Use Cases

  • Performing complex mathematical calculations or data processing tasks locally.
  • Checking system status or environment variables on the host machine.
  • Running utility scripts without the overhead of initializing a full subagent.
  • Executing one-off Node.js commands as part of a larger workflow in Openclaw Skills.
  • Automating local system maintenance tasks through direct code injection.

How Local Task Runner Works

  1. The user or parent agent prepares the specific Node.js logic as a string.
  2. The script is passed to the Local Task Runner via the run_task function or the Command Line Interface.
  3. The skill isolates the execution logic and initializes a managed process on the host machine.
  4. The task is executed with specific timeout constraints to prevent resource leaking or infinite loops.
  5. Upon completion or failure, the skill captures all stdout and stderr output for analysis.
  6. Temporary files and resources are automatically cleaned up, and a structured response is returned to the user.

Local Task Runner Setup

To begin using this skill within your Openclaw Skills environment, ensure Node.js is installed on your host. You can trigger tasks directly using the following CLI commands:

# Standard task execution
node skills/local-task-runner/index.js run --code "console.log('Task Complete')"

# Execution with a custom timeout (e.g., 5 seconds)
node skills/local-task-runner/index.js run --code "while(true){}" --timeout 5000

Local Task Runner Data Schema & Taxonomy

The Local Task Runner organizes its execution data and feedback using a structured response format. This ensures that Openclaw Skills can parse the results of any local script accurately:

Attribute Description
Task ID A unique identifier generated for every execution cycle.
STDOUT The standard output stream captured during script execution.
STDERR The error stream output if the script encounters an exception.
Execution Time The total duration of the task measured in milliseconds.
Status Indicates whether the task completed or failed.

Local Task Runner Advanced Features

  • Integrated timeout enforcement to prevent runaway processes and resource exhaustion.
  • Automatic lifecycle management that handles file creation and cleanup without manual intervention.
  • Lightweight execution model designed to replace resource-heavy subagent spawning for simple logic.
  • High-fidelity error reporting including full stack traces and stderr capture within the Openclaw Skills environment.
  • Direct CLI access for debugging and manual script triggering.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*