From 8ea0feeb5543787134f63a9a1b41b7c061c4a151 Mon Sep 17 00:00:00 2001 From: dtzp555 Date: Tue, 24 Mar 2026 20:05:01 +1000 Subject: [PATCH] Add upgrade guide for v2.x skill-based users Explains how to remove the old skills/ocp/SKILL.md to avoid conflicts with the new plugin-based command handler. Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index f659af3..dca887d 100644 --- a/README.md +++ b/README.md @@ -148,6 +148,21 @@ Then add to `openclaw.json`: Restart the gateway and `/mc --help` should work. +### Upgrading from v2.x (skill-based /ocp) + +If you previously used the skill-based `/ocp` command (via `skills/ocp/SKILL.md`), you need to remove it to avoid conflicts with the new plugin-based command handler: + +```bash +# Remove the old skill (it conflicts with the plugin command) +rm -rf ~/.openclaw/workspace/main/skills/ocp + +# Restart gateway +launchctl kickstart -k gui/501/ai.openclaw.gateway # macOS +# or: systemctl --user restart openclaw-gateway # Linux +``` + +**Why?** The old skill-based approach routed `/ocp` to the agent as a prompt, which required model invocation and was slow. The new plugin-based approach handles commands directly in the gateway — instant response, no model cost. If both exist, the skill takes priority and the plugin is never reached, causing "Unknown skill" errors. + ## Configuration The plugin works with zero configuration. Optional settings in `openclaw.json`: