From 315cee96b9f853d469b0525a9d2375c9e412eb3e Mon Sep 17 00:00:00 2001
From: Josh Lehman <josh@martian.engineering>
Date: Sat, 14 Mar 2026 10:14:13 -0700
Subject: [PATCH] docs: add plugin installation steps to context engine page

Show the full workflow: install via openclaw plugins install,
enable in plugins.entries, then select in plugins.slots.contextEngine.
Uses lossless-claw as the concrete example.
---
 docs/concepts/context-engine.md | 28 +++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/docs/concepts/context-engine.md b/docs/concepts/context-engine.md
index ec769ca9d54..5c64bc42f3d 100644
--- a/docs/concepts/context-engine.md
+++ b/docs/concepts/context-engine.md
@@ -26,20 +26,42 @@ openclaw doctor
 cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'
 ```
 
-Switch engines:
+### Installing a context engine plugin
+
+Context engine plugins are installed like any other OpenClaw plugin. Install
+first, then select the engine in the slot:
+
+```bash
+# Install from npm
+openclaw plugins install @martian-engineering/lossless-claw
+
+# Or install from a local path (for development)
+openclaw plugins install -l ./my-context-engine
+```
+
+Then enable the plugin and select it as the active engine in your config:
 
 ```json5
 // openclaw.json
 {
   plugins: {
     slots: {
-      contextEngine: "lossless-claw", // or "legacy" (default)
+      contextEngine: "lossless-claw", // must match the plugin's registered engine id
+    },
+    entries: {
+      "lossless-claw": {
+        enabled: true,
+        // Plugin-specific config goes here (see the plugin's docs)
+      },
     },
   },
 }
 ```
 
-Restart the gateway after changing the slot.
+Restart the gateway after installing and configuring.
+
+To switch back to the built-in engine, set `contextEngine` to `"legacy"` (or
+remove the key entirely — `"legacy"` is the default).
 
 ## How it works