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

• แชตกับโมเดลผ่าน Gateway WS (chat.history, chat.send, chat.abort, chat.inject)
• การรีเฟรชประวัติแชตจะขอหน้าต่างล่าสุดแบบมีขอบเขตพร้อมเพดานข้อความต่อข้อความ เพื่อให้เซสชันขนาดใหญ่ไม่บังคับให้เบราว์เซอร์เรนเดอร์เพย์โหลดทรานสคริปต์เต็มก่อนที่แชตจะใช้งานได้
• พูดคุยผ่านเซสชันเรียลไทม์ของเบราว์เซอร์ OpenAI ใช้ WebRTC โดยตรง, Google Live ใช้โทเค็นเบราว์เซอร์แบบใช้ครั้งเดียวที่ถูกจำกัดผ่าน WebSocket และ Plugin เสียงเรียลไทม์แบบแบ็กเอนด์เท่านั้นใช้ทรานสปอร์ตรีเลย์ของ Gateway เซสชันผู้ให้บริการที่ไคลเอนต์เป็นเจ้าของเริ่มด้วย talk.client.create; เซสชันรีเลย์ Gateway เริ่มด้วย talk.session.create รีเลย์จะเก็บข้อมูลรับรองผู้ให้บริการไว้บน Gateway ขณะที่เบราว์เซอร์สตรีม PCM จากไมโครโฟนผ่าน talk.session.appendAudio, ส่งต่อการเรียกเครื่องมือผู้ให้บริการ openclaw_agent_consult ผ่าน talk.client.toolCall สำหรับนโยบาย Gateway และโมเดล OpenClaw ที่กำหนดค่าไว้ขนาดใหญ่กว่า และกำหนดเส้นทางการควบคุมเสียงของรันที่ทำงานอยู่ผ่าน talk.client.steer หรือ talk.session.steer
• สตรีมการเรียกเครื่องมือ + การ์ดเอาต์พุตเครื่องมือสดในแชต (เหตุการณ์เอเจนต์)
• แท็บกิจกรรมพร้อมสรุปกิจกรรมเครื่องมือสดจากการส่ง session.tool / เหตุการณ์เครื่องมือที่มีอยู่ ซึ่งอยู่ภายในเบราว์เซอร์และให้ความสำคัญกับการปกปิดข้อมูลก่อน

• ช่องทาง: สถานะช่องทาง Plugin ในตัว รวมถึงที่บันเดิล/ภายนอก, การเข้าสู่ระบบด้วย QR และการกำหนดค่าต่อช่องทาง (channels.status, web.login.*, config.patch)
• การรีเฟรชการตรวจสอบช่องทางจะคงสแนปช็อตก่อนหน้าให้มองเห็นได้ขณะการตรวจสอบผู้ให้บริการที่ช้าดำเนินการเสร็จ และสแนปช็อตบางส่วนจะถูกติดป้ายเมื่อการตรวจสอบหรือการตรวจประเมินเกินงบเวลา UI
• อินสแตนซ์: รายการสถานะพร้อมใช้งาน + รีเฟรช (system-presence)
• เซสชัน: แสดงรายการเซสชันเอเจนต์ที่กำหนดค่าไว้เป็นค่าเริ่มต้น ปักหมุดเซสชันที่ใช้บ่อย เปลี่ยนชื่อ เก็บถาวรหรือกู้คืนเซสชันที่ไม่ใช้งาน ถอยกลับจากคีย์เซสชันเอเจนต์ที่ไม่ได้กำหนดค่าซึ่งเก่าเกินไป และใช้การแทนที่โมเดล/การคิด/เร็ว/ละเอียด/ติดตาม/การให้เหตุผลต่อเซสชัน (sessions.list, sessions.patch) เซสชันที่ปักหมุดจะเรียงเหนือเซสชันล่าสุดที่ไม่ได้ปักหมุด; เซสชันที่เก็บถาวรอยู่ในมุมมองที่เก็บถาวรของหน้าเซสชันและคงทรานสคริปต์ไว้
• ความฝัน: สถานะ Dreaming, สวิตช์เปิด/ปิด และตัวอ่านไดอารีความฝัน (doctor.memory.status, doctor.memory.dreamDiary, config.patch)

• งาน Cron: แสดงรายการ/เพิ่ม/แก้ไข/รัน/เปิดใช้งาน/ปิดใช้งาน + ประวัติการรัน (cron.*)
• Skills: สถานะ เปิดใช้งาน/ปิดใช้งาน ติดตั้ง อัปเดตคีย์ API (skills.*)
• โหนด: แสดงรายการ + ความสามารถ (node.list), สร้างรหัสตั้งค่ามือถือ และอนุมัติการจับคู่อุปกรณ์ (device.pair.*)
• การอนุมัติ exec: แก้ไขรายการอนุญาตของ Gateway หรือโหนด + นโยบายการถามสำหรับ exec host=gateway/node (exec.approvals.*)

• ดู/แก้ไข ~/.openclaw/openclaw.json (config.get, config.set)
• MCP มีหน้าการตั้งค่าเฉพาะสำหรับเซิร์ฟเวอร์ที่กำหนดค่าไว้ การเปิดใช้งาน สรุป OAuth/ตัวกรอง/การทำงานแบบขนาน คำสั่งผู้ปฏิบัติงานทั่วไป และตัวแก้ไขการกำหนดค่า mcp แบบจำกัดขอบเขต
• นำไปใช้ + รีสตาร์ตพร้อมการตรวจสอบ (config.apply) และปลุกเซสชันที่ใช้งานล่าสุด
• การเขียนมีตัวป้องกัน base-hash เพื่อป้องกันการเขียนทับการแก้ไขพร้อมกัน
• การเขียน (config.set/config.apply/config.patch) จะตรวจสอบล่วงหน้าการแก้ค่า SecretRef ที่ใช้งานอยู่สำหรับ refs ในเพย์โหลดการกำหนดค่าที่ส่งมา; refs ที่ส่งมาซึ่งใช้งานอยู่แต่แก้ค่าไม่ได้จะถูกปฏิเสธก่อนเขียน
• การบันทึกฟอร์มจะทิ้งตัวแทนค่าที่ถูกปกปิดซึ่งล้าสมัยและไม่สามารถกู้คืนจากการกำหนดค่าที่บันทึกไว้ได้ พร้อมคงค่าที่ถูกปกปิดซึ่งยังจับคู่กับ secret ที่บันทึกไว้
• Schema + การเรนเดอร์ฟอร์ม (config.schema / config.schema.lookup รวมถึงฟิลด์ title / description, คำใบ้ UI ที่ตรงกัน, สรุปลูกโดยตรง, เมตาดาต้าเอกสารบนโหนด object/wildcard/array/composition ที่ซ้อนกัน รวมถึง schema ของ Plugin + ช่องทางเมื่อมี); ตัวแก้ไข Raw JSON จะใช้ได้เฉพาะเมื่อ snapshot มี raw round-trip ที่ปลอดภัย
• หาก snapshot ไม่สามารถ round-trip ข้อความ raw ได้อย่างปลอดภัย Control UI จะบังคับใช้โหมดฟอร์มและปิดใช้งานโหมด Raw สำหรับ snapshot นั้น
• ตัวแก้ไข Raw JSON "รีเซ็ตเป็นค่าที่บันทึกไว้" จะคงรูปทรงที่เขียนแบบ raw ไว้ (การจัดรูปแบบ, ความคิดเห็น, เลย์เอาต์ $include) แทนการเรนเดอร์ snapshot แบบแบนใหม่ ดังนั้นการแก้ไขภายนอกจะรอดจากการรีเซ็ตเมื่อ snapshot สามารถ round-trip ได้อย่างปลอดภัย
• ค่า object SecretRef แบบมีโครงสร้างจะแสดงเป็นอ่านอย่างเดียวในอินพุตข้อความของฟอร์ม เพื่อป้องกันความเสียหายจากการแปลง object เป็น string โดยไม่ตั้งใจ

• ดีบัก: snapshot สถานะ/สุขภาพ/โมเดล + บันทึกเหตุการณ์ + การเรียก RPC ด้วยตนเอง (status, health, models.list)
• บันทึกเหตุการณ์รวมเวลา refresh/RPC ของ Control UI, เวลาเรนเดอร์ chat/config ที่ช้า และรายการการตอบสนองของเบราว์เซอร์สำหรับเฟรมแอนิเมชันยาวหรืองานยาวเมื่อเบราว์เซอร์เปิดเผยชนิดรายการ PerformanceObserver เหล่านั้น
• บันทึก: tail แบบสดของบันทึกไฟล์ Gateway พร้อมตัวกรอง/ส่งออก (logs.tail)
• อัปเดต: รันการอัปเดตแพ็กเกจ/git + รีสตาร์ต (update.run) พร้อมรายงานการรีสตาร์ต จากนั้น poll update.status หลังเชื่อมต่อใหม่เพื่อตรวจสอบเวอร์ชัน Gateway ที่กำลังทำงาน

• สำหรับงานแบบแยกเดี่ยว การส่งมอบมีค่าเริ่มต้นเป็นประกาศสรุป คุณสามารถเปลี่ยนเป็นไม่มีได้หากต้องการให้รันเฉพาะภายใน
• ฟิลด์ช่องทาง/เป้าหมายจะแสดงเมื่อเลือกประกาศ
• โหมด Webhook ใช้ delivery.mode = "webhook" โดยตั้ง delivery.to เป็น URL webhook HTTP(S) ที่ถูกต้อง
• สำหรับงานเซสชันหลัก โหมดการส่งมอบ webhook และไม่มีจะพร้อมใช้งาน
• ตัวควบคุมการแก้ไขขั้นสูงรวมถึงลบหลังรัน, ล้างการ override agent, ตัวเลือก cron exact/stagger, การ override โมเดล/thinking ของ agent และสวิตช์การส่งมอบแบบ best-effort
• การตรวจสอบฟอร์มเป็นแบบ inline พร้อมข้อผิดพลาดระดับฟิลด์; ค่าที่ไม่ถูกต้องจะปิดใช้งานปุ่มบันทึกจนกว่าจะแก้ไข
• ตั้ง cron.webhookToken เพื่อส่ง bearer token เฉพาะ หากละไว้ webhook จะถูกส่งโดยไม่มีส่วนหัว auth
• fallback ที่เลิกใช้แล้ว: รัน openclaw doctor --fix เพื่อย้ายงาน legacy ที่จัดเก็บไว้พร้อม notify: true จาก cron.webhook ไปเป็น webhook ต่อรายการงานอย่างชัดเจนหรือการส่งมอบเมื่อเสร็จสิ้น

• chat.send เป็นแบบ ไม่บล็อก: ตอบรับทันทีด้วย { runId, status: "started" } และสตรีมคำตอบผ่านเหตุการณ์ chat ไคลเอนต์ Control UI ที่เชื่อถือได้อาจได้รับเมตาดาต้าเวลา ACK เพิ่มเติมสำหรับ diagnostics ภายในเครื่องด้วย
• การอัปโหลด Chat รองรับรูปภาพและไฟล์ที่ไม่ใช่วิดีโอ รูปภาพจะคงพาธรูปภาพดั้งเดิม; ไฟล์อื่นจะถูกจัดเก็บเป็นสื่อที่จัดการและแสดงในประวัติเป็นลิงก์แนบ
• การส่งซ้ำด้วย idempotencyKey เดิมจะคืน { status: "in_flight" } ระหว่างที่กำลังทำงาน และ { status: "ok" } หลังเสร็จสิ้น
• คำตอบ chat.history ถูกจำกัดขนาดเพื่อความปลอดภัยของ UI เมื่อรายการ transcript ใหญ่เกินไป Gateway อาจตัดทอนฟิลด์ข้อความยาว ละเว้นบล็อกเมตาดาต้าหนัก และแทนที่ข้อความที่ใหญ่เกินด้วยตัวแทน ([chat.history omitted: message too large])
• เมื่อข้อความผู้ช่วยที่มองเห็นได้ถูกตัดทอนใน chat.history ตัวอ่านด้านข้างสามารถดึงรายการ transcript แบบ display-normalized ฉบับเต็มตามต้องการผ่าน chat.message.get ด้วย sessionKey, agentId ที่ใช้งานอยู่เมื่อจำเป็น และ messageId ของ transcript หาก Gateway ยังไม่สามารถคืนข้อมูลเพิ่มได้ ตัวอ่านจะแสดงสถานะไม่พร้อมใช้งานอย่างชัดเจนแทนการแสดงตัวอย่างที่ถูกตัดทอนซ้ำอย่างเงียบ ๆ
• รูปภาพที่ผู้ช่วย/ระบบสร้างขึ้นจะถูกคงอยู่เป็น managed media references และให้บริการกลับผ่าน URL สื่อ Gateway ที่ยืนยันตัวตนแล้ว ดังนั้นการโหลดใหม่จึงไม่ขึ้นกับเพย์โหลดรูปภาพ base64 ดิบที่ยังอยู่ในคำตอบประวัติ Chat
• เมื่อเรนเดอร์ chat.history Control UI จะลบแท็กคำสั่ง inline ที่ใช้แสดงผลเท่านั้นออกจากข้อความผู้ช่วยที่มองเห็นได้ (เช่น [[reply_to_*]] และ [[audio_as_voice]]), เพย์โหลด XML การเรียกเครื่องมือแบบข้อความล้วน (รวมถึง <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> และบล็อกการเรียกเครื่องมือที่ถูกตัดทอน), และโทเค็นควบคุมโมเดล ASCII/full-width ที่รั่วไหล และละเว้นรายการผู้ช่วยที่ข้อความที่มองเห็นได้ทั้งหมดเป็นเพียง silent token ที่ตรงเป๊ะ NO_REPLY / no_reply หรือโทเค็นตอบรับ Heartbeat HEARTBEAT_OK
• ระหว่างการส่งที่ใช้งานอยู่และการ refresh ประวัติครั้งสุดท้าย มุมมอง Chat จะคงข้อความผู้ใช้/ผู้ช่วยแบบ optimistic ภายในเครื่องให้มองเห็นได้หาก chat.history คืน snapshot ที่เก่ากว่าชั่วครู่; transcript canonical จะแทนที่ข้อความภายในเครื่องเหล่านั้นเมื่อประวัติ Gateway ตามทัน
• เหตุการณ์ chat แบบสดคือสถานะการส่งมอบ ขณะที่ chat.history ถูกสร้างใหม่จาก transcript เซสชันถาวร หลังเหตุการณ์ tool-final Control UI จะโหลดประวัติใหม่และ merge เฉพาะส่วนท้ายแบบ optimistic ขนาดเล็ก; ขอบเขต transcript อธิบายไว้ใน WebChat
• chat.inject เพิ่มโน้ตผู้ช่วยต่อท้าย transcript เซสชันและ broadcast เหตุการณ์ chat สำหรับการอัปเดตเฉพาะ UI (ไม่มี agent run, ไม่มีการส่งมอบช่องทาง)
• แถบด้านข้างแสดงเซสชันล่าสุดพร้อมการกระทำเซสชันใหม่ ลิงก์เซสชันทั้งหมด และปุ่มค้นหาเซสชันที่เปิดตัวเลือกเซสชันแบบเต็ม (จำกัดขอบเขตตาม agent ที่เลือก พร้อมการค้นหาและ pagination) การสลับ agent จะแสดงเฉพาะเซสชันที่ผูกกับ agent นั้น และ fallback ไปยังเซสชันหลักของ agent นั้นเมื่อยังไม่มีเซสชัน dashboard ที่บันทึกไว้
• แต่ละแถวในตัวเลือกเซสชันสามารถเปลี่ยนชื่อ ปักหมุด หรือ archive เซสชันได้ run ที่ใช้งานอยู่และเซสชันหลักของ agent ไม่สามารถ archive ได้ การ archive เซสชันที่เลือกอยู่ในปัจจุบันจะสลับ Chat กลับไปยังเซสชันหลักของ agent นั้น
• บนความกว้างระดับเดสก์ท็อป ตัวควบคุม Chat จะอยู่ในแถวกะทัดรัดแถวเดียวและยุบขณะเลื่อนลง transcript; การเลื่อนขึ้น กลับไปด้านบน หรือไปถึงด้านล่างจะคืนตัวควบคุม
• ข้อความข้อความล้วนที่ซ้ำกันต่อเนื่องจะเรนเดอร์เป็น bubble เดียวพร้อม badge จำนวน ข้อความที่มีรูปภาพ ไฟล์แนบ output เครื่องมือ หรือ canvas preview จะไม่ถูกยุบ
• ตัวเลือกโมเดลและ thinking ในส่วนหัว Chat จะ patch เซสชันที่ใช้งานอยู่ทันทีผ่าน sessions.patch; สิ่งเหล่านี้เป็นการ override เซสชันแบบถาวร ไม่ใช่ตัวเลือกส่งสำหรับรอบเดียวเท่านั้น
• หากคุณส่งข้อความขณะที่การเปลี่ยนตัวเลือกโมเดลสำหรับเซสชันเดียวกันยังบันทึกอยู่ composer จะรอ session patch นั้นก่อนเรียก chat.send เพื่อให้การส่งใช้โมเดลที่เลือก
• การพิมพ์ /new ใน Control UI จะสร้างและสลับไปยังเซสชัน dashboard ใหม่แบบเดียวกับ New Chat ยกเว้นเมื่อกำหนดค่า session.dmScope: "main" และ parent ปัจจุบันเป็นเซสชันหลักของ agent; ในกรณีนั้นจะรีเซ็ตเซสชันหลักในที่เดิม การพิมพ์ /reset จะคงการรีเซ็ตในที่เดิมอย่างชัดเจนของ Gateway สำหรับเซสชันปัจจุบัน
• ตัวเลือกโมเดลของ Chat ขอ model view ที่กำหนดค่าไว้ของ Gateway หากมี agents.defaults.models allowlist นั้นจะขับเคลื่อนตัวเลือก รวมถึงรายการ provider/* ที่ทำให้ catalog แบบจำกัดขอบเขต provider เป็นแบบไดนามิก มิฉะนั้นตัวเลือกจะแสดงรายการ models.providers.*.models ที่ชัดเจนพร้อม provider ที่มี auth ใช้งานได้ catalog ฉบับเต็มยังพร้อมใช้งานผ่าน RPC ดีบัก models.list ด้วย view: "all"
• เมื่อรายงานการใช้งานเซสชัน Gateway ใหม่มี context tokens ปัจจุบัน แถบเครื่องมือ composer ของ Chat จะแสดงวงแหวนการใช้งาน context ขนาดเล็กพร้อมเปอร์เซ็นต์ที่ใช้; รายละเอียด token ฉบับเต็มอยู่ใน tooltip วงแหวนจะเปลี่ยนเป็นสไตล์คำเตือนเมื่อ context กดดันสูง และที่ระดับ Compaction ที่แนะนำ จะแสดงปุ่มกะทัดรัดที่รันเส้นทาง Compaction เซสชันปกติ snapshot token ที่ล้าสมัยจะถูกซ่อนไว้จนกว่า Gateway จะรายงานการใช้งานใหม่อีกครั้ง

โหมดพูดใช้ผู้ให้บริการเสียง realtime ที่ลงทะเบียนไว้ กำหนดค่า OpenAI ด้วย talk.realtime.provider: "openai" พร้อมโปรไฟล์ auth แบบคีย์ API openai, talk.realtime.providers.openai.apiKey หรือ OPENAI_API_KEY; โปรไฟล์ OAuth ของ OpenAI ไม่ได้กำหนดค่าเสียง Realtime กำหนดค่า Google ด้วย talk.realtime.provider: "google" พร้อม talk.realtime.providers.google.apiKey เบราว์เซอร์จะไม่เคยได้รับคีย์ API ของ provider มาตรฐาน OpenAI ได้รับ secret ไคลเอนต์ Realtime แบบชั่วคราวสำหรับ WebRTC Google Live ได้รับ token auth Live API แบบจำกัดและใช้ครั้งเดียวสำหรับเซสชัน WebSocket ของเบราว์เซอร์ พร้อมคำสั่งและการประกาศเครื่องมือที่ถูกล็อกไว้ใน token โดย Gateway provider ที่เปิดเผยเฉพาะ backend realtime bridge จะทำงานผ่าน transport relay ของ Gateway ดังนั้นข้อมูลประจำตัวและ socket ของ vendor จะอยู่ฝั่งเซิร์ฟเวอร์ ขณะที่เสียงของเบราว์เซอร์ย้ายผ่าน RPC ของ Gateway ที่ยืนยันตัวตนแล้ว prompt ของเซสชัน Realtime ประกอบโดย Gateway; talk.client.create ไม่ยอมรับการ override คำสั่งที่ caller ระบุ

ตัวเขียนข้อความแชทมีปุ่มตัวเลือกการพูดคุยอยู่ถัดจากปุ่มเริ่ม/หยุดการพูดคุย ตัวเลือกเหล่านี้มีผลกับเซสชันการพูดคุยถัดไป และสามารถแทนที่ผู้ให้บริการ, การรับส่ง, โมเดล, เสียง, ระดับความพยายามในการให้เหตุผล, เกณฑ์ VAD, ระยะเวลาความเงียบ และระยะ padding ของคำนำหน้าได้ เมื่อตัวเลือกว่าง Gateway จะใช้ค่าเริ่มต้นที่กำหนดค่าไว้เมื่อมี หรือใช้ค่าเริ่มต้นของผู้ให้บริการ การเลือก Gateway relay จะบังคับใช้เส้นทาง relay ของแบ็กเอนด์ ส่วนการเลือก WebRTC จะคงให้เซสชันเป็นของไคลเอนต์ และจะล้มเหลวแทนการถอยกลับไปใช้ relay แบบเงียบ ๆ หากผู้ให้บริการไม่สามารถสร้างเซสชันเบราว์เซอร์ได้

ในตัวเขียนข้อความแชท ตัวควบคุมการพูดคุยคือปุ่มรูปคลื่นที่อยู่ถัดจากปุ่มบันทึกเสียงตามคำบอกด้วยไมโครโฟน เมื่อการพูดคุยเริ่มขึ้น แถวสถานะของตัวเขียนข้อความจะแสดง Connecting Talk... จากนั้นแสดง Talk live ขณะเชื่อมต่อเสียงอยู่ หรือ Asking OpenClaw... ขณะที่การเรียกเครื่องมือแบบเรียลไทม์กำลังปรึกษาโมเดลขนาดใหญ่ที่กำหนดค่าไว้ผ่าน talk.client.toolCall

การทดสอบสดสำหรับผู้ดูแล: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts ตรวจสอบบริดจ์ WebSocket ของแบ็กเอนด์ OpenAI, การแลกเปลี่ยน SDP ของ WebRTC เบราว์เซอร์ OpenAI, การตั้งค่า WebSocket เบราว์เซอร์ Google Live แบบจำกัดโทเค็น และอะแดปเตอร์เบราว์เซอร์ Gateway relay พร้อมสื่อไมโครโฟนจำลอง คำสั่งนี้พิมพ์เฉพาะสถานะผู้ให้บริการและไม่บันทึกความลับ

• คลิก หยุด (เรียก chat.abort)
• ขณะที่การรันทำงานอยู่ การติดตามผลปกติจะเข้าคิว คลิก นำทาง บนข้อความที่เข้าคิวเพื่อแทรกการติดตามผลนั้นเข้าไปในเทิร์นที่กำลังรันอยู่
• พิมพ์ /stop (หรือวลี abort แบบเดี่ยว เช่น stop, stop action, stop run, stop openclaw, please stop) เพื่อยกเลิกนอกแบนด์
• chat.abort รองรับ { sessionKey } (ไม่มี runId) เพื่อยกเลิกการรันที่ทำงานอยู่ทั้งหมดสำหรับเซสชันนั้น

• เมื่อการรันถูก abort ข้อความบางส่วนของผู้ช่วยยังสามารถแสดงใน UI ได้
• Gateway จะคงข้อความผู้ช่วยบางส่วนที่ถูก abort ไว้ในประวัติ transcript เมื่อมีเอาต์พุตที่บัฟเฟอร์ไว้
• รายการที่คงไว้มีเมทาดาทา abort เพื่อให้ผู้บริโภค transcript แยกส่วนบางส่วนจาก abort ออกจากเอาต์พุตการเสร็จสิ้นปกติได้

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

allowInsecureAuth เป็น toggle ความเข้ากันได้เฉพาะ local เท่านั้น:

• อนุญาตให้เซสชัน Control UI ของ localhost ดำเนินต่อได้โดยไม่มีตัวตนอุปกรณ์ในบริบท HTTP ที่ไม่ปลอดภัย
• ไม่ข้ามการตรวจสอบการจับคู่
• ไม่ผ่อนคลายข้อกำหนดตัวตนอุปกรณ์ระยะไกล (ไม่ใช่ localhost)

• auth แบบ trusted-proxy ที่สำเร็จสามารถรับเซสชัน Control UI ของ ผู้ปฏิบัติการ โดยไม่มีตัวตนอุปกรณ์ได้
• สิ่งนี้ ไม่ ขยายไปยังเซสชัน Control UI บทบาท node
• reverse proxy local loopback บนโฮสต์เดียวกันยังไม่ผ่าน auth แบบ trusted-proxy; ดู auth แบบ trusted proxy

• gatewayUrl จะถูกเก็บไว้ใน localStorage หลังจากโหลดและถูกลบออกจาก URL
• หากคุณส่ง endpoint ws:// หรือ wss:// แบบเต็มผ่าน gatewayUrl ให้ URL-encode ค่า gatewayUrl เพื่อให้เบราว์เซอร์แยกวิเคราะห์ query string ได้อย่างถูกต้อง
• ควรส่ง token ผ่าน fragment ของ URL (#token=...) เมื่อเป็นไปได้ Fragment จะไม่ถูกส่งไปยังเซิร์ฟเวอร์ ซึ่งช่วยหลีกเลี่ยงการรั่วไหลใน request log และ Referer พารามิเตอร์ query แบบเดิม ?token= ยังถูกนำเข้าได้หนึ่งครั้งเพื่อความเข้ากันได้ แต่ใช้เป็น fallback เท่านั้น และจะถูกลบออกทันทีหลัง bootstrap
• password จะถูกเก็บไว้ในหน่วยความจำเท่านั้น
• เมื่อกำหนด gatewayUrl แล้ว UI จะไม่ fallback ไปยังข้อมูลประจำตัวจาก config หรือ environment โปรดระบุ token (หรือ password) อย่างชัดเจน การไม่มีข้อมูลประจำตัวที่ระบุอย่างชัดเจนถือเป็นข้อผิดพลาด
• ใช้ wss:// เมื่อ Gateway อยู่หลัง TLS (Tailscale Serve, HTTPS proxy ฯลฯ)
• gatewayUrl ยอมรับเฉพาะในหน้าต่างระดับบนสุดเท่านั้น (ไม่ใช่แบบฝัง) เพื่อป้องกัน clickjacking
• การปรับใช้ Control UI แบบสาธารณะที่ไม่ใช่ loopback ต้องตั้งค่า gateway.controlUi.allowedOrigins อย่างชัดเจน (origin แบบเต็ม) การโหลด LAN/Tailnet ส่วนตัวแบบ same-origin จาก loopback, RFC1918/link-local, .local, .ts.net หรือโฮสต์ Tailscale CGNAT จะยอมรับได้โดยไม่ต้องเปิดใช้ Host-header fallback
• การเริ่มต้น Gateway อาจ seed origin ภายในเครื่อง เช่น http://localhost:<port> และ http://127.0.0.1:<port> จาก bind และ port ของ runtime ที่มีผล แต่ origin ของเบราว์เซอร์ระยะไกลยังต้องมีรายการที่ระบุอย่างชัดเจน
• ห้ามใช้ gateway.controlUi.allowedOrigins: ["*"] ยกเว้นสำหรับการทดสอบภายในเครื่องที่ควบคุมอย่างเข้มงวด หมายถึงอนุญาต browser origin ใดก็ได้ ไม่ใช่ "จับคู่กับ host ใดก็ตามที่ฉันใช้อยู่"
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true เปิดใช้โหมด Host-header origin fallback แต่เป็นโหมดความปลอดภัยที่อันตราย