bereach-openclaw 0.2.10 → 0.2.11

package/README.md

@@ -10,14 +10,22 @@ openclaw plugins install bereach-openclaw
 
 ## Upgrade
 
-`openclaw plugins update bereach` can leave `node_modules` and `extensions/` out of sync (version mismatch → trim/crash errors). **Use uninstall + reinstall** instead:
+`openclaw plugins update bereach` can leave `node_modules` and `extensions/` out of sync (version mismatch → trim/crash errors). **Use uninstall + reinstall** instead.
+
+**Before upgrading:** note your `BEREACH_API_KEY` — uninstall may remove `plugins.entries.bereach`.
 
 ```bash
+# 1. Uninstall
 openclaw plugins uninstall bereach
+
+# 2. Reinstall latest
 openclaw plugins install bereach-openclaw
+
+# 3. Re-add config (API key + plugins.allow) in openclaw.json — see Setup above
+# 4. Restart the Gateway
 ```
 
-Then restart the Gateway. Verify versions match:
+Verify versions match:
 ```bash
 cat /data/.openclaw/node_modules/bereach-openclaw/package.json | grep version
 cat /data/.openclaw/extensions/bereach/package.json | grep version
@@ -41,14 +49,11 @@ The API key can be set in 3 ways (in order of precedence):
         }
       }
     }
-  },
-  "tools": {
-    "allow": ["bereach"]
   }
 }
 ```
 
-> **Note:** `plugins.allow` loads the plugin; `tools.allow` enables the tools (they are registered with `optional: true`).
+> **Note:** `plugins.allow` loads the plugin. Tools are auto-enabled when the plugin is loaded (no `tools.allow` needed).
 
 **Skills + model (optional)** — `skills.entries` has no `model` field; model is set at the agent level. To use Sonnet for BeReach:
 
@@ -78,6 +83,20 @@ Restart the Gateway after configuring.
 
 ## Troubleshooting
 
+### BeReach tools (`bereach_*`) not visible in my session
+
+The plugin is loaded but tools don't appear in the agent's tool list. Common causes:
+
+1. **Plugin installed after session started** — Existing sessions don't pick up new tools.
+2. **Gateway not restarted** — Config changes require a restart.
+
+**Fix:**
+```bash
+openclaw gateway restart
+# Then start a NEW session (e.g. new Telegram chat)
+# Test: "Utilise bereach_get_credits"
+```
+
 ### "Cannot read properties of undefined (reading 'trim')" or "plugin disabled (not in allowlist)"
 
 OpenClaw loads plugins from **two locations**:

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "bereach",
   "name": "BeReach",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "description": "LinkedIn outreach automation — 33 tools, auto-reply commands, campaign monitoring",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bereach-openclaw",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "description": "BeReach LinkedIn automation plugin for OpenClaw",
   "license": "AGPL-3.0",
   "scripts": {

package/src/tools/index.ts

@@ -4,25 +4,22 @@ import { definitions } from "./definitions";
 /**
  * Registers all 33 BeReach tools with the OpenClaw agent.
  * Format per https://docs.openclaw.ai/plugins/agent-tools
- * optional: true — tools have side effects (messages, connections) and require BEREACH_API_KEY
+ * Tools are required (not optional) — auto-enabled when plugin is loaded. Simpler UX: no tools.allow needed.
  */
 export function registerAllTools(api: any) {
   for (const def of definitions) {
-    api.registerTool(
-      {
-        name: def.name,
-        description: def.description,
-        parameters: def.parameters,
-        async execute(_id: string, params: Record<string, unknown>) {
-          const client = getClient();
-          const [resource, method] = def.handler.split(".");
-          const result = await (client as any)[resource][method](params);
-          return {
-            content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }],
-          };
-        },
+    api.registerTool({
+      name: def.name,
+      description: def.description,
+      parameters: def.parameters,
+      async execute(_id: string, params: Record<string, unknown>) {
+        const client = getClient();
+        const [resource, method] = def.handler.split(".");
+        const result = await (client as any)[resource][method](params);
+        return {
+          content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }],
+        };
       },
-      { optional: true },
-    );
+    });
   }
 }