Skip to main content
Kehadiran komputer aktif memberi tahu Gateway tentang node macOS terhubung 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 beacon 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.
  • Settings -> Permissions -> Active computer detection diaktifkan. Fitur ini dinonaktifkan secara default.
  • Izin Accessibility diberikan kepada aplikasi OpenClaw yang ditandatangani.
  • Untuk peringatan koneksi, izin Notifications juga diberikan dan node Mac mengekspos system.notify.
Pelaporan aktivitas saat ini diimplementasikan oleh node macOS native. Host node iOS, Android, watchOS, dan headless dapat melaporkan status terakhir terlihat saat terhubung atau di latar belakang, tetapi tidak bersaing untuk mendapatkan penetapan sebagai komputer aktif.

​
Memeriksa komputer aktif

  1. Di aplikasi macOS, buka Settings -> Permissions, aktifkan Active computer detection, lalu berikan izin Accessibility di macOS System Settings.
  2. Pastikan node Mac terhubung:
  3. Gerakkan mouse atau tekan tombol pada Mac tersebut, lalu jalankan:
Mac terbaru yang memenuhi syarat ditandai sebagai active. Output status menampilkan usia input terakhirnya; describe mengekspos 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 satu laporan saat koneksi node siap, lalu melaporkan aktivitas fisik yang lebih baru tidak lebih dari 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 ke depan dan secara keliru menjadi komputer terbaru. Menonaktifkan Active computer detection menghentikan pengambilan sampel dan mengirim peristiwa penghapusan terautentikasi melalui koneksi node saat ini. Gateway segera menghapus stempel waktu aktivitas Mac tersebut yang tersimpan dan menghitung ulang komputer aktif; kemampuan node lainnya dan pekerjaan yang sedang berlangsung tetap terhubung. Jika Gateway yang terhubung berasal dari versi sebelum tindakan penghapusan ini, node Mac akan terhubung kembali satu kali agar pembersihan saat pemutusan koneksi dapat menghapus aktivitas yang tersimpan. Gateway hanya menerima aktivitas jika semua kondisi berikut terpenuhi:
  • peristiwa tersebut termasuk dalam koneksi terautentikasi saat ini untuk id node tersebut;
  • node memiliki izin accessibility: true yang efektif;
  • payload berisi nilai bilangan bulat terbatas idleSeconds.
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 yang dipilih; 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

Berbagi aktivitas dinonaktifkan secara default dan terpisah dari pemberian izin Accessibility yang digunakan untuk otomatisasi UI. 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 ditujukan kepada model. Baris runtime dinamis hanya berisi id node terautentikasi:
Stempel waktu persis dan nama tampilan yang dikendalikan node tidak disertakan dalam 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 pertamanya yang berhasil setelah disetujui, OpenClaw menunggu 750 milidetik agar Mac yang terhubung dapat mengirim sampel aktivitas pertamanya. OpenClaw kemudian mencoba Mac terhubung yang mendukung 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 mengekspos system.notify.
  • Koneksi ulang berikutnya tidak menghasilkan pemberitahuan. Gateway mencatat koneksi yang berhasil dalam metadata pemasangan, sehingga memulai ulang Gateway tidak memutar ulang peringatan untuk setiap node yang sebelumnya terhubung.
Peringatan terikat pada identitas node terautentikasi. Sesi pengganti untuk node yang sama mengambil alih peringatan koneksi pertama yang tertunda; jika node tersebut tidak lagi terhubung saat pengiriman dijalankan, peringatan dibatalkan.

​
Pemecahan masalah

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

​
Terkait