ส่วนติดต่อผู้ใช้สำหรับควบคุม

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.

• ค่าเริ่มต้น: http://<host>:18789/
• คำนำหน้าเสริม: ตั้งค่า gateway.controlUi.basePath (เช่น /openclaw)

​

เปิดอย่างรวดเร็ว (ภายในเครื่อง)

• http://127.0.0.1:18789/ (หรือ http://localhost:18789/)

• connect.params.auth.token
• connect.params.auth.password
• ส่วนหัวข้อมูลประจำตัวของ Tailscale Serve เมื่อ gateway.auth.allowTailscale: true
• ส่วนหัวข้อมูลประจำตัวของ trusted-proxy เมื่อ gateway.auth.mode: "trusted-proxy"

​

การจับคู่อุปกรณ์ (การเชื่อมต่อครั้งแรก)

openclaw devices list

openclaw devices approve <requestId>

​

ข้อมูลประจำตัวส่วนบุคคล (เฉพาะเบราว์เซอร์)

​

endpoint การตั้งค่ารันไทม์

​

การรองรับภาษา

• locale ที่รองรับ: en, zh-CN, zh-TW, pt-BR, de, es, ja-JP, ko, fr, ar, it, tr, uk, id, pl, th, vi, nl, fa
• คำแปลที่ไม่ใช่ภาษาอังกฤษจะถูกโหลดแบบ lazy-load ในเบราว์เซอร์
• locale ที่เลือกจะถูกบันทึกในพื้นที่จัดเก็บของเบราว์เซอร์และนำมาใช้ซ้ำในการเข้าชมครั้งถัดไป
• คีย์คำแปลที่ขาดหายจะย้อนกลับไปใช้ภาษาอังกฤษ

​

ธีม Appearance

​

สิ่งที่ทำได้ (วันนี้)

​

พฤติกรรมของ Chat

​

การติดตั้ง PWA และ Web Push

• OPENCLAW_VAPID_PUBLIC_KEY
• OPENCLAW_VAPID_PRIVATE_KEY
• OPENCLAW_VAPID_SUBJECT (ค่าเริ่มต้นคือ mailto:openclaw@localhost)

• push.web.vapidPublicKey — ดึงคีย์สาธารณะ VAPID ที่ใช้งานอยู่
• push.web.subscribe — ลงทะเบียน endpoint พร้อม keys.p256dh/keys.auth
• push.web.unsubscribe — ลบ endpoint ที่ลงทะเบียนไว้
• push.web.test — ส่งการแจ้งเตือนทดสอบไปยังการสมัครรับข้อมูลของผู้เรียก

​

เอ็มเบดที่โฮสต์

{
  gateway: {
    controlUi: {
      embedSandbox: "scripts",
    },
  },
}

​

ความกว้างข้อความแชต

{
  gateway: {
    controlUi: {
      chatMessageMaxWidth: "min(1280px, 82%)",
    },
  },
}

​

การเข้าถึง Tailnet (แนะนำ)

openclaw gateway --tailscale serve

openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"

​

HTTP ที่ไม่ปลอดภัย

• ความเข้ากันได้กับ HTTP ที่ไม่ปลอดภัยเฉพาะ localhost ด้วย gateway.controlUi.allowInsecureAuth=true
• การยืนยันตัวตน Control UI ของผู้ปฏิบัติงานสำเร็จผ่าน gateway.auth.mode: "trusted-proxy"
• กลไกฉุกเฉิน gateway.controlUi.dangerouslyDisableDeviceAuth=true

• https://<magicdns>/ (Serve)
• http://127.0.0.1:18789/ (บนโฮสต์ gateway)

{
  gateway: {
    controlUi: { allowInsecureAuth: true },
    bind: "tailnet",
    auth: { mode: "token", token: "replace-me" },
  },
}

{
  gateway: {
    controlUi: { dangerouslyDisableDeviceAuth: true },
    bind: "tailnet",
    auth: { mode: "token", token: "replace-me" },
  },
}

​

นโยบายความปลอดภัยของเนื้อหา

• อวาตาร์และรูปภาพที่ให้บริการใต้พาธสัมพันธ์ (เช่น /avatars/<id>) ยังแสดงผลได้ รวมถึงเส้นทางอวาตาร์ที่ผ่านการยืนยันตัวตนซึ่ง UI ดึงมาและแปลงเป็น URL blob: ในเครื่อง
• URL แบบ inline data:image/... ยังแสดงผลได้ (มีประโยชน์สำหรับ payload ในโปรโตคอล)
• URL blob: ในเครื่องที่สร้างโดย Control UI ยังแสดงผลได้
• URL อวาตาร์ระยะไกลที่ปล่อยออกมาจาก metadata ของช่องทางจะถูกตัดออกที่ตัวช่วยอวาตาร์ของ Control UI และแทนที่ด้วยโลโก้/แบดจ์ในตัว ดังนั้นช่องทางที่ถูกเจาะหรือประสงค์ร้ายจึงไม่สามารถบังคับให้เบราว์เซอร์ของผู้ปฏิบัติงานดึงรูปภาพระยะไกลตามอำเภอใจได้

​

การยืนยันตัวตนเส้นทางอวาตาร์

• GET /avatar/<agentId> ส่งคืนรูปภาพอวาตาร์เฉพาะให้ผู้เรียกที่ผ่านการยืนยันตัวตนเท่านั้น GET /avatar/<agentId>?meta=1 ส่งคืน metadata ของอวาตาร์ภายใต้กฎเดียวกัน
• คำขอที่ไม่ผ่านการยืนยันตัวตนไปยังเส้นทางใดเส้นทางหนึ่งจะถูกปฏิเสธ (ตรงกับเส้นทาง assistant-media ที่อยู่ระดับเดียวกัน) สิ่งนี้ป้องกันไม่ให้เส้นทางอวาตาร์รั่วไหลข้อมูลประจำตัวเอเจนต์บนโฮสต์ที่ได้รับการป้องกันด้วยวิธีอื่น
• Control UI เองส่งต่อโทเคน gateway เป็นส่วนหัว bearer เมื่อดึงอวาตาร์ และใช้ URL blob ที่ผ่านการยืนยันตัวตนเพื่อให้รูปภาพยังแสดงในแดชบอร์ดได้

​

การยืนยันตัวตนเส้นทางสื่อของผู้ช่วย

• GET /__openclaw__/assistant-media?meta=1&source=<path> ต้องใช้การยืนยันตัวตนผู้ปฏิบัติงาน Control UI ตามปกติ เบราว์เซอร์ส่งโทเคน gateway เป็นส่วนหัว bearer เมื่อตรวจสอบความพร้อมใช้งาน
• การตอบกลับ metadata ที่สำเร็จจะมี mediaTicket อายุสั้นที่ถูกจำกัดขอบเขตกับพาธต้นทางนั้นเท่านั้น
• URL รูปภาพ เสียง วิดีโอ และเอกสารที่เบราว์เซอร์แสดงผลใช้ mediaTicket=<ticket> แทนโทเคนหรือรหัสผ่าน gateway ที่ใช้งานอยู่ ตั๋วจะหมดอายุอย่างรวดเร็วและไม่สามารถอนุญาตต้นทางอื่นได้

​

การสร้าง UI

pnpm ui:build

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

pnpm ui:dev

​

หน้า Control UI ว่างเปล่า

• ปิดใช้งานส่วนขยายที่แทรกเข้าไปในทุกหน้า โดยเฉพาะส่วนขยายที่มี content script แบบ <all_urls>
• ลองใช้หน้าต่างส่วนตัว โปรไฟล์เบราว์เซอร์ใหม่ หรือเบราว์เซอร์อื่น
• ให้ Gateway ทำงานต่อและตรวจสอบ URL แดชบอร์ดเดียวกันหลังเปลี่ยนเบราว์เซอร์

​

การดีบัก/ทดสอบ: dev server + Gateway ระยะไกล

pnpm ui:dev

http://localhost:5173/?gatewayUrl=ws%3A%2F%2F<gateway-host>%3A18789

http://localhost:5173/?gatewayUrl=wss%3A%2F%2F<gateway-host>%3A18789#token=<gateway-token>

{
  gateway: {
    controlUi: {
      allowedOrigins: ["http://localhost:5173"],
    },
  },
}

​

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

• แดชบอร์ด — แดชบอร์ด gateway
• การตรวจสอบสถานะ — การตรวจสอบสถานะ gateway
• TUI — อินเทอร์เฟซผู้ใช้บนเทอร์มินัล
• WebChat — อินเทอร์เฟซแชทบนเบราว์เซอร์