From ecdd7bfb57c60c19ce11bde65174b0f9dce390cc Mon Sep 17 00:00:00 2001
From: Fsocietyhhh <1211904451@qq.com>
Date: Wed, 13 May 2026 13:19:08 -0700
Subject: [PATCH] docs: add `openclaw plugins enable` step to Options 2 & 3
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`openclaw plugins install` writes the install record (plugins.entries)
but does NOT add the plugin to plugins.allow — the whitelist the gateway
checks at startup to decide which plugins to actually load. Without an
explicit enable, users following Options 2 or 3 saw:

  $ openclaw plugins install @blockrun/xclawrouter
  $ openclaw gateway restart
  # plugin loaded? no.
  # register() called? no.
  # BlockRun provider injected into openclaw.json? no.
  # models in OpenClaw TUI picker? no — "no models available".

Reproduced live this afternoon. The fix is a single command:

  openclaw plugins enable xclawrouter

which appends "xclawrouter" to plugins.allow in openclaw.json and tells
the user to restart the gateway. With that line in place, the next
restart actually loads the plugin, register() runs, the provider gets
injected, and TUI sees blockrun models.

Option 1 doesn't need this addition because scripts/reinstall.sh and
scripts/update.sh both handle plugins.allow themselves.
---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 500c2c7..544d04e 100644
--- a/README.md
+++ b/README.md
@@ -96,6 +96,7 @@ npx @blockrun/xclawrouter setup        # email + OTP login to your OKX Agentic W
 
 ```bash
 openclaw plugins install @blockrun/xclawrouter
+openclaw plugins enable xclawrouter    # add to plugins.allow so the gateway loads it
 openclaw gateway restart
 npx @blockrun/xclawrouter setup        # email + OTP login to your OKX Agentic Wallet
 ```
@@ -104,6 +105,7 @@ npx @blockrun/xclawrouter setup        # email + OTP login to your OKX Agentic W
 
 ```bash
 npm install -g @blockrun/xclawrouter
+openclaw plugins enable xclawrouter    # add to plugins.allow so the gateway loads it
 openclaw gateway restart
 xclawrouter setup                      # email + OTP login to your OKX Agentic Wallet
 ```