DEV Community

Cover image for We Built an Open-Source OpenClaw Desktop Client That Fixes 17 Pitfalls
Joey Lee
Joey Lee

Posted on

We Built an Open-Source OpenClaw Desktop Client That Fixes 17 Pitfalls

If you've deployed OpenClaw in production, you've probably hit at least a few of these — and may not even realize it:

  • Context window silently truncates — response quality tanks and you don't know why
  • Some channel plugins require a full restart on first connect
  • Slack quietly drops group messages — messages just vanish
  • Bedrock returns 400 because of supportsStore
  • Default Docker image is 660MB and cold-starts in minutes

We've been running OpenClaw for months and hit all 17 known pitfalls. So we built Nexu — an open-source desktop client that auto-fixes every one of them. Double-click to install, no Docker, no CLI, no YAML.

The 500-Line Config Compiler

At Nexu's core is a 500-line config compiler that automatically generates correct OpenClaw configuration, with all 17 pitfalls pre-patched.

Context: Not Bigger, Smarter

OpenClaw's default context handling brutally truncates when the window fills up. Nexu's compiler injects a safeguard context compression strategy: auto-retry when quality drops instead of silently truncating. It allocates a 200K context window — 50% for conversation history, 20K token floor — and auto-archives old conversations to vector memory.

Channel-Specific Hacks

  • Channel preheat: pre-loads channel plugins at init so first connect does not require an extra restart
  • Slack groupPolicy: open: forced globally — group messages no longer silently swallowed
  • supportsStore: false: set globally to prevent Bedrock/LiteLLM 400 errors

Hot-Reload That Actually Works

Mixed hot-reload: small config changes hot-load instantly; large changes trigger a graceful restart. Zero user-perceived interruption in either case.

Cut in Half

We use a custom dependency closure algorithm that only bundles actually-used modules, cutting the packaged runtime footprint roughly in half compared to shipping full dependency trees. Every new 1MB dependency = 1MB added to the final package. We track this obsessively.

System-Level Process Guard

Not a child process — a macOS native LaunchAgent (system service). Crash auto-restart in 2s with exponential backoff (2s → 4s → 8s → 30s cap). Close the window, your workflows keep running. Reopen, instant re-attach. SIGTERM → 3s → SIGKILL — no zombie processes ever.

Anti-Sleep Guard

Intercepts 5 types of macOS power events. Lid closed, low battery, night — workflows keep processing without forcing screen awake.

Health Probe: 1000x Faster

4.8s → 1-3ms. Disconnect detection is now millisecond-level. No more waiting seconds to know your runtime is down.

10,000+ Skills, Hot-Install

29 curated skills pre-installed. Remote catalog with CDN, auto-synced every 24 hours. Install and use immediately — no restart required. Also supports ZIP file and GitHub repo import.

Nexu skills — 10,000+ skills hot-install

Channel-Specific Optimizations

  • Slack: fix for silent group message loss — groupPolicy: open enforced globally
  • Telegram: BotFather token flow — no self-hosted webhook server required
  • WhatsApp: QR scan to connect your account
  • Discord: native bot gateway with auto-reconnect
  • Feishu/Lark: 27 field types, streaming cards — strong for in-org workflows

Zero Barrier

Double-click to install. OAuth for Slack. QR scan for WhatsApp. BotFather token for Telegram. 10+ models switch without restart. No Docker, no database, no CLI. Universal macOS — Apple Silicon and Intel.

Nexu on GitHub

Try It

Download: github.com/nexu-io/nexu/releases

GitHub: github.com/nexu-io/nexu

Honest Limitations

  • Universal macOS — Intel + Apple Silicon (one .dmg each)
  • Single-user, no multi-tenant
  • Channel maturity: Slack and Discord most battle-tested. WhatsApp and Telegram freshly shipped (v0.1.8)

Open-source, MIT licensed. → GitHub Repo

Top comments (2)

Collapse
 
_ea335f27a714c564b44cd6 profile image
黄巍

Been running OpenClaw on a small team for 3 months. The Feishu restart issue alone cost us probably 20 hours of debugging before we figured out it was a known thing. Will definitely try this.

Some comments may only be visible to logged-in visitors. Sign in to view all comments.