Skip to main content
WhatsApp is available as a plugin. Install it with lukan plugin install-remote or from the Web UI plugin manager.

Architecture

Two-process design (via plugin):
  1. lukan-bridge - Node.js/Bun process using whatsapp-web.js, exposes WebSocket at ws://localhost:3001
  2. lukan whatsapp - Agent process connecting to the bridge

Setup

Commands

Features

  • Whitelist-only - Only processes messages from whitelisted numbers or allowed groups
  • Prefix filtering - Optional prefix (e.g., /lukan) required to trigger the agent
  • Voice transcription - Uses OpenAI Whisper for audio messages
  • Directory restrictions - File tools blocked unless directories are explicitly allowed
  • Hidden file blocking - .env, .git/, etc. always blocked
  • Group support - Allowed by full chat ID (e.g., 123456789@g.us)
  • Email confirmation - Requires explicit user confirmation before sending emails
  • Reminder notifications - Proactive notifications sent to configured chat

Configuration

Default Tools

Grep, Glob, ReadFiles, WebSearch, WebFetch