bereach-openclaw 0.2.10 → 0.2.13

package/README.md

@@ -1,6 +1,6 @@
 # BeReach — OpenClaw Plugin
 
-LinkedIn outreach automation via [BeReach](https://berea.ch). Registers 33 in-process tools, auto-reply commands, and a campaign monitoring service.
+LinkedIn outreach automation via [BeReach](https://berea.ch). Registers 33 in-process tools and auto-reply commands.
 
 ## Install
 
@@ -8,16 +8,31 @@ LinkedIn outreach automation via [BeReach](https://berea.ch). Registers 33 in-pr
 openclaw plugins install bereach-openclaw
 ```
 
+## Post-install checklist
+
+1. **Configure** — Add `BEREACH_API_KEY` to `openclaw.json` (see [Setup](#setup)).
+2. **Restart** — `openclaw gateway restart`
+3. **New session** — Type `/new` in Telegram or chat so the agent sees the tools (existing sessions don't pick up new plugins).
+
 ## 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
+# 5. /new in Telegram or chat (new session picks up the plugin)
 ```
 
-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 +56,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:
 
@@ -76,8 +88,18 @@ The API key can be set in 3 ways (in order of precedence):
 
 Restart the Gateway after configuring.
 
+**Important:** After install or restart, start a **new session** so the agent sees the tools. In Telegram or chat: type `/new`. Existing sessions don't pick up new plugins.
+
 ## Troubleshooting
 
+### BeReach tools (`bereach_*`) not visible in my session
+
+**First try:** `/new` in Telegram or chat — new sessions pick up plugins; old ones don't.
+
+If that doesn't work:
+- Restart the Gateway: `openclaw gateway restart`
+- Then `/new` again
+
 ### "Cannot read properties of undefined (reading 'trim')" or "plugin disabled (not in allowlist)"
 
 OpenClaw loads plugins from **two locations**:
@@ -135,17 +157,12 @@ These execute instantly without invoking the AI:
 openclaw bereach status
 ```
 
-### Campaign monitor
-
-A background service polls active campaigns every 5 minutes and logs activity deltas (new actions since last check).
-
 ## What's included
 
 | Component | Description |
 | --- | --- |
 | `src/tools/` | 33 tool definitions generated from OpenAPI |
 | `src/commands/` | Auto-reply commands + CLI |
-| `src/services/` | Campaign monitoring service |
 | `skills/bereach/SKILL.md` | Main behavioral skill |
 | `skills/bereach/sub/lead-magnet.md` | Lead magnet workflow |
 | `skills/bereach/sdk-reference.md` | SDK method reference |

package/openclaw.plugin.json

@@ -1,13 +1,10 @@
 {
   "id": "bereach",
   "name": "BeReach",
-  "version": "0.2.10",
-  "description": "LinkedIn outreach automation — 33 tools, auto-reply commands, campaign monitoring",
+  "version": "0.2.13",
+  "description": "LinkedIn outreach automation — 33 tools, auto-reply commands",
   "configSchema": {
     "type": "object",
-    "required": [
-      "BEREACH_API_KEY"
-    ],
     "additionalProperties": false,
     "properties": {
       "BEREACH_API_KEY": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bereach-openclaw",
-  "version": "0.2.10",
+  "version": "0.2.13",
   "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 },
-    );
+    });
   }
 }

package/src/types/bereach.d.ts

@@ -1,15 +0,0 @@
-declare module "bereach" {
-  interface BereachOptions {
-    token: string;
-  }
-
-  export class Bereach {
-    constructor(options: BereachOptions);
-    linkedinScrapers: Record<string, (params: any) => Promise<any>>;
-    linkedinActions: Record<string, (params: any) => Promise<any>>;
-    linkedinChat: Record<string, (params: any) => Promise<any>>;
-    linkedinSearch: Record<string, (params: any) => Promise<any>>;
-    profile: Record<string, (params?: any) => Promise<any>>;
-    campaigns: Record<string, (params: any) => Promise<any>>;
-  }
-}