docs: add Known Issues — /ocp Unknown skill workaround

Documented the intermittent "Unknown skill: ocp" issue caused by
OpenClaw gateway session routing bug (#26895). Workaround: /new
followed by /ocp restart.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-03-30 20:50:17 +10:00
co-authored by Claude Opus 4.6
parent 27cd8b1735
commit d9b7c0d905
+21
View File
@@ -317,6 +317,27 @@ openclaw gateway restart
- Session management with `--resume` - Session management with `--resume`
- Full tool access, system prompt, MCP config support - Full tool access, system prompt, MCP config support
## Known Issues
### `/ocp` command returns "Unknown skill: ocp"
The `/ocp` plugin command may intermittently stop working and return "Unknown skill: ocp". This is caused by an OpenClaw gateway bug where internal session routing interferes with plugin command dispatch ([openclaw/openclaw#26895](https://github.com/openclaw/openclaw/issues/26895)).
**Workaround:** Send `/new` to reset the session, then `/ocp restart` to restart the proxy:
```
/new
/ocp restart
```
This reliably restores the plugin. The issue may recur after some time — repeat the workaround as needed.
**Important:**
- Do **not** add `ocp` to agent `skills` lists in `openclaw.json` — this creates a routing conflict and makes the problem worse. OCP should only be registered as a **plugin**.
- Do **not** place a `SKILL.md` file in the workspace skills directory for ocp — same conflict.
We are tracking the upstream fix. This section will be updated when it is resolved.
## License ## License
MIT MIT