DescribePolarClawPlugins

Lists all installed PolarClaw plugins and their status.

Operation description

Request

This API gets information about all plugins for a given application, including built-in and user-installed plugins.
Use the PluginList parameter to request information for specific plugins. If you omit this parameter, the API returns details for all plugins.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
ApplicationId	string	Yes	The application ID.	pa-**************
PluginList	array	No	A list of plugin IDs. If omitted, all plugins are returned.
	string	No	The plugin ID.	openclaw-lark

Response elements

Element	Type	Description	Example
	object	The response data.
RequestId	string	The request ID.	2281C6C9-CBAB-1AFD-8400-670750CF6025_2212
Message	string	The response message.	successful
Code	integer	The response status code.	200
ApplicationId	string	The application ID.	pa-**************
Plugins	array<object>	An array of plugin objects.
	object	The structure of a plugin object.
Id	string	The plugin ID.	openclaw-lark
Name	string	The display name of the plugin.	Feishu
Description	string	The description of the plugin.	Lark/Feishu channel plugin with im/doc/wiki/drive/task/calendar tools
Status	string	The status of the plugin. Valid values: `loaded`, `disabled`, and `error`.	loaded
Format	string	The format of the plugin, which can be an empty string.	openclaw
Version	string	The version number of the plugin.	2026.4.7
Source	string	The file path to the plugin's entry point.	/home/node/.openclaw/extensions/openclaw-lark/index.js
Origin	string	The origin of the plugin. Valid values: `bundled`, `global`, and `user-install`.	global
Error	string	The error message, or `null` if no error occurred.	null
ProviderIds	array	A list of provider IDs, which can be empty.
	string	A provider ID.	***
ChannelIds	array	A list of channel IDs, which can be empty.
	string	A channel ID.	feishu
Diagnostics	array<object>	An array of diagnostic objects.
	object	The structure of a diagnostic object.
Level	string	The severity level. Valid values: `error` and `warn`.	warn
Message	string	The detailed diagnostic message.	loaded without install/load-path provenance; treat as untracked local code
PluginId	string	The ID of the associated plugin.	openclaw-lark
Source	string	The source file path associated with the diagnostic.	/home/node/.openclaw/extensions/openclaw-lark/index.js

Examples

Success response

JSON format

{
  "RequestId": "2281C6C9-CBAB-1AFD-8400-670750CF6025_2212",
  "Message": "successful",
  "Code": 200,
  "ApplicationId": "pa-**************",
  "Plugins": [
    {
      "Id": "openclaw-lark",
      "Name": "Feishu",
      "Description": "Lark/Feishu channel plugin with im/doc/wiki/drive/task/calendar tools",
      "Status": "loaded",
      "Format": "openclaw",
      "Version": "2026.4.7",
      "Source": "/home/node/.openclaw/extensions/openclaw-lark/index.js",
      "Origin": "global",
      "Error": "null",
      "ProviderIds": [
        "***"
      ],
      "ChannelIds": [
        "feishu"
      ]
    }
  ],
  "Diagnostics": [
    {
      "Level": "warn",
      "Message": "loaded without install/load-path provenance; treat as untracked local code",
      "PluginId": "openclaw-lark",
      "Source": "/home/node/.openclaw/extensions/openclaw-lark/index.js"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.