Skip to content

Commit 790a240

Browse files
committed
docs: refresh daemon overview references
1 parent f39b5e8 commit 790a240

5 files changed

Lines changed: 28 additions & 2 deletions

File tree

docs/gateway/index.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -202,6 +202,22 @@ WantedBy=default.target
202202

203203
</Tab>
204204

205+
<Tab title="Windows (native)">
206+
207+
```powershell
208+
openclaw gateway install
209+
openclaw gateway status --json
210+
openclaw gateway restart
211+
openclaw gateway stop
212+
```
213+
214+
Native Windows managed startup uses a Scheduled Task named `OpenClaw Gateway`
215+
(or `OpenClaw Gateway (<profile>)` for named profiles). If Scheduled Task
216+
creation is denied, OpenClaw falls back to a per-user Startup-folder launcher
217+
that points at `gateway.cmd` inside the state directory.
218+
219+
</Tab>
220+
205221
<Tab title="Linux (system service)">
206222

207223
Use a system unit for multi-user/always-on hosts.

docs/install/index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,12 @@ openclaw doctor # check for config issues
133133
openclaw gateway status # verify the Gateway is running
134134
```
135135

136+
If you want managed startup after install:
137+
138+
- macOS: LaunchAgent via `openclaw onboard --install-daemon` or `openclaw gateway install`
139+
- Linux/WSL2: systemd user service via the same commands
140+
- Native Windows: Scheduled Task first, with a per-user Startup-folder login item fallback if task creation is denied
141+
136142
## Hosting and deployment
137143

138144
Deploy OpenClaw on a cloud server or VPS:

docs/platforms/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,3 +52,4 @@ The service target depends on OS:
5252

5353
- macOS: LaunchAgent (`ai.openclaw.gateway` or `ai.openclaw.<profile>`; legacy `com.openclaw.*`)
5454
- Linux/WSL2: systemd user service (`openclaw-gateway[-<profile>].service`)
55+
- Native Windows: Scheduled Task (`OpenClaw Gateway` or `OpenClaw Gateway (<profile>)`), with a per-user Startup-folder login item fallback if task creation is denied

docs/start/wizard-cli-reference.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Local mode (default) walks you through:
2020
- Workspace location and bootstrap files
2121
- Gateway settings (port, bind, auth, tailscale)
2222
- Channels and providers (Telegram, WhatsApp, Discord, Google Chat, Mattermost plugin, Signal)
23-
- Daemon install (LaunchAgent or systemd user unit)
23+
- Daemon install (LaunchAgent, systemd user unit, or native Windows Scheduled Task with Startup-folder fallback)
2424
- Health check
2525
- Skills setup
2626

@@ -79,6 +79,9 @@ It does not install or modify anything on the remote host.
7979
- Linux and Windows via WSL2: systemd user unit
8080
- Wizard attempts `loginctl enable-linger <user>` so gateway stays up after logout.
8181
- May prompt for sudo (writes `/var/lib/systemd/linger`); it tries without sudo first.
82+
- Native Windows: Scheduled Task first
83+
- If task creation is denied, OpenClaw falls back to a per-user Startup-folder login item and starts the gateway immediately.
84+
- Scheduled Tasks remain preferred because they provide better supervisor status.
8285
- Runtime selection: Node (recommended; required for WhatsApp and Telegram). Bun is not recommended.
8386
</Step>
8487
<Step title="Health check">

docs/start/wizard.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ Onboarding starts with **QuickStart** (defaults) vs **Advanced** (full control).
7878
In interactive token mode, choose default plaintext token storage or opt into SecretRef.
7979
Non-interactive token SecretRef path: `--gateway-token-ref-env <ENV_VAR>`.
8080
4. **Channels** — WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles, or iMessage.
81-
5. **Daemon** — Installs a LaunchAgent (macOS) or systemd user unit (Linux/WSL2).
81+
5. **Daemon** — Installs a LaunchAgent (macOS), systemd user unit (Linux/WSL2), or native Windows Scheduled Task with per-user Startup-folder fallback.
8282
If token auth requires a token and `gateway.auth.token` is SecretRef-managed, daemon install validates it but does not persist the resolved token into supervisor service environment metadata.
8383
If token auth requires a token and the configured token SecretRef is unresolved, daemon install is blocked with actionable guidance.
8484
If both `gateway.auth.token` and `gateway.auth.password` are configured and `gateway.auth.mode` is unset, daemon install is blocked until mode is set explicitly.

0 commit comments

Comments
 (0)