ironclaw registry

The ironclaw registry command lets you discover, browse, and install pre-built extensions (tools and channels) from the IronClaw extension registry.

Usage

ironclaw registry <subcommand>

Subcommands

list

List available extensions in the registry.

ironclaw registry list [OPTIONS]

string

Filter by extension type: tool or channel

string

Filter by tag (e.g., default, google, messaging)

boolean

Show detailed information for each extension

Example:

# List all extensions
ironclaw registry list

# List only tools
ironclaw registry list --kind tool

# List extensions tagged with "google"
ironclaw registry list --tag google

# Show detailed information
ironclaw registry list --verbose

info

Show detailed information about a specific extension or bundle.

ironclaw registry info <name>

string

required

Extension or bundle name (e.g., slack, google, tools/gmail)

Example:

# Show info about the Slack channel
ironclaw registry info slack

# Show info about the Google bundle
ironclaw registry info google

# Show info about the Gmail tool
ironclaw registry info tools/gmail

install

Install an extension or bundle from the registry.

ironclaw registry install <name> [OPTIONS]

string

required

Extension or bundle name to install

boolean

Force overwrite if already installed

boolean

Build from source instead of downloading pre-built artifact

Example:

# Install Slack channel
ironclaw registry install slack

# Install and overwrite existing
ironclaw registry install slack --force

# Build from source
ironclaw registry install slack --build

# Install entire Google bundle
ironclaw registry install google

install-defaults

Install the default bundle of recommended extensions.

ironclaw registry install-defaults [OPTIONS]

boolean

Force overwrite if already installed

boolean

Build from source instead of downloading pre-built artifacts

Example:

# Install default extensions
ironclaw registry install-defaults

# Force reinstall
ironclaw registry install-defaults --force

Extension Types

The registry contains two types of extensions:

Tools

WASM-based tools that extend IronClaw’s capabilities (e.g., Gmail, GitHub, Slack integrations)

Channels

WASM-based communication channels for connecting to messaging platforms (e.g., Telegram, Slack, Discord)

Bundles

Bundles are collections of related extensions that can be installed together:

default - Recommended set of extensions for common use cases
google - All Google Workspace tools (Gmail, Drive, Docs, Sheets, Calendar)
messaging - Popular messaging channels (Telegram, Slack, Discord)

Extension Sources

Extensions can be installed from:

Pre-built artifacts - Compiled WASM binaries (default, faster)
Source code - Build from source using --build flag (requires Rust toolchain)

Pre-built artifacts are hosted on GitHub releases and are the recommended installation method for most users.

Examples

Browse available extensions

# List all extensions
ironclaw registry list

# List with full details
ironclaw registry list --verbose

Example output:

Available extensions:

Tools (15):
  - tools/gmail         Google Gmail integration
  - tools/github        GitHub API integration
  - tools/slack         Slack workspace integration
  - tools/web-search    Web search capabilities
  ...

Channels (5):
  - telegram           Telegram messaging channel
  - slack              Slack workspace channel
  - discord            Discord server channel
  ...

Bundles (3):
  - default            Recommended starter bundle
  - google             All Google Workspace tools
  - messaging          Popular messaging channels

Install specific extensions

# Install Gmail tool
ironclaw registry install tools/gmail

# Install Telegram channel
ironclaw registry install telegram

Install a bundle

# Install Google Workspace bundle (Gmail, Drive, Docs, Sheets, Calendar)
ironclaw registry install google

Get extension details

# Show detailed info about Slack
ironclaw registry info slack

Example output:

Extension: slack
Type: channel
Version: 0.13.0
Description: Slack workspace channel for IronClaw

Features:
  - Direct messages
  - Channel messages
  - Thread support
  - File uploads
  - Slash commands

Requirements:
  - Slack workspace
  - Bot token with required scopes

Capabilities:
  - HTTP requests to api.slack.com
  - Workspace read/write
  - Credential injection

Troubleshooting

Registry connection failed

The registry requires internet access to GitHub. Common issues:

Network connectivity: Verify you can reach github.com
Proxy settings: Set HTTPS_PROXY if behind a corporate proxy
Rate limiting: GitHub API may be rate-limited; wait and try again

Installation failed

If extension installation fails:

Check you have write permissions to the extensions directory (~/.ironclaw/extensions/)
Try with --force to overwrite corrupted installations
If using --build, ensure Rust toolchain is installed: rustup --version
Check the specific error message for details

Extension not working after install

After installing an extension:

Restart IronClaw to load the new extension
For tools: Check if authentication is required with ironclaw tool auth <name>
For channels: Configure secrets with ironclaw onboard --channels-only
Run ironclaw doctor to diagnose issues

ironclaw tool

Manage installed WASM tools

ironclaw onboard

Configure extensions and channels

Building tools

Create your own WASM tools

Building channels

Create your own WASM channels

​Usage

​Subcommands

​list

​info

​install

​install-defaults

​Extension Types

Tools

Channels

​Bundles

​Extension Sources

​Examples

​Browse available extensions

​Install specific extensions

​Install a bundle

​Get extension details

​Troubleshooting

​Related Commands

ironclaw tool

ironclaw onboard

Building tools

Building channels

Usage

Subcommands

list

info

install

install-defaults

Extension Types

Bundles

Extension Sources

Examples

Browse available extensions

Install specific extensions

Install a bundle

Get extension details

Troubleshooting

Related Commands