​

Ứng dụng Android (Node)

Lưu ý: Ứng dụng Android chưa được phát hành công khai. Mã nguồn có sẵn trong kho OpenClaw dưới apps/android. Bạn có thể tự xây dựng bằng Java 17 và Android SDK (./gradlew :app:assemblePlayDebug). Xem apps/android/README.md để biết hướng dẫn xây dựng.

​

Hỗ trợ snapshot

• Vai trò: ứng dụng node đồng hành (Android không lưu trữ Gateway).
• Yêu cầu Gateway: có (chạy trên macOS, Linux, hoặc Windows qua WSL2).
• Cài đặt: Bắt đầu + Ghép đôi.
• Gateway: Hướng dẫn + Cấu hình.
  • Giao thức: Giao thức Gateway (nodes + control plane).

​

Kiểm soát hệ thống

​

Hướng dẫn kết nối

​

Điều kiện tiên quyết

• Có thể chạy Gateway trên máy “chủ”.
• Thiết bị/emulator Android có thể truy cập WebSocket của gateway:
  • Cùng mạng LAN với mDNS/NSD, hoặc
  • Cùng mạng Tailscale sử dụng Wide-Area Bonjour / unicast DNS-SD (xem bên dưới), hoặc
  • Thủ công nhập host/port của gateway (dự phòng)
• Có thể chạy CLI (openclaw) trên máy gateway (hoặc qua SSH).

​

1) Khởi động Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

• Đặt gateway.bind: "tailnet" trong ~/.openclaw/openclaw.json trên máy chủ gateway.
• Khởi động lại Gateway / ứng dụng menubar macOS.

​

2) Xác minh phát hiện (tùy chọn)

dns-sd -B _openclaw-gw._tcp local.

​

Phát hiện Tailnet (Vienna ⇄ London) qua unicast DNS-SD

1. Thiết lập một vùng DNS-SD (ví dụ openclaw.internal.) trên máy chủ gateway và công bố các bản ghi _openclaw-gw._tcp.
2. Cấu hình Tailscale split DNS cho miền đã chọn trỏ vào máy chủ DNS đó.

​

3) Kết nối từ Android

• Ứng dụng giữ kết nối gateway thông qua một dịch vụ nền (thông báo liên tục).
• Mở tab Connect.
• Sử dụng Setup Code hoặc chế độ Manual.
• Nếu phát hiện bị chặn, sử dụng host/port thủ công (và TLS/token/mật khẩu khi cần) trong Advanced controls.

• Điểm cuối thủ công (nếu được bật), nếu không
• Gateway cuối cùng được phát hiện (nỗ lực tốt nhất).

​

4) Phê duyệt ghép đôi (CLI)

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

​

5) Xác minh node đã kết nối

• Qua trạng thái nodes:
  Sao chép

  Hỏi AI

  openclaw nodes status
  
• Qua Gateway:
  Sao chép

  Hỏi AI

  openclaw gateway call node.list --params "{}"
  

​

6) Chat + lịch sử

• Lịch sử: chat.history
• Gửi: chat.send
• Cập nhật đẩy (nỗ lực tốt nhất): chat.subscribe → event:"chat"

​

7) Canvas + camera

​

Máy chủ Canvas Gateway (khuyến nghị cho nội dung web)

1. Tạo ~/.openclaw/workspace/canvas/index.html trên máy chủ gateway.
2. Điều hướng node đến đó (LAN):

openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'

• canvas.eval, canvas.snapshot, canvas.navigate (sử dụng {"url":""} hoặc {"url":"/"} để quay lại scaffold mặc định). canvas.snapshot trả về { format, base64 } (mặc định format="jpeg").
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL alias cũ)

• camera.snap (jpg)
• camera.clip (mp4)

​

8) Voice + bề mặt lệnh Android mở rộng

• Voice: Android sử dụng một luồng mic bật/tắt duy nhất trong tab Voice với ghi âm và phát lại TTS (ElevenLabs khi được cấu hình, hệ thống TTS dự phòng). Voice dừng khi ứng dụng rời khỏi nền trước.
• Các công tắc wake/talk-mode của Voice hiện đã bị loại bỏ khỏi UX/runtime của Android.
• Các nhóm lệnh Android bổ sung (tùy thuộc vào thiết bị + quyền):
  • device.status, device.info, device.permissions, device.health
  • notifications.list, notifications.actions
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer