중급5분 소요openclawnodespresence

Active computer presence

Active computer presence 문서는 OpenClaw 공식 문서(nodes/presence)를 한국어로 정리한 가이드입니다. Detect the Mac you most recently used and route node alerts there 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Detect the Mac you most recently used and route node alerts there

한국어 가이드 범위: nodes/presence 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

요구사항
Check the active computer
How activity becomes presence
Privacy and model context
How connection alerts are routed
트러블슈팅
관련 문서

상세 내용

본문

Active computer presence tells the Gateway which connected macOS node received the most recent physical mouse or keyboard input. OpenClaw uses that signal to mark one Mac as active, give the agent a stable active-node hint, and route node connection alerts to the computer where you are most likely present.

요구사항

Activity reporting is currently implemented by the native macOS node. iOS, Android, watchOS, and headless node hosts can report connection or background last-seen state, but they do not compete for the active-computer designation.

주요 항목:

The OpenClaw macOS app is paired and connected in node mode.
Settings -> Permissions -> Active computer detection is enabled. It is off by default.
Accessibility permission is granted to the signed OpenClaw app.
For connection alerts, Notifications permission is also granted and the

Check the active computer

In the macOS app, open Settings -> Permissions, enable

openclaw nodes status --connected

openclaw nodes status
   openclaw nodes describe --node <node-id-or-name>

How activity becomes presence

The macOS reporter samples the HID system idle clock every two seconds. It reports once when a node connection becomes ready, then reports newer physical activity no more than once every 15 seconds. While idle, it sends a keepalive every three minutes. Idle duration is capped at 30 days so a very old sample cannot drift forward and incorrectly become the newest computer.

주요 항목:

the event belongs to the current authenticated connection for that node id;
the node has effective accessibility: true permission;
the payload contains a bounded integer idleSeconds value.

Privacy and model context

Activity sharing is off by default and is separate from the Accessibility grant used for UI automation. OpenClaw sends idle duration, not input content. It does not send key values, mouse coordinates, application names, window titles, or raw input events. The macOS reporter reads the hardware HID state, so synthetic computer-control events do not make an automated Mac appear to be the computer you physically used.

active_node=<node-id>

How connection alerts are routed

After a node finishes its first successful Gateway handshake after approval, OpenClaw waits 750 milliseconds so the connecting Mac can submit its first activity sample. It then tries the connected notification-capable Mac with the freshest activity.

주요 항목:

If primary delivery succeeds, no other Mac receives the alert.
If no active Mac is available or primary delivery fails, OpenClaw waits five
Later reconnects are silent. The Gateway records the successful connection

트러블슈팅

For TCC recovery, see macOS permissions. For node connection and command failures, see Node troubleshooting.

Symptom	Check
No row is marked `active`	Confirm active computer detection is enabled, a native macOS node is connected, and `openclaw nodes describe --node <id>` shows `permissions.accessibility: true`.
The wrong Mac remains active	Use that Mac physically, wait for the coalescing window, then rerun `openclaw nodes status`. Synthetic computer-control actions do not count.
Last-input data disappears	Check whether the Mac disconnected, its node session was replaced, or Accessibility was revoked. Each condition intentionally clears activity.
The alert appears on several Macs	Primary delivery was unavailable or failed, so the delayed fallback ran. Verify that the active Mac is connected, allows notifications, and exposes `system.notify`.
The agent does not mention the active Mac	Start a new turn after activity changes. The runtime hint is stable and compact; use the `nodes` tool for exact current metadata.

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/nodes/presence
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw nodes status --connected

openclaw nodes status
   openclaw nodes describe --node <node-id-or-name>

active_node=<node-id>

Active computer presence

핵심 요약

Detect the Mac you most recently used and route node alerts there

한국어 가이드 범위: nodes/presence 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

요구사항
Check the active computer
How activity becomes presence
Privacy and model context
How connection alerts are routed
트러블슈팅
관련 문서

상세 내용

본문

요구사항

주요 항목:

The OpenClaw macOS app is paired and connected in node mode.
Settings -> Permissions -> Active computer detection is enabled. It is off by default.
Accessibility permission is granted to the signed OpenClaw app.
For connection alerts, Notifications permission is also granted and the

Check the active computer

In the macOS app, open Settings -> Permissions, enable

openclaw nodes status --connected

openclaw nodes status
   openclaw nodes describe --node <node-id-or-name>

How activity becomes presence

주요 항목:

the event belongs to the current authenticated connection for that node id;
the node has effective accessibility: true permission;
the payload contains a bounded integer idleSeconds value.

Privacy and model context

active_node=<node-id>

How connection alerts are routed

주요 항목:

If primary delivery succeeds, no other Mac receives the alert.
If no active Mac is available or primary delivery fails, OpenClaw waits five
Later reconnects are silent. The Gateway records the successful connection

트러블슈팅

For TCC recovery, see macOS permissions. For node connection and command failures, see Node troubleshooting.

Symptom	Check
No row is marked `active`	Confirm active computer detection is enabled, a native macOS node is connected, and `openclaw nodes describe --node <id>` shows `permissions.accessibility: true`.
The wrong Mac remains active	Use that Mac physically, wait for the coalescing window, then rerun `openclaw nodes status`. Synthetic computer-control actions do not count.
Last-input data disappears	Check whether the Mac disconnected, its node session was replaced, or Accessibility was revoked. Each condition intentionally clears activity.
The alert appears on several Macs	Primary delivery was unavailable or failed, so the delayed fallback ran. Verify that the active Mac is connected, allows notifications, and exposes `system.notify`.
The agent does not mention the active Mac	Start a new turn after activity changes. The runtime hint is stable and compact; use the `nodes` tool for exact current metadata.

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/nodes/presence
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw nodes status --connected

openclaw nodes status
   openclaw nodes describe --node <node-id-or-name>

active_node=<node-id>

Active computer presence

핵심 요약

문서 구성

상세 내용

본문

요구사항

Check the active computer

How activity becomes presence

Privacy and model context

How connection alerts are routed

트러블슈팅

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

Active computer presence

핵심 요약

문서 구성

상세 내용

본문

요구사항

Check the active computer

How activity becomes presence

Privacy and model context

How connection alerts are routed

트러블슈팅

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드