@@ -422,6 +422,41 @@ openclaw gateway restart
|
422 | 422 | openclaw gateway uninstall |
423 | 423 | ``` |
424 | 424 | |
| 425 | +### Install with a wrapper |
| 426 | + |
| 427 | +Use `--wrapper` when the managed service must start through another executable, for example a |
| 428 | +secrets manager shim or a run-as helper. The wrapper receives the normal Gateway args and is |
| 429 | +responsible for eventually exec'ing `openclaw` or Node with those args. |
| 430 | + |
| 431 | +```bash |
| 432 | +cat > ~/.local/bin/openclaw-doppler <<'EOF' |
| 433 | +#!/usr/bin/env bash |
| 434 | +set -euo pipefail |
| 435 | +exec doppler run --project my-project --config production -- openclaw "$@" |
| 436 | +EOF |
| 437 | +chmod +x ~/.local/bin/openclaw-doppler |
| 438 | + |
| 439 | +openclaw gateway install --wrapper ~/.local/bin/openclaw-doppler --force |
| 440 | +openclaw gateway restart |
| 441 | +``` |
| 442 | + |
| 443 | +You can also set the wrapper through the environment. `gateway install` validates that the path is |
| 444 | +an executable file, writes the wrapper into service `ProgramArguments`, and persists |
| 445 | +`OPENCLAW_WRAPPER` in the service environment for later forced reinstalls, updates, and doctor |
| 446 | +repairs. |
| 447 | + |
| 448 | +```bash |
| 449 | +OPENCLAW_WRAPPER="$HOME/.local/bin/openclaw-doppler" openclaw gateway install --force |
| 450 | +openclaw doctor |
| 451 | +``` |
| 452 | + |
| 453 | +To remove a persisted wrapper, clear `OPENCLAW_WRAPPER` while reinstalling: |
| 454 | + |
| 455 | +```bash |
| 456 | +OPENCLAW_WRAPPER= openclaw gateway install --force |
| 457 | +openclaw gateway restart |
| 458 | +``` |
| 459 | + |
425 | 460 | <AccordionGroup> |
426 | 461 | <Accordion title="Command options"> |
427 | 462 | - `gateway status`: `--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json` |
|