Cancel Dispatch Run for Openclaw

A vital utility for stopping active AI dispatch tasks and ralph-loop sessions through a simple slash command.

edxi
v0.1.1
Feb 27, 2026
0
1.2k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install miniade-cancel

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 miniade-cancel 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 Cancel Dispatch Run?

The cancel skill is a core component of the Openclaw Skills suite, designed to provide developers with granular control over running AI processes. It allows for the immediate termination of interactive dispatch runs, ensuring that resources are not wasted and system states remain consistent. This skill integrates seamlessly with the ralph-loop, providing a standardized way to stop agentic workflows mid-execution via a command-line interface.

By leveraging this skill, users can manage their local development environments more effectively, stopping specific tasks using unique run identifiers. It is particularly useful when an agent requires an immediate halt or when a specific project task needs to be cleared from the active session queue.

Cancel Dispatch Run Use Cases

  • Terminating a long-running AI agent task that is no longer required.
  • Stopping a ralph-loop session to update local configuration or environment variables.
  • Cleaning up active tmux sessions that are associated with specific run-id identifiers.
  • Managing multiple project runs by cancelling tasks using the project/run-id format.

How Cancel Dispatch Run Works

  1. The user provides a run-id via the /cancel command.
  2. The script resolves the run-id to its specific result directory on the local filesystem.
  3. It attempts a soft cancel by sending a signal to the active tmux session.
  4. A hard-cancel is executed by requesting an exit and forcefully killing the tmux session if necessary.
  5. The local run metadata is updated to reflect a cancelled status and an exit code of 130.

Cancel Dispatch Run Setup

To set up this skill within your Openclaw Skills environment, ensure the shell script is executable and the environment variables are correctly mapped:

# Navigate to your skill directory
cd skills/

# Ensure the execution script has the correct permissions
chmod +x ./scripts/run_cancel.sh

# Optional: Configure your local environment file
echo "MY_VAR=value" >> ./skills/dispatch.env.local

Cancel Dispatch Run Data Schema & Taxonomy

Field Description
run-id The primary identifier for the dispatch session.
project/run-id Scoped identifier for project-specific task management.
status Updated in the metadata to 'cancelled' upon successful execution.
exit_code Hardcoded to 130 to signify a user-initiated termination.

Cancel Dispatch Run Advanced Features

  • Integration with Openclaw Skills entry environment injection for secure configuration.
  • Precise error reporting for invalid run-ids or session resolution failures.
  • Support for scoped cancellation across different project directories.
  • Automated metadata synchronization for downstream analytics and logging.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*