Ứng dụng Android

Documentation Index

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

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

​

Ảnh chụp nhanh hỗ trợ

• Vai trò: ứng dụng node đồ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 đôi.
• Gateway: Sổ tay vận hành + Cấu hình.
  • Giao thức: Giao thức Gateway (node + control plane).

​

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

​

Sổ tay 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 với endpoint TLS thật
• Văn bản rõ ws:// 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 WebSocket gateway:
  • 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 đô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 một 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 khám phá (tùy chọn)

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

openclaw gateway discover --json

​

Khám phá tailnet (Vienna ⇄ London) qua unicast DNS-SD

1. Thiết lập một vùng DNS-SD (ví dụ openclaw.internal.) trên host gateway và xuất bản 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 giữ kết nối gateway còn sống qua một foreground service (thông báo thường trực).
• Mở tab Connect.
• Dùng chế độ Setup Code hoặc Manual.
• Nếu khám phá bị chặn, dùng host/cổng thủ công trong Advanced controls. 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 đã bật), nếu không thì
• Gateway được khám phá lần cuối (nỗ lực tối đa).

​

Beacon báo còn sống của presence

​

4) Phê duyệt ghép đô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 node đã kết nối

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

​

6) Chat + lịch sử

• Lịch sử: chat.history (được chuẩn hóa để hiển thị; các thẻ chỉ thị nội tuyến bị loại khỏi văn bản hiển thị, payload XML lệnh 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 lệnh gọi công cụ bị cắt ngắn) cùng token điều khiển mô hình ASCII/full-width bị rò rỉ đều bị loại bỏ, các hàng assistant chỉ chứa token im lặng như đúng 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 đẩy (nỗ lực tối đa): chat.subscribe → event:"chat"

​

7) Canvas + camera

​

Gateway Canvas Host (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 node 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":"/"} để 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 (bí danh legacy canvas.a2ui.pushJSONL)

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

​

8) Giọng nói + bề mặt lệnh Android mở rộng

• Tab Voice: Android có hai chế độ ghi âm rõ ràng. Mic là một phiên tab Voice thủ công, gửi mỗi quã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 tab Voice. Talk là Talk Mode liên tục và tiếp tục nghe cho đến khi được tắt hoặc node ngắt kết nối.
• Talk Mode nâng cấp foreground service hiện có từ dataSync lên dataSync|microphone trước khi bắt đầu ghi âm, rồi hạ cấp khi Talk Mode dừng. Android 14+ yêu cầu khai báo FOREGROUND_SERVICE_MICROPHONE, quyền runtime RECORD_AUDIO, và kiểu dịch vụ microphone tại runtime.
• Phản hồi được đọc 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 Android.
• Các nhóm lệnh Android bổ sung (tính 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
• Node
• Khắc phục sự cố node Android