Struct PluginRegistry 

pub struct PluginRegistry { /* private fields */ }

Plugin registry — manage installed plugins

Implementations

impl PluginRegistry

pub fn new() -> Self

pub fn tools(&self) -> &[Arc<dyn Tool>]

Tools contributed by plugins during on_register.

LoopRunner::with_plugin_registry appends these to the agent’s tool list. They were previously logged and dropped, so a plugin could “register” a tool the agent could never call.

pub fn host_plugins(&self) -> &[HostPluginEntry]

Host plugin directories found by ingest_host_plugins.

pub fn channels(&self) -> &ChannelRegistry

Every channel that can be selected by name — built-ins plus whatever plugins registered during on_register.

pub fn ingest_host_plugins(&mut self, workspace: &Path, extra: &[PathBuf])

Discover OpenClaw/Hermes plugin directories and keep them.

Kept, not just logged: host_plugins() is what feeds SKILL.md-bearing plugin directories into skill discovery. A HostPluginEntry carries no entrypoint, so a plugin whose manifest declares neither a skill nor an in-process registration still does nothing — see docs/ before adding an execution model for those.

pub fn ingest_host_plugins_trusting( &mut self, workspace: &Path, extra: &[PathBuf], trusted: &[String], )

As ingest_host_plugins, additionally building the manifest-declared tools of plugins named in trusted.

Trust is per plugin id and defaults to empty, because discovery finds a directory — it does not vouch for it. See plugin_exec for what a trusted plugin is still not allowed to do.

pub async fn register(&mut self, plugin: Arc<dyn Plugin>)

Register a plugin and call its on_register with a PluginContext

pub fn register_sync(&mut self, plugin: Arc<dyn Plugin>)

Register a plugin without async (for tests, legacy)

pub fn register_hook(&mut self, hook: Arc<dyn LifecycleHook>)

Register a lifecycle hook directly (not from a plugin)

pub fn register_pre_tool_hook(&mut self, hook: Arc<dyn PreToolHook>)

Register a pre-tool hook directly (not from a plugin)

pub fn hooks(&self) -> &HookManager

Access the hook manager

pub async fn call( &self, plugin: &str, method: &str, params: Value, ) -> Result<Value, PluginError>

Call a plugin method

pub fn list(&self) -> Vec<String>

List all plugins

pub fn info(&self, name: &str) -> Option<PluginInfo>

Get plugin info

pub async fn emit(&self, event: &LifecycleEvent)

Emit lifecycle event to all registered hooks

pub async fn check_pre_tool(&self, name: &str, arguments: &str) -> HookDecision

Run pre-tool checks

pub async fn notify_post_tool( &self, name: &str, arguments: &str, result: &ToolResult, )

Notify post-tool hooks

Trait Implementations

impl Default for PluginRegistry

fn default() -> Self

Returns the “default value” for a type.