hello-openclaw-plugin

Minimal OpenClaw Gateway plugin: one agent tool (hello_openclaw_ping) so you can confirm install on your VM.

Layout

• openclaw.plugin.json — manifest (id: hello-openclaw) + bundled skill path
• skills/hello-openclaw-verify/SKILL.md — tells the agent to call hello_openclaw_ping to verify install
• src/index.ts — definePluginEntry + registerTool
• package.json — openclaw.extensions points at ./src/index.ts

Install on your VM (after pushing to GitHub)

OpenClaw resolves npm-style specs (openclaw plugins install <spec>). It does not install straight from a raw Git URL the way npm install git+... might.

Option A — publish to npm (or private registry), then:

openclaw plugins install hello-openclaw-plugin
# or, if you use a scoped name:
# openclaw plugins install @your-scope/hello-openclaw-plugin
openclaw gateway restart

Option B — clone the repo on the VM and install from the folder:

git clone <your-repo-url> && cd <repo>/hello-openclaw-plugin
npm install
openclaw plugins install -l .
openclaw gateway restart

Option C — tarball / zip (see CLI plugins):

openclaw plugins install ./hello-openclaw-plugin.tgz

Verify

openclaw plugins list
openclaw plugins info hello-openclaw

In an agent session, ask something like: “Use the hello-openclaw verification steps and confirm the plugin is installed.” The bundled skill instructs the model to call hello_openclaw_ping; a successful reply includes hello-openclaw OK, pluginId=hello-openclaw, and version=….

Notes

The tool is registered as a normal (required) agent tool. If your gateway uses strict tool allowlists, ensure hello_openclaw_ping is allowed. See agent tools.