openclaw system으로 Gateway 관리하기

시스템을 운영하다 보면 특정 이벤트를 즉시 주입하거나 시스템의 활성 상태를 실시간으로 확인해야 할 때가 있죠. 하지만 상태 확인 절차가 복잡하면 개발 흐름이 쉽게 끊기곤 해요. openclaw system 명령어를 사용하면 Gateway의 시스템 레벨 헬퍼를 통해 이런 작업을 간단하게 처리할 수 있어요.

이 도구는 시스템 이벤트를 큐에 추가하거나 heartbeat를 제어하고, 현재 presence 상태를 조회하는 기능을 제공해요. 복잡한 설정 없이 CLI에서 바로 시스템의 상태를 파악하고 조작해 보세요.

필요한 것

• 현재 config로 접속 가능한 실행 중인 Gateway (로컬 또는 원격)

빠른 시작

5분 안에 가장 자주 쓰이는 명령어를 실행해 보세요.

# 즉시 실행되는 시스템 이벤트 예약
openclaw system event --text "Check for urgent follow-ups" --mode now

# heartbeat 활성화
openclaw system heartbeat enable

# 마지막 heartbeat 이벤트 확인
openclaw system heartbeat last

# 현재 presence 항목 목록 확인
openclaw system presence

주요 기능 활용하기

system event

main 세션에 시스템 이벤트를 큐에 추가해요. 다음 heartbeat가 발생할 때 프롬프트에 System: 라인으로 주입돼요.

• --text <text>: (필수) 시스템 이벤트에 들어갈 텍스트예요.
• --mode <mode>: now(즉시 heartbeat 트리거) 또는 next-heartbeat(예약된 다음 틱까지 대기, 기본값) 중 선택하세요.
• --json: 결과값을 기계가 읽을 수 있는 JSON 형식으로 출력해요.

system heartbeat

Heartbeat의 동작을 직접 제어할 수 있어요.

• last: 마지막으로 발생한 heartbeat 이벤트를 보여줘요.
• enable: 비활성화된 heartbeat를 다시 켜요.
• disable: heartbeat를 일시 정지해요.
• --json: 결과를 JSON 형식으로 출력해요.

system presence

Gateway가 파악하고 있는 node, instance 등 현재 시스템의 presence 항목과 상태 라인을 리스트로 보여줘요.

• --json: 결과를 JSON 형식으로 출력해요.

문제 해결

• Gateway 접속 불가: 현재 설정된 config가 실행 중인 Gateway에 올바르게 연결되어 있는지 확인해 보세요.
• 이벤트 사라짐: 시스템 이벤트는 일시적(ephemeral)인 데이터예요. Gateway를 재시작하면 저장되지 않고 사라지니 주의하세요.

궁금한 점이 있다면 AI Setup Assistant에서 바로 도움을 받을 수 있어요.

다음 단계

• Gateway 설정 가이드
• Node 관리 커맨드 알아보기