Skip to content

human-install.zh-CN.md

Latest commit

 

History

History
138 lines (93 loc) · 3.73 KB

human-install.zh-CN.md

File metadata and controls

138 lines (93 loc) · 3.73 KB

Human Install 中文版

English

npm 发布版安装

要求：

  • OpenClaw 2026.5.5+。
  • 安装包内必须包含 dist/index.js、dist/setup-entry.js、openclaw.plugin.json、skills/cs-chat。
  1. 安装插件。
openclaw plugins install @1panel-dev/clawswarm

如果这一步出现 429 Rate Limit Exceeded，说明 ClawHub 限流了。不要停在这里，直接改走 npm 手动安装：

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

这会把安装包解压到 /tmp/clawswarm-pkg/package/。

然后复制到 OpenClaw extensions 目录：

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

如果 /home/node/.openclaw/extensions/clawswarm 已经存在，不要直接删除。请先检查目录内容；如果里面有你自己改过的文件，先备份，再替换。可参考：

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

最后安装插件依赖：

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

如果此时出现 baseUrl、outboundToken、inboundSigningSecret 缺失报错，不用停止，继续下一步配置。

  1. 启用插件。
openclaw plugins enable clawswarm

  1. 打开 ClawSwarm 客户端，进入 OpenClaw 页面，先创建实例或编辑已有实例。

  2. 在实例抽屉里填写这些内容：

  • OpenClaw URL 填当前 OpenClaw 实例地址。
  • Gateway Token 填当前 OpenClaw Gateway 正在使用的 token。
  1. 先保存实例。

实例保存成功后，ClawSwarm 才会为这个实例生成：

  • outboundToken
  • inboundSigningSecret

之后，实例抽屉里才会出现可复制的 OpenClaw JSON 配置。

  1. 在实例抽屉里点击 OpenClaw JSON 配置 右侧的复制图标。

这时客户端会自动生成我们的 OpenClaw JSON 配置，内容包括：

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

你只需要补 Gateway Token，其余值由 ClawSwarm 自动生成。

  1. 打开 OpenClaw 配置文件。

常见位置：

~/.openclaw/openclaw.json
  1. 把刚才从 ClawSwarm 客户端复制出来的 OpenClaw JSON 配置合并到 openclaw.json 里。

注意：

  • 不要把整个文件直接覆盖掉。
  • 如果 openclaw.json 里已经存在 plugins、skills 或 channels，请务必先仔细检查，再手动合并。
  1. 重启 Gateway。
openclaw gateway restart
  1. 验证安装。
openclaw plugins list
openclaw plugins inspect clawswarm
openclaw skills list

正常情况下，应该能看到：

  • clawswarm 状态为 loaded
  • CS Chat 技能（cs-chat）状态为 ready

可选的安装包检查：

node -e "const p=require('./package.json'); console.log(p.openclaw)"
ls dist/index.js dist/setup-entry.js skills/cs-chat/SKILL.md

排障：

  • 配置页面无法显示：确认 openclaw.plugin.json 中存在 channelConfigs.clawswarm。
  • 工具存在但技能还是旧的：重启 OpenClaw，并确认 openclaw skills list 中能看到 cs-chat。
  • 安装或更新后只有源码入口：确认插件目录下存在 dist/index.js 和 dist/setup-entry.js。
  • setup 阶段能加载但 runtime 阶段不能加载：检查 package.json 中的 openclaw.runtimeExtensions 和 openclaw.runtimeSetupEntry 是否指向存在的构建文件。