​

openclaw daemon

​

사용법

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw 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 운영 지침서