Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
1547719
Redesign WSL gateway onboarding (stepped, brand-themed, accessible)
Jun 23, 2026
9eecf69
Polish WSL gateway onboarding UX
Jun 30, 2026
91d6183
Reconcile onboarding polish with main
Jun 30, 2026
56f8ae4
Clean up obsolete onboarding setup paths
Jun 30, 2026
41a0a9b
Add preview coverage for onboarding error states
Jun 30, 2026
904cff1
Use mascot status badge on complete screen
Jul 1, 2026
5c5401c
Remove obsolete onboarding V2 artifacts
Jul 1, 2026
0835a80
Persist setup profile and startup choices
Jul 1, 2026
6d35b4e
Persist onboarding runtime settings correctly
Jul 1, 2026
886fc90
Polish onboarding review edge cases
Jul 1, 2026
b25d763
Preserve startup choice during direct onboard
Jul 1, 2026
dda4033
Respect hidden startup preference on direct onboard
Jul 1, 2026
43cab29
Address dual-review onboarding edge cases
Jul 1, 2026
d984588
Remove generated impeccable cache
Jul 1, 2026
619fc77
Preserve explicit capability configs during setup
Jul 1, 2026
f8342ee
Remove generated impeccable cache
Jul 1, 2026
74604ae
Fix connection snapshot truth (#918)
bkudiess Jul 2, 2026
1df8047
Redesign WSL gateway onboarding (stepped, brand-themed, accessible)
Jun 23, 2026
4aa6b12
Polish WSL gateway onboarding UX
Jun 30, 2026
c9cf93d
Reconcile onboarding polish with main
Jun 30, 2026
2434aac
Clean up obsolete onboarding setup paths
Jun 30, 2026
7043c40
Add preview coverage for onboarding error states
Jun 30, 2026
dc55bd9
Use mascot status badge on complete screen
Jul 1, 2026
11b41ff
Remove obsolete onboarding V2 artifacts
Jul 1, 2026
1adca34
Persist setup profile and startup choices
Jul 1, 2026
9bfa8ec
Persist onboarding runtime settings correctly
Jul 1, 2026
4cc0f9a
Polish onboarding review edge cases
Jul 1, 2026
1ee2ded
Preserve startup choice during direct onboard
Jul 1, 2026
66421cc
Respect hidden startup preference on direct onboard
Jul 1, 2026
42a7856
Address dual-review onboarding edge cases
Jul 1, 2026
1bf33f2
Remove generated impeccable cache
Jul 1, 2026
3f104f3
Preserve explicit capability configs during setup
Jul 1, 2026
e2d7a51
Remove generated impeccable cache
Jul 1, 2026
2bd70cf
Merge commit 'f8342ee1510eed34624a1d7b67e405f530dd76f2' into bkudiess…
Jul 2, 2026
70b5648
Fix setup review truth and capability persistence
shanselman Jul 2, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 0 additions & 3 deletions DEVELOPMENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,9 +74,6 @@ openclaw-windows-hub/
│ ├── OpenClaw.SetupEngine.Tests/ # Setup engine tests
│ └── OpenClaw.Tray.UITests/ # Native WinUI/A2UI UI tests
├── tools/
│ └── icongen/ # Icon generation tool
├── .github/workflows/
│ └── ci.yml # GitHub Actions CI/CD workflow
Expand Down
21 changes: 11 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,7 @@ dotnet run --project src/OpenClaw.Cli -- --url ws://127.0.0.1:18789 --token "<to
Modern Windows 11-style system tray companion that connects to your local OpenClaw gateway.

### Features
- 🦞 **Lobster branding** - Pixel-art lobster tray icon with status colors
- 🎨 **OpenClaw branding** - OpenClaw tray icon with status colors
- 🎨 **Modern UI** - Windows 11 flyout menu with dark/light mode support
- 💬 **Quick Send** - Send messages via global hotkey (Ctrl+Alt+Shift+C)
- 🔄 **Auto-updates** - Automatic updates from GitHub Releases
Expand All @@ -157,7 +157,7 @@ Modern Windows 11-style system tray companion that connects to your local OpenCl
- ⏱ **Cron Jobs** - Quick access to scheduled tasks
- 🚀 **Auto-start** - Launch with Windows
- ⚙️ **Settings** - Full configuration page
- 🎯 **First-run onboarding** — 6-screen setup wizard (connection, permissions, chat, configuration)
- 🎯 **First-run onboarding** — native WSL gateway setup with capability, permission, install, onboard, and completion screens

#### Quick Send scope requirement

Expand Down Expand Up @@ -216,7 +216,7 @@ These features are available in Windows but not in the Mac app:
| Channel control | Start/stop Telegram & WhatsApp |
| Modern flyout menu | Windows 11-style with dark/light mode |
| Deep links | `openclaw://` URL scheme with IPC |
| First-run onboarding | 6-screen guided setup wizard (Welcome → ConnectionWizard → Permissions → Chat → Ready) |
| First-run onboarding | Native setup flow: Security notice → Welcome/AdvancedCapabilities and permissions → Install progress → OpenClaw onboard → Complete |

### 🔌 Node Mode (Agent Control)

Expand Down Expand Up @@ -426,14 +426,15 @@ Default gateway: `ws://localhost:18789`

### First Run

On first run, Molty launches a guided onboarding wizard that walks you through setup:
On first run, Molty launches a guided setup flow:

1. **Welcome** — introduces OpenClaw and starts the setup flow
2. **Connection** — choose Local gateway, Remote gateway, or configure later. Paste a setup code or enter gateway URL and token manually. Tests the connection with Ed25519 device authentication.
3. **Wizard** — gateway-driven configuration steps (AI provider selection, personality setup, communication channels). Steps are defined by your gateway.
4. **Permissions** — reviews Windows system permissions (notifications, camera, microphone, screen capture, location) and links to system settings to grant them.
5. **Chat** — meet your agent in a live chat powered by the gateway's web UI.
6. **Ready** — summary of available features, option to launch at startup, and a Finish button.
1. **Security notice** — confirms this is a trusted PC before local setup starts.
2. **Welcome** — choose **Install a local gateway (WSL)** or connect to an existing gateway from Connections.
3. **Capabilities** — choose a profile, review matching Windows permission status, and see exactly what setup will install.
4. **Progress** — installs the app-owned `OpenClawGateway` WSL instance and keeps Live activity available but collapsed by default.
5. **Gateway installed** — confirms the WSL gateway is running before moving into OpenClaw onboard.
6. **OpenClaw onboard** — gateway-driven provider/model/key setup rendered as a transcript.
7. **All set** — summary of available features, startup preference, and Finish.

For detailed setup instructions, see [docs/SETUP.md](docs/SETUP.md). For the full onboarding architecture, see [docs/ONBOARDING_WIZARD.md](docs/ONBOARDING_WIZARD.md).

Expand Down
5 changes: 4 additions & 1 deletion docs/CONNECTION_ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,10 @@ Idle → Connecting → Connected
| Connected | Error/Rejected | Degraded |
| Connected | PairingRequired | PairingRequired |
| Connected | Connecting | Connecting |
| Connected | Disabled/Off | Connected |
| Connected | Idle while Node mode is intended | Degraded |
| Connected | Disabled/Off | Ready |

`GatewayConnectionSnapshot.NodeConnectionIntended` records the Node mode intent used by the manager's state machine. If Node mode is enabled but node startup is skipped, blocked, or missing a node credential, the manager publishes a blocked node snapshot (`NodeState=Error`, `NodeError=...`) instead of leaving the node idle and letting tray surfaces report a healthy connection.

## Gateway registry and persistence

Expand Down
2 changes: 2 additions & 0 deletions docs/MCP_MODE.md
Original file line number Diff line number Diff line change
Expand Up @@ -111,6 +111,8 @@ Settings UI exposes both toggles in the Advanced section, with the live MCP endp

A legacy `McpOnlyMode` field is migrated automatically on load and never re-written.

MCP startup is reported from the actual listener state. `NodeService.McpStartupError` is populated when capability registration or the HTTP listener fails, and MCP-only startup is not treated as successful unless the loopback MCP server is running. Tray, Permissions, and Command Center surfaces show local MCP-only separately from gateway connectivity so a working local MCP listener is never presented as a gateway connection.

## Why this matters

### Testing
Expand Down
162 changes: 0 additions & 162 deletions docs/ONBOARDING_V2.md

This file was deleted.

Loading
Loading