Daemon

기준일: 2026-07-26
공식 기준: Daemon

Daemon 문서는 OpenClaw 공식 문서(cli/daemon)를 한국어로 정리한 가이드입니다. CLI reference for openclaw daemon (legacy alias for gateway service management) 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

CLI reference for openclaw daemon (legacy alias for gateway service management)

한국어 가이드 범위: cli/daemon 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

사용법
Subcommands and options
참고
관련 문서

상세 내용

openclaw daemon

Legacy alias for Gateway service management. openclaw daemon ... maps to the same service-control commands as openclaw gateway .... Prefer openclaw gateway for current docs and examples.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

사용법

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall

Subcommands and options

주요 항목:

status: shows service install state (launchd/systemd/schtasks) and probes Gateway health.
install: installs the service; --force reinstalls/overwrites an existing install.
restart --safe: asks the running Gateway to preflight active work and schedule one coalesced restart after work drains, bounded to 5 minutes. When that budget expires, the restart is forced anyway. Plain restart uses the service manager directly; --force is the immediate override.
restart --safe --skip-deferral: bypasses the active-work deferral gate so the Gateway restarts immediately even when blockers are reported. Requires --safe.

Subcommand	Options
`status`	`--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json`
`install`	`--port`, `--runtime <node>`, `--token`, `--wrapper <path>`, `--force`, `--json`
`uninstall`	`--json`
`start`	`--json`
`stop`	`--json`, `--disable` (launchd only: persistently suppress KeepAlive/RunAtLoad until next start)
`restart`	`--force`, `--safe`, `--skip-deferral`, `--wait <duration>`, `--json`

참고

주요 항목:

status resolves configured auth SecretRefs for probe auth when possible. If a required SecretRef is unresolved, status --json reports rpc.authWarning; pass --token/--password explicitly or resolve the secret source first. Unresolved-auth warnings are suppressed once the probe otherwise succeeds.
status --deep adds a best-effort system-level scan for other gateway-like services (prints cleanup hints; one Gateway per machine is still the recommendation) and runs config validation in plugin-aware mode, surfacing plugin manifest warnings that the fast default path skips.
On Linux systemd installs, token-drift checks inspect both Environment= and EnvironmentFile= unit sources.
Token-drift checks resolve gateway.auth.token SecretRefs using merged runtime env (service command env first, then process env). If token auth is not effectively active (gateway.auth.mode of password/none/trusted-proxy, or unset with password able to win), config token resolution is skipped.
install validates a SecretRef-managed gateway.auth.token is resolvable but never persists the resolved value into service environment metadata; if it can't resolve, install fails closed.
If both gateway.auth.token and gateway.auth.password are configured and gateway.auth.mode is unset, install blocks until you set the mode explicitly.
On macOS, install keeps LaunchAgent plists and the generated env file/wrapper owner-only (mode 0600/0700) instead of embedding secrets in EnvironmentVariables.
Running multiple Gateways on one host: isolate ports, config/state, and workspaces. See Multiple gateways.

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/cli/daemon
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall

Daemon

기준일: 2026-07-26
공식 기준: Daemon

핵심 요약

CLI reference for openclaw daemon (legacy alias for gateway service management)

한국어 가이드 범위: cli/daemon 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

사용법
Subcommands and options
참고
관련 문서

상세 내용

openclaw daemon

Legacy alias for Gateway service management. openclaw daemon ... maps to the same service-control commands as openclaw gateway .... Prefer openclaw gateway for current docs and examples.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

사용법

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall

Subcommands and options

주요 항목:

status: shows service install state (launchd/systemd/schtasks) and probes Gateway health.
install: installs the service; --force reinstalls/overwrites an existing install.
restart --safe: asks the running Gateway to preflight active work and schedule one coalesced restart after work drains, bounded to 5 minutes. When that budget expires, the restart is forced anyway. Plain restart uses the service manager directly; --force is the immediate override.
restart --safe --skip-deferral: bypasses the active-work deferral gate so the Gateway restarts immediately even when blockers are reported. Requires --safe.

Subcommand	Options
`status`	`--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json`
`install`	`--port`, `--runtime <node>`, `--token`, `--wrapper <path>`, `--force`, `--json`
`uninstall`	`--json`
`start`	`--json`
`stop`	`--json`, `--disable` (launchd only: persistently suppress KeepAlive/RunAtLoad until next start)
`restart`	`--force`, `--safe`, `--skip-deferral`, `--wait <duration>`, `--json`

참고

주요 항목:

status resolves configured auth SecretRefs for probe auth when possible. If a required SecretRef is unresolved, status --json reports rpc.authWarning; pass --token/--password explicitly or resolve the secret source first. Unresolved-auth warnings are suppressed once the probe otherwise succeeds.
status --deep adds a best-effort system-level scan for other gateway-like services (prints cleanup hints; one Gateway per machine is still the recommendation) and runs config validation in plugin-aware mode, surfacing plugin manifest warnings that the fast default path skips.
On Linux systemd installs, token-drift checks inspect both Environment= and EnvironmentFile= unit sources.
Token-drift checks resolve gateway.auth.token SecretRefs using merged runtime env (service command env first, then process env). If token auth is not effectively active (gateway.auth.mode of password/none/trusted-proxy, or unset with password able to win), config token resolution is skipped.
install validates a SecretRef-managed gateway.auth.token is resolvable but never persists the resolved value into service environment metadata; if it can't resolve, install fails closed.
If both gateway.auth.token and gateway.auth.password are configured and gateway.auth.mode is unset, install blocks until you set the mode explicitly.
On macOS, install keeps LaunchAgent plists and the generated env file/wrapper owner-only (mode 0600/0700) instead of embedding secrets in EnvironmentVariables.
Running multiple Gateways on one host: isolate ports, config/state, and workspaces. See Multiple gateways.

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/cli/daemon
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall

Daemon

핵심 요약

문서 구성

상세 내용

openclaw daemon

사용법

Subcommands and options

참고

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

Daemon

핵심 요약

문서 구성

상세 내용

openclaw daemon

사용법

Subcommands and options

참고

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드