From f6f4f68ecdf2cfa7e48d2351b6a776132b1d1d18 Mon Sep 17 00:00:00 2001 From: dtzp555 Date: Tue, 24 Mar 2026 20:07:29 +1000 Subject: [PATCH] Add upgrade guide for v2.x skill-based /ocp users Explains removing old skills/ocp/SKILL.md to avoid conflict 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 7f5558f..41b3504 100644 --- a/README.md +++ b/README.md @@ -165,6 +165,21 @@ Add to `~/.openclaw/openclaw.json`: Restart the gateway: `openclaw gateway restart` +### Upgrading from v2.x (skill-based /ocp) + +If you previously used the skill-based `/ocp` command (via `skills/ocp/SKILL.md`), remove it to avoid conflicts: + +```bash +# Remove the old skill +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 routed `/ocp` to the agent as a prompt (slow, costs tokens). The new plugin handles commands directly in the gateway (instant, free). If both exist, the skill takes priority and you get "Unknown skill" errors. + ## API Endpoints | Endpoint | Method | Description |