openclaw plugins: Plugin Management Command Guide

Command Overview

The openclaw plugins command manages OpenClaw's plugin ecosystem. Plugins can add new tools, skills, and integrations to the AI assistant.

View Installed Plugins

openclaw plugins list

Installed Plugins:
  Name              Version   Status    Description
  ──────────────────────────────────────────────────────
  web-search        1.2.0     Active    Web search capability
  code-exec         1.0.3     Active    Code execution sandbox
  image-gen         2.1.0     Active    AI image generation
  weather           1.0.0     Inactive  Weather information
  rss-reader        1.1.0     Active    RSS feed reader

Total: 5 plugins (4 active)

Search for Plugins

openclaw plugins search weather

Available Plugins:
  weather           1.0.0   Weather information from multiple providers
  weather-pro       2.0.0   Advanced weather with forecasts and maps
  weather-alert     1.0.0   Severe weather alerts and notifications

Install Plugins

# Install from the official repository
openclaw plugins install weather

# Install a specific version
openclaw plugins install [email protected]

# Install from GitHub
openclaw plugins install github:username/openclaw-plugin-name

# Install from a local path
openclaw plugins install /path/to/plugin

Configure Plugins

Configure plugin parameters after installation:

openclaw plugins configure weather

Configuring plugin: weather

API Provider:
  [1] OpenWeatherMap (free tier available)
  [2] WeatherAPI
  [3] AccuWeather

> 1

Enter OpenWeatherMap API key: ****

Default units:
  [1] Metric (°C, km/h)
  [2] Imperial (°F, mph)

> 1

Plugin 'weather' configured successfully.

Or set it directly in the configuration file:

{
  "plugins": {
    "weather": {
      "provider": "openweathermap",
      "apiKey": "{{WEATHER_API_KEY}}",
      "units": "metric",
      "defaultCity": "Beijing"
    }
  }
}

Enable/Disable Plugins

openclaw plugins enable weather
openclaw plugins disable weather

Update Plugins

# Update a specific plugin
openclaw plugins update weather

# Update all plugins
openclaw plugins update --all

# Check for available updates
openclaw plugins outdated

Uninstall Plugins

openclaw plugins uninstall weather

View Plugin Details

openclaw plugins info weather

Plugin: weather
  Version: 1.0.0
  Author: OpenClaw Community
  License: MIT
  Description: Weather information from multiple providers

  Provides tools:
    get_weather     - Get current weather for a location
    get_forecast    - Get weather forecast

  Configuration:
    provider        - Weather data provider
    apiKey          - API key for the provider
    units           - Temperature units (metric/imperial)

  Dependencies: none
  Size: 45KB

Assign Plugins to Channels

# Add plugin tools to a channel
openclaw channels set telegram-main --add-tool weather.get_weather
openclaw channels set telegram-main --add-tool weather.get_forecast

Or in the configuration:

{
  "channels": {
    "telegram-main": {
      "tools": ["weather.get_weather", "weather.get_forecast", "web_search"]
    }
  }
}

Develop Custom Plugins

Create a plugin scaffold:

openclaw plugins create my-plugin

Generated directory structure:

my-plugin/
├── package.json
├── index.js
├── tools/
│   └── my-tool.js
├── config.schema.json
└── README.md

Example plugin entry file:

// index.js
module.exports = {
  name: 'my-plugin',
  version: '1.0.0',
  tools: [
    {
      name: 'my_tool',
      description: 'My custom tool',
      parameters: {
        type: 'object',
        properties: {
          query: { type: 'string', description: 'Query content' }
        },
        required: ['query']
      },
      execute: async ({ query }) => {
        return { result: `Processed: ${query}` };
      }
    }
  ]
};

Test a plugin in development:

openclaw plugins test /path/to/my-plugin

Plugin Marketplace

Browse the official plugin marketplace:

openclaw plugins market
openclaw plugins market --category tools
openclaw plugins market --sort popular

Summary

OpenClaw's plugin system uses a modular design to flexibly extend the AI assistant's capabilities. Whether using community plugins or developing custom ones, you can easily add new skills to your AI.