메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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, --skip-deferral, --force, --wait <duration>, --json
  • 수명 주기(uninstall|start|stop): --json
참고:
  • status는 가능할 때 프로브 인증을 위해 구성된 인증 SecretRef를 해석합니다.
  • 이 명령 경로에서 필요한 인증 SecretRef가 해석되지 않은 경우, 프로브 연결/인증이 실패하면 daemon status --json은 rpc.authWarning을 보고합니다. --token/--password를 명시적으로 전달하거나 먼저 시크릿 소스를 해석하세요.
  • 프로브가 성공하면 잘못된 양성 결과를 방지하기 위해 해석되지 않은 auth-ref 경고가 억제됩니다.
  • status --deep은 최선 노력 방식의 시스템 수준 서비스 스캔을 추가합니다. 다른 Gateway 유사 서비스를 발견하면 사람이 읽는 출력은 정리 힌트를 출력하고 머신당 하나의 Gateway가 여전히 일반적인 권장 사항임을 경고합니다.
  • status --deep은 Plugin 인식 모드에서 구성 검증도 실행하고, 구성된 Plugin 매니페스트 경고(예: 누락된 채널 구성 메타데이터)를 노출하여 설치 및 업데이트 스모크 검사가 이를 포착하도록 합니다. 기본 status는 Plugin 검증을 건너뛰는 빠른 읽기 전용 경로를 유지합니다.
  • Linux systemd 설치에서 status 토큰 드리프트 검사는 Environment= 및 EnvironmentFile= 유닛 소스를 모두 포함합니다.
  • 드리프트 검사는 병합된 런타임 env(먼저 서비스 명령 env, 그다음 프로세스 env 폴백)를 사용하여 gateway.auth.token SecretRef를 해석합니다.
  • 토큰 인증이 실질적으로 활성 상태가 아닌 경우(명시적 gateway.auth.mode가 password/none/trusted-proxy이거나, 모드가 설정되지 않았고 password가 우선될 수 있으며 이길 수 있는 토큰 후보가 없는 경우), 토큰 드리프트 검사는 구성 토큰 해석을 건너뜁니다.
  • 토큰 인증에 토큰이 필요하고 gateway.auth.token이 SecretRef로 관리되는 경우, install은 SecretRef가 해석 가능한지 검증하지만 해석된 토큰을 서비스 환경 메타데이터에 유지하지 않습니다.
  • 토큰 인증에 토큰이 필요하고 구성된 토큰 SecretRef가 해석되지 않으면 설치는 닫힌 상태로 실패합니다.
  • gateway.auth.token과 gateway.auth.password가 모두 구성되어 있고 gateway.auth.mode가 설정되지 않은 경우, 모드가 명시적으로 설정될 때까지 설치가 차단됩니다.
  • macOS에서 install은 LaunchAgent plist를 소유자 전용으로 유지하고 API 키 또는 auth-profile env ref를 EnvironmentVariables에 직렬화하는 대신 소유자 전용 파일과 래퍼를 통해 관리형 서비스 환경 값을 로드합니다.
  • 의도적으로 한 호스트에서 여러 Gateway를 실행하는 경우 포트, 구성/상태, 워크스페이스를 격리하세요. /gateway#multiple-gateways-same-host를 참조하세요.
  • restart --safe는 실행 중인 Gateway에 활성 작업을 사전 점검하고 활성 작업이 비워진 뒤 하나로 병합된 재시작을 예약하도록 요청합니다. 일반 restart는 기존 서비스 관리자 동작을 유지하며, --force는 즉시 재정의 경로로 유지됩니다.
  • restart --safe --skip-deferral은 OpenClaw 인식 안전 재시작을 실행하지만 활성 작업 지연 게이트를 우회하므로 차단 요소가 보고되더라도 Gateway가 즉시 재시작을 내보냅니다. 안전 재시작을 고정하는 멈춘 작업 실행이 있을 때 운영자용 탈출구이며, --safe가 필요합니다.

​
권장

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

​
관련