# openclaw daemon

Gateway 서비스 관리 명령의 레거시 별칭입니다.

openclaw daemon ...은 openclaw gateway ... 서비스 명령과 동일한 서비스 제어 표면에 매핑됩니다.

# 사용법

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

# 하위 명령

• status: 서비스 설치 상태를 표시하고 Gateway 상태를 프로브합니다
• install: 서비스를 설치합니다(launchd/systemd/schtasks)
• uninstall: 서비스를 제거합니다
• start: 서비스를 시작합니다
• stop: 서비스를 중지합니다
• restart: 서비스를 다시 시작합니다

# 공통 옵션

• status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
• install: --port, --runtime <node|bun>, --token, --force, --json
• restart: --safe, --force, --wait <duration>, --json
• 수명 주기(uninstall|start|stop): --json

참고:

• status는 가능한 경우 프로브 인증을 위해 구성된 인증 SecretRefs를 확인합니다.
• 이 명령 경로에서 필수 인증 SecretRef를 확인할 수 없으면, 프로브 연결/인증에 실패할 때 daemon status --json은 rpc.authWarning을 보고합니다. --token/--password를 명시적으로 전달하거나 먼저 비밀 소스를 확인하세요.
• 프로브가 성공하면 미확인 auth-ref 경고는 오탐을 피하기 위해 표시되지 않습니다.
• status --deep은 최선 노력 방식의 시스템 수준 서비스 스캔을 추가합니다. 다른 gateway 유사 서비스를 발견하면 사람이 읽는 출력에 정리 힌트를 표시하고, 머신당 하나의 gateway가 여전히 일반적인 권장 사항임을 경고합니다.
• Linux systemd 설치에서 status 토큰 드리프트 검사는 Environment= 및 EnvironmentFile= 단위 소스를 모두 포함합니다.
• 드리프트 검사는 병합된 런타임 env를 사용하여 gateway.auth.token SecretRefs를 확인합니다. 서비스 명령 env를 먼저 사용하고, 그다음 프로세스 env를 대체로 사용합니다.
• 토큰 인증이 실질적으로 활성 상태가 아닌 경우(gateway.auth.mode가 명시적으로 password/none/trusted-proxy이거나, 모드가 설정되지 않아 password가 우선될 수 있고 토큰 후보가 우선될 수 없는 경우), 토큰 드리프트 검사는 config 토큰 확인을 건너뜁니다.
• 토큰 인증에 토큰이 필요하고 gateway.auth.token이 SecretRef로 관리되는 경우, install은 SecretRef를 확인할 수 있는지 검증하지만 확인된 토큰을 서비스 환경 메타데이터에 유지하지 않습니다.
• 토큰 인증에 토큰이 필요하고 구성된 토큰 SecretRef를 확인할 수 없으면 설치는 안전하게 실패합니다.
• gateway.auth.token과 gateway.auth.password가 모두 구성되어 있고 gateway.auth.mode가 설정되지 않은 경우, 모드가 명시적으로 설정될 때까지 설치가 차단됩니다.
• macOS에서 install은 LaunchAgent plists를 소유자 전용으로 유지하고, API 키나 auth-profile env refs를 EnvironmentVariables에 직렬화하는 대신 소유자 전용 파일과 래퍼를 통해 관리형 서비스 환경 값을 로드합니다.
• 한 호스트에서 여러 gateways를 의도적으로 실행하는 경우 포트, config/상태, 작업 공간을 분리하세요. /gateway#multiple-gateways-same-host를 참조하세요.
• restart --safe는 실행 중인 Gateway에 활성 작업을 사전 점검하고 활성 작업이 빠진 뒤 하나로 병합된 재시작을 예약하도록 요청합니다. 일반 restart는 기존 서비스 관리자 동작을 유지하며, --force는 즉시 재정의 경로로 남아 있습니다.

# 권장

현재 문서와 예제는 openclaw gateway를 사용하세요.

# 관련 항목

• CLI 참조
• Gateway 런북