Enum PluginError 

pub enum PluginError {
    NotFound(PluginId),
    AlreadyRegistered(PluginId),
    ManifestParseError {
        path: PathBuf,
        message: String,
    },
    LoadFailed {
        plugin_id: PluginId,
        message: String,
    },
    ExecutionFailed(String),
    ToolNotFound(String),
    InvalidId(String),
    Storage(String),
    McpServerFailed {
        plugin_id: PluginId,
        message: String,
    },
    McpClientRequired,
    UnsupportedEntryPoint(String),
    SandboxError(String),
    Io(Error),
    WasmError(String),
    RegistryError {
        message: String,
    },
    IntegrityError {
        package: String,
        expected: String,
    },
    ExtractionError {
        message: String,
    },
    UnsafeEntryType {
        entry_type: String,
        path: String,
    },
    PathTraversal {
        path: String,
    },
    PackageTooLarge {
        size: u64,
        limit: u64,
    },
    NotOpenClawPlugin,
    InvalidPackageName {
        name: String,
        reason: String,
    },
    SsrfBlocked {
        url: String,
    },
    SecurityDenied(String),
    HashMismatch {
        expected: String,
        actual: String,
    },
    LockfileError {
        path: PathBuf,
        message: String,
    },
}

Errors from plugin operations.

Variants

NotFound(PluginId)

The requested plugin was not found in the registry.

AlreadyRegistered(PluginId)

A plugin with this ID is already registered.

ManifestParseError

Failed to parse a plugin manifest file.

Fields

path: PathBuf

Path to the manifest file.

message: String

Parse error message.

LoadFailed

Plugin failed to load.

Fields

plugin_id: PluginId

The plugin that failed to load.

message: String

Failure reason.

ExecutionFailed(String)

Plugin tool execution failed.

ToolNotFound(String)

The requested tool was not found.

InvalidId(String)

The plugin ID is invalid.

Storage(String)

Storage operation failed.

McpServerFailed

The MCP server for a plugin failed.

Fields

plugin_id: PluginId

The plugin whose MCP server failed.

message: String

Failure reason.

McpClientRequired

An MCP client is required but was not provided.

UnsupportedEntryPoint(String)

The plugin entry point type is not supported by this factory.

SandboxError(String)

Sandbox profile error.

Io(Error)

I/O error.

WasmError(String)

WASM runtime error (Extism/Wasmtime).

RegistryError

npm registry API failure.

Fields

message: String

Description of the registry failure.

IntegrityError

SHA-512 SRI integrity verification failed.

Fields

package: String

Package that failed verification.

expected: String

Expected SRI hash string.

ExtractionError

Tarball extraction failure.

Fields

message: String

Description of the extraction failure.

UnsafeEntryType

Unsafe entry type in archive (e.g. symlink, hardlink, device node).

Fields

entry_type: String

The entry type that was rejected.

path: String

The path of the entry.

PathTraversal

Path traversal detected in archive entry.

Fields

path: String

The offending path.

PackageTooLarge

Tarball exceeds maximum allowed size.

Fields

size: u64

Actual size in bytes.

limit: u64

Maximum allowed size in bytes.

NotOpenClawPlugin

Package is not an OpenClaw plugin (missing openclaw.plugin.json).

InvalidPackageName

Invalid npm package name.

Fields

name: String

The invalid name.

reason: String

Why the name is invalid.

SsrfBlocked

SSRF attempt blocked — tarball URL doesn’t match registry.

Fields

url: String

The blocked URL.

SecurityDenied(String)

Security gate denied the operation.

HashMismatch

WASM module hash verification failed.

Fields

expected: String

Expected blake3 hex digest.

actual: String

Actual blake3 hex digest.

LockfileError

Lockfile read/write/parse error.

Fields

path: PathBuf

Path to the lockfile.

message: String

Error description.

Trait Implementations

impl Debug for PluginError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for PluginError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for PluginError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for PluginError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<StorageError> for PluginError

fn from(e: StorageError) -> Self

Converts to this type from the input type.