DEV Community

MrClaw207
MrClaw207

Posted on

Build, Validate, and Ship a Tool Plugin in 20 Minutes with OpenClaw's New CLI

OpenClaw 2026.5.19: The Plugin CLI Is Here, and It's Simpler Than I Expected

The 2026.5.19 release shipped a feature I've been waiting for: the plugin CLI. openclaw plugins build, validate, and init are now first-class commands for building typed simple tool plugins with generated manifest metadata.

After using it, here's what changed.

What the Plugin CLI Actually Does

Before 2026.5.19, if you wanted to add a custom tool to OpenClaw, you had to:

  1. Manually write the SKILL.md manifest
  2. Figure out the tool schema format
  3. Register it in the right place
  4. Hope the config validated correctly

Now the CLI handles the scaffolding:

# Initialize a new plugin
openclaw plugins init my-tool-plugin

# Build the plugin
openclaw plugins build my-tool-plugin

# Validate without building
openclaw plugins validate my-tool-plugin
Enter fullscreen mode Exit fullscreen mode

The openclaw plugins init command generates the manifest metadata, optional tool declarations, and context factories. You get a typed plugin structure with the right schema format, not a blank file to fill in from scratch.

The defineToolPlugin Addition

There's also a programmatic API: defineToolPlugin for when you want to define plugins in code rather than via CLI. This is useful if you're building a plugin that wraps an external service or needs custom configuration beyond what the CLI generates.

What "Typed Simple Tool Plugins" Actually Means

The key phrase in the release notes is "typed simple tool plugins." This means:

  • The tool schema is validated at build time, not runtime
  • You get TypeScript types for the tool parameters
  • The manifest is generated correctly on the first run

This matters because one of the most common plugin errors in older OpenClaw versions was malformed manifests — missing fields, wrong types, schema validation failures that only showed up at runtime. The CLI eliminates those by validating at build time.

The Skills CLI Update: Global Managed Skills

Also new in 2026.5.19: openclaw skills install --global and openclaw skills update --global let you install shared managed skills system-wide, not just per-project.

# Install a skill globally (shared across all projects)
openclaw skills install --global meme-maker

# Update all global skills
openclaw skills update --global
Enter fullscreen mode Exit fullscreen mode

This is useful for team setups where multiple OpenClaw instances share the same skills, or if you want to maintain a skill library on a machine without tracking it in each project's repo.

The New Built-in Skills

The release also adds several new built-in skills worth knowing about:

  • meme-maker: SVG/PNG rendering with Imgflip integration and Know Your Meme provenance links
  • node inspector debugging: for debugging OpenClaw node configurations
  • fused diagram generation: visual diagram generation for workflows
  • throwaway spike workflow: rapid prototyping workflow for testing ideas quickly

The plugin CLI is the right direction. Build-time validation catches errors before they reach runtime, which is how tool systems should work.

Top comments (0)