OpenClaw 데몬 서비스 관리: 설치 및 제어 명령어 가이드

서버를 관리하다 보면 백그라운드 서비스를 제어하는 일이 잦죠. 특히 기존에 사용하던 명령어가 변경되거나 새로운 방식으로 통합될 때 조금 헷갈릴 수 있습니다. 오늘은 Gateway 서비스를 관리할 때 사용하는 레거시 별칭인 openclaw daemon에 대해 정리해 드릴게요.

openclaw daemon은 Gateway 서비스 관리 명령어를 위한 레거시 별칭이에요. openclaw daemon ...을 실행하면 openclaw gateway ... 서비스 명령어와 동일한 서비스 제어 기능을 사용할 수 있습니다.

Usage

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

Subcommands

• status: 서비스 설치 상태를 보여주고 Gateway health를 확인합니다.
• install: 서비스(launchd/systemd/schtasks)를 설치합니다.
• uninstall: 서비스를 제거합니다.
• start: 서비스를 시작합니다.
• stop: 서비스를 중지합니다.
• restart: 서비스를 재시작합니다.

Common options

• status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
• install: --port, --runtime <node|bun>, --token, --force, --json
• lifecycle (uninstall|start|stop|restart): --json

참고 사항:

• status는 가능할 때 probe 인증을 위해 설정된 인증 SecretRefs를 확인해요.
• 필요한 인증 SecretRef가 이 명령어 경로에서 해결되지 않은 상태로 probe 연결이나 인증이 실패하면, daemon status --json은 rpc.authWarning을 보고합니다. 이럴 때는 --token이나 --password를 직접 전달하거나 secret 소스를 먼저 해결해 주세요.
• probe에 성공하면 잘못된 경고를 방지하기 위해 해결되지 않은 auth-ref 경고는 표시되지 않아요.
• Linux systemd 설치의 경우, status의 token-drift 체크에는 Environment=와 EnvironmentFile= 유닛 소스가 모두 포함됩니다.
• Drift 체크는 병합된 런타임 환경(서비스 명령어 환경 우선, 프로세스 환경 폴백 순)을 사용하여 gateway.auth.token SecretRefs를 확인해요.
• 토큰 인증이 활성화되지 않은 경우(예: gateway.auth.mode가 password/none/trusted-proxy로 명시되었거나, 모드가 설정되지 않아 password가 우선되고 토큰 후보가 없는 경우), token-drift 체크는 설정 토큰 확인을 건너뜁니다.
• 토큰 인증에 토큰이 필요하고 gateway.auth.token이 SecretRef로 관리될 때, install은 SecretRef를 확인할 수 있는지 검증하지만 확인된 토큰을 서비스 환경 메타데이터에 저장하지는 않아요.
• 토큰 인증에 토큰이 필요한데 설정된 토큰 SecretRef를 확인할 수 없으면 설치가 실패합니다.
• gateway.auth.token과 gateway.auth.password가 모두 설정되어 있고 gateway.auth.mode가 설정되지 않은 경우, 모드를 명시적으로 설정할 때까지 설치가 차단돼요.

Prefer

최신 문서와 예제는 openclaw gateway를 확인해 주세요.

다음 단계

• Gateway CLI 상세 가이드
• 서비스 구성 및 환경 설정

AI Setup Assistant