openclaw daemon

Gateway 서비스 관리를 위한 레거시 별칭입니다. openclaw daemon ...은 openclaw gateway ...와 동일한 서비스 제어 명령에 매핑됩니다. 최신 문서와 예시에서는 openclaw gateway를 사용하는 것이 좋습니다.

사용법

openclaw daemon statusopenclaw daemon installopenclaw daemon startopenclaw daemon stopopenclaw daemon restartopenclaw daemon uninstall

하위 명령 및 옵션

• status: 서비스 설치 상태(launchd/systemd/schtasks)를 표시하고 Gateway 상태를 검사합니다.
• install: 서비스를 설치합니다. --force는 기존 설치를 다시 설치하거나 덮어씁니다.
• restart --safe: 실행 중인 Gateway에 활성 작업을 사전 점검하고 작업이 모두 완료된 후 하나로 병합된 재시작을 예약하도록 요청합니다. 대기 시간은 gateway.reload.deferralTimeoutMs로 제한됩니다(기본값 300000ms/5분, 무기한 대기하려면 0으로 설정). 이 제한 시간이 만료되면 재시작이 강제로 수행됩니다. 일반 restart는 서비스 관리자를 직접 사용하며, --force는 즉시 실행하는 재정의 옵션입니다.
• restart --safe --skip-deferral: 활성 작업 연기 게이트를 우회하여 차단 요인이 보고되더라도 Gateway를 즉시 재시작합니다. --safe가 필요합니다.

참고 사항

• status는 가능한 경우 검사 인증을 위해 구성된 인증 SecretRef를 해석합니다. 필수 SecretRef를 해석할 수 없으면 status --json이 rpc.authWarning을 보고합니다. --token/--password를 명시적으로 전달하거나 먼저 비밀 소스를 해석하십시오. 인증 미해결 경고는 검사가 다른 면에서 성공하면 더 이상 표시되지 않습니다.
• status --deep은 Gateway와 유사한 다른 서비스를 찾기 위한 최선형 시스템 수준 검사를 추가하고(정리 방법을 출력하지만, 시스템당 하나의 Gateway 사용이 여전히 권장됨), Plugin 인식 모드에서 구성 검증을 실행하여 빠른 기본 경로에서 건너뛰는 Plugin 매니페스트 경고를 표시합니다.
• Linux systemd 설치에서는 토큰 불일치 검사 시 Environment=와 EnvironmentFile= 유닛 소스를 모두 확인합니다.
• 토큰 불일치 검사는 병합된 런타임 환경(서비스 명령 환경 우선, 그다음 프로세스 환경)을 사용하여 gateway.auth.token SecretRef를 해석합니다. 토큰 인증이 실질적으로 활성화되지 않은 경우(gateway.auth.mode가 password/none/trusted-proxy이거나, 설정되지 않았으며 비밀번호가 우선할 수 있는 경우) 구성 토큰 해석을 건너뜁니다.
• install은 SecretRef로 관리되는 gateway.auth.token을 해석할 수 있는지 검증하지만, 해석된 값을 서비스 환경 메타데이터에 저장하지 않습니다. 해석할 수 없으면 설치가 안전하게 실패합니다.
• gateway.auth.token과 gateway.auth.password가 모두 구성되어 있고 gateway.auth.mode가 설정되지 않은 경우, 모드를 명시적으로 설정할 때까지 install이 차단됩니다.
• macOS에서 install은 비밀을 EnvironmentVariables에 포함하는 대신 LaunchAgent plist와 생성된 환경 파일/래퍼를 소유자만 접근 가능하도록 유지합니다(모드 0600/0700).
• 한 호스트에서 여러 Gateway를 실행하려면 포트, 구성/상태 및 작업 공간을 분리하십시오. 여러 Gateway를 참조하십시오.

관련 문서

• CLI 참조
• Gateway 운영 가이드