Nodes and media

Keberadaan komputer aktif

Kehadiran komputer aktif memberi tahu Gateway node macOS terhubung mana yang menerima input fisik mouse atau papan ketik terbaru. OpenClaw menggunakan sinyal tersebut untuk menandai satu Mac sebagai active, memberikan petunjuk node aktif yang stabil kepada agen, dan merutekan peringatan koneksi node ke komputer tempat Anda kemungkinan besar berada.

Ini terpisah dari kehadiran sistem, yaitu daftar langsung klien Gateway, dan dari suar node.presence.alive yang persisten, yang mencatat kapan node seluler terakhir aktif tanpa menganggapnya terhubung.

Persyaratan

Aplikasi OpenClaw macOS telah dipasangkan dan terhubung dalam mode node.
Izin Accessibility diberikan kepada aplikasi OpenClaw yang ditandatangani.
Untuk peringatan koneksi, izin Notifications juga diberikan dan node Mac menyediakan system.notify.

Pelaporan aktivitas saat ini diterapkan oleh node macOS native. Host node iOS, Android, watchOS, dan tanpa antarmuka dapat melaporkan koneksi atau status terakhir terlihat di latar belakang, tetapi tidak bersaing untuk penetapan komputer aktif.

Memeriksa komputer aktif

Di aplikasi macOS, buka Settings -> Permissions dan berikan Accessibility di macOS System Settings.
Pastikan node Mac terhubung:
bash
```
openclaw nodes status --connected
```
Gerakkan mouse atau tekan tombol pada Mac tersebut, lalu jalankan:
bash
```
openclaw nodes statusopenclaw nodes describe --node <node-id-or-name>
```

Mac memenuhi syarat yang paling baru ditandai sebagai active. Output status menampilkan usia input terakhirnya; describe menyediakan active, lastActiveAtMs, dan presenceUpdatedAtMs. Aktivitas sengaja digabungkan, sehingga tampilan mungkin memerlukan waktu hingga sekitar 15 detik untuk mencerminkan input lain setelah laporan terbaru.

Cara aktivitas menjadi kehadiran

Pelapor macOS mengambil sampel jam idle sistem HID setiap dua detik. Pelapor mengirim laporan sekali saat koneksi node siap, lalu melaporkan aktivitas fisik yang lebih baru paling sering sekali setiap 15 detik. Saat idle, pelapor mengirim keepalive setiap tiga menit. Durasi idle dibatasi hingga 30 hari agar sampel yang sangat lama tidak bergeser maju dan secara keliru menjadi komputer terbaru.

Gateway menerima aktivitas hanya jika semua kondisi berikut terpenuhi:

peristiwa tersebut milik koneksi terautentikasi saat ini untuk id node tersebut;
node memiliki izin accessibility: true yang efektif;
payload berisi nilai bilangan bulat idleSeconds yang dibatasi.

Gateway mengurangi idleSeconds dari waktu pengamatannya sendiri untuk memperoleh lastActiveAtMs. Gateway tidak pernah memercayai stempel waktu jam dinding yang diberikan node. Di antara Mac terhubung yang memenuhi syarat, lastActiveAtMs terbaru menang; jika seri, pembaruan kehadiran terbaru digunakan.

Kehadiran bersifat lokal bagi proses dan terikat pada koneksi. Memutuskan sesi saat ini, menggantinya dengan sesi lain yang menggunakan id node yang sama, atau mencabut Accessibility akan menghapus status aktivitas node tersebut dan menghitung ulang Mac aktif.

Privasi dan konteks model

OpenClaw mengirim durasi idle, bukan konten input. OpenClaw tidak mengirim nilai tombol, koordinat mouse, nama aplikasi, judul jendela, atau peristiwa input mentah. Pelapor macOS membaca status HID perangkat keras, sehingga peristiwa kontrol komputer sintetis tidak membuat Mac otomatis tampak sebagai komputer yang Anda gunakan secara fisik.

Aktivitas berkelanjutan tidak membuat peristiwa sistem yang dihadapkan ke model. Baris runtime dinamis hanya berisi id node terautentikasi:

text

active_node=<node-id>

Stempel waktu yang tepat dan nama tampilan yang dikendalikan node tidak dimasukkan ke prompt untuk menghindari injeksi prompt dan perubahan cache. Saat agen memerlukan detail terkini, alat nodes dapat membaca node.list atau node.describe sebagai gantinya.

Cara peringatan koneksi dirutekan

Setelah node menyelesaikan handshake Gateway, OpenClaw menunggu 750 milidetik agar Mac yang terhubung dapat mengirimkan sampel aktivitas pertamanya. Kemudian OpenClaw mencoba Mac terhubung berkemampuan notifikasi dengan aktivitas terbaru.

Jika pengiriman utama berhasil, tidak ada Mac lain yang menerima peringatan.
Jika tidak ada Mac aktif yang tersedia atau pengiriman utama gagal, OpenClaw menunggu lima detik dan mencoba setiap Mac terhubung lainnya yang menyediakan system.notify.
Peringatan koneksi ulang untuk node yang sama ditekan selama lima menit setelah upaya pengiriman aktual, sehingga koneksi ulang yang berulang tidak menghasilkan banjir notifikasi.

Peringatan terikat pada koneksi node yang tepat. Sesi sumber yang terputus atau diganti tidak dapat menyelesaikan peringatan terjadwal lama, dan koneksi tujuan pengganti tetap dapat berpartisipasi dalam pengiriman cadangan.

Pemecahan masalah

Gejala	Pemeriksaan
Tidak ada baris yang ditandai `active`	Pastikan node macOS native terhubung dan `openclaw nodes describe --node <id>` menampilkan `permissions.accessibility: true`.
Mac yang salah tetap aktif	Gunakan Mac tersebut secara fisik, tunggu jendela penggabungan, lalu jalankan kembali `openclaw nodes status`. Tindakan kontrol komputer sintetis tidak dihitung.
Data input terakhir menghilang	Periksa apakah Mac terputus, sesi nodenya diganti, atau Accessibility dicabut. Setiap kondisi memang sengaja menghapus aktivitas.
Peringatan muncul di beberapa Mac	Pengiriman utama tidak tersedia atau gagal, sehingga mekanisme cadangan tertunda dijalankan. Pastikan Mac aktif terhubung, mengizinkan notifikasi, dan menyediakan `system.notify`.
Agen tidak menyebutkan Mac aktif	Mulai giliran baru setelah aktivitas berubah. Petunjuk runtime stabil dan ringkas; gunakan alat `nodes` untuk metadata terkini yang tepat.

Untuk pemulihan TCC, lihat izin macOS. Untuk kegagalan koneksi dan perintah node, lihat Pemecahan masalah Node.

Terkait

Was this useful?