RivonClaw simplifies AI agent management by providing an easy-mode runtime and UI layer atop OpenClaw. It targets non-programmers, enabling them to configure and interact with AI agents as personal digital butlers through natural language rules and a local web interface, abstracting away complex terminal configurations.

How It Works

This project wraps the powerful OpenClaw agent runtime in a user-friendly desktop application. Users define agent behavior via natural language rules that compile instantly into policies, guards, or skills. It supports over 20 LLM providers, numerous messaging channels, and integrates features like OAuth for subscription plans, per-provider proxies, and real-time token usage tracking, all managed through a local web panel without terminal interaction.

Quick Start & Requirements

• Primary Install/Run: Clone the repo, run ./scripts/setup-vendor.sh to build the vendored OpenClaw, install dependencies with pnpm install, build with pnpm build, and launch with pnpm --filter @rivonclaw/desktop dev.
• Prerequisites: Git (any), Node.js (>= 24), pnpm (10.6.2).
• Links: Repository: https://github.com/nicepkg/rivonclaw.git

Highlighted Details

• Natural Language Rules: Define agent logic using plain language that compiles immediately without restarts.
• Extensive LLM & Channel Support: Integrates 20+ LLM providers (including subscription/coding plans and local Ollama) and numerous messaging platforms (Telegram, WhatsApp, Discord, Slack, etc.).
• Local-First & Private: All data and secrets are stored locally, with no plaintext storage of sensitive information.
• File Permissions: An OpenClaw plugin intercepts tool calls to validate file read/write access against user-configured permissions, covering ~85-90% of scenarios.
• Zero-Restart Updates: Configuration changes (API keys, proxies, channels) are applied instantly via hot reload.

Maintenance & Community

• Community: Telegram (International) discussion group.
• Development: Utilizes pnpm workspaces and Turbo for monorepo management. Features privacy-first telemetry (optional, anonymous).

Licensing & Compatibility

• License: Details are provided in the LICENSE file.
• Compatibility: Designed for local, private use.

Limitations & Caveats

The file permissions plugin cannot inspect paths within command strings for exec tools, recommending disabling exec tools for maximum security. Native module compilation requires specific build steps for Node.js and Electron runtimes.