Skip to main content
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]
​
--kind
string
Filter by extension type: tool or channel
​
--tag
string
Filter by tag (e.g., default, google, messaging)
​
--verbose
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>
​
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]
​
name
string
required
Extension or bundle name to install
​
--force
boolean
Force overwrite if already installed
​
--build
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]
​
--force
boolean
Force overwrite if already installed
​
--build
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:
  1. Pre-built artifacts - Compiled WASM binaries (default, faster)
  2. 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

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
If extension installation fails:
  1. Check you have write permissions to the extensions directory (~/.ironclaw/extensions/)
  2. Try with --force to overwrite corrupted installations
  3. If using --build, ensure Rust toolchain is installed: rustup --version
  4. Check the specific error message for details
After installing an extension:
  1. Restart IronClaw to load the new extension
  2. For tools: Check if authentication is required with ironclaw tool auth <name>
  3. For channels: Configure secrets with ironclaw onboard --channels-only
  4. 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

Build docs developers (and LLMs) love

Get started for freeTalk to us