UI ควบคุม

Control UI เป็นแอปหน้าเดียวขนาดเล็กที่ใช้ Vite + Lit และให้บริการโดย Gateway:

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

แอปสื่อสาร โดยตรงกับ Gateway WebSocket บนพอร์ตเดียวกัน

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

หาก Gateway ทำงานอยู่บนคอมพิวเตอร์เครื่องเดียวกัน ให้เปิด http://127.0.0.1:18789/ (หรือ http://localhost:18789/)

หากโหลดหน้าไม่ได้ ให้เริ่ม Gateway ก่อน: openclaw gateway

ข้อมูลรับรองความถูกต้องจะถูกส่งระหว่างการจับมือ WebSocket ผ่าน:

• connect.params.auth.token
• connect.params.auth.password
• ส่วนหัวข้อมูลประจำตัว Tailscale Serve เมื่อ gateway.auth.allowTailscale: true
• ส่วนหัวข้อมูลประจำตัวพร็อกซีที่เชื่อถือได้เมื่อ gateway.auth.mode: "trusted-proxy"

แผงการตั้งค่าแดชบอร์ดจะเก็บโทเค็นไว้สำหรับเซสชันแท็บเบราว์เซอร์ปัจจุบันและ URL ของ Gateway ที่เลือก แต่จะไม่จัดเก็บรหัสผ่าน โดยปกติการเริ่มต้นใช้งานจะสร้างโทเค็น Gateway สำหรับการยืนยันตัวตนด้วยข้อมูลลับที่ใช้ร่วมกันในการเชื่อมต่อครั้งแรก แต่การยืนยันตัวตนด้วยรหัสผ่านก็ใช้ได้เช่นกันเมื่อ gateway.auth.mode เป็น "password"

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

โดยทั่วไป การเชื่อมต่อจากเบราว์เซอร์หรืออุปกรณ์ใหม่ต้องได้รับ การอนุมัติการจับคู่แบบครั้งเดียว ซึ่งแสดงเป็น disconnected (1008): pairing required

openclaw devices list

openclaw devices approve <requestId>

หากเบราว์เซอร์ลองจับคู่ใหม่โดยเปลี่ยนรายละเอียดการยืนยันตัวตน (บทบาท/ขอบเขต/กุญแจสาธารณะ) คำขอที่รอดำเนินการก่อนหน้าจะถูกแทนที่และสร้าง requestId ใหม่ ให้เรียกใช้ openclaw devices list อีกครั้งก่อนอนุมัติ

การเปลี่ยนเบราว์เซอร์ที่จับคู่แล้วจากสิทธิ์อ่านเป็นสิทธิ์เขียน/ผู้ดูแลระบบจะถือเป็นการยกระดับการอนุมัติ ไม่ใช่การเชื่อมต่อใหม่โดยไม่แจ้ง: OpenClaw จะคงการอนุมัติเดิมไว้ บล็อกการเชื่อมต่อใหม่ที่มีสิทธิ์กว้างกว่า และขอให้อนุมัติชุดขอบเขตใหม่อย่างชัดเจน

เมื่ออนุมัติแล้ว ระบบจะจดจำอุปกรณ์และไม่ต้องอนุมัติซ้ำ เว้นแต่จะเพิกถอนด้วย openclaw devices revoke --device <id> --role <role> ดูขั้นตอนการหมุนเวียนโทเค็น การเพิกถอน และการอนุมัติการเรียกใช้ครั้งแรกของ Paperclip / openclaw_gateway ได้ที่ CLI สำหรับอุปกรณ์

จับคู่อุปกรณ์เคลื่อนที่

ผู้ดูแลระบบที่จับคู่แล้วสามารถสร้าง QR สำหรับเชื่อมต่อ iOS/Android ได้โดยไม่ต้องเปิดเทอร์มินัล:

การสร้างรหัสตั้งค่าต้องใช้ operator.admin และปุ่มจะถูกปิดใช้งานสำหรับเซสชันที่ไม่มีสิทธิ์ดังกล่าว รหัสตั้งค่ามีข้อมูลรับรองสำหรับเริ่มต้นระบบที่มีอายุสั้น ดังนั้นให้ปฏิบัติต่อ QR และรหัสที่คัดลอกเหมือนรหัสผ่านในช่วงที่ยังใช้ได้ สำหรับการจับคู่ระยะไกล Gateway ต้องแปลงชื่อเป็น wss:// ได้ (เช่น ผ่าน Tailscale Serve/Funnel) ส่วน ws:// แบบธรรมดาจะจำกัดเฉพาะลูปแบ็กและที่อยู่ LAN ส่วนตัว ดูรายละเอียดทั้งหมดเกี่ยวกับความปลอดภัยและทางเลือกสำรองได้ที่ การจับคู่

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

Control UI รองรับข้อมูลประจำตัวส่วนบุคคลแยกตามเบราว์เซอร์ (ชื่อที่แสดงและอวาตาร์) ซึ่งแนบไปกับข้อความขาออกเพื่อระบุผู้ส่งในเซสชันที่ใช้ร่วมกัน ข้อมูลนี้อยู่ในพื้นที่จัดเก็บของเบราว์เซอร์ จำกัดขอบเขตไว้ที่โปรไฟล์เบราว์เซอร์ปัจจุบัน และไม่ซิงค์ไปยังอุปกรณ์อื่นหรือจัดเก็บฝั่งเซิร์ฟเวอร์ นอกเหนือจากข้อมูลเมตาผู้เขียนตามปกติในบันทึกข้อความที่ส่ง การล้างข้อมูลเว็บไซต์หรือเปลี่ยนเบราว์เซอร์จะรีเซ็ตข้อมูลนี้ให้ว่าง

การแทนที่อวาตาร์ของผู้ช่วยใช้รูปแบบเฉพาะเบราว์เซอร์เดียวกัน: การแทนที่ที่อัปโหลดจะซ้อนทับข้อมูลประจำตัวที่ Gateway แก้ไขไว้เฉพาะภายในเครื่อง และจะไม่ส่งไปกลับผ่าน config.patch ฟิลด์การกำหนดค่าที่ใช้ร่วมกัน ui.assistant.avatar ยังคงพร้อมใช้งานสำหรับไคลเอนต์ที่ไม่ใช่ UI ซึ่งเขียนฟิลด์นี้โดยตรง

ปลายทางการกำหนดค่ารันไทม์

Control UI ดึงการตั้งค่ารันไทม์จาก /control-ui-config.json โดยแก้ไขแบบสัมพัทธ์กับพาธฐาน Control UI ของ Gateway (เช่น /__openclaw__/control-ui-config.json ภายใต้พาธฐาน /__openclaw__/) ปลายทางนี้อยู่ภายใต้การยืนยันตัวตน Gateway แบบเดียวกับพื้นผิว HTTP ส่วนที่เหลือ: เบราว์เซอร์ที่ไม่ได้ยืนยันตัวตนจะดึงข้อมูลไม่ได้ และการดึงข้อมูลให้สำเร็จต้องใช้โทเค็น/รหัสผ่าน Gateway ที่ถูกต้อง ข้อมูลประจำตัว Tailscale Serve หรือข้อมูลประจำตัวพร็อกซีที่เชื่อถือได้

สถานะโฮสต์ Gateway

เปิด Settings → General เพื่อดูการ์ด Gateway Host ซึ่งแสดงเครื่อง Gateway, ที่อยู่ LAN, ระบบปฏิบัติการ, รันไทม์, ระยะเวลาทำงาน, โหลด CPU, หน่วยความจำ และพื้นที่ดิสก์ของวอลุ่มสถานะ การ์ดจะรีเฟรชทุก 10 วินาทีขณะแสดงอยู่ผ่าน Gateway RPC system.info ซึ่งต้องมีขอบเขต operator.read Gateway รุ่นเก่าและการเชื่อมต่อที่ไม่มีขอบเขตดังกล่าวจะไม่แสดงการ์ดนี้

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

Control UI จะปรับภาษาตามภาษาของเบราว์เซอร์เมื่อโหลดครั้งแรก หากต้องการแทนที่ในภายหลัง ให้เปิด Settings -> General -> Language (ตัวเลือกภาษาอยู่ในหน้า General ไม่ได้อยู่ใต้ Appearance)

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

คำแปลเอกสารจะถูกสร้างสำหรับชุดภาษาที่ไม่ใช่ภาษาอังกฤษเดียวกัน แต่ตัวเลือกภาษา Mintlify ในตัวของเว็บไซต์เอกสารจะแสดงเฉพาะรหัสภาษาที่ Mintlify ยอมรับ เอกสารภาษาไทย (th) และภาษาเปอร์เซีย (fa) ยังคงถูกสร้างใน repo สำหรับเผยแพร่ แต่อาจไม่ปรากฏในตัวเลือกดังกล่าวจนกว่า Mintlify จะรองรับรหัสเหล่านั้น

ธีมรูปลักษณ์

แผง Appearance มีธีม Claw, Knot และ Dash ในตัว (Claw เป็นค่าเริ่มต้น) พร้อมช่องนำเข้า tweakcn เฉพาะเบราว์เซอร์หนึ่งช่อง หากต้องการนำเข้าธีม ให้เปิด เครื่องมือแก้ไข tweakcn เลือกหรือสร้างธีม คลิก Share แล้ววางลิงก์ที่คัดลอกลงใน Appearance เครื่องมือนำเข้ายังรองรับ URL รีจิสทรี https://tweakcn.com/r/themes/<id>, URL เครื่องมือแก้ไข เช่น https://tweakcn.com/editor/theme?theme=amethyst-haze, พาธสัมพัทธ์ /themes/<id>, ID ธีมดิบ และชื่อธีมเริ่มต้น เช่น amethyst-haze

ธีมที่นำเข้าจะถูกจัดเก็บเฉพาะในโปรไฟล์เบราว์เซอร์ปัจจุบัน โดยจะไม่เขียนลงในการกำหนดค่า Gateway และไม่ซิงค์ข้ามอุปกรณ์ การแทนที่ธีมที่นำเข้าจะอัปเดตช่องภายในเครื่องเพียงช่องเดียว ส่วนการล้างธีมจะสลับกลับไปเป็น Claw หากธีมที่นำเข้าเปิดใช้งานอยู่

Appearance ยังมีการตั้งค่าขนาดข้อความ ซึ่งใช้กับข้อความแชต ข้อความในช่องเขียน การ์ดเครื่องมือ และแถบด้านข้างของแชต และคงขนาดช่องป้อนข้อความไว้อย่างน้อย 16px เพื่อไม่ให้ Safari บนอุปกรณ์เคลื่อนที่ซูมโดยอัตโนมัติเมื่อโฟกัส

ธีม โหมดธีม ขนาดข้อความ ภาษา และค่ากำหนดการแสดงผลแชตจะซิงค์ผ่านการกำหนดค่า Gateway (ui.prefs) จึงติดตามไปยังอุปกรณ์ต่าง ๆ และเอเจนต์สามารถเปลี่ยนค่าเหล่านี้ผ่านด่านการอนุมัติได้ โดยไคลเอนต์ที่เชื่อมต่อจะใช้การเปลี่ยนแปลงแบบสดผ่านประกาศ config.changed ของ Gateway แต่ละเบราว์เซอร์จะเก็บสำเนาภายในเครื่องเพื่อเริ่มทำงานทันที ส่วนไคลเอนต์ที่เขียนการกำหนดค่าไม่ได้ (ขอบเขตผู้ดู ออฟไลน์) จะเก็บการเปลี่ยนแปลงไว้เฉพาะอุปกรณ์ ดู ข้อมูลอ้างอิงการกำหนดค่า

การดูแลระบบ OpenClaw

เปิด Settings → Ask OpenClaw เพื่อสนทนากับเอเจนต์ตั้งค่าและซ่อมแซมระบบ นอกขั้นตอนการเริ่มต้นใช้งาน หน้านี้จะแสดงชิปเหตุการณ์ที่ปิดได้ไม่เกินหนึ่งรายการต่อการเข้าชม โดยจะไม่ตอบสนองต่อการรับส่งข้อมูลตามปกติของ Gateway และจะตอบสนองเฉพาะสแนปช็อตสถานภาพที่รายงานว่าตัวโหลดการกำหนดค่าใหม่ถูกปิดใช้งาน ช่องทางที่กำหนดค่าไว้ขาดการเชื่อมต่อ/ประสิทธิภาพลดลง การตรวจสอบช่องทางล้มเหลว หรือข้อมูลรับรองช่องทางไม่พร้อมใช้งาน เหตุการณ์ใหม่กว่าจะแทนที่ชิปที่รอดำเนินการเฉพาะเมื่อมีความรุนแรงมากกว่า การปิดหรือใช้ชิปจะระงับข้อความแจ้งเหตุการณ์สำหรับการเข้าชมนั้น การคลิกชิปจะส่งคำถามวินิจฉัยเป็นข้อความ openclaw.chat จริง บันทึกข้อความจึงเก็บคำขอไว้และ OpenClaw จะดำเนินการวินิจฉัย ขั้นตอนการเริ่มต้นใช้งานจะไม่แสดงชิปเหตุการณ์เหล่านี้

จัดการ Plugin

เปิด Plugin ในแถบด้านข้าง หรือใช้ /settings/plugins แบบสัมพัทธ์กับ พาธฐาน Control UI ที่กำหนดค่าไว้ เพื่อเรียกดูและจัดการ Plugin โดยไม่ต้องออกจาก Control UI ตัวอย่างเช่น พาธฐาน /openclaw จะใช้ /openclaw/settings/plugins หน้านี้พร้อมใช้งานเสมอ แม้ว่า Plugin เสริมทั้งหมดจะถูกปิดใช้งาน

Plugin เป็นศูนย์รวมที่มีสี่แท็บ: ติดตั้งแล้ว และ ค้นหา ใช้จัดการโค้ด Plugin ที่ /settings/plugins, Skills โฮสต์ตัวจัดการ Skills แยกตามเอเจนต์ที่ /skills และ เวิร์กช็อป โฮสต์การตรวจทานข้อเสนอ Skill Workshop ที่ /skills/workshop แต่ละแท็บมี URL ของตัวเอง และแถบด้านข้างจะแสดง รายการ Plugin รายการเดียวสำหรับทั้งหมด

แท็บ ติดตั้งแล้ว แสดงรายการภายในเครื่องทั้งหมดโดยจัดกลุ่มตามหมวดหมู่ พร้อม จำนวนภาพรวม แต่ละแถวเปิดมุมมองรายละเอียด เมนูรายการเพิ่มเติม (…) ของแถวนั้นใช้ เปิดหรือปิดใช้ Plugin และมีตัวเลือก นำออก สำหรับ Plugin ที่ติดตั้งจากภายนอก นอกจากนี้ยังแสดงรายการ เซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้ และรองรับการเพิ่ม การปิดใช้งาน และการนำออกภายในหน้าเดียวกัน การควบคุมเซิร์ฟเวอร์แบบเดียวกันอยู่ที่ Settings → MCP แท็บ ค้นหา คือร้านค้า ซึ่งมี Plugin เด่นที่รวมมากับ OpenClaw, Plugin ภายนอกอย่างเป็นทางการ และตัวเชื่อมต่อ MCP แบบคลิกเดียวสำหรับบริการยอดนิยม การพิมพ์ในช่องค้นหาจะค้นหา ClawHub ภายในหน้า และเพิ่มส่วน จาก ClawHub พร้อมจำนวนการดาวน์โหลดและป้ายยืนยันแหล่งที่มา Deep Link สามารถ นำไปยังร้านค้าโดยตรงด้วย /settings/plugins?tab=discover

แท็บ Skills มีรายงานสถานะ Skills, สวิตช์เปิด/ปิด, ช่องป้อนคีย์ API และการค้นหา Skills ใน ClawHub ภายในหน้า โดยจำกัดขอบเขตตามเอเจนต์ที่เลือก แท็บ เวิร์กช็อป มีบอร์ด Skill Workshop และขั้นตอนการตรวจทานประจำวันนี้สำหรับ ข้อเสนอ Skills ค้นหาแนวคิด Skills จะตรวจทานเซสชันที่มีเนื้อหาสำคัญ ในช่วงที่จำกัด โดยเรียงจากใหม่ที่สุดไปเก่าที่สุด และเก็บผลลัพธ์ไว้เป็น ข้อเสนอที่รอดำเนินการ แผงจะแสดงความครอบคลุมสะสม ส่วน สแกนงานก่อนหน้า จะดำเนินการต่อจากเคอร์เซอร์ที่จัดเก็บไว้ แล้วเปลี่ยนเป็น สแกนงานใหม่ หลังจากประวัติ ที่เก่ากว่าหมดแล้ว การตรวจทานประวัติด้วยตนเองทำงานได้ขณะที่การเรียนรู้ด้วยตนเองแบบอัตโนมัติ ถูกปิดใช้งาน และใช้โมเดลที่กำหนดค่าไว้ของเอเจนต์ที่เลือก

Plugin ที่รวมมาให้อยู่บน Gateway แล้ว และจะแสดง เปิดใช้งาน หรือ ปิดใช้งาน แทน ติดตั้ง ตัวอย่างเช่น Workboard รวมมากับ OpenClaw แต่ปิดใช้งานโดยค่าเริ่มต้น ดังนั้นการดำเนินการจึงเป็น เปิดใช้งาน Plugin ที่รวมมา ไม่สามารถนำออกได้ ทำได้เพียงปิดใช้งานเท่านั้น

การอ่านแค็ตตาล็อกและการค้นหา ClawHub ต้องใช้ operator.read ส่วนการติดตั้ง เปิดใช้ ปิดใช้ หรือลบ Plugin และการเปลี่ยนเซิร์ฟเวอร์ MCP ต้องใช้ operator.admin; การดำเนินการเหล่านั้นจะยังคงถูกปิดใช้งานสำหรับผู้ปฏิบัติงานที่มีสิทธิ์อ่านอย่างเดียว

การติดตั้งจาก ClawHub ดำเนินการผ่าน Gateway และใช้การตรวจสอบความน่าเชื่อถือ ความสมบูรณ์ และนโยบายการติดตั้ง Plugin เช่นเดียวกับการติดตั้งอื่นที่ดำเนินการผ่าน Gateway การติดตั้ง หรือลบโค้ด Plugin ต้องรีสตาร์ท Gateway การเปิดใช้หรือปิดใช้ Plugin ที่ติดตั้งแล้วสามารถมีผลได้โดยไม่ต้องรีสตาร์ทเมื่อ Plugin และรันไทม์ Gateway ปัจจุบันรองรับ มิฉะนั้น UI จะแจ้งว่าจำเป็นต้อง รีสตาร์ท ตัวเชื่อมต่อ MCP ที่ใช้ OAuth ต้องดำเนินการ openclaw mcp login <name> จาก CLI หนึ่งครั้งหลังจากเพิ่มแล้ว

หน้านี้มุ่งเน้นที่รายการสิ่งที่มีอยู่ การค้นหา การติดตั้ง การเปิดใช้ และการลบโดยเจตนา ใช้ openclaw plugins สำหรับแหล่งที่มาแบบ npm, git หรือ พาธภายในเครื่องที่กำหนดเอง การอัปเดต และการกำหนดค่า Plugin ขั้นสูง

แอปและส่วนขยาย

เปิด แอป จากเมนู เพิ่มเติม ในแถบด้านข้าง พาเล็ตคำสั่ง หรือเมนู เอเจนต์ในแถบด้านข้าง (รับแอป) หรือใช้ /apps โดยอ้างอิงจาก พาธฐานของ Control UI ที่กำหนดค่าไว้ หน้านี้รวบรวมลิงก์ติดตั้งสำหรับทุก พื้นผิวเสริมของ OpenClaw ได้แก่ แอป iOS และ Android, แอปเสริม Apple Watch และ Wear OS ที่มาพร้อมกัน, แอปเดสก์ท็อป macOS, Windows และ Linux, ส่วนขยาย Chrome, ศูนย์รวม Plugin ภายในแอปพร้อม ClawHub ตลอดจนชุมชน Discord และเอกสาร

การนำทางด้วยแถบด้านข้าง

แถบด้านข้างจัดระเบียบทุกอย่างโดยมีเอเจนต์เป็นศูนย์กลาง แถวข้อมูลประจำตัวด้านบนคือเอเจนต์ที่ใช้งานอยู่ ด้านล่าง ส่วน หน้า เริ่มด้วย หน้าหลัก ซึ่งเป็นเซสชันหลักที่ดำเนินต่อเนื่องของเอเจนต์ โดยมีป้ายแสดงสถานะที่ยังไม่ได้อ่านหรือกำลังทำงาน ตามด้วยปลายทางที่ปักหมุดไว้ (การใช้งาน, ระบบอัตโนมัติ และ Plugin เป็นค่าเริ่มต้น) ตัวควบคุมปรับแต่งบนส่วนหัวของหน้าเปิดเมนูที่มีปลายทางอื่นทั้งหมด รวมถึงแท็บที่ Plugin จัดเตรียมให้ พร้อม แก้ไขรายการที่ปักหมุด; การคลิกขวาบริเวณการนำทางจะเปิดตัวแก้ไขการปักหมุดโดยตรง รายการเซสชันด้านล่างแบ่งเป็นโซน ได้แก่ เธรด สำหรับเซสชันแชตของเอเจนต์ (เซสชันหลักอยู่หลังหน้าหลัก เซสชันที่เซสชันนั้นสร้างขึ้นจะแสดงที่นี่เป็นเธรดระดับบน และเธรดที่ตั้งชื่อจะแสดงโดยไม่มีคำนำหน้าประเภท), กลุ่ม สำหรับการสนทนาแบบกลุ่มและห้อง และ การเขียนโค้ด สำหรับเซสชันที่ผูกกับเวิร์กทรีที่มีการจัดการหรือโหนด exec (แต่ละแถวแสดงบรรทัด repo ⎇ branch พร้อมโฮสต์ของโหนด), เซสชันชุดทดสอบที่ใช้ ACP และแค็ตตาล็อก CLI ของ Codex/Claude การเขียนโค้ดจะยุบไว้เมื่อเรียกใช้ครั้งแรกและจดจำตัวเลือกของคุณ ส่วนหัวที่ยุบไว้จะคงจำนวนจริงและแสดงตัวบ่งชี้การทำงานขณะที่เซสชันภายในกำลังทำงาน กลุ่มที่กำหนดเอง (category ของเซสชัน) และแถว ปักหมุดแล้ว อยู่เหนือเธรด และการกำหนดเซสชันให้กลุ่มที่กำหนดเองจะมีลำดับความสำคัญเหนือการจัดประเภทโซนอัตโนมัติเสมอ ส่วนหัวของเธรดมีตัวควบคุมการจัดเรียง (สร้างเมื่อ หรือ อัปเดตล่าสุด พร้อมสวิตช์จัดกลุ่มตาม) และ + ซึ่งเปิดหน้าสร้างเซสชันใหม่ การเปิดเซสชันจะย้ายไฮไลต์การเลือกโดยไม่จัดเรียงแถวใหม่ เซสชันแม่ที่มีการทำงานของเซสชันลูกเมื่อไม่นานมานี้จะแสดงตัวเปิดเผยข้อมูลและจำนวนเซสชันลูก ขยายเพื่อดูเซสชันลูกที่ซ้อนอยู่ สถานะแบบสดหรือสิ้นสุดแล้ว และรันไทม์ได้โดยไม่ต้องออกจากแถบด้านข้าง การเลือกเซสชันลูกจะเปิดแชตและแสดงพาธบรรพบุรุษโดยอัตโนมัติ แถวเซสชันลูกไม่อยู่ในการจัดกลุ่มระดับราก การปักหมุด การลาก การเลือกหลายรายการ และการแบ่งหน้า ส่วนโซนที่ยุบไว้จะไม่ใช้โควตาของหน้าที่มองเห็นได้ เซสชันที่มีกิจกรรมใหม่หลังจากอ่านครั้งล่าสุดจะแสดงจุดยังไม่ได้อ่าน และการเปิดเซสชันจะทำเครื่องหมายว่าอ่านแล้ว เอเจนต์ยังสามารถเผยแพร่บรรทัดสถานะสั้นที่หมดอายุได้ และเลือกขอให้สนใจด้วยไอคอนสีเหลืองอำพันที่คัดสรรไว้ได้ การประกาศนั้นจะถูกล้างเมื่อเปิดเซสชัน ส่งข้อความถัดไป ล้างอย่างชัดเจน หรือเมื่อ TTL หมดอายุ สถานะวงจรชีวิตของเวิร์กเกอร์บนคลาวด์ใช้ป้ายรูปลูกโลก ส่วนเซสชันภายในเครื่องและเซสชันที่เรียกคืนแล้วจะไม่มีป้ายตำแหน่ง เนื่องจากการดำเนินการภายในเครื่องเป็นค่าเริ่มต้น แถวเซสชันระดับรากแต่ละแถวมีเมนูบริบท (ปุ่มจุดสามจุดแนวตั้งหรือคลิกขวา) พร้อม ปักหมุด/เลิกปักหมุด, ทำเครื่องหมายว่ายังไม่ได้อ่าน/อ่านแล้ว, เปลี่ยนชื่อ, แยกแขนง, ย้ายไปยังกลุ่ม (รวมถึง กลุ่มใหม่ และ นำออกจากกลุ่ม), เก็บถาวร และ ลบ; เลย์เอาต์แบบสัมผัสจะแสดงตัวควบคุมการปักหมุดและเมนูโดยตรงไว้เสมอ การ Cmd/Ctrl-click จะสลับแถวระดับรากเข้าสู่การเลือกหลายรายการ และ Shift-click จะขยายการเลือกตามลำดับที่มองเห็นได้ จากนั้นการเปิดเมนูบนแถวที่เลือกจะแสดงการดำเนินการแบบกลุ่ม (ทำเครื่องหมาย N รายการว่ายังไม่ได้อ่าน/อ่านแล้ว, ย้าย N รายการไปยังกลุ่ม, เก็บถาวร N รายการ, ลบ N รายการ) ซึ่งใช้กับทุกเซสชันที่เลือก โดยยืนยันเพียงครั้งเดียวสำหรับการลบแบบกลุ่ม ลากเซสชันระดับรากไปยัง ปักหมุดแล้ว เพื่อปักหมุด หรือลากไปยังกลุ่มที่กำหนดเองเพื่อย้าย ส่วนหัวของกลุ่มที่กำหนดเองสามารถยุบ ขยาย หรือลากเพื่อจัดลำดับใหม่ได้ ชื่อกลุ่มและลำดับจะอยู่ใน Gateway (sessions.groups.*) จึงติดตามคุณไปในทุกเบราว์เซอร์ ส่วนสถานะการยุบจะอยู่ในโปรไฟล์เบราว์เซอร์ ส่วนหัวของกลุ่มยังมีเมนู (ปุ่มจุดสามจุดแนวตั้งหรือคลิกขวา) พร้อม เปลี่ยนชื่อกลุ่ม, กลุ่มใหม่ และ ลบกลุ่ม; การเปลี่ยนชื่อหรือลบกลุ่มจะอัปเดตเซสชันสมาชิกทั้งหมดที่ฝั่งเซิร์ฟเวอร์ รวมถึงเซสชันที่เก็บถาวร และการลบกลุ่มจะเก็บเซสชันไว้และย้ายกลับไปยังเธรด

หน้าสร้างเซสชันใหม่

เครื่องหมาย + ในส่วนหัวรายการเซสชันของแถบด้านข้างจะเปิดฉบับร่างแบบเต็มหน้าที่ /new: จะยังไม่มีการสร้างสิ่งใดจนกว่าจะส่งข้อความแรก แถวเป้าหมายเหนือกล่องข้อความใช้เลือกตำแหน่งที่เซสชันทำงาน ได้แก่ เอเจนต์ (การตั้งค่าแบบหลายเอเจนต์), ตำแหน่งที่ exec ทำงาน (Gateway · ภายในเครื่อง หรือโหนดที่จับคู่ซึ่งเปิดเผย system.run; ต้องใช้ operator.admin), โฟลเดอร์ (ค่าเริ่มต้นคือพื้นที่ทำงานของเอเจนต์; พาธ Gateway แบบสัมบูรณ์อื่นต้องใช้ operator.admin และเวิร์กทรี) และสวิตช์ เวิร์กทรี ที่เลือกใช้ได้ พร้อมตัวเลือกสาขาฐาน (รองรับโดย worktrees.branches จึงไม่มีการ fetch) และชื่อเวิร์กทรีที่เลือกใส่ได้ (สาขาจะกลายเป็น openclaw/<name>) ส่วนท้ายของตัวเขียนข้อความใช้เลือกโมเดลและระดับการใช้เหตุผลของเซสชันใหม่ และการเริ่มต้นบนคลาวด์จะบันทึกตัวเลือกทั้งสองก่อนส่งเซสชันไปยังเวิร์กเกอร์ ปุ่มเรียกดูของชิปโฟลเดอร์จะเปิดตัวเลือกไดเรกทอรีแบบอินไลน์ซึ่งรองรับโดยเมธอด fs.listDir ที่ใช้ได้เฉพาะผู้ดูแลระบบ ระดับบนสุดจะแสดง Gateway และโหนดที่รู้จักทั้งหมด โหนดออฟไลน์และโหนดที่ไม่รองรับการเรียกดูไดเรกทอรีจะยังคงแสดงอยู่แต่ถูกปิดใช้งาน การเลือก Gateway จะเริ่มจากโฟลเดอร์ปัจจุบันหรือโฮมของ Gateway การเลือกโหนดที่รองรับจะเรียกดูระบบไฟล์ของโฮสต์โหนดนั้น ผูก exec เข้ากับโหนด และใช้พาธสัมบูรณ์ของโหนดที่เลือกโดยตรง (เวิร์กทรีที่มีการจัดการยังคงใช้ได้เฉพาะ Gateway) การส่งจะเรียก sessions.create พร้อมข้อความแรก ทำให้การทำงานเริ่มภายในรอบการรับส่งเดียวกันและ UI ข้ามไปยังแชตของเซสชันใหม่ หาก Gateway สร้างเซสชันสำเร็จแต่ปฏิเสธการส่งครั้งแรก แชตจะเก็บพรอมต์และข้อผิดพลาดไว้แม้โหลดใหม่; ลองอีกครั้ง จะส่งผ่านเซสชันที่สร้างไว้แล้วแทนการสร้างเซสชันใหม่อีกเซสชัน

ภายใน การตั้งค่า แถบด้านข้างเฉพาะมี ถาม OpenClaw และเริ่มต้นด้วยช่อง ค้นหาการตั้งค่า เพื่อค้นหาส่วนต่าง ๆ ของการตั้งค่าอย่างรวดเร็ว

ช่อง ค้นหา ที่ด้านบนของแถบด้านข้างจะเปิดพาเล็ตคำสั่ง (⌘K) การคลิกแถวข้อมูลประจำตัวของเอเจนต์ที่ด้านบนของแถบด้านข้างจะเปิดเมนูเอเจนต์; หน้าหลัก จะเปิดเซสชันหลัก เมื่อมีบางสิ่งต้องดำเนินการ เช่น งาน cron ที่ล้มเหลวหรือเกินกำหนด หรือการยืนยันตัวตนของโมเดลที่กำลังจะหมดอายุหรือหมดอายุแล้ว ชิปแจ้งเตือนแบบกะทัดรัดจะปรากฏเหนือส่วนท้ายของแถบด้านข้างและคลิกผ่านไปยังหน้าที่เป็นเจ้าของได้ แถวข้อมูลประจำตัวจะแสดงอวาตาร์ของเอเจนต์ (รูปภาพหรืออีโมจิประจำตัว), ชื่อ, จุดแสดงการเชื่อมต่อ และคำบรรยายสด การคลิกจะเปิดเมนูเอเจนต์ ซึ่งประกอบด้วยตัวสลับเอเจนต์ (การตั้งค่าแบบหลายเอเจนต์), "เอเจนต์นี้ทำอะไรได้บ้าง?", การตั้งค่าเอเจนต์, การตั้งค่า, การจับคู่อุปกรณ์เคลื่อนที่, เอกสาร, ชิปบิลด์ และสวิตช์โหมดสี รายชื่อที่มีเอเจนต์มากกว่าสิบตัวจะมีช่องกรองและแสดงเอเจนต์ที่ปักหมุดก่อน ปักหมุดหรือเลิกปักหมุดเอเจนต์จากหน้าการตั้งค่าเอเจนต์ โดยชุดที่ปักหมุดจะถูกจัดเก็บในโปรไฟล์เบราว์เซอร์ การเลือกเอเจนต์จะจำกัดขอบเขตแชต รวมถึงการใช้งาน ระบบอัตโนมัติ งาน กระดานงาน และเซสชันให้เป็นของเอเจนต์นั้น หน้าที่มีขอบเขตแต่ละหน้ามีตัวควบคุม เอเจนต์ พร้อม เอเจนต์ทั้งหมด สำหรับออกจากขอบเขต ซึ่งจะขยายขอบเขตหน้าที่ใช้ร่วมกันโดยไม่เปลี่ยนเอเจนต์แชตที่ระบุไว้ ขณะที่ลิงก์เซสชันโดยตรงยังคงเปิดเป้าหมายของลิงก์ หน้าการตั้งค่าเอเจนต์จะเก็บการเลือก ?agent= ของตนเองและไม่เปลี่ยนตามขอบเขตหน้าที่ใช้ร่วมกัน แถบส่วนท้ายมีโลโก้ผลิตภัณฑ์ ชิปบิลด์ จุดแสดงการเชื่อมต่อ Gateway และทางลัดการตั้งค่า เมื่อ Gateway ทำงานจากการ checkout ซอร์สบนสาขาอื่นที่ไม่ใช่ main ส่วนท้ายจะแสดงชื่อสาขานั้นเป็นสีแดงด้วย เพื่อให้เห็นได้ทันทีว่าเป็น Gateway ที่ไม่ใช่รุ่นเผยแพร่ (การติดตั้งรุ่นเผยแพร่จะไม่แสดง) Shift-Command-Comma เปิด การตั้งค่า โดยไม่แทนที่ทางลัด Command-Comma ของเบราว์เซอร์ ส่วนหัวของแถบด้านข้างยังมีสวิตช์ยุบ (⌘B); การยุบจะซ่อนแถบด้านข้างทั้งหมดเพื่อให้ได้พื้นที่ทำงานเต็มความกว้าง และตัวควบคุมขยายแบบลอย (หรือ ⌘B) จะนำกลับมา; แอป macOS จะโฮสต์สวิตช์นั้นแบบเนทีฟในแถบชื่อเรื่องแทน แถบด้านข้างเป็นองค์ประกอบการนำทางเพียงอย่างเดียวบนเดสก์ท็อป โดยไม่มีแถบด้านบน วิวพอร์ตแคบจะแทนแถบด้านข้างด้วยลิ้นชักแบบเลื่อนทับหลังแถวส่วนหัวกะทัดรัดซึ่งมีสวิตช์ลิ้นชัก แบรนด์ และการค้นหาพาเล็ตคำสั่ง; บนโทรศัพท์ แชตจะรวมแถวการนำทางนั้นไว้ในแถบชื่อเรื่อง โดยมีตัวควบคุมเมนูและการค้นหาอยู่ข้างชื่อเซสชัน ในแอป macOS แถวส่วนหัวแยกจะรวมพื้นที่เผื่อแถบชื่อเรื่องไว้ในแถบกะทัดรัดแถบเดียวข้างตัวควบคุมหน้าต่าง การนำทางใช้ประวัติเบราว์เซอร์ตามปกติ ดังนั้นปุ่มย้อนกลับ/ไปข้างหน้าของเบราว์เซอร์จึงใช้เลื่อนผ่านการนำทางได้ แอป macOS เพิ่มสวิตช์แถบด้านข้างแบบเนทีฟข้างตัวควบคุมหน้าต่าง พร้อมท่าทางปัดบนแทร็กแพด โดยมีปุ่มย้อนกลับ/ไปข้างหน้าที่ขอบขวาของแถบด้านข้างขณะขยาย และมีปุ่มค้นหาแบบเนทีฟ (พาเล็ตคำสั่ง) กับปุ่มสร้างเซสชันใหม่ขณะยุบ

การอนุมัติที่รอดำเนินการจะเพิ่มชิปแจ้งเตือนเหนือส่วนท้ายของแถบด้านข้างด้วย; เลือกชิปเพื่อเปิดหน้าการอนุมัติที่เป็นเจ้าของรายการนั้น

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

นำเข้าหน่วยความจำของผู้ช่วย

เปิด Settings → Import Memory เพื่อนำเข้าหน่วยความจำภายในเครื่องของ Codex หรือ Claude Code ไปยังตัวแทน OpenClaw Gateway จะค้นหาหน่วยความจำภายในเครื่องที่รองรับบนโฮสต์ของตนเอง ดังนั้น Control UI ระยะไกลจึงนำเข้าจากคอมพิวเตอร์ของ Gateway แทนคอมพิวเตอร์ ที่ใช้เบราว์เซอร์

1. เลือกตัวแทนปลายทาง
2. ตรวจสอบคอลเลกชันต้นทางและชื่อไฟล์ Markdown ที่ตรวจพบ เนื้อหาไฟล์ จะไม่ถูกส่งในการตอบกลับแผนหรือแสดงในหน้า
3. เลือกคอลเลกชันที่จะนำเข้าและยืนยัน การนำไปใช้จะสร้างแผนใหม่ก่อน เขียน เพื่อให้การเลือกที่ล้าสมัยล้มเหลวอย่างปลอดภัย
4. หากมีไฟล์อยู่แล้ว ให้เปิดใช้ Replace existing imports รีเฟรช ตัวอย่าง แล้วจึงยืนยันการแทนที่

Codex นำเข้าเฉพาะ MEMORY.md และ memory_summary.md ที่รวมไว้แล้ว ส่วน Claude Code นำเข้า Markdown จากไดเรกทอรีหน่วยความจำอัตโนมัติของโปรเจกต์และ autoMemoryDirectory ที่กำหนดค่าไว้ โดยจะไม่นำเข้าเซสชัน การตั้งค่า คำสั่ง หรือ ข้อมูลประจำตัวผ่านหน้านี้ ไฟล์จะถูกคัดลอกไว้ใต้ memory/imports/ ในพื้นที่ทำงาน ที่เลือก ซึ่ง Plugin หน่วยความจำที่ใช้งานอยู่สามารถจัดทำดัชนีไฟล์เหล่านั้นได้ แหล่งข้อมูล จะไม่ถูกเปลี่ยนแปลง

การวางแผนและการนำไปใช้ต้องใช้ operator.admin การนำไปใช้ทุกครั้งจะสร้างข้อมูลสำรอง OpenClaw ที่ผ่านการตรวจสอบเมื่อมีสถานะอยู่ เขียนรายงานการย้ายข้อมูลที่ปกปิดข้อมูลแล้ว และเก็บ ข้อมูลสำรองระดับรายการก่อนแทนที่ไฟล์ปลายทางที่มีอยู่ ดูเส้นทางและ พฤติกรรมการเรียกคืนได้ที่ ภาพรวมหน่วยความจำ

หน้า MCP

หน้า MCP โดยเฉพาะเป็นมุมมองสำหรับผู้ดูแลระบบของเซิร์ฟเวอร์ MCP ที่ OpenClaw จัดการภายใต้ mcp.servers หน้านี้ไม่เริ่มการรับส่งข้อมูล MCP ด้วยตนเอง ให้ใช้เพื่อตรวจสอบและแก้ไขการกำหนดค่าที่บันทึกไว้ จากนั้นใช้ openclaw mcp doctor --probe เมื่อต้องการพิสูจน์เซิร์ฟเวอร์แบบสด

ขั้นตอนการทำงานทั่วไป:

1. เปิด MCP จากแถบด้านข้าง
2. ตรวจสอบการ์ดสรุปสำหรับจำนวนเซิร์ฟเวอร์ทั้งหมด ที่เปิดใช้งาน ที่ใช้ OAuth และที่กรองแล้ว
3. ตรวจสอบแต่ละแถวของเซิร์ฟเวอร์เกี่ยวกับการรับส่งข้อมูล การเปิดใช้งาน การยืนยันตัวตน ตัวกรอง การหมดเวลา และคำแนะนำคำสั่ง
4. เพิ่ม เปิดใช้ ปิดใช้ หรือนำเซิร์ฟเวอร์ออกโดยตรงบนหน้า MCP เลือก Streamable HTTP, SSE หรือ stdio อย่างชัดเจน บรรทัดคำสั่ง stdio รองรับอาร์กิวเมนต์ที่ใส่เครื่องหมายคำพูด เช่น เส้นทางที่มีช่องว่าง ใช้หน้า Plugins สำหรับตัวเชื่อมต่อแบบคลิกเดียวและการค้นหา
5. แก้ไขส่วนการกำหนดค่า mcp ที่จำกัดขอบเขตไว้ สำหรับฟิลด์เซิร์ฟเวอร์ขั้นสูง เช่น ตัวแปรสภาพแวดล้อม ไดเรกทอรีทำงาน ส่วนหัว เส้นทาง TLS/mTLS ข้อมูลเมตา OAuth ตัวกรองเครื่องมือ และข้อมูลเมตาการฉายภาพ Codex
6. ใช้ Save สำหรับเขียนการกำหนดค่า หรือ Save & Publish เมื่อ Gateway ที่กำลังทำงานควรนำการกำหนดค่าที่เปลี่ยนแปลงไปใช้
7. เรียกใช้ openclaw mcp status --verbose, openclaw mcp doctor --probe หรือ openclaw mcp reload จากเทอร์มินัลสำหรับการวินิจฉัยแบบคงที่ การพิสูจน์แบบสด หรือการล้างรันไทม์ที่แคชไว้

หน้าจะปกปิดค่าที่มีข้อมูลประจำตัวและมีลักษณะคล้าย URL ก่อนแสดงผล และใส่ชื่อเซิร์ฟเวอร์ไว้ในเครื่องหมายคำพูดในส่วนย่อยคำสั่ง เพื่อให้คำสั่งที่คัดลอกมายังคงทำงานได้กับชื่อที่มีช่องว่างหรืออักขระพิเศษของเชลล์ ข้อมูลอ้างอิง CLI และการกำหนดค่าฉบับเต็ม: MCP

แท็บกิจกรรม

แท็บ Activity อยู่ใน Settings › System ถัดจาก Logs และ Debug โดยเป็นเครื่องมือสังเกตการณ์ชั่วคราวภายในเบราว์เซอร์สำหรับกิจกรรมเครื่องมือแบบสด ซึ่งได้มาจากสตรีมเหตุการณ์ session.tool / เครื่องมือของ Gateway เดียวกับที่ขับเคลื่อนการ์ดเครื่องมือใน Chat โดยไม่เพิ่มกลุ่มเหตุการณ์ Endpoint พื้นที่เก็บกิจกรรมแบบถาวร ฟีดเมตริก หรือสตรีมสำหรับผู้สังเกตการณ์ภายนอกของ Gateway เพิ่มเติม

รายการกิจกรรมจะเก็บเฉพาะสรุปที่ผ่านการทำให้ปลอดภัยและตัวอย่างผลลัพธ์ที่ปกปิดและตัดทอนแล้ว ค่าของอาร์กิวเมนต์เครื่องมือจะไม่ถูกเก็บไว้ในสถานะ Activity โดย UI จะแสดงว่าอาร์กิวเมนต์ถูกซ่อนและบันทึกเฉพาะจำนวนฟิลด์อาร์กิวเมนต์ รายการในหน่วยความจำจะผูกกับแท็บเบราว์เซอร์ปัจจุบัน คงอยู่ระหว่างการนำทางภายใน Control UI และรีเซ็ตเมื่อโหลดหน้าใหม่ สลับเซสชัน หรือเลือก Clear

เทอร์มินัลสำหรับผู้ดูแลระบบ

เทอร์มินัลสำหรับผู้ดูแลระบบแบบวางเทียบได้จะถูกปิดใช้งานโดยค่าเริ่มต้น หากต้องการเปิดใช้งาน ให้ตั้งค่า gateway.terminal.enabled: true และรีสตาร์ต Gateway เทอร์มินัลต้องใช้การเชื่อมต่อ operator.admin และเปิด PTY ของโฮสต์ในพื้นที่ทำงานของตัวแทนที่ใช้งานอยู่ แท็บใหม่จะใช้ตัวแทนแชตที่เลือกอยู่ในปัจจุบัน

ใช้ Ctrl + backtick เพื่อสลับแสดงหรือซ่อนแผงเทียบท่า เลย์เอาต์รองรับการเทียบท่าด้านล่างและด้านขวา ปรับขนาดตามวิวพอร์ตของเบราว์เซอร์ และเก็บแท็บเชลล์ไว้ได้หลายแท็บ ดู gateway.terminal.enabled และการแทนที่ด้วย gateway.terminal.shell ซึ่งเป็นตัวเลือกได้ที่ การกำหนดค่า Gateway

เอเจนต์ที่ได้รับอนุญาตจากเจ้าของและไม่ได้อยู่ในแซนด์บ็อกซ์สามารถใช้เครื่องมือ terminal สำหรับงานที่ใช้เวลานานหรืองานแบบโต้ตอบซึ่งผู้ควบคุมควรเฝ้าดู การเรียกใช้เครื่องมือแต่ละครั้งสามารถเปิด อ่าน เขียน ปรับขนาด ปิด หรือแสดงรายการ PTY ของ Gateway ที่เป็นของเอเจนต์เอง เซสชันใหม่จะเปิดแท็บ Control UI ที่เชื่อมต่อร่วมกันตามค่าเริ่มต้น เพื่อให้เอเจนต์และผู้ควบคุมใช้เอาต์พุตร่วมกัน และทั้งสองฝ่ายสามารถพิมพ์หรือปรับขนาดได้ การเข้าถึงของเอเจนต์จำกัดขอบเขตตามเซสชันอย่างเคร่งครัด: เอเจนต์ไม่สามารถอ่านหรือควบคุมเทอร์มินัลที่ผู้ควบคุมสร้างขึ้นหรือเทอร์มินัลที่เปิดโดยเซสชันเอเจนต์อื่น

ลากไฟล์อย่างน้อยหนึ่งไฟล์ไปยังเทอร์มินัลที่ใช้งานอยู่ หรือใช้ปุ่มคลิปหนีบกระดาษเพื่อเลือกไฟล์ OpenClaw จะจัดเตรียมแต่ละไฟล์บนเครื่องที่เป็นเจ้าของ PTY และวางพาธสัมบูรณ์ที่ใส่เครื่องหมายคำพูดสำหรับเชลล์แล้ว ณ ตำแหน่งเคอร์เซอร์ โดยจะไม่กด Enter หรือเรียกใช้อินพุต ตัวบ่งชี้ชุดงานแบบกะทัดรัดจะแสดงไฟล์ปัจจุบันและจำนวนที่เสร็จสมบูรณ์ การยกเลิกจะหยุดชุดงานที่เหลือโดยไม่วางพาธ ส่วนการถ่ายโอนที่ล้มเหลวจะยังคงแสดงอยู่เพื่อให้ลองใหม่จากไฟล์นั้นได้โดยไม่ต้องอัปโหลดไฟล์ที่เสร็จสมบูรณ์แล้วซ้ำ รองรับรูปภาพ PDF ไฟล์เก็บถาวร และไฟล์ประเภทอื่นๆ ขนาดสูงสุด 16 MiB ต่อไฟล์ ไฟล์ที่จัดเตรียมไว้จะใช้ไดเรกทอรีชั่วคราวของระบบแบบส่วนตัวบนโฮสต์ POSIX (โหมดไดเรกทอรี 0700, โหมดไฟล์ 0600) หรือไดเรกทอรีภายในขอบเขต ACL ของโปรไฟล์ผู้ใช้บน Windows พร้อมตัวจับเวลาล้างข้อมูล 24 ชั่วโมง ดังนั้นให้ย้ายหรือคัดลอกสิ่งที่ต้องการเก็บไว้

การแทรกพาธรองรับ PowerShell, cmd.exe และเชลล์ POSIX ที่ระบบรู้จัก (sh, Bash, Dash, Ash, Ksh, Zsh และ Fish) รวมถึง Git Bash บน Windows ระบบจะปฏิเสธการแทนที่ด้วยเชลล์อื่น เนื่องจากไม่สามารถอนุมานกฎการใส่เครื่องหมายคำพูดของเชลล์เหล่านั้นได้อย่างปลอดภัย ให้เรียกใช้ Gateway ภายใน WSL เพื่อใช้เทอร์มินัล WSL แบบเนทีฟและพาธอัปโหลดของ Linux ระบบจะปฏิเสธพาธ cmd.exe ที่มี % หรือ ! ด้วยเช่นกัน เนื่องจากเชลล์ดังกล่าวจะขยายอักขระเหล่านั้นแม้อยู่ภายในเครื่องหมายคำพูดคู่

เซสชัน Codex และ Claude Code ที่ค้นพบในแถบด้านข้างของเซสชันสามารถเปิดใน CLI แบบเนทีฟภายในแผงเทอร์มินัลเดียวกันได้ ใน Settings › Chat ให้ตั้งค่า Open Codex/Claude threads in เป็น Terminal เพื่อให้การคลิกแถวตามปกติเปิด codex resume หรือ claude --resume; ค่าเริ่มต้นยังคงเป็นโปรแกรมดู OpenClaw แบบอ่านอย่างเดียว เมนูคลิกขวาหรือเมนูจุดสามจุดของแต่ละแถวมีทั้งสองตัวเลือกเสมอ และส่วนหัวของโปรแกรมดูจะแสดง Open in terminal เมื่อเซสชันนั้นมีคุณสมบัติเหมาะสม

คุณสมบัติการใช้งานจะพิจารณาแยกตามเซสชันและโฮสต์ เซสชันภายใน Gateway จะเริ่มคำสั่งดำเนินการต่อที่ผู้ให้บริการเป็นเจ้าของบนโฮสต์ Gateway เซสชันของโหนดที่จับคู่แล้วจะเริ่มคำสั่งของผู้ให้บริการที่อยู่ในรายการอนุญาตบนโหนดเจ้าของ และส่งต่อเฉพาะเอาต์พุต อินพุต และเหตุการณ์การปรับขนาดของ PTY นั้น การดำเนินการนี้จะไม่เปิดเผยเชลล์ทั่วไปของโหนดหรือยอมรับคำสั่งที่เบราว์เซอร์ส่งมา การอัปโหลดไฟล์ใช้คำสั่งโหนด terminal.upload ที่แยกต่างหากและมีขนาดจำกัด และยังคงผูกอยู่กับเซสชันเทอร์มินัลที่เปิดไว้แล้ว อนุมัติการอัปเกรดการจับคู่โหนดเมื่อคำสั่งดังกล่าวปรากฏขึ้นครั้งแรก โหนดที่ไม่ได้ประกาศคำสั่งดำเนินการต่อของเทอร์มินัลที่ตรงกัน รวมถึงบริดจ์เวิร์กเกอร์แบบฝังที่ไม่มีการสตรีมสองทิศทาง จะยังคงใช้โปรแกรมดูได้และแสดงว่าไม่สามารถเปิดเทอร์มินัลได้ ส่วนโหนดรุ่นเก่ายังคงเรียกใช้เทอร์มินัลได้แต่ไม่สามารถรับไฟล์ที่ลากมาวาง

เซสชันที่เป็นของการเชื่อมต่อจะยังคงอยู่เมื่อการเชื่อมต่อขาดหาย: การโหลดหน้าใหม่ แล็ปท็อปเข้าสู่โหมดสลีป หรือเครือข่ายสะดุด จะทำให้เซสชันถูกแยกออกบน Gateway แทนที่จะถูกยุติ และแท็บเบราว์เซอร์เดิมจะเชื่อมต่อกลับเมื่อเชื่อมต่อใหม่ พร้อมเล่นเอาต์พุตล่าสุดซ้ำ เซสชันที่เป็นของการเชื่อมต่อซึ่งถูกแยกออกจะถูกยุติหลังจาก gateway.terminal.detachedSessionTimeoutSeconds (ค่าเริ่มต้น 300 วินาที; 0 จะคืนค่าการยุติเมื่อขาดการเชื่อมต่อ) การเชื่อมต่อกับเซสชันเหล่านี้ยังคงเป็นการเข้าควบคุมแบบ tmux

เซสชันที่เป็นของเอเจนต์ไม่ได้ผูกกับการเชื่อมต่อของเบราว์เซอร์ terminal.attach จะเพิ่มแต่ละเบราว์เซอร์เป็นผู้ดูโดยไม่รับความเป็นเจ้าของ และการปิดแท็บผู้ดูจะแยกเฉพาะเบราว์เซอร์นั้น PTY จะยังคงอยู่จนกว่าเอเจนต์เจ้าของจะปิด โพรเซสของ PTY จะสิ้นสุด นโยบายจะปิดใช้งาน หรือ Gateway จะปิดตัวลง terminal.list ระบุแต่ละรายการว่าเป็นของการเชื่อมต่อหรือของเอเจนต์ และ terminal.text อนุญาตให้การเชื่อมต่อของผู้ดูแลระบบอ่านเอาต์พุตข้อความธรรมดาล่าสุดได้โดยไม่ต้องเชื่อมต่อกับเซสชัน

เทอร์มินัลยังพร้อมใช้งานในรูปแบบเอกสารเต็มหน้าจอที่มีเฉพาะเทอร์มินัล ณ /?view=terminal แอป iOS และ Android ฝังหน้านี้ไว้ในหน้าจอ Terminal โดยใช้ข้อมูลประจำตัว Gateway ที่จัดเก็บไว้ซ้ำ ความพร้อมใช้งานเป็นไปตามเงื่อนไข gateway.terminal.enabled และ operator.admin เดียวกัน และหน้าจะแสดงประกาศเมื่อ Gateway ที่เชื่อมต่อไม่ให้บริการเทอร์มินัล

แผงเบราว์เซอร์

Control UI มาพร้อมแผงเบราว์เซอร์แบบเทียบท่าได้ ซึ่งแสดงผลเบราว์เซอร์ที่ Gateway ควบคุม (ตัวเดียวกับที่เอเจนต์ควบคุมผ่าน เครื่องมือเบราว์เซอร์) ในเว็บเบราว์เซอร์ทั่วไปโดยไม่ต้องใช้ webview แบบเนทีฟ แผงนี้จะปรากฏเมื่อ Gateway ที่เชื่อมต่อประกาศ browser.request ให้กับการเชื่อมต่อ operator.admin; ปุ่มรูปลูกโลกในแถบพื้นที่ทำงานของเธรดใช้สลับการแสดงแผง แผงจะแสดงสแนปช็อตหน้าเว็บแบบสดพร้อมแท็บ แถบ URL ที่แก้ไขได้ ย้อนกลับ/ไปข้างหน้า/โหลดใหม่ และเปิดในเบราว์เซอร์ของคุณ สามารถเทียบท่าด้านขวาหรือด้านล่าง และส่งต่อการคลิก การเลื่อนด้วยล้อเมาส์ และการพิมพ์พื้นฐานไปยังหน้าเว็บระยะไกล

โหมดบันทึกภาพสองโหมดจะรวมบริบทของหน้าเว็บสำหรับเอเจนต์:

• ใส่คำอธิบายประกอบ (ดินสอ): วาดเครื่องหมายด้วยมือเปล่าทับบนหน้าเว็บ Send to chat จะรวมเส้นที่วาดลงในภาพหน้าจอ แนบภาพกับช่องเขียนแชตที่ใช้งานอยู่ และกรอกพรอมต์ล่วงหน้าที่อธิบาย URL ของหน้า ชื่อ และแต่ละบริเวณที่ทำเครื่องหมายไว้ เพื่อให้เอเจนต์ทราบอย่างแม่นยำว่ามีการวงส่วนใดไว้
• ตรวจสอบ (ตัวชี้): วางเมาส์เหนือเพื่อดูองค์ประกอบใต้เคอร์เซอร์ (ตัวเลือก ชื่อสำหรับการช่วยการเข้าถึง บทบาท ขนาด) คลิกเพื่อส่งรายละเอียดขององค์ประกอบนั้นพร้อมภาพหน้าจอที่ไฮไลต์ผ่านขั้นตอนช่องเขียนเดียวกัน การตรวจสอบ การเลื่อนด้วยล้อเมาส์ และการย้อนกลับ/ไปข้างหน้าต้องใช้ browser.evaluateEnabled (เปิดอยู่ตามค่าเริ่มต้น)

แอป macOS ยังคงใช้แถบด้านข้างเบราว์เซอร์ลิงก์แบบเนทีฟสำหรับลิงก์ที่คลิกในแดชบอร์ด แผงเบราว์เซอร์ใช้งานได้ในแอปนี้ด้วย และเป็นวิธีใส่คำอธิบายประกอบบนหน้าเว็บในแพลตฟอร์มอื่นทั้งหมด

ลักษณะการทำงานของแชต

การเชื่อมต่อขาดหายและการเชื่อมต่อใหม่

เมื่อสร้างเซสชันแล้ว การเชื่อมต่อ Gateway ที่ขาดหายจะไม่ทำให้ออกจากระบบ แดชบอร์ดยังคง แสดงอยู่ โดยมีป้ายทรงแคปซูลสีเหลืองอำพันแบบลอย "การเชื่อมต่อ Gateway ขาดหาย — กำลังเชื่อมต่อใหม่…" ใต้แถบ ด้านบน ขณะที่ไคลเอนต์ลองใหม่โดยอัตโนมัติด้วยระยะหน่วงที่เพิ่มขึ้น (800 ms ถึง 15 s) การอัปเดตสดและ การดำเนินการแบบเรียลไทม์/เซสชันจะหยุดชั่วคราวจนกว่าการเชื่อมต่อจะกลับมา Retry now ในป้ายจะบังคับให้ ลองเชื่อมต่อทันที แชตยังคงแก้ไขได้: การส่งข้อความธรรมดาและไฟล์แนบจะถูกเก็บไว้ใน พื้นที่จัดเก็บของเบราว์เซอร์ในแท็บปัจจุบันซึ่งจำกัดขอบเขตตาม Gateway/เซสชัน แสดงว่ากำลังรอการเชื่อมต่อใหม่ และส่ง โดยอัตโนมัติเมื่อ Gateway กลับมา ส่วนตัวควบคุมสดและคำสั่งสแลชยังคงใช้งานไม่ได้ขณะ ออฟไลน์

เมื่อเบราว์เซอร์นี้มีข้อมูลประจำตัวอยู่แล้ว (โทเค็น/รหัสผ่านที่กำหนดค่าไว้ หรือโทเค็นอุปกรณ์ ที่อนุมัติแล้ว) การเปิดครั้งแรกและการโหลดใหม่จะแสดงสัญลักษณ์ OpenClaw แบบเคลื่อนไหวขนาดเล็กขณะที่กำลัง สร้างการเชื่อมต่อ แทนการกะพริบหน้าจอเข้าสู่ระบบ หน้าจอเข้าสู่ระบบจะแสดงเฉพาะเมื่อยังไม่มีการจัดเก็บข้อมูลประจำตัว หรือเมื่อ Gateway ปฏิเสธข้อมูลดังกล่าวโดยตรง (โทเค็น/รหัสผ่านไม่ถูกต้อง การจับคู่ถูกเพิกถอน) — ซึ่งเป็นสถานะที่ต้องให้ป้อนข้อมูลแทนการรอ

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

Control UI มาพร้อม manifest.webmanifest และ service worker เพื่อให้เบราว์เซอร์สมัยใหม่ติดตั้งเป็น PWA แบบสแตนด์อโลนได้ Web Push ช่วยให้ Gateway ปลุก PWA ที่ติดตั้งไว้พร้อมการแจ้งเตือนได้ แม้แท็บหรือหน้าต่างเบราว์เซอร์จะไม่ได้เปิดอยู่

ภายในแอป macOS หน้าการตั้งค่า Notifications จะแสดงสิทธิ์การแจ้งเตือนแบบเนทีฟของแอปแทน browser push เนื่องจากแอปส่งการแจ้งเตือนแบบเนทีฟ

หากหน้าแสดง Protocol mismatch ทันทีหลังอัปเดต OpenClaw ให้เปิดแดชบอร์ดอีกครั้งด้วย openclaw dashboard และทำการรีเฟรชแบบล้างแคชก่อน หากยังล้มเหลว ให้ล้างข้อมูลไซต์สำหรับต้นทางของแดชบอร์ดหรือทดสอบในหน้าต่างเบราว์เซอร์ส่วนตัว แท็บเก่าหรือแคช service worker ของเบราว์เซอร์อาจยังคงเรียกใช้บันเดิล Control UI ก่อนอัปเดตกับ Gateway เวอร์ชันใหม่กว่า

ข้อมูลจากพื้นที่จัดเก็บ push/vapid-keys.json และ push/web-push-subscriptions.json ที่เลิกใช้แล้วจะถูกนำเข้าโดย openclaw doctor --fix หยุด Gateway ก่อนเรียกใช้การซ่อมแซมนี้ เพื่อไม่ให้กระบวนการรุ่นเก่าสร้างสถานะที่เลิกใช้แล้วขึ้นมาใหม่ระหว่างการนำเข้า เรียกใช้การซ่อมแซมก่อนใช้ Web Push หลังอัปเกรด การลงทะเบียน การส่ง การลบ และการค้นหาคีย์จะปฏิเสธการดำเนินการตราบใดที่ยังมีแหล่งข้อมูลที่เลิกใช้แล้วหรือการอ้างสิทธิ์ของ Doctor ที่ถูกขัดจังหวะเหลืออยู่ รันไทม์ Gateway อ่านและเขียนเฉพาะ SQLite

แทนที่คู่คีย์ VAPID ผ่านตัวแปรสภาพแวดล้อมในกระบวนการ Gateway เมื่อต้องการตรึงคีย์ (การปรับใช้หลายโฮสต์ การหมุนเวียนข้อมูลลับ หรือการทดสอบ):

• OPENCLAW_VAPID_PUBLIC_KEY
• OPENCLAW_VAPID_PRIVATE_KEY
• OPENCLAW_VAPID_SUBJECT (ค่าเริ่มต้นคือ https://openclaw.ai)

Control UI ใช้เมธอด Gateway ที่จำกัดขอบเขตเหล่านี้เพื่อลงทะเบียนและทดสอบการสมัครใช้งานของเบราว์เซอร์:

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

การฝังเนื้อหาที่โฮสต์

ข้อความของผู้ช่วยสามารถแสดงเนื้อหาเว็บที่โฮสต์ไว้แบบอินไลน์ด้วยชอร์ตโค้ด [embed ...] นโยบายแซนด์บ็อกซ์ของ iframe ควบคุมโดย gateway.controlUi.embedSandbox:

เครื่องมือหลัก show_widget แสดง SVG หรือ HTML ที่สมบูรณ์ในตัวโดยตรงจากการเรียกใช้เครื่องมือ เบราว์เซอร์และไคลเอนต์แชตแบบเนทีฟที่รองรับจะประกาศความสามารถ Gateway inline-widgets และเอกสาร Canvas ที่ได้จะยังคงพร้อมใช้งานเมื่อโหลดประวัติแชตใหม่ Discord Activities ใช้ชื่อเครื่องมือเดียวกันบน Discord ส่วนการทำงานที่เริ่มจากช่องทางอื่นจะไม่ได้รับเครื่องมือนี้

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

URL ฝัง http(s) ภายนอกแบบสัมบูรณ์จะยังคงถูกบล็อกตามค่าเริ่มต้น หากต้องการให้ [embed url="https://..."] โหลดหน้าจากบุคคลที่สาม ให้ตั้งค่า gateway.controlUi.allowExternalEmbedUrls: true

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

ทรานสคริปต์แชตใช้กรอบสำหรับการอ่านที่จัดกึ่งกลางและอยู่ในแนวเดียวกับช่องเขียนข้อความ เอาต์พุตของผู้ช่วยและเครื่องมือจะจัดชิดซ้าย ส่วนกล่องข้อความผู้ใช้จะจัดชิดขวาภายในกรอบนั้น การปรับใช้บนจอกว้างสามารถแทนที่ความกว้างของทรานสคริปต์โดยไม่ต้องแก้ไข CSS ที่รวมมา ด้วยการตั้งค่า gateway.controlUi.chatMessageMaxWidth:

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

ค่าจะผ่านการตรวจสอบก่อนส่งถึงเบราว์เซอร์ รูปแบบที่รองรับประกอบด้วยค่าความยาวและเปอร์เซ็นต์ธรรมดา เช่น 960px หรือ 82% รวมถึงนิพจน์ความกว้างแบบมีข้อจำกัด min(...), max(...), clamp(...), calc(...) และ fit-content(...)

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

openclaw gateway --tailscale serve

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

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

หากเปิดแดชบอร์ดผ่าน HTTP ธรรมดา (http://<lan-ip> หรือ http://<tailscale-ip>) เบราว์เซอร์จะทำงานใน บริบทที่ไม่ปลอดภัย และบล็อก WebCrypto โดยค่าเริ่มต้น OpenClaw จะ บล็อก การเชื่อมต่อ Control UI ที่ไม่มีข้อมูลประจำตัวอุปกรณ์

ข้อยกเว้นที่ระบุไว้ในเอกสาร:

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

วิธีแก้ที่แนะนำ: ใช้ HTTPS (Tailscale Serve) หรือเปิด UI ภายในเครื่องที่ 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" },  },}

โปรดดู Tailscale สำหรับคำแนะนำในการตั้งค่า HTTPS

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

Control UI มาพร้อมนโยบาย img-src ที่เข้มงวด โดยอนุญาตเฉพาะทรัพยากรจาก ต้นทางเดียวกัน, URL แบบ data: และ URL แบบ blob: ที่สร้างขึ้นภายในเครื่อง เบราว์เซอร์จะปฏิเสธ URL รูปภาพระยะไกลแบบ http(s) และแบบสัมพันธ์กับโปรโตคอล โดยจะไม่ส่งคำขอดึงข้อมูลผ่านเครือข่ายเลย

ในทางปฏิบัติ:

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

คุณลักษณะนี้เปิดใช้งานตลอดเวลาและไม่สามารถกำหนดค่าได้

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

เมื่อกำหนดค่าการยืนยันตัวตนของ Gateway ปลายทางอวาตาร์ของ Control UI จะต้องใช้โทเค็น Gateway เดียวกับส่วนอื่นของ API:

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

หากปิดใช้งานการยืนยันตัวตนของ Gateway (ไม่แนะนำบนโฮสต์ที่ใช้ร่วมกัน) เส้นทางอวาตาร์จะไม่ต้องยืนยันตัวตนเช่นกัน ซึ่งสอดคล้องกับส่วนอื่นของ Gateway

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

เมื่อกำหนดค่าการยืนยันตัวตนของ Gateway ตัวอย่างสื่อภายในเครื่องของผู้ช่วยจะใช้เส้นทางสองขั้นตอน:

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

วิธีนี้ช่วยให้การแสดงผลสื่อเข้ากันได้กับองค์ประกอบสื่อแบบเนทีฟของเบราว์เซอร์ โดยไม่ใส่ข้อมูลประจำตัว Gateway ที่นำกลับมาใช้ซ้ำได้ลงใน URL สื่อที่มองเห็นได้

ลิงก์การอนุมัติ

การแจ้งเตือนการอนุมัติของผู้ดำเนินการสามารถลิงก์โดยตรงไปยังเอกสารการอนุมัติแบบสแตนด์อโลนที่ให้บริการภายใต้เนมสเปซ ${controlUiBasePath}/approve/{approvalId} ที่สงวนไว้ (เช่น /approve/<approvalId> หรือ /openclaw/approve/<approvalId> เมื่อกำหนดค่าพาธฐาน) URL จะคงที่ตลอดอายุของการอนุมัติและสามารถส่งต่อระหว่างอุปกรณ์ของคุณเองได้อย่างปลอดภัย โดย URL นี้ระบุการอนุมัติเท่านั้นและไม่เคยให้สิทธิ์อนุมัติ

• Gateway สงวนเนมสเปซ /approve/<approvalId> แบบหนึ่งเซกเมนต์ไว้ก่อนเส้นทาง HTTP ของ Plugin สำหรับเมธอด HTTP ทั้งหมด ดังนั้นเส้นทาง Plugin จึงไม่สามารถบดบังหรือสกัดกั้นเอกสารการอนุมัติได้
• การเปิดเอกสารการอนุมัติต้องใช้การยืนยันตัวตน Gateway แบบเดียวกับส่วนอื่นของ Control UI (โทเค็น/รหัสผ่าน, ข้อมูลประจำตัว Tailscale Serve หรือข้อมูลประจำตัวจากพร็อกซีที่เชื่อถือได้) โดยข้อมูลประจำตัวจะไม่เป็นส่วนหนึ่งของ URL การอนุมัติ
• เมื่อปิดใช้งานการให้บริการ Control UI คำขอไปยังเนมสเปซนี้จะส่งคืน 404 แทนที่จะส่งต่อไปยังตัวจัดการ Plugin
• การลงชื่อเข้าใช้ในเอกสารการอนุมัติมีผลชั่วคราวเฉพาะหน้านั้น โดยจะไม่เขียนทับการเลือกหรือการตั้งค่า Gateway ที่ Control UI แบบเต็มบันทึกไว้ในเบราว์เซอร์เดียวกัน

Gateway ให้บริการไฟล์แบบคงที่จาก dist/control-ui:

pnpm ui:build

พาธฐานแบบสัมบูรณ์ที่ไม่บังคับ (URL ทรัพยากรแบบตายตัว):

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

การพัฒนาภายในเครื่อง (เซิร์ฟเวอร์สำหรับพัฒนาแยกต่างหาก):

pnpm ui:dev

จากนั้นกำหนดให้ UI ชี้ไปยัง URL WS ของ Gateway (เช่น ws://127.0.0.1:18789)

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

หากเบราว์เซอร์โหลดแดชบอร์ดว่างเปล่าและ DevTools ไม่แสดงข้อผิดพลาดที่เป็นประโยชน์ ส่วนขยายหรือสคริปต์เนื้อหาที่ทำงานช่วงต้นอาจขัดขวางไม่ให้แอปโมดูล JavaScript ประมวลผล หน้าคงที่มีแผงกู้คืน HTML ธรรมดาที่จะปรากฏเมื่อ <openclaw-app> ไม่ได้ลงทะเบียนหลังเริ่มต้นระบบ

ใช้การดำเนินการ Try again ของแผงหลังเปลี่ยนสภาพแวดล้อมของเบราว์เซอร์ หรือโหลดใหม่ด้วยตนเองหลังตรวจสอบรายการต่อไปนี้:

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

การดีบัก/การทดสอบ: เซิร์ฟเวอร์สำหรับพัฒนา + Gateway ระยะไกล

Control UI ประกอบด้วยไฟล์แบบคงที่ ส่วนเป้าหมาย WebSocket สามารถกำหนดค่าได้และอาจต่างจากต้นทาง HTTP คุณลักษณะนี้มีประโยชน์เมื่อต้องการใช้เซิร์ฟเวอร์สำหรับพัฒนา Vite ภายในเครื่อง แต่ 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 — ส่วนติดต่อแชตผ่านเบราว์เซอร์