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):- lukan-bridge - Node.js/Bun process using
whatsapp-web.js, exposes WebSocket atws://localhost:3001 - 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