Creating and Managing Custom Skills with ClawHub

If you're using OpenClaw, you're already working with skills—those powerful plugins that extend your AI agent's capabilities. But what if the skill you need doesn't exist yet? Or what if you want to customize an existing one to better fit your workflow? That's where ClawHub comes in.

ClawHub is the public skill registry for OpenClaw, a central hub where users can discover, install, update, and share skills. It's not just a marketplace—it's a collaborative ecosystem that empowers users to build, refine, and distribute new capabilities for the OpenClaw platform.

In this guide, we'll walk through how to use ClawHub to manage skills effectively, whether you're installing third-party skills or publishing your own.

What is a Skill?

Before we dive in, let's clarify what a skill actually is. In OpenClaw, a skill is a self-contained module that teaches your agent how to perform a specific task. Each skill is a folder containing:

A SKILL.md file with instructions and metadata
Optional supporting files (scripts, configs, templates)
An optional installer script or binary

Skills can do anything from controlling smart home devices to integrating with third-party APIs. When properly configured, they appear in your agent's tool list and can be invoked automatically or via slash commands.

Getting Started with ClawHub

Install the CLI

To interact with ClawHub, you'll need the command-line interface. Install it globally with npm:

npm i -g clawhub

Or with pnpm:

pnpm add -g clawhub

Once installed, you can use clawhub commands to search, install, and manage skills.

Search for Skills

Let's say you need a skill to interact with your calendar. Instead of building one from scratch, search ClawHub first:

clawhub search "calendar"

This returns relevant skills like caldav-calendar, google-calendar, or ical-tools. The search uses vector embeddings, so it understands semantic intent—not just keywords.

Installing Skills

Found a skill you want to use? Install it with:

clawhub install caldav-calendar

By default, clawhub installs skills into a skills folder in your current directory. If you're in your OpenClaw workspace, that's usually the right place. The skill will be picked up on your next agent session.

Pro Tip: After installing a skill, restart your OpenClaw session to ensure it's properly loaded.

Managing Dependencies

Many skills require external tools or API keys. For example, the caldav-calendar skill needs khal and vdirsyncer binaries, while gemini requires a GEMINI_API_KEY.

ClawHub handles this gracefully. When you install a skill, check its SKILL.md for requirements. Many skills include installer specs that suggest installation methods:

---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---

Follow the suggested installation method, then set any required environment variables in your OpenClaw config.

Updating Skills

Skills are updated regularly. To keep yours current, run:

clawhub update --all

This checks each installed skill against the registry and downloads updates when available. By default, it prompts before overwriting local changes, protecting any customizations you've made.

Note: If you've modified a skill locally, clawhub will detect the divergence and ask how to proceed. Use --force to overwrite, or manually merge your changes.

Publishing Your Own Skills

Created something amazing? Share it with the community by publishing to ClawHub.

Prepare Your Skill

First, ensure your skill follows the standard structure:

my-awesome-skill/
├── SKILL.md
├── script.py
└── README.md

Your SKILL.md must include proper frontmatter:

---
name: my-awesome-skill
description: Does something amazing with AI
---

Add detailed instructions in the body, including usage examples and any requirements.

Publish to ClawHub

Run the publish command:

clawhub publish ./my-awesome-skill \
  --slug my-awesome-skill \
  --name "My Awesome Skill" \
  --version 1.0.0 \
  --tags latest

You'll be prompted to log in via browser if you haven't already. Once authenticated, your skill is published to the registry.

Using the Sync Workflow

If you maintain multiple skills, use the sync command to publish all updates at once:

clawhub sync --all

This scans your skills directory, compares each against the registry, and uploads new or updated skills automatically. It's perfect for maintaining a personal skill library.

Skill Versioning and Tags

ClawHub uses semantic versioning (semver) for all published skills. Each publish creates a new version, and the registry maintains a full history.

Tags like latest point to specific versions and can be moved. This allows you to:

Roll back to previous versions
Maintain stable and bleeding-edge releases
Publish hotfixes without breaking existing installations

When users install without specifying a version, they get the latest tagged version.

Security and Moderation

ClawHub is open by default—anyone can publish skills. To prevent abuse:

GitHub accounts must be at least one week old to publish
Users can report suspicious skills
Skills with multiple reports are auto-hidden
Moderators review and take action on reports

Always review third-party skills before installing. Check the code, understand what it does, and consider running it in a sandboxed environment first.

Best Practices

Start with search—chances are, someone's already built what you need
Document thoroughly—clear instructions help others use your skills
Version responsibly—follow semver and write meaningful changelogs
Test locally—verify your skill works before publishing
Update regularly—fix bugs and improve functionality

Conclusion

ClawHub transforms OpenClaw from a standalone tool into a collaborative platform. By making it easy to share capabilities, it accelerates innovation and reduces duplicated effort across the community.

Whether you're installing skills to extend your agent's functionality or publishing your own creations to help others, ClawHub puts the power of customization in your hands. Start exploring today at clawhub.ai and see what the community has built—or publish your first skill and contribute to the ecosystem.