Releases: nexu-io/nexu
v0.1.12
π Highlights
- πͺ Windows support is here β Nexu now officially supports Windows as a first-class desktop platform. Install, upgrade, local runtime, tray behavior, and SkillHub extraction all received a full stabilization pass. (#949, #986, #988, #1021, #1030, #1073) Thanks @PerishCode, @alchemistklk, @mrcfps, @lefarcen, and @Siri-Ray.
- βοΈ Refined desktop settings & update experience β Settings align with the workspace design system, the update flow consolidates into a single entry with real background download progress, and the balance / account area got a visual polish pass. (#984, #1020, #1022, #1033, #1056) Thanks @Siri-Ray and @lefarcen.
- π¬ Feishu video direct delivery β LibTV video delivery now runs through a detached background waiter, making long-running sends smoother and less likely to block the foreground experience. (#973) Thanks @alchemistklk.
- π Channel reliability & diagnostics β Connect/disconnect flows surface clearer failure diagnostics with structured logging, and QQBot/DingTalk plugin packaging issues were fixed. (#1001, #1003, #1018, #1037) Thanks @lefarcen and @Siri-Ray.
- π Zero-credit model access β Users with zero credits can now continue chatting via free models. The platform automatically routes zero-credit requests to a configurable fallback model, so new users and users who have used up their credits still get a working experience out of the box.
π₯ Download now:
Platform Architecture Link macOS Apple Silicon nexu-0.1.12-mac-arm64.dmg macOS Intel nexu-0.1.12-mac-x64.dmg Windows x64 nexu-setup-0.1.12-win-x64.exe
β¨ What's New
- πͺ Windows desktop is now a first-class path β Packaging, user-data migration, local updates, tray behavior, and SkillHub catalog extraction all stabilized for daily Windows use. (#949, #986, #988, #1021, #1030)
- π Background auto-download with real progress β Updates download silently in the background; the settings page shows live progress when opened, and a single consolidated banner replaces the previous duplicate update UI. (#1020, #1033)
- π§ Desktop settings aligned with workspace design β Account area, shell preferences, and model picker brought in line with the workspace visual language. (#984, #1022, #1034)
- π³ Credits & balance polish β Gifted credits now appear in the sidebar balance popup, and the popup renders via portal to fix clipping issues. (#985, #990)
- π₯ Feishu video hardening β Long-running video delivery no longer blocks foreground flows. (#973)
- π Zero-credit model fallback β Zero-cost models bypass credit rejection; when credits are exhausted, requests automatically route to a free fallback model instead of failing.
π‘οΈ Stability & Reliability
- π Windows migration hardening β User-data path handling and migration logic stabilized to reduce upgrade regressions. (#1021)
- π§° Installer safety β Windows installer directory-selection pages hidden to prevent install-path-related data loss. Windows installer now retries gracefully when a running Nexu instance is detected. (#1030, #1073)
- π§ OpenClaw config determinism β Skill lists and config serialization sorted deterministically, eliminating unnecessary runtime reloads from key reordering. (#1033)
- β‘ Skill install sync batching β Batch skill installs now trigger a single OpenClaw config sync instead of one per skill, eliminating the restart loop that left the agent stuck on "starting" during initial bootstrap. (#1074)
- π§ Structured channel diagnostics β All channel connect/disconnect flows now produce structured logs for easier production tracing. (#1003, #1018)
- π¬ WeChat runtime fixes β Fixed prewarm drain behavior and raw ID session title issues. (#972)
- ποΈ Desktop shell polish β Improved Windows tray behavior, Mac sidebar toggle positioning, and renderer background keepalive. (#988, #1002, #958)
- π Desktop update failure recovery β Auto-updater now recovers gracefully from interrupted downloads and failed installs. (#1056)
π Bug Fixes
- Fixed QQBot and DingTalk plugin bundle dependency closures in packaged builds. (#1001, #1037)
- Fixed controller overwriting agent-edited platform docs. (#999)
- Fixed dev controller startup wait and platform template injection. (#971)
- Preserved full X share copy and repo URL. (#975)
- Aligned settings model picker and analytics defaults. (#1034)
- Fixed desktop account area and dock behavior. (#1022)
- Fixed missing i18n translations for Home and Conversation pages. (#1049)
- Fixed welcome locale switching and added channel setup diagnostics. (#1054)
- Added logout confirmation dialogs in settings. (#1069)
π Documentation
- Added Korean localization for README and docs site. (#998) Thanks @qiongyu1999.
- Added model credit consumption guide in zh/en/ja. (#978) Thanks @qiongyu1999.
- Updated Feishu app permissions with expanded user scopes. (#997)
- Added EN & JA translations for first-pr and contributor-rewards guides. (#1043) Thanks @caiqiling958-cmd.
- Added WeChat contributor group QR code and i18n contributor sections. (#1042, #1038, #1036, #1032) Thanks @caiqiling958-cmd.
- Added Windows installation guide (zh/en/ja/ko). (#1039)
- Rewrote README (en/zh/ja/ko). (#1040)
π¨ For Developers
Click to expand
- π Fixed PostHog analytics identity and desktop metadata propagation. (#960) Thanks @mrcfps.
- π Added Vaunt contributor achievement configuration. (#1015) Thanks @qiongyu1999.
- π§ Added temporary Langfuse tracing passthrough. (#1019)
- πͺ Aligned Windows desktop delivery pipeline with mainline. (#949) Thanks @PerishCode.
Full Changelog: v0.1.11...release/v0.1.12
v0.1.11
π Highlights
- π Desktop Rewards Center β Earn credits by starring the repo, sharing assets, and inviting friends. Track your balance and claim rewards directly from the desktop app. (#789) Thanks @anthhub @nettee .
- π¬ Three new managed channels: QQ, WeCom, and DingTalk β Connect QQ, WeCom, and DingTalk directly from the dashboard as a bundled new channel set. (#775, #895) Thanks @Siri-Ray and @qiongyu1999.
- π Localized LLM errors β Provider failures are now translated into clearer, actionable messages across channels instead of raw English stack traces. (#834) Thanks @lefarcen.
- π§© Model provider registry β Provider settings are now driven by a centralized registry, making model/provider management much easier to evolve. (#837) Thanks @mrcfps.
π₯ Download now: macOS Apple Silicon (.dmg) Β· macOS Intel (.dmg)
Requires macOS 13+. Windows beta available β see #897.
β¨ What's New
- π Rewards Center building blocks β Daily check-in, GitHub Star verification, social sharing, and invite flows ship together as a complete credits center. (#913, #914, #918, #921, #923, #942, #945, #952) Thanks @anthhub and @lefarcen.
- π Channel docs & setup polish β Setup guides and docs links for QQ, WeCom, and DingTalk landed alongside the runtime plugins. (#776, #781, #833, #897) Thanks @qiongyu1999 and @caiqiling958-cmd.
π‘οΈ Stability & Reliability
- π Fixed SIGUSR1 restart loops and BYOK model override regressions in the controller runtime. (#915, #936) Thanks @lefarcen.
- π©Ή Restored packaged `NEXU_HOME`, auto-cleared launchd disabled overrides, and hardened upgrade startup recovery so users no longer get stranded on blank/loading states. (#836, #885, #906) Thanks @lefarcen.
- πͺ Windows dev/distribution flow stabilization, Help menu fixes on Windows/Linux, Rosetta warnings, and packaged debug shortcut recovery. (#449, #888, #939) Thanks @PerishCode and @lefarcen.
π Bug Fixes
- Removed redundant connectivity actions from QQ / DingTalk / WeCom setup; docs links and setup copy were also cleaned up. (#894, #943) Thanks @Siri-Ray and @qiongyu1999.
- Fixed interrupted cloud-login browser recovery and Minimax OAuth browser launching. (#892, #926) Thanks @lefarcen.
- Prevented locale bootstrap from overriding explicit user choice. (#924) Thanks @anthhub.
- Refreshed share-link behavior for a smoother rewards experience. (#947, #952) Thanks @lefarcen.
π¨ For Developers
Click to expand
- π Analytics migrated from Amplitude to PostHog across web, desktop renderer, and controller transports. (#778) Thanks @mrcfps.
- β Desktop E2E coverage collection and reporting added. (#698) Thanks @mrcfps.
- π¬ Nightly signing and E2E orchestration hardened to prevent build-pipeline regressions. (#698, #863, #925, #930) Thanks @mrcfps and @lefarcen.
- π§ͺ Release/build workflows improved with stale E2E cancellation, reserved Windows lanes, and Bothub verification support. (#839, #925, #930) Thanks @joeylee12629-star and @lefarcen.
Full Changelog: v0.1.10...release/v0.1.11
v0.1.10
π Highlights
- π¬ Seedance 2.0 video generation β Generate 15-20 second AI videos right from your bot conversations. Star the repo and join the community group to get free credits. (#749, #751, #764) Thanks @alchemistklk and @lefarcen.
- π Startup is more resilient β If the controller fails its initial readiness check, the app now retries automatically instead of getting stuck on a loading screen. (#750) Thanks @mrcfps.
π₯ Download now: macOS Apple Silicon (.dmg) Β· macOS Intel (.dmg)
Requires macOS 13+.
β¨ What's New
- π₯ Two video skills bundled β Medeo Video and LibTV Video ship out of the box, with Seedance 2.0, Kling 3.0, and more models available. (#751, #764) Thanks @alchemistklk.
- π Seedance guide β New documentation pages in Chinese, English, and Japanese walking users through setup and usage. (#748, #761) Thanks @qiongyu1999.
- π Better analytics β First-conversation events and skill source tracking for understanding how users discover features. (#766) Thanks @lefarcen.
π‘οΈ Stability & Reliability
- Controller startup retries after readiness failure instead of hanging forever. (#750) Thanks @mrcfps.
- Amplitude API key now correctly passed to the controller in launchd mode β analytics no longer silently broken in packaged builds. (#763) Thanks @lefarcen.
- Promo banner dismiss is session-scoped β comes back on next launch so users don't permanently miss it. (#756) Thanks @lefarcen.
π Bug Fixes
- Fixed promo banner appearing above bot status β now sits between the hero section and channels. (#752, #757) Thanks @lefarcen.
- Fixed NoneType crash in LibTV video skill when API returns unexpected data. (#764) Thanks @alchemistklk.
- Fixed Sentry automation commits being misattributed as external contributions. (#744) Thanks @nettee.
π¨ For Developers
Click to expand
- Seedance promo countdown starts from configurable cycle start with 2-day auto-reset. (#752) Thanks @lefarcen.
- Docs page validation script added. (#748) Thanks @qiongyu1999.
- Internal author detection expanded to cover Sentry bot commits. (#744) Thanks @nettee.
- Renamed
session_startanalytics event tonexu_first_conversation_startfor clarity. (#766) Thanks @lefarcen.
Full Changelog: v0.1.9...release/v0.1.10
v0.1.9
π Highlights
- π Plays nice with other OpenClaw apps β Other OpenClaw-based apps on the same machine? No problem β Nexu now coexists gracefully, running side by side without interference. (#700) Thanks @lefarcen.
- πΌοΈ Images work again, everywhere β Switched to macOS-native image processing. Send a photo in Slack, Feishu, WeChat, Discord, or WhatsApp β your bot will see it and respond. No more "image optimization failed". (#674) Thanks @anthhub.
- π PDFs and web browsing are back β Bots can read PDF files, fetch web pages, and control a browser with Playwright again. (#689) Thanks @nettee.
- π¬ A proper first impression β Fresh installs and upgrades now show a branded loading animation instead of a blank white screen. (#596) Thanks @lefarcen.
π₯ Download now: macOS Apple Silicon (.dmg) Β· macOS Intel (.dmg)
Requires macOS 13+.
β¨ What's New
- π Channels connect reliably β Gateway authentication token now correctly reaches OpenClaw, fixing channels stuck on "connecting". (#697) Thanks @lefarcen.
- πͺ Window behaves β Activating a running instance properly brings the window back (#701, thanks @mrcfps), and the default size is now a consistent 1280Γ720 (#738). Thanks @lefarcen.
- π Docs refresh β New update guide and troubleshooting pages in Chinese, English, and Japanese. (#713, #716) Thanks @qiongyu1999.
π‘οΈ Stability & Reliability
- Force Quit no longer leaves the app stuck on a loading screen β stale background services are detected and cleaned up automatically. (#734) Thanks @mrcfps.
- Smoother update installs with better teardown sequencing and user feedback. (#739) Thanks @lefarcen.
- Port-theft recovery no longer leaves the controller in a confused state. (#726) Thanks @lefarcen.
- Account-scoped config moved to avoid unnecessary OpenClaw migrations on startup. (#736) Thanks @lefarcen.
π Bug Fixes
- Fixed channels not connecting after fresh install (missing gateway token). (#697) Thanks @lefarcen.
- Fixed "image optimization failed" errors across all messaging platforms. (#674) Thanks @anthhub.
- Fixed PDF reading and web browsing skills broken after dependency cleanup. (#689) Thanks @nettee.
- Fixed blank white screen on first launch. (#596) Thanks @lefarcen.
- Fixed window not appearing when clicking the Dock icon on a running instance. (#701) Thanks @mrcfps.
π¨ For Developers
Click to expand
- R2 upload switched from wrangler to AWS S3 CLI for reliability. (#730) Thanks @lefarcen.
- CDN cache purge added to desktop release workflow. (#735, #745) Thanks @lefarcen.
- Desktop E2E quit uses IPC instead of SIGTERM, fixing test hangs. (#737) Thanks @lefarcen.
- E2E now selects correct architecture-specific artifacts. (#712) Thanks @nettee.
- Nightly changelog formatting improved. (#683) Thanks @lefarcen.
- CI auto-tag uses PAT to trigger downstream release builds. (#692) Thanks @lefarcen.
@lefarcen, @anthhub, @mrcfps, @nettee, @qiongyu1999
Full Changelog: v0.1.8...release/v0.1.9
v0.1.8
π Highlights
- π» Now available for Intel Macs β Native builds for both Apple Silicon and Intel. (#550)
- π± WhatsApp & Telegram! β Connect your bots to two of the world's most popular messaging platforms. WhatsApp via QR scan, Telegram via BotFather β both just work. (#554)
- π System Proxy β zero config β The desktop runtime now auto-detects your macOS system proxy. Corporate VPN, Clash, Surge β all just work, no manual setup. (#637)
- π¦ Ollama β your local models, one click β Running Llama, Mistral, or Gemma locally? Plug Ollama in as a model provider and go. (#575)
- β‘ WeChat connects 40x faster β Cold-start slashed from ~2 minutes to ~5 seconds. Bots come online almost instantly. (#646)
- π§ Reinstall? Just drag and drop. β Background services no longer lock the .app bundle. Replace the app anytime, even with bots running. (#597)
π₯ Download now: macOS Apple Silicon (.dmg) Β· macOS Intel (.dmg)
Requires macOS 13+. Windows support arriving in v0.2.0 πͺ
β¨ What's New
- π Models stay fresh β Official model inventory refreshes automatically, no restart needed (#634)
- π¬ Real group names β Group chat sessions now display actual group names instead of cryptic IDs (#660)
- π§© Smarter skill sync β Installed skills auto-detect workspace config changes and stay in sync (#643)
- β¬οΈ Live download progress β Watch your skills install in real-time with progress indicators (#580)
- π Nightly gets a changelog β Every nightly build now ships with auto-generated release notes and linked issues (#677)
π‘οΈ Stability & Reliability
- Updates are smarter β the app verifies no critical files are locked before installing, preventing failed silent upgrades
- Every exit path (window close, Cmd+Q, Force Quit, even renderer crashes) now properly cleans up background services
- Startup refuses to attach to leftover services from a different app version β no more ghost processes
- Runaway sidecar crashes trigger a circuit breaker instead of looping forever
- Diagnostic exports now include step-by-step bootstrap timing for faster troubleshooting
π Bug Fixes
- Fixed white screen on macOS 14.7.4+ after upgrade (#597)
- Closing the window now hides to background like Slack β no more "Quit or Background?" dialog (#673)
- Cmd+R no longer accidentally reloads the app in production (#639)
- WhatsApp stays connected after sleep/wake cycles (#668)
- Various model provider and channel connectivity improvements
π¨ For Developers
Click to expand
- Intel Mac packaging flow with architecture-specific builds (#550)
- Desktop E2E automation framework with packaged app testing (#650)
- Background launchd helper commands for debugging (#672)
- CI installs and desktop packaging speed optimized (#590)
- Nightly builds include Feishu notification with download links (#677)
- Release PR merge now auto-tags and publishes release notes β merge = ship π
π New Contributors
Welcome! π
π Contributors
@lefarcen, @alchemistklk, @anthhub, @ashleyashli, @qiongyu1999, @hkslover, @mrcfps, @nettee, @Siri-Ray
Full Changelog: v0.1.7...v0.1.8
v0.1.7
Highlights
- π§ Rock-solid startup β Fixed "white screen", "can't open", and "channels stuck connecting" issues. Startup is now resilient to port conflicts, app upgrades, and force-quit recovery.
- π OpenAI Codex OAuth β Login with your ChatGPT Plus/Pro account to use GPT models β no separate API keys needed. (#537)
- π MiniMax OAuth β One-click MiniMax model access via OAuth, with polished provider UI. (#549)
- π Z.AI Coding Plan β Quick-setup for GLM models with Global/CN region toggle. (#537)
- π‘οΈ Self-healing services β Launchd integration rebuilt: plist config drift auto-detected, stale services cleaned up on startup, Stop/Start buttons work reliably.
What's New
- π WeChat setup guide β English-language channel setup documentation (#548)
- π Discord guide refresh β Updated screenshots and simplified permissions guide (#528)
Bug Fixes
- Fixed app showing white screen after upgrade β plist config drift now auto-detected and re-bootstrapped (#544)
- Fixed "channels connecting forever" when default port is occupied by another Nexu instance (#544)
- Fixed Stop button being ignored by KeepAlive β now properly unregisters service (#544)
- Fixed Stop/Start buttons greyed out in launchd mode (#544)
- Fixed force-quit leaving stale web port β dead Electron PID now detected on restart (#544)
- Fixed v0.1.6 data loss β sessions, skills, and channel state migrated back from wrong directory (#544)
- Fixed unhandled rejection crash in cloud status refresh (#539)
- Fixed OAuth disconnect not clearing models from selector β now properly deletes provider and syncs (#551)
- Fixed model list showing expired OAuth providers (#551)
- Fixed skill detail "Back" button always resetting to initial tab (#551)
UI Polish
- Skills page persists active tab (Yours/ClawHub) in URL for bookmarking (#551)
- GitHub import tab input set to read-only (coming soon) (#551)
- Fixed spacing in Chinese disclaimer text (#551)
For Developers
- 24 new launchd startup smoke tests covering cold start, attach, port conflicts, config drift, force-quit recovery, and more
- Controller/OpenClaw port conflicts resolved via
findFreePortinstead of killing processes coldStartReadyIPC gate ensures renderer always gets final port config
Contributors
@lefarcen, @nettee, @qiongyu1999, @alchemistklk, @mrcfps
Full Changelog: v0.1.6...v0.1.7
v0.1.6
Highlights
β‘ 3x faster startup β Cold start reduced from ~22s to ~7s. Reopening after background mode takes just ~200ms.
π‘οΈ Crash-proof services β Controller and OpenClaw now run as independent system services. If one crashes, it auto-recovers without restarting the app.
π¨ Polished launch experience β New animated splash screen with smooth transition. Status shows "Starting up β Connecting β Running" instead of flashing "Offline".
What's New
- π Background mode β Close the app and keep bots running. Reopen from Dock instantly (#405, #519)
- π§© ClawHub (formerly Explore) β Batch skill installation with queue management (#445, #477)
- π₯ Dev hot reload β Edit controller code, see changes in ~3s, no restart needed (#519)
- β¨ UI refresh β WeChat official logo, updated design tokens, improved cloud connection flow (#503)
- π¬ Session chat improvements β Better message display and desktop workspace links (#420)
Bug Fixes
- Fixed startup showing "Offline" status during boot (#405)
- Fixed WeChat channel showing generic "Error" instead of "Reconnect required" (#405)
- Fixed display sleep being blocked while app is active (#436)
For Developers
pnpm startnow auto-watches controller and web source files- Dev state fully isolated under
.tmp/β no conflict with installed app - Comprehensive startup flow documentation
π New Contributors
- @zoeforfun made their first contribution in #503
Contributors
@lefarcen, @anthhub, @mrcfps, @alchemistklk, @nettee, @Siri-Ray, @zoeforfun, @qiongyu1999
Full Changelog: v0.1.5...v0.1.6
v0.1.5
β¨ New Features
- Skill import modal: Import Skill dialog with zip upload support and bilingual UI. (#355)
- Markdown chat rendering: Session chat bubbles now render formatted content β lists, links, code blocks. (#348)
- Dynamic runtime ports: Desktop runtime allocates ports dynamically, eliminating fixed-port conflicts on startup. (#331)
- About dialog & update menu: Added app About dialog and in-app update check actions. (#345)
- Workspace & runtime analytics: Added analytics events for workspace and runtime lifecycle tracking. (#411)
π Bug Fixes
- Fix Feishu restart loop: Config writer now skips redundant writes, breaking the restart β syncAll β write β watcher cycle that made Feishu channels unusable. (#347)
- Fix zombie processes on quit: App quit now awaits child process cleanup and escalates to SIGKILL after 3s, preventing orphaned processes that block app deletion. (#346)
- Fix cold-start config reload: Config writer seeds its cache from disk on startup, avoiding unnecessary OpenClaw reloads after every controller restart. (#349)
- Fix channel-aware update checks: Updater now checks the correct feed URL for stable/beta/nightly channels. (#345)
- Fix webview mount crash: Set webview src via JSX prop to prevent null-src crash on initial mount. (#407)
- Fix skill card drag: Prevent drag event on skill cards from opening a second browser window. (#361)
- Fix controller symlink crash: Filter out node_modules/.bin symlinks during runtime plugin copy to prevent EINVAL on skill import. (#355)
π New Contributors
- @NickHood1984 made their first contribution in #348
- @zoeforfun made their first contribution in #418
Full Changelog: v0.1.4...v0.1.5
v0.1.4
β¨ New Features
- Better skill management: curated installs, Chinese catalog localization, lowdb skill ledger, and catalog/package fixes (#267, #288, #317, #323).
- New controller-first local runtime with OpenClaw config push, readiness feedback, and model-routing templates (#269, #274, #320).
- New WeChat support with QR-code login, plus bundled image/audio/browser skills (#324, #326, #270).
- Better product UI: session chat history, updated auth page, improved sidebar, restored provider icons, and desktop build metadata (#278, #309, #252, #314, #257, #290).
- Better release and debug tooling: Slack reply probe, desktop diagnostics export, and improved release channel/artifact handling (#272, #289, #266, #338, #337).
π Bug Fixes
- Fixed packaged desktop skill installs and several startup/reconnect issues across local and cloud flows (#240, #237, #241, #247, #261, #256, #265).
- Fixed desktop polish issues including sleep handling, drag bar spacing, traffic-light alignment, icons, and diagnostics/Sentry setup (#299, #316, #313, #291, #253, #287, #301, #303).
- Fixed web/product issues including BYOK saved-state messaging, privacy/terms links, docs links, model list cleanup, and skill content rendering (#260, #259, #271, #282, #315, #294).
- Fixed runtime and packaging issues by restoring local dev flow, switching to
sql.js, speeding postinstall, preservingsharppaths, and stabilizing WeChat plugin config (#295, #298, #318, #330, #329). - Fixed channel and UX issues in Feishu fallback handling, Slack model routing, browser open-folder flow, and WeChat session/sidebar behavior (#319, #268, #309, #340).
π§Ή Maintenance & Cleanup
- Removed deprecated API/gateway/deploy paths, the
apps/landingpackage, the router workspace, and old skills-catalog APIs (#296, #254, #325, #292). - Cleaned up release plumbing with refreshed runtime metadata,
vtag support, safer release scripting, and finalv0.1.4prep (#332, #338, #341, #333, #342).
π New Contributors
- @qiongyu1999 made their first contribution in #248
- @ashleyashli made their first contribution in #310
Full Changelog: v0.1.0...v0.1.4
Nexu Desktop Beta
Automated desktop build.
- Version:
0.1.12-beta.20260507 - Channel:
beta - Environment:
nexu-prod - Commit:
dadfb1c8085bfaf500440cd86a66c7e5b3961a1b - Built:
20260507
The packaged Nexu.app bundle is notarized and stapled.
This build is intended for testing and may be unstable.