Ứng dụng Android

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Ảnh chụp trạng thái hỗ trợ

• Vai trò: ứng dụng nút đồng hành (Android không host 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 nối.
• Gateway: Runbook + Cấu hình.
  • Giao thức: Giao thức Gateway (các nút + mặt phẳng điều khiển).

​

Điều khiển hệ thống

​

Runbook kết nối

• Ưu tiên: Tailscale Serve / Funnel với https://<magicdns> / wss://<magicdns>
• Cũng được hỗ trợ: bất kỳ URL Gateway wss:// nào khác có endpoint TLS thật
• ws:// dạng cleartext vẫn được hỗ trợ trên địa chỉ LAN riêng / host .local, cùng với localhost, 127.0.0.1 và cầu nối trình giả lập Android (10.0.2.2)

​

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

• Bạn có thể chạy Gateway trên máy “master”.
• Thiết bị/trình giả lập Android có thể truy cập gateway WebSocket:
  • Cùng LAN với mDNS/NSD, hoặc
  • Cùng tailnet Tailscale bằng Wide-Area Bonjour / unicast DNS-SD (xem bên dưới), hoặc
  • Host/cổng gateway thủ công (dự phòng)
• Ghép nối di động qua tailnet/công khai không dùng endpoint IP tailnet thô ws://. Thay vào đó hãy dùng Tailscale Serve hoặc URL wss:// khác.
• Bạn 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

openclaw gateway --tailscale serve

​

2) Xác minh discovery (tùy chọn)

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

openclaw gateway discover --json

​

Discovery qua tailnet (Vienna ⇄ London) bằng unicast DNS-SD

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

​

3) Kết nối từ Android

• Ứng dụng duy trì kết nối gateway bằng foreground service (thông báo thường trực).
• Mở thẻ Kết nối.
• Dùng chế độ Mã thiết lập hoặc Thủ công.
• Nếu discovery bị chặn, dùng host/cổng thủ công trong Điều khiển nâng cao. Với host LAN riêng, ws:// vẫn hoạt động. Với host Tailscale/công khai, bật TLS và dùng endpoint wss:// / Tailscale Serve.

• Endpoint thủ công (nếu được bật), nếu không thì
• Gateway được phát hiện gần nhất (nỗ lực tối đa).

​

Beacon báo hiện diện còn sống

​

4) Phê duyệt ghép nối (CLI)

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

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

​

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

• Qua trạng thái nút:
  openclaw nodes status
  
• Qua Gateway:
  openclaw gateway call node.list --params "{}"
  

​

6) Chat + lịch sử

• Lịch sử: chat.history (đã chuẩn hóa để hiển thị; thẻ chỉ thị inline bị loại khỏi văn bản hiển thị, payload XML gọi công cụ dạng văn bản thuần (bao gồm <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> và các khối gọi công cụ bị cắt ngắn) cùng token điều khiển mô hình ASCII/full-width bị lộ bị loại bỏ, các hàng assistant chỉ chứa token im lặng như chính xác NO_REPLY / no_reply bị bỏ qua, và các hàng quá lớn có thể được thay bằng placeholder)
• Gửi: chat.send
• Cập nhật push (nỗ lực tối đa): chat.subscribe → event:"chat"

​

7) Canvas + camera

​

Host Canvas Gateway (khuyến nghị cho nội dung web)

1. Tạo ~/.openclaw/workspace/canvas/index.html trên host gateway.
2. Điều hướng nút tới đó (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 (dùng {"url":""} hoặc {"url":"/"} để trở về 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 là alias cũ)

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

​

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

• Thẻ Voice: Android có hai chế độ thu âm rõ ràng. Mic là phiên thủ công trong thẻ Voice, gửi mỗi khoảng dừng thành một lượt chat và dừng khi ứng dụng rời foreground hoặc người dùng rời thẻ Voice. Talk là Chế độ Talk liên tục và tiếp tục nghe cho tới khi bị tắt hoặc nút ngắt kết nối.
• Chế độ Talk nâng foreground service hiện có từ dataSync lên dataSync|microphone trước khi bắt đầu thu âm, rồi hạ xuống khi Chế độ Talk dừng. Android 14+ yêu cầu khai báo FOREGROUND_SERVICE_MICROPHONE, quyền runtime RECORD_AUDIO và loại dịch vụ microphone tại runtime.
• Phản hồi bằng giọng nói dùng talk.speak thông qua nhà cung cấp Talk đã cấu hình của gateway. TTS hệ thống cục bộ chỉ được dùng khi talk.speak không khả dụng.
• Voice wake vẫn bị tắt trong UX/runtime của Android.
• Các nhóm lệnh Android bổ sung (mức khả dụng phụ thuộc vào thiết bị + quyền):
  • device.status, device.info, device.permissions, device.health
  • notifications.list, notifications.actions (xem Chuyển tiếp thông báo bên dưới)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

Điểm vào assistant

​

Chuyển tiếp thông báo

{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}

​

Liên quan

• Ứng dụng iOS
• Nút
• Khắc phục sự cố nút Android