RivonClaw is a desktop application designed to simplify the management and deployment of OpenClaw, a powerful agent runtime. Built with non-programmers in mind, RivonClaw provides an intuitive interface that allows users to configure agents, manage LLM providers, and set up messaging channels without needing to edit configuration files or interact with terminals.
Key Features:
Natural Language Rules: Write rules in plain language that compile into policies, guards, or skills, taking effect immediately without requiring a restart.
Multi-Provider LLM Support: Integrates with over 20 LLM providers, including OpenAI, Anthropic, Google Gemini, DeepSeek, and more, along with subscription-based plans for access to premium models like Claude and Gemini.
OAuth & Subscription Plans: Seamlessly connect to services like Google for free-tier access or link directly to paid subscriptions without handling API keys manually.
Per-Provider Proxy Support: Configure HTTP/SOCKS5 proxies per provider or API key, ensuring smooth operation in regions with restricted access.
Multi-Account Channels: Connect and manage multiple accounts across platforms such as Telegram, WhatsApp, Discord, Slack, and more through a user-friendly interface.
Zero-Restart Updates: Real-time updates for API keys, proxies, and channels without needing to restart the application.
OpenClaw is a powerful agent runtime,
but operating it directly means managing config files, local processes, provider
credentials, channel plugins, and update workflows. RivonClaw packages that
runtime into a desktop application with a local panel, provider management,
mobile/channel integrations, ecommerce workflows, and release infrastructure.
OpenClaw is the engine; RivonClaw is the desktop cockpit and business layer.
Current Features
Desktop runtime manager: Electron desktop app that owns the OpenClaw
gateway lifecycle, local HTTP panel server, update checks, and user data.
Local panel UI: React/Vite panel for chat, providers, channels, skills,
crons, usage, settings, account/billing, and gated ecommerce modules.
LLM provider management: API-key, OAuth, custom OpenAI-compatible, local
Ollama, subscription/coding-plan, proxy, model catalog, reauth, and usage
surfaces.
Channel integrations: OpenClaw channel configuration plus RivonClaw-owned
mobile chat, Weixin wrapper, event bridge, and capability enforcement plugins.
Cloud-backed business modules: authenticated cloud GraphQL proxy, account
and billing state, TikTok/ecommerce surfaces, customer-service bridge, and
affiliate workflow support.
Skills marketplace: browse/install cloud skills, manage installed skills,
and open the local user skills directory.
Token and key usage: session usage aggregation plus per-key usage history
and subscription quota fetches where providers support it.
Speech-to-text and extras: STT credentials/transcription routes plus web
search and embedding credential management.
Dynamic tool authority: runtime tool visibility and enforcement via
generated tool specs, run profiles, surfaces, and the capability-manager
extension.
Auto-update and release pipeline: electron-builder installers, update
manifests, draft GitHub releases, production website promotion, and CDN refresh
scripts.
Ideal for designers, operators, small business owners, and anyone looking to deploy AI agents without technical expertise. RivonClaw enables users to set up and manage complex agent configurations through a local web panel, eliminating the need for terminal commands or manual configuration. With its intuitive design and comprehensive features, RivonClaw democratizes access to advanced AI capabilities, making it easier than ever to integrate intelligent automation into daily workflows.
RivonClaw can be installed via winget, ensuring seamless deployment across compatible systems.
Node.js
>= 24
pnpm
10.6.2
Quick Start
# 1. Clone the repository
git clone https://github.com/gaoyangz77/rivonclaw.git
cd rivonclaw
# 2. Clone/build the pinned OpenClaw runtime and apply vendor patches
./scripts/setup-vendor.sh
# 3. Install workspace dependencies and build
pnpm install
pnpm build
# 4. Launch in dev mode
pnpm --filter @rivonclaw/desktop dev
The desktop app starts Electron, launches the OpenClaw gateway, and serves the
panel on a dynamically assigned localhost port. In dev mode the panel uses the
Vite dev server at http://localhost:5180.
The monorepo uses pnpm workspaces (apps/*, packages/*, extensions/*,
extensions-merchant/*) with Turbo for build orchestration.
Apps
Package
Description
@rivonclaw/desktop
Electron 40 desktop app. Owns app lifecycle, local API routes, gateway startup, config writes, storage, updater, telemetry, and cloud/CS/mobile bridges.
The current release flow is documented in docs/RELEASE.md.
At a high level: bump apps/desktop/package.json, trigger the manual
Build & Release GitHub workflow, run ./scripts/test-local.sh, publish the
draft GitHub Release with ./scripts/publish-release.sh, then promote website
download files and CDN state from the server/ repo.
