MonClaw is a minimal implementation of OpenClaw using the OpenCode SDK.

• Telegram adapter (grammy)
• WhatsApp adapter (baileys)
• Single markdown memory file (MEMORY.md) loaded on every message
• Proactive memory updates via an OpenCode plugin tool (save_memory)
• Heartbeat task runner (periodic checklist from heartbeat.md)
• Channel-level whitelist with disk persistence

This project is set up to reuse OpenCode's existing auth mechanisms.

• Default path: uses createOpencode(...) so SDK starts/manages a local OpenCode server and uses OpenCode auth/config.
• Alternate path: set OPENCODE_SERVER_URL to connect to an already-running OpenCode server/client setup.
• No app-specific API key is required in this repo.

1. Install Bun and dependencies:

# install bun
curl -fsSL https://bun.com/install | bash

# clone repo
git clone https://github.com/CefBoud/MonClaw.git && cd MonClaw

# install
bun install

2. Log in using the OpenCode CLI:

bun run opencode auth login

Then open the TUI with bun run opencode and pick a model using /models.

3. Create the env file:

cp .env.example .env

4. Fill required values in .env (manually or via the setup script below):

• TELEGRAM_BOT_TOKEN (if Telegram enabled)

Optional:

• OPENCODE_MODEL in provider/model format
• ENABLE_WHATSAPP=true
• HEARTBEAT_INTERVAL_MINUTES (default 30)
• HEARTBEAT_FILE (default .data/heartbeat.md; empty file disables heartbeat)
• WHITELIST_FILE (default .data/whitelist.json)
• WHITELIST_PAIR_TOKEN (required for self-pairing via chat command)

5. Run:

bun run dev

To keep it running after an SSH session ends:

nohup bun run dev > monclaw.log 2>&1 &
disown

Run the interactive setup to configure channels and auth:

bun run setup

This will:

• Enable Telegram and/or WhatsApp
• Capture bot token or QR login
• Update .env
• Check OpenCode model auth (launches opencode if missing)

Run a local end-to-end check that starts its own OpenCode server via SDK, sends a prompt, and verifies a model reply:

bun run test:opencode:e2e

In Telegram / WhatsApp chat:

• /remember <text>: force-save durable memory in .data/workspace/MEMORY.md
• /pair <token>: add your account to whitelist (if pairing token is configured)
• /new: start a new shared main OpenCode session across all channels
• Any normal message: sent to OpenCode SDK session, with relevant memory context injected

• .data/sessions.json: shared mainSessionID + separate heartbeatSessionID
• .data/workspace/MEMORY.md: durable user memory (single memory file)
• .data/whatsapp-auth: Baileys auth state
• .data/whitelist.json: allowed Telegram/WhatsApp accounts

• Warning: This project is experimental. Use at your own risk and exercise extreme care and caution, especially in production or with sensitive data.