Nomad Skill for Openclaw

A read-only monitoring and troubleshooting interface for HashiCorp Nomad clusters using the nomad CLI.

macdesire
v1.0.0
Mar 14, 2026
0
908
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install nomad-backup

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 nomad-backup 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 Nomad Skill?

The Nomad skill enables AI agents to interact directly with HashiCorp Nomad clusters for high-level observability and detailed troubleshooting. It provides a robust set of tools to query jobs, nodes, allocations, and services without the risk of modifying the cluster state. By integrating this capability through Openclaw Skills, developers can automate infrastructure health checks and log analysis through natural language or automated workflows.

Nomad Skill Use Cases

  • Tracking job deployment progress and identifying failed task groups
  • Inspecting stdout and stderr logs for specific allocations to debug application errors
  • Monitoring cluster health by checking node status and server member connectivity
  • Querying Nomad native service discovery and internal variable stores
  • Auditing namespace and regional cluster configurations

How Nomad Skill Works

  1. The AI agent leverages the local nomad CLI to communicate with the cluster API.
  2. Authentication and connectivity are established using standard environment variables such as NOMAD_ADDR and NOMAD_TOKEN.
  3. The skill executes read-only commands to fetch real-time data about the cluster's state.
  4. Data is often retrieved in JSON format to provide structured, high-fidelity information back to the agent.
  5. The agent synthesizes this data to provide actionable insights or direct answers to infrastructure queries.

Nomad Skill Setup

To use this skill, ensure the nomad CLI is installed and your environment is configured to point to your cluster.

# Install the nomad CLI if not present
# Then set your connection details
export NOMAD_ADDR='http://127.0.0.1:4646'
export NOMAD_TOKEN='your-acl-token-here'

# Test the connection
nomad agent-info

Nomad Skill Data Schema & Taxonomy

The skill interacts with several core Nomad entities. The data returned follows the standard Nomad object schema:

Entity Key Attributes Metadata Captured
Jobs ID, Status, Type, Priority Deployment history, task group counts
Allocations ID, NodeID, ClientStatus Log offsets, restart counts, resource usage
Nodes ID, Datacenter, Status Driver versions, available resources
Evaluations ID, JobID, Status Triggering events, scheduling decisions
Services Name, JobID, Namespace Service discovery tags and addresses

Nomad Skill Advanced Features

  • Expression-based filtering using the -filter flag for complex job and node queries
  • Structured JSON output support for precise data extraction and multi-agent coordination
  • Real-time log streaming for both stdout and stderr across specific allocations
  • Integrated support for Nomad Namespaces and Regions to manage multi-tenant environments
  • Read-only enforcement to prevent accidental job deletions or configuration changes within the Openclaw Skills environment

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*