Nomad for Openclaw

A read-only integration for querying and monitoring HashiCorp Nomad clusters via the native CLI.

danfedick
v1.0.0
Jan 26, 2026
1
2.5k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install nomad

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 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?

The Nomad skill for Openclaw Skills provides a robust, read-only interface to interact with HashiCorp Nomad clusters directly from your AI agent environment. By leveraging the native nomad CLI, this skill enables real-time monitoring of orchestration workflows, job statuses, and infrastructure health without the risk of accidental cluster modifications. It is specifically designed for developers and SREs who need rapid access to cluster state, allocation logs, and node health during troubleshooting or system audits.

This integration streamlines the process of extracting critical data from your scheduler, supporting job history lookups, deployment tracking, and service discovery verification. As a component of the Openclaw Skills ecosystem, it ensures that infrastructure insights are easily accessible to your AI agents while maintaining a strict security posture through read-only operations.

Nomad Use Cases

  • Monitoring job status and deployment history across distributed Nomad clusters.
  • Troubleshooting failed allocations by retrieving stdout and stderr logs for specific tasks.
  • Auditing node health and resource distribution within the orchestration layer.
  • Verifying service discovery records and native Nomad service configurations.
  • Inspecting cluster-wide variables and namespace-specific metadata for debugging.

How Nomad Works

  1. The skill interfaces with the local nomad CLI installed on the host environment.
  2. It utilizes environment variables such as NOMAD_ADDR and NOMAD_TOKEN to authenticate and connect to the target cluster.
  3. The agent triggers specific read-only commands to query entities like jobs, allocations, or nodes.
  4. The skill executes the command, often appending the -json flag to ensure the output is structured for easy parsing.
  5. The resulting data is returned to the Openclaw Skills agent, allowing for further analysis, filtering, or reporting.

Nomad Setup

To enable this skill, ensure the Nomad CLI is installed on your system. You must then configure your environment to point to your Nomad cluster:

# Set the cluster address
export NOMAD_ADDR='http://your-nomad-cluster:4646'

# Provide an ACL token if security is enabled
export NOMAD_TOKEN='your-secure-token'

# Optional: Define default namespace or region
export NOMAD_NAMESPACE='prod'

Ensure the binary is in the agent's PATH so Openclaw Skills can execute the required commands.

Nomad Data Schema & Taxonomy

The Nomad skill organizes data based on the cluster's internal state. It primarily retrieves structured data in the following formats:

Entity Data Provided Key Identifiers
Jobs Status, History, Deployments JobID, Status, Type
Allocations Runtime state, Logs, Metrics AllocID, NodeID, ClientStatus
Nodes Hardware health, Allocations NodeID, Datacenter, Address
Evaluations Scheduling logic outcomes EvalID, JobID, Status
Services Service discovery metadata ServiceName, Port, Tags

Most data can be retrieved as JSON objects for high-fidelity processing within Openclaw Skills workflows.

Nomad Advanced Features

  • Support for expression-based filtering using the -filter flag to isolate specific job or node states.
  • Real-time log streaming for stdout and stderr to facilitate live application debugging.
  • Multi-region and multi-namespace support for complex enterprise environments.
  • JSON output compatibility for seamless integration with jq or other data processing tools within Openclaw Skills.
  • Server and agent-info querying for deep cluster health diagnostics.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*