@maniflow/connect

Connect your OpenClaw instance to Maniflow Beacon with one command.

Usage

npx @maniflow/connect <INVITE-CODE>

Your organization's Beacon administrator will provide you with an invite code.

What it does

1. Finds your OpenClaw installation - Looks for config in ~/.openclaw/ or current directory
2. Connects to Beacon - Exchanges the invite code for credentials
3. Shows a verification code - You'll see a code like PINE-7392 that your admin can verify
4. Waits for approval - Your admin approves the connection in Beacon
5. Configures OpenClaw - Writes the Beacon plugin configuration
6. Restarts the gateway - Your bot comes online in Beacon

Example

$ npx @maniflow/connect ABCD-1234-WXYZ

🔍 Found OpenClaw at /Users/you/.openclaw/config.yaml
📡 Connecting to Beacon...

┌────────────────────────────────────────┐
│                                        │
│   Verify this code matches:            │
│                                        │
│          🔐 PINE-7392                  │
│                                        │
│   Check the Maniflow dashboard to      │
│   confirm this connection is real.     │
│                                        │
└────────────────────────────────────────┘

Waiting for approval... ✓
✓ Approved by [email protected]
✓ Configuration saved
⟳ Restarting OpenClaw...
✓ Restarted

🎉 Connected to Acme Corp!

Your bot is now online at Beacon.
Run `openclaw status` to check connection.

Security

• Open source - This package is fully auditable on GitHub
• No embedded secrets - All credentials come from Beacon during the connection flow
• Verification code - The pairing code ensures you're connecting to the right organization
• Admin approval - Your organization's admin must explicitly approve the connection

Requirements

• Node.js 18 or later
• OpenClaw installed and configured

Manual configuration

If you prefer not to use this tool, you can manually configure the Beacon plugin:

1. Add to your ~/.openclaw/config.yaml:

plugins:
  maniflow-beacon:
    enabled: true
    env:
      MC_CONVEX_URL: "https://your-tenant.convex.cloud"
      MC_API_TOKEN: "your-api-token"
      MC_GATEWAY_ID: "your-gateway-id"
      MC_HOOKS_TOKEN: "your-hooks-token"

2. Restart OpenClaw: openclaw gateway restart

License

MIT