> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/nearai/ironclaw/llms.txt
> Use this file to discover all available pages before exploring further.

# ironclaw registry

> Browse and install extensions from the registry

# ironclaw registry

Browse and install extensions (tools and channels) from the IronClaw registry.

## Usage

```bash theme={null}
ironclaw registry <subcommand> [options]
```

## Subcommands

### ironclaw registry list

List available extensions in the registry.

**Usage:**

```bash theme={null}
ironclaw registry list [options]
```

**Options:**

<ParamField path="--kind, -k" type="string">
  Filter by extension kind: `tool` or `channel`
</ParamField>

<ParamField path="--tag, -t" type="string">
  Filter by tag (e.g., `default`, `google`, `messaging`)
</ParamField>

<ParamField path="--verbose, -v" type="boolean">
  Show detailed information for each extension
</ParamField>

**Examples:**

```bash theme={null}
# List all extensions
ironclaw registry list

# List only tools
ironclaw registry list --kind tool

# List Google-related extensions
ironclaw registry list --tag google

# List with detailed information
ironclaw registry list --verbose
```

**Output:**

```
Available extensions in registry:

Tools:
  gmail          - Gmail tool for reading and sending emails
  google-docs    - Google Docs integration
  google-sheets  - Google Sheets integration
  slack          - Slack bot integration
  web-search     - Web search tool

Channels:
  telegram       - Telegram channel (MTProto)
  slack          - Slack Events API channel
  discord        - Discord bot channel

Bundles:
  default        - Default set of recommended extensions
  google         - Complete Google Workspace suite
```

### ironclaw registry info

Show detailed information about a specific extension or bundle.

**Usage:**

```bash theme={null}
ironclaw registry info <name>
```

**Arguments:**

<ParamField path="name" type="string" required>
  Extension or bundle name (e.g., `slack`, `google`, `tools/gmail`)
</ParamField>

**Examples:**

```bash theme={null}
# Show info about Slack tool
ironclaw registry info slack

# Show info about Google bundle
ironclaw registry info google

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

**Output:**

```
Extension: slack
Kind: tool
Version: 0.1.0
Description: Slack bot integration for sending messages and managing channels
Tags: messaging, collaboration, default

Capabilities:
  - HTTP access to api.slack.com
  - Secrets: SLACK_BOT_TOKEN, SLACK_APP_TOKEN

Source: https://github.com/nearai/ironclaw/tree/main/tools-src/slack
```

### ironclaw registry install

Install an extension or bundle from the registry.

**Usage:**

```bash theme={null}
ironclaw registry install <name> [options]
```

**Arguments:**

<ParamField path="name" type="string" required>
  Extension or bundle name to install
</ParamField>

**Options:**

<ParamField path="--force, -f" type="boolean">
  Force overwrite if the extension is already installed
</ParamField>

<ParamField path="--build" type="boolean">
  Build from source instead of downloading pre-built artifact
</ParamField>

**Examples:**

```bash theme={null}
# Install Slack tool
ironclaw registry install slack

# Install Google bundle (all Google Workspace tools)
ironclaw registry install google

# Force reinstall
ironclaw registry install slack --force

# Build from source
ironclaw registry install slack --build
```

**Output:**

```
Installing slack from registry...
Downloading artifact...
✓ Downloaded slack-v0.1.0-wasm32-wasi.wasm
✓ Installed to ~/.ironclaw/tools/slack.wasm
✓ Extracted capabilities to ~/.ironclaw/tools/slack.capabilities.json

Extension installed successfully!

Next steps:
  1. Configure credentials: ironclaw tool auth slack
  2. Restart IronClaw to load the tool
```

### ironclaw registry install-defaults

Install the default bundle of recommended extensions.

**Usage:**

```bash theme={null}
ironclaw registry install-defaults [options]
```

**Options:**

<ParamField path="--force, -f" type="boolean">
  Force overwrite if extensions are already installed
</ParamField>

<ParamField path="--build" type="boolean">
  Build from source instead of downloading pre-built artifacts
</ParamField>

**Examples:**

```bash theme={null}
# Install default extensions
ironclaw registry install-defaults

# Force reinstall all defaults
ironclaw registry install-defaults --force
```

**Output:**

```
Installing default bundle (5 extensions)...

Installing tools:
  ✓ web-search
  ✓ gmail
  ✓ google-calendar

Installing channels:
  ✓ telegram
  ✓ slack

Successfully installed 5 extensions!

Next steps:
  1. Configure credentials for each extension
  2. Restart IronClaw to load the extensions
```

## Extension Types

### Tools

WASM-based tools that extend IronClaw's capabilities:

* **API integrations** - Gmail, Slack, Google Docs, etc.
* **Utilities** - Web search, file processing, data transformation
* **Custom tools** - Built by the community

### Channels

Communication channels for interacting with IronClaw:

* **Telegram** - MTProto-based Telegram integration
* **Slack** - Slack Events API channel
* **Discord** - Discord bot channel
* **WhatsApp** - WhatsApp integration

### Bundles

Pre-configured sets of related extensions:

* **default** - Recommended tools and channels for getting started
* **google** - Complete Google Workspace suite (Gmail, Docs, Sheets, Calendar, Drive, Slides)
* **messaging** - All messaging channels (Telegram, Slack, Discord, WhatsApp)

## Registry Structure

The registry is stored in the IronClaw repository at `registry/`:

```
registry/
├── tools/
│   ├── gmail/
│   │   ├── manifest.json
│   │   └── releases/
│   ├── slack/
│   └── web-search/
├── channels/
│   ├── telegram/
│   ├── slack/
│   └── discord/
└── bundles/
    ├── default.json
    ├── google.json
    └── messaging.json
```

## Troubleshooting

<AccordionGroup>
  <Accordion title="Extension not found">
    The extension may not exist in the registry. Run `ironclaw registry list` to see available extensions.
  </Accordion>

  <Accordion title="Download failed">
    * Check your internet connection
    * Verify the registry URL is accessible
    * Try building from source with `--build` flag
  </Accordion>

  <Accordion title="Installation permissions error">
    Ensure you have write permissions to `~/.ironclaw/tools/` directory:

    ```bash theme={null}
    chmod 755 ~/.ironclaw/tools
    ```
  </Accordion>

  <Accordion title="Extension not loading after install">
    Restart IronClaw to load newly installed extensions:

    ```bash theme={null}
    # Stop IronClaw (Ctrl+C or service stop)
    ironclaw service stop

    # Start again
    ironclaw
    ```
  </Accordion>
</AccordionGroup>

## See Also

<CardGroup cols={2}>
  <Card title="Tool Management" icon="wrench" href="/cli/tool">
    Manage WASM tools
  </Card>

  <Card title="WASM Tools" icon="cube" href="/tools/wasm">
    Learn about WASM tool system
  </Card>

  <Card title="Building Tools" icon="hammer" href="/tools/building">
    Build custom tools
  </Card>

  <Card title="Extensions" icon="puzzle-piece" href="/tools/overview">
    Tools & Extensions overview
  </Card>
</CardGroup>