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를 확인합니다. 토큰 인증이 실질적으로 활성화되지 않은 경우(password/none/trusted-proxy 중 gateway.auth.mode이거나, 설정되지 않은 상태에서 비밀번호가 우선될 수 있는 경우) 구성 토큰 확인을 건너뜁니다.
• 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 운영 지침서