openclaw-assistant  by yuga-hashimoto

Self-hosted Android voice assistant with deep system integration

Created 2 months ago
255 stars

Top 98.8% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

OpenClaw Assistant offers a self-hosted Android voice assistant focused on privacy and deep system integration. It provides offline wake word detection, direct control over device functions (notifications, apps, SMS), and Wear OS support. Aimed at users seeking a powerful, private alternative to cloud-based assistants, it delivers a native Android experience with extensive customization.

How It Works

The app connects to an OpenClaw gateway via WebSocket/HTTP, using Vosk for on-device, offline wake word detection. It integrates with Android through VoiceInteractionService for system-level actions and long-press activation. The assistant supports multiple Text-to-Speech (TTS) engines (native, ElevenLabs, OpenAI, VOICEVOX), features continuous conversation mode, and includes a "Canvas" tab for rich, AI-driven user interfaces.

Quick Start & Requirements

Install the latest APK from Releases or build from source. A quick start involves installing the app, running openclaw qr on a server, scanning the QR code for pairing, and activating via home button long-press or wake word. A self-hosted OpenClaw gateway is recommended. Minimum SDK is Android 12 (API 31). Optional dependencies include API keys for specific TTS providers. Links to the demo video and build instructions (BUILDING.md) are provided.

Highlighted Details

  • Offline Wake Word: Vosk-based, local detection for privacy.
  • System Control: Manages notifications, apps, camera, SMS, clipboard, location, WiFi, contacts, calendar, screen recording.
  • Wear OS Support: Enables assistant functionality on smartwatches.
  • Privacy: Encrypted settings (AES256-GCM), local wake word, Ed25519 identity.
  • Rich UI: "Canvas" tab for interactive AI interfaces, Markdown chat rendering.
  • Multi-TTS: Integrates native TTS, ElevenLabs, OpenAI, VOICEVOX.

Maintenance & Community

The project welcomes contributions via pull requests and issue reports. Specific details on maintainers or dedicated community channels are not provided.

Licensing & Compatibility

Released under the MIT License, permitting broad use, modification, and distribution, including commercially. Third-party license details are in THIRD_PARTY_LICENSES.md.

Limitations & Caveats

Full functionality requires a companion OpenClaw gateway. Certain features need explicit Android permission grants, potentially requiring manual configuration (e.g., Notification Listener). The "full build" requirement for VOICEVOX TTS may imply additional setup complexity.

Health Check
Last Commit

10 hours ago

Responsiveness

Inactive

Pull Requests (30d)
186
Issues (30d)
13
Star History
32 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.