BeReach — OpenClaw Plugin

LinkedIn outreach automation via BeReach. Registers 33 in-process tools and auto-reply commands.

Install

openclaw plugins install bereach-openclaw

Post-install checklist

1. Configure — Add BEREACH_API_KEY to openclaw.json (see 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-openclaw 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-openclaw.

# 1. Uninstall
openclaw plugins uninstall bereach-openclaw

# 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)

Verify versions match:

cat /data/.openclaw/node_modules/bereach-openclaw/package.json | grep version
cat /data/.openclaw/extensions/bereach-openclaw/package.json | grep version

Setup

The API key can be set in 3 ways (in order of precedence):

1. OpenClaw config (recommended) — ~/.openclaw/openclaw.json or /data/.openclaw/openclaw.json:

{
  "plugins": {
    "allow": ["bereach-openclaw"],
    "entries": {
      "bereach-openclaw": {
        "enabled": true,
        "config": {
          "BEREACH_API_KEY": "brc_your_token_here"
        }
      }
    }
  }
}

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:

{
  "skills": {
    "entries": {
      "bereach": { "enabled": true }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-sonnet-4-5" },
      "models": {
        "anthropic/claude-sonnet-4-5": { "alias": "sonnet" }
      }
    }
  }
}

2. Environment variable — BEREACH_API_KEY=brc_xxx in your shell or export BEREACH_API_KEY="brc_xxx" in ~/.bashrc.

3. Docker — pass via -e when launching the container: docker run -e BEREACH_API_KEY=brc_xxx ...

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:

• node_modules/bereach-openclaw/ — the npm package (source)
• extensions/bereach-openclaw/ — the active copy OpenClaw uses at runtime

If extensions/bereach-openclaw/ is corrupt or incomplete, you get trim/undefined errors. Fix:

1. Backup and remove the active extension:

mv /data/.openclaw/extensions/bereach-openclaw /data/.openclaw/extensions/bereach-openclaw.bak.$(date +%s)

2. Reinstall from npm (inside the container):

cd /data/.openclaw
npm i bereach-openclaw@latest

3. Restart OpenClaw so it rebuilds extensions/bereach-openclaw/ from the package.

4. If extensions/bereach-openclaw/ is still incomplete after restart, force a symlink:

rm -rf /data/.openclaw/extensions/bereach-openclaw
ln -s /data/.openclaw/node_modules/bereach-openclaw /data/.openclaw/extensions/bereach-openclaw
# then restart the container

5. Verify — compare the two manifests:

wc -l /data/.openclaw/extensions/bereach-openclaw/openclaw.plugin.json
wc -l /data/.openclaw/node_modules/bereach-openclaw/openclaw.plugin.json

They should match. Per OpenClaw Plugin Manifest, tools are registered at runtime via api.registerTool().

Usage

Tools (33 registered)

All BeReach operations are available as agent tools — the agent uses them automatically based on your requests. No MCP needed; tools run in-process via the bereach SDK.

Auto-reply commands

These execute instantly without invoking the AI:

| Command | Description | | --- | --- | | /bereach-credits | Show current credit balance | | /bereach-status | Show LinkedIn rate limit summary | | /bereach-limits | Show detailed per-action rate limits |

CLI

openclaw bereach status

What's included

| Component | Description | | --- | --- | | src/tools/ | 33 tool definitions generated from OpenAPI | | src/commands/ | Auto-reply commands + CLI | | skills/bereach/SKILL.md | Main behavioral skill | | skills/bereach/sub/lead-magnet.md | Lead magnet workflow | | skills/bereach/sdk-reference.md | SDK method reference | | skills/bereach/openclaw-optimization.md | OpenClaw cost optimization guide |