Platforms
Velaclaw core is written in TypeScript. Node is the recommended runtime. Bun is not recommended for the Gateway (WhatsApp/Telegram bugs). Companion apps exist for macOS (menu bar app) and mobile nodes (iOS/Android). Windows and Linux companion apps are planned, but the Gateway is fully supported today. Native companion apps for Windows are also planned; the Gateway is recommended via WSL2.Choose your OS
VPS & hosting
- VPS hub: VPS hosting
- Fly.io: Fly.io
- Hetzner (Docker): Hetzner
- GCP (Compute Engine): GCP
- Azure (Linux VM): Azure
- exe.dev (VM + HTTPS proxy): exe.dev
Common links
- Install guide: Getting Started
- Gateway runbook: Gateway
- Gateway configuration: Configuration
- Service status:
velaclaw gateway status
Gateway service install (CLI)
Use one of these (all supported):- Wizard (recommended):
velaclaw onboard --install-daemon - Direct:
velaclaw gateway install - Configure flow:
velaclaw configure→ select Gateway service - Repair/migrate:
velaclaw doctor(offers to install or fix the service)
- macOS: LaunchAgent (
ai.velaclaw.gatewayorai.velaclaw.<profile>; legacycom.velaclaw.*) - Linux/WSL2: systemd user service (
velaclaw-gateway[-<profile>].service) - Native Windows: Scheduled Task (
Velaclaw GatewayorVelaclaw Gateway (<profile>)), with a per-user Startup-folder login item fallback if task creation is denied