Skip to content

human-install.en.md

Latest commit

 

History

History
122 lines (83 loc) · 3.04 KB

human-install.en.md

File metadata and controls

122 lines (83 loc) · 3.04 KB

Human Install

中文版

npm release install

  1. Install the plugin.
openclaw plugins install @1panel-dev/clawswarm

If this step returns 429 Rate Limit Exceeded, ClawHub is rate-limiting. Do not stop here. Switch to manual npm installation instead:

cd /tmp
PKG=$(npm pack @1panel-dev/clawswarm)
mkdir -p /tmp/clawswarm-pkg
cd /tmp/clawswarm-pkg
tar xzf "/tmp/$PKG"

This extracts the package into /tmp/clawswarm-pkg/package/.

Then copy it into the OpenClaw extensions directory:

cp -r /tmp/clawswarm-pkg/package /home/node/.openclaw/extensions/clawswarm

If /home/node/.openclaw/extensions/clawswarm already exists, do not delete it blindly. Check the directory first. If it contains local changes, back it up before replacing it. For example:

ls -la /home/node/.openclaw/extensions/clawswarm
mv /home/node/.openclaw/extensions/clawswarm /home/node/.openclaw/extensions/clawswarm.bak.$(date +%Y%m%d-%H%M%S)
cp -r /tmp/clawswarm-pkg/package /home/node/.openclaw/extensions/clawswarm

Then install plugin dependencies:

cd /home/node/.openclaw/extensions/clawswarm
npm install --omit=dev

If you see missing config errors for baseUrl, outboundToken, or inboundSigningSecret at this step, do not stop. Continue to the config step.

  1. Enable the plugin.
openclaw plugins enable clawswarm

  1. Open the ClawSwarm client, go to the OpenClaw page, and create a new instance or edit an existing one.

  2. Fill in these values in the instance drawer:

  • OpenClaw URL Enter the current OpenClaw instance URL.
  • Gateway Token Enter the token currently used by the OpenClaw Gateway.
  1. Save the instance first.

After the instance is saved successfully, ClawSwarm will generate:

  • outboundToken
  • inboundSigningSecret

Only after that will the OpenClaw JSON Config become available to copy.

  1. Click the copy icon next to OpenClaw JSON Config in the instance drawer.

The client will generate the full OpenClaw config snippet, including:

  • plugins.allow
  • plugins.entries.clawswarm
  • skills
  • channels.clawswarm.accounts.default.baseUrl
  • outboundToken
  • inboundSigningSecret
  • gateway.baseUrl
  • webchatMirror.includeIntermediateMessages

You only need to fill in Gateway Token. The rest is generated by ClawSwarm.

  1. Open the OpenClaw config file.

Common path:

~/.openclaw/openclaw.json
  1. Merge the copied OpenClaw JSON Config into openclaw.json.

Notes:

  • Do not overwrite the whole file.
  • If plugins, skills, or channels already exist in openclaw.json, review and merge them carefully by hand.
  • plugins.allow does not support wildcards like ["*"].
  • You must explicitly list clawswarm.
  • Unknown plugin IDs will fail config validation.
  1. Restart the Gateway.
openclaw gateway restart
  1. Verify the installation.
openclaw plugins list
openclaw plugins inspect clawswarm
openclaw skills list

You should see:

  • clawswarm status is loaded
  • CS Chat skill (cs-chat) status is ready