OpenClaw Plugin

OpenClaw Plugin

Manage your Linux and Windows servers from OpenClaw using natural language. 33 tools to run tasks and scans, search your fleet and act on cloud VMs. Works with any LLM model.

Overview

OpenClaw is an open-source personal AI assistant that runs locally. The ManageLM plugin gives it the same tools ManageLM gives Claude through MCP, so you can manage your entire server infrastructure in natural language with 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

34 Built-in Tools

Modelled on the ManageLM MCP tools, with a managelm_ prefix: tasks, scans, fleet searches, hosting actions, task history and revert.

Any LLM Model

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

Interactive Tasks

When an agent needs a domain name, a password or a choice, OpenClaw asks you and answers the task.

Scans That Wait

Security, inventory, access, certificate and activity scans run on a server and return their result.

Fleet Search

Inventory, security issues, logins, SSH keys, sudo rules, certificates, monitors, backups, credentials, keystore and cloud resources, without dispatching commands.

Webhook Events

Signed ManageLM events logged in the gateway: servers going offline, failed tasks, monitors down, certificate renewals and more.

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, created in your ManageLM portal under Settings > MCP & API > API Keys. The key acts as you, limited to the authorizations you tick: add Reports for scans, Hosting for VM actions, Credentials or Keystore to search those.

  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 33 tools, modelled on the ManageLM MCP tools. Tasks and scans run on one server at a time. Approving agents, users, API keys and webhooks are managed in the portal.

Servers & Account

ToolDescription
managelm_search_agentsServers by status, group, site, health metrics or text
managelm_get_agent_infoOne server: OS, health, skills, recent tasks
managelm_get_agent_skillsSkills assigned to a server
managelm_list_available_skillsCatalog skills not yet imported
managelm_get_account_infoAccount, groups and sites
managelm_list_team_membersTeam members with role, permissions and SSH key status

Tasks

ToolDescription
managelm_run_taskRun a skill-based task on one server (auto lets the agent pick the skill)
managelm_answer_taskAnswer a task waiting for input
managelm_follow_up_taskContinue the conversation of a completed task
managelm_get_task_statusStatus and result of a task
managelm_get_task_historyRecent tasks on a server, optionally within a time range
managelm_get_task_changesFiles changed by a task, with an optional full diff
managelm_revert_taskUndo the file changes of a task

A task waits up to 2 minutes. A longer one returns its task ID, and OpenClaw checks it later with managelm_get_task_status.

Scans

ToolDescription
managelm_run_security_auditSecurity audit (SSH, firewall, ports, users, TLS, kernel)
managelm_run_inventory_scanInventory scan (services, packages, containers, network, storage)
managelm_run_access_scanSSH authorized keys and sudo rules, or Windows local accounts
managelm_run_certificate_scanCertificate discovery (metadata only, never private keys)
managelm_run_activity_scanLogins, failed logins, sudo commands and file changes over the last 24 hours

Search (read-only, no commands dispatched)

ToolDescription
managelm_search_inventoryServices, packages and containers across servers
managelm_search_securitySecurity issues from audits, pentests and threat alerts
managelm_search_activityLogins, failed logins, sudo commands and file changes
managelm_search_ssh_keysSSH keys mapped to your team members
managelm_search_sudo_rulesSudo rules and Windows administrators
managelm_search_certificatesCertificates found on servers: expired, expiring, weak, self-signed
managelm_search_pkiCertificates ManageLM issues and renews
managelm_search_monitorsMonitors with their current status
managelm_search_backupsBackups with their last run
managelm_search_credentialsRotating credentials (metadata only, requires the Credentials authorization)
managelm_search_keystoreKeystore keys, applications and usage (metadata only, requires the Keystore authorization)

Hosting

ToolDescription
managelm_list_connectorsHosting connectors with sync status
managelm_search_cloudVMs, volumes, networks and security groups discovered by connectors
managelm_get_cloud_infoOne resource and the actions its connector allows
managelm_cloud_actionStart, shut down, reboot or snapshot a VM. Disruptive actions need your confirmation.

Skills

When using managelm_run_task, you specify a skill that determines what the agent can do. OpenClaw reads the skills assigned to the server with managelm_get_agent_skills, or passes auto to let the agent choose. Common skills:

SkillDescription
baseRead files, system info, resource monitoring, network diagnostics
systemOS config, performance tuning, hostname, timezone, kernel parameters
packagesInstall, remove and update packages
servicesServices, processes and scheduled tasks
usersUser accounts, groups, SSH keys, sudo, password policies
networkInterfaces, routes, DNS, ports, connectivity testing
securityHardening, fail2ban, SSH, SELinux/AppArmor
filesRead, write and manage files
firewalliptables, nftables, firewalld, ufw, Windows Firewall
containersDocker, Podman, Compose and Kubernetes
webserverApache, Nginx, IIS: virtual hosts, reverse proxy, TLS
databaseMySQL, MariaDB, PostgreSQL, SQL Server
certificatesLet's Encrypt, self-signed, inspection, renewal
backupCreate, schedule, restore and verify backups
storageDisks, volumes, partitions, LVM, encryption
dns / vpnDNS servers, VPNs and tunnels

The full catalog also covers Active Directory, email, LDAP, monitoring, proxies, virtualization and more. managelm_list_available_skills lists the ones not yet imported into your account.

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
who logged in to db-primary yesterday?
which certificates expire this month?

Webhooks

Optionally receive real-time events from ManageLM. The plugin exposes a /managelm/webhook HTTP route on the OpenClaw gateway and logs each event it receives.

  1. An admin adds a webhook in the portal under Settings > MCP & API > Webhooks, pointing to your gateway's /managelm/webhook endpoint, with the event categories to send and an HMAC secret

  2. Set the same secret in the plugin:

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

Every delivery is checked against its X-Webhook-Signature header, and one sent more than 5 minutes ago is refused so a captured delivery cannot be replayed. Without a secret configured, deliveries are refused, so a misconfiguration shows up as failed deliveries in the portal. Event categories:

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 the key's owner cannot see them: a key sees the servers its owner sees. 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 33 tools. If not, reinstall with openclaw plugins install managelm --force.