OpenClaw Plugin

OpenClaw Plugin

Manage your Linux and Windows servers from OpenClaw using natural language. 17 tools for server management, security audits, inventory scans, and cross-fleet search — works with any LLM model.

Table of Contents

Overview

OpenClaw is an open-source personal AI assistant that runs locally. The ManageLM plugin adds 17 tools that let you manage your entire server infrastructure using natural language — from any LLM model (Claude, GPT, Gemini, Llama, and more).

You describe what you need in plain English. OpenClaw selects the right tool, sends the instruction to the agent running on your server via the ManageLM portal, and returns the result.

Features

17 Built-in Tools

List servers, run tasks, check status, view security findings, scan inventory, search SSH keys, and more.

Any LLM Model

Works with Claude, GPT, Gemini, Llama, or any model supported by OpenClaw. Tools are model-agnostic.

Security Audits

Run security audits on any server and review findings with severity levels, explanations, and remediation.

Inventory Scans

Discover installed packages, running services, and containers across your servers.

Cross-Fleet Search

Search inventory, security findings, SSH keys, and sudo rules across all servers without dispatching commands.

Webhook Events

Real-time alerts when agents go online/offline, tasks complete or fail, and new servers enroll.

Architecture

OpenClaw (any LLM) ── REST API ──> ManageLM Portal ── WebSocket ──> Agent on Server Plugin tools (cloud control (outbound only, (local LLM, plane) no inbound ports) skill execution)

The plugin communicates with the ManageLM portal via REST API. The portal dispatches tasks to agents over WebSocket. Agents execute tasks using a local LLM and report results back. No SSH, no inbound ports on your servers.

Installation

From ClawHub

terminal
openclaw plugins install managelm

From Downloaded Package

Download the tarball from GitHub Releases and install locally:

terminal
openclaw plugins install managelm-openclaw-1.0.0.tar.gz

Setup

The plugin uses an API key for authentication. Configure it via the OpenClaw CLI:

  1. Set your API Key — find it in your ManageLM portal under Settings > MCP & API

  2. Trust the plugin: openclaw config set plugins.allow '["managelm"]'

  3. Enable tools: openclaw config set tools.allow '["managelm"]' and openclaw config set tools.profile "full"

  4. Restart the gateway and start a fresh session

terminal
# Set API key
openclaw config set plugins.entries.managelm.config.apiKey "mlm_ak_your_key"

# Trust plugin and enable tools
openclaw config set plugins.allow '["managelm"]'
openclaw config set tools.allow '["managelm"]'
openclaw config set tools.profile "full"

# Restart gateway
openclaw gateway stop
openclaw gateway

Self-hosted users: Set the Portal URL to your own portal address: openclaw config set plugins.entries.managelm.config.portalUrl "https://portal.example.com"

Available Tools

The plugin provides 17 tools that OpenClaw's agent uses to interact with your infrastructure:

Server Management

ToolDescription
managelm_agentsList all servers with status, health metrics, OS info, and IP addresses
managelm_agent_infoGet detailed information about a specific server
managelm_runExecute a skill-based task on a server (requires target, skill, instruction)
managelm_answer_taskAnswer an interactive task question (agent needs input)

Task Tracking

ToolDescription
managelm_task_statusCheck status and result of a task by its ID
managelm_task_historyView recent tasks for a server
managelm_task_changesView file changes made by a task
managelm_revert_taskRevert file changes from a previous task

Audits & Scans

ToolDescription
managelm_security_auditRun a security audit (SSH, firewall, ports, TLS, Docker, kernel)
managelm_inventory_scanRun an inventory scan (services, packages, containers, storage)

Search (read-only, no commands dispatched)

ToolDescription
managelm_search_agentsSearch servers by health metrics, OS, status, or group
managelm_search_inventorySearch installed packages, running services, and containers
managelm_search_securitySearch security audit findings by severity or category
managelm_search_ssh_keysSearch SSH keys across infrastructure with identity mapping
managelm_search_sudoSearch sudo privileges across all servers

Utility

ToolDescription
managelm_accountGet account plan, usage limits, and consumption details
managelm_send_emailSend an email report or summary to yourself

Skills

When using managelm_run, you specify a skill that determines what the agent can do. The LLM automatically selects the right skill based on your request.

SkillDescription
baseRead files, system info, resource monitoring, network diagnostics
systemOS config, performance tuning, hostname, timezone, kernel parameters
packagesInstall, remove, update packages across apt/dnf/yum/pacman
servicesSystemd units, cron jobs, logs, process management
usersUser accounts, groups, SSH keys, sudo, password policies
networkInterfaces, routes, DNS, ports, connectivity testing
securityAudits, fail2ban, SSH hardening, SELinux/AppArmor, SSL/TLS
filesRead, write, and manage files on remote servers
firewalliptables, nftables, firewalld, ufw
dockerContainers, images, compose, volumes, networks
apacheVirtual hosts, modules, SSL, configuration
nginxServer blocks, reverse proxy, SSL, load balancing
mysqlDatabases, users, queries, backups, replication
postgresqlDatabases, roles, queries, backups, extensions
backupCreate, schedule, restore, verify backups
certificatesLet's Encrypt, self-signed, inspection, renewal
gitClone, pull, status, log on remote servers

Tip: You don't need to know skill names. Just describe what you want — "install nginx on web-01" — and the LLM will select the right skill automatically.

Example Usage

Open the OpenClaw TUI and type your request naturally:

openclaw tui
# Server overview
list my servers
which servers have CPU above 80%?

# System administration
check disk usage on web-prod-01
list running services on lb-01

# Package management
install nginx on web-prod-01
update all packages on db-primary

# Security
run a security audit on db-primary
show me all critical security findings

# Infrastructure search
search inventory for postfix
who has SSH access to production servers?
show all NOPASSWD sudo rules

Webhooks

Optionally receive real-time events from ManageLM. The plugin exposes a /managelm/webhook HTTP route on the OpenClaw gateway that accepts HMAC-signed events.

terminal
openclaw config set plugins.entries.managelm.config.webhookSecret "whsec_your_secret"

Point a ManageLM webhook (Portal > Settings > Webhooks) to your gateway's /managelm/webhook endpoint. Supported events:

Security

Requirements

Troubleshooting

API key not configured

Run openclaw config set plugins.entries.managelm.config.apiKey "mlm_ak_...". You can find your key in the portal under Settings > MCP & API.

Tools not available to the agent

Make sure plugin tools are enabled: openclaw config set tools.allow '["managelm"]' and openclaw config set tools.profile "full". Restart the gateway after changes.

Agent says "command not found"

Start a fresh session — type /new in the TUI or use openclaw tui --session fresh. Old sessions may have cached failed responses.

Connection refused or timeout

Verify the portal URL is correct. The default is https://app.managelm.com. If self-hosting, set your portal URL in the plugin config.

No agents listed

Either no agents are enrolled, or your API key doesn't have access. Check the portal dashboard to verify agents are enrolled and online.

Plugin not loading

Run openclaw plugins inspect managelm to check plugin status. Ensure it shows "Status: loaded" and lists 17 tools. If not, reinstall with openclaw plugins install managelm --force.