메인 콘텐츠로 건너뛰기

openclaw system

Gateway를 위한 system-level helper입니다. system event를 queue에 넣고, heartbeat를 제어하고, presence를 확인할 수 있습니다.

Common commands

openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence

system event

main session에 system event를 enqueue합니다. 다음 heartbeat가 이를 prompt 안의 System: line으로 주입합니다. --mode now를 사용하면 heartbeat를 즉시 트리거하고, next-heartbeat는 다음 scheduled tick까지 기다립니다. Flags:
  • --text <text>: 필수 system event text
  • --mode <mode>: now 또는 next-heartbeat (기본값)
  • --json: machine-readable output

system heartbeat last|enable|disable

heartbeat 제어:
  • last: 마지막 heartbeat event 표시
  • enable: heartbeat를 다시 켭니다. (비활성화되어 있던 경우)
  • disable: heartbeat를 일시 중지합니다.
Flags:
  • --json: machine-readable output

system presence

Gateway가 알고 있는 현재 system presence entry(node, instance, 기타 status line)를 나열합니다. Flags:
  • --json: machine-readable output

Notes

  • 현재 config(local 또는 remote)로 접근 가능한 실행 중인 Gateway가 필요합니다.
  • system event는 ephemeral하며 restart 이후에는 유지되지 않습니다.