แอป 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.

​

ภาพรวมการรองรับ

• บทบาท: แอป companion node (Android ไม่ได้โฮสต์ Gateway)
• ต้องใช้ Gateway: ใช่ (รันบน macOS, Linux หรือ Windows ผ่าน WSL2)
• ติดตั้ง: เริ่มต้นใช้งาน + จับคู่
• Gateway: Runbook + การกำหนดค่า
  • โปรโตคอล: โปรโตคอล Gateway (nodes + control plane)

​

การควบคุมระบบ

​

Runbook การเชื่อมต่อ

• แนะนำ: Tailscale Serve / Funnel พร้อม https://<magicdns> / wss://<magicdns>
• รองรับด้วย: URL Gateway แบบ wss:// อื่นใดที่มี endpoint TLS จริง
• ws:// แบบ cleartext ยังคงรองรับบนที่อยู่ LAN ส่วนตัว / โฮสต์ .local รวมถึง localhost, 127.0.0.1 และ bridge ของ Android emulator (10.0.2.2)

​

ข้อกำหนดเบื้องต้น

• คุณสามารถรัน Gateway บนเครื่อง “master” ได้
• อุปกรณ์/อีมูเลเตอร์ Android สามารถเข้าถึง gateway WebSocket ได้:
  • LAN เดียวกันพร้อม mDNS/NSD, หรือ
  • Tailnet Tailscale เดียวกันโดยใช้ Wide-Area Bonjour / unicast DNS-SD (ดูด้านล่าง), หรือ
  • โฮสต์/พอร์ต gateway แบบกำหนดเอง (fallback)
• การจับคู่ผ่าน tailnet/มือถือสาธารณะ ไม่ ใช้ endpoint raw tailnet IP ws:// ให้ใช้ Tailscale Serve หรือ URL wss:// อื่นแทน
• คุณสามารถรัน CLI (openclaw) บนเครื่อง gateway (หรือผ่าน SSH) ได้

​

1) เริ่ม Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2) ตรวจสอบ discovery (ไม่บังคับ)

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

openclaw gateway discover --json

​

Discovery ผ่าน tailnet (Vienna ⇄ London) ด้วย unicast DNS-SD

1. ตั้งค่าโซน DNS-SD (ตัวอย่าง openclaw.internal.) บนโฮสต์ gateway และเผยแพร่ระเบียน _openclaw-gw._tcp
2. กำหนดค่า Tailscale split DNS สำหรับโดเมนที่คุณเลือกให้ชี้ไปยังเซิร์ฟเวอร์ DNS นั้น

​

3) เชื่อมต่อจาก Android

• แอปจะรักษาการเชื่อมต่อ gateway ให้คงอยู่ผ่าน foreground service (การแจ้งเตือนแบบถาวร)
• เปิดแท็บ Connect
• ใช้โหมด Setup Code หรือ Manual
• หาก discovery ถูกบล็อก ให้ใช้ host/port แบบกำหนดเองใน Advanced controls สำหรับโฮสต์ LAN ส่วนตัว ws:// ยังใช้งานได้ สำหรับโฮสต์ Tailscale/สาธารณะ ให้เปิด TLS และใช้ endpoint wss:// / Tailscale Serve

• endpoint แบบกำหนดเอง (หากเปิดใช้), มิฉะนั้น
• gateway ล่าสุดที่ค้นพบ (แบบ best-effort)

​

Beacon สถานะ presence alive

​

4) อนุมัติการจับคู่ (CLI)

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

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

​

5) ตรวจสอบว่า node เชื่อมต่อแล้ว

• ผ่านสถานะ nodes:
  openclaw nodes status
  
• ผ่าน Gateway:
  openclaw gateway call node.list --params "{}"
  

​

6) Chat + ประวัติ

• ประวัติ: chat.history (ทำให้การแสดงผลเป็นมาตรฐาน; tag directive แบบ inline จะถูก ลบออกจากข้อความที่มองเห็น payload XML ของ tool-call แบบ plain-text (รวมถึง <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> และ บล็อก tool-call ที่ถูกตัดทอน) รวมถึง token ควบคุมโมเดล ASCII/full-width ที่รั่วออกมา จะถูกลบ แถว assistant ที่เป็น silent-token ล้วน เช่น NO_REPLY / no_reply แบบ exact จะถูกละไว้ และแถวที่ใหญ่เกินไปสามารถถูกแทนที่ด้วย placeholder)
• ส่ง: chat.send
• อัปเดตแบบ push (best-effort): chat.subscribe → event:"chat"

​

7) Canvas + กล้อง

​

Gateway Canvas Host (แนะนำสำหรับเนื้อหาเว็บ)

1. สร้าง ~/.openclaw/workspace/canvas/index.html บนโฮสต์ gateway
2. นำทาง node ไปยังหน้านั้น (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 (ใช้ {"url":""} หรือ {"url":"/"} เพื่อกลับไปยัง scaffold ค่าเริ่มต้น) canvas.snapshot ส่งคืน { format, base64 } (ค่าเริ่มต้น format="jpeg")
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL เป็น alias เดิม)

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

​

8) Voice + พื้นผิวคำสั่ง Android ที่ขยายเพิ่ม

• แท็บ Voice: Android มีโหมด capture ที่ชัดเจนสองโหมด Mic คือ session แบบ manual ในแท็บ Voice ที่ส่งแต่ละช่วงหยุดพูดเป็น chat turn และหยุดเมื่อแอปออกจาก foreground หรือผู้ใช้ออกจากแท็บ Voice Talk คือ Talk Mode แบบต่อเนื่องและจะฟังต่อไปจนกว่าจะปิด toggle หรือ node ตัดการเชื่อมต่อ
• Talk Mode จะยกระดับ foreground service ที่มีอยู่จาก dataSync เป็น dataSync|microphone ก่อนเริ่ม capture แล้วลดระดับกลับเมื่อ Talk Mode หยุด Android 14+ ต้องมีการประกาศ FOREGROUND_SERVICE_MICROPHONE, grant runtime RECORD_AUDIO และชนิดบริการ microphone ใน runtime
• คำตอบที่พูดออกเสียงใช้ talk.speak ผ่าน gateway Talk provider ที่กำหนดค่าไว้ ระบบ TTS ในเครื่องจะถูกใช้เฉพาะเมื่อ talk.speak ไม่พร้อมใช้งาน
• Voice wake ยังคงปิดใช้งานใน UX/runtime ของ Android
• ตระกูลคำสั่ง Android เพิ่มเติม (ความพร้อมใช้งานขึ้นกับอุปกรณ์ + permissions):
  • 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

​

จุดเข้า Assistant

​

การส่งต่อการแจ้งเตือน

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

​

ที่เกี่ยวข้อง

• แอป iOS
• Nodes
• การแก้ปัญหา Android node