CLI commands

เอเจนต์ตั้งค่า OpenClaw

openclaw setup

OpenClaw มาพร้อมเอเจนต์ระบบในตัว ซึ่งสื่อสารในชื่อ "OpenClaw" สำหรับ การตั้งค่า การซ่อมแซม และการกำหนดค่าในเครื่อง (เดิมเรียกว่า Crestodian) โดยจะเริ่มทำงานหลังจากโมเดลเริ่มต้นที่มีผลทำงานจริงครบหนึ่งรอบแล้วเท่านั้น การติดตั้งใหม่จะตั้งค่าการอนุมานก่อน ส่วนการกำหนดค่าที่ผิดรูปแบบจะยังคงใช้ ขั้นตอน doctor แบบดั้งเดิม

เริ่มทำงานเมื่อใด

การเรียกใช้ openclaw โดยไม่มีคำสั่งย่อยจะกำหนดเส้นทางตามสถานะการกำหนดค่า:

  • ไม่มีการกำหนดค่า หรือมีอยู่แต่ไม่มีการตั้งค่าที่ผู้ใช้กำหนด (ว่างเปล่า หรือมีเฉพาะคีย์ $schema/meta): เริ่มการเริ่มต้นใช้งานแบบมีคำแนะนำพร้อมการตรวจสอบ AI แบบสด
  • มีการกำหนดค่าอยู่แต่ไม่ผ่านการตรวจสอบความถูกต้อง: เริ่มการเริ่มต้นใช้งานแบบดั้งเดิม ซึ่งรายงานปัญหาและแนะนำให้ไปที่ openclaw doctor
  • มีการกำหนดค่าอยู่และถูกต้อง: เปิด TUI ปกติของเอเจนต์ หากเข้าถึง Gateway ที่กำหนดค่าไว้ได้และเอเจนต์เริ่มต้นของ Gateway มีโมเดล ระบบจะเข้าสู่ UI นั้นโดยตรง โดยไม่ผ่านการเริ่มต้นใช้งานหรือ OpenClaw ใช้ /openclaw ภายใน TUI หรือเรียกใช้ openclaw setup โดยตรง เพื่อเข้าสู่ OpenClaw ภายหลัง

การเรียกใช้ openclaw setup จะทดสอบโมเดลเริ่มต้นที่กำหนดค่าไว้แบบสดก่อน หากทำงานผ่านหนึ่งรอบ OpenClaw จะเริ่มทำงาน หากล้มเหลวในโหมดโต้ตอบ ระบบจะเปิดการตั้งค่าการอนุมานแบบมีคำแนะนำ และส่งต่อไปยัง OpenClaw หลังจากมีตัวเลือกที่ผ่านการทดสอบ คำขอแบบครั้งเดียว, JSON และคำขอแบบไม่โต้ตอบอื่นๆ จะล้มเหลวพร้อมคำแนะนำให้เรียกใช้ openclaw onboard เมื่อการอนุมานไม่พร้อมใช้งาน openclaw --help และ openclaw --version ยังคงใช้เส้นทางด่วนตามปกติ

การเรียกใช้ openclaw เปล่าๆ ในโหมดไม่โต้ตอบ (ไม่มี TTY) จะออกจากโปรแกรมพร้อมข้อความสั้นๆ แทนการแสดงวิธีใช้ระดับราก โดยจะแนะนำไปยังการเริ่มต้นใช้งานแบบไม่โต้ตอบสำหรับการติดตั้งใหม่หรือไม่ถูกต้อง หรือไปยัง openclaw agent --local ... เมื่อการกำหนดค่าถูกต้อง

openclaw onboard --modern ยังคงเป็นนามแฝงเพื่อความเข้ากันได้สำหรับ OpenClaw แต่ใช้ด่านตรวจการอนุมานเดียวกัน: หากการอนุมานทำงาน ระบบจะเปิดแชต หากล้มเหลวในโหมดโต้ตอบ ระบบจะเริ่มการตั้งค่าการอนุมานแบบมีคำแนะนำ และหากล้มเหลวในโหมดไม่โต้ตอบ ระบบจะออกพร้อมคำแนะนำการเริ่มต้นใช้งาน openclaw onboard --classic เปิดวิซาร์ดแบบเต็มทีละขั้นตอน

สิ่งที่ OpenClaw แสดง

OpenClaw แบบโต้ตอบจะเปิดเชลล์ TUI เดียวกับ openclaw tui พร้อมแบ็กเอนด์แชต OpenClaw คำทักทายเมื่อเริ่มต้นจะครอบคลุม:

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

ระบบจะไม่แสดงข้อมูลลับทั้งหมดหรือโหลดคำสั่ง CLI ของ Plugin เพียงเพื่อเริ่มทำงาน

ใช้ status เพื่อดูรายการโดยละเอียด ได้แก่ พาธการกำหนดค่า พาธเอกสาร/ซอร์ส การตรวจสอบ CLI ในเครื่อง การมีอยู่ของคีย์/โทเค็น เอเจนต์ โมเดล และรายละเอียด Gateway

OpenClaw ใช้การค้นหาแหล่งอ้างอิงแบบเดียวกับเอเจนต์ทั่วไป: ใน Git checkout ระบบจะชี้ไปยัง docs/ ในเครื่องและโครงสร้างซอร์ส ส่วนในการติดตั้งผ่าน npm ระบบจะใช้เอกสารที่รวมมาให้และลิงก์ไปยัง https://github.com/openclaw/openclaw พร้อมคำแนะนำให้ตรวจสอบซอร์สเมื่อเอกสารไม่เพียงพอ

ตัวอย่าง

bash
openclawopenclaw setupopenclaw setup --jsonopenclaw setup --message "models"openclaw setup --message "validate config"openclaw setup --message "setup workspace ~/Projects/work" --yesopenclaw setup --message "set default model openai/gpt-5.6" --yesopenclaw onboard --modern

ภายใน TUI ของ OpenClaw:

text
statushealthdoctorvalidate configsetupsetup workspace ~/Projects/workconfig set gateway.port 19001config set-ref gateway.auth.token env OPENCLAW_GATEWAY_TOKENgateway statusrestart gatewayagentscreate agent work workspace ~/Projects/workmodelsconfigure model providerset default model openai/gpt-5.6channelschannel info slackconnect slackopen channel wizard for slackplugins listplugins search slackplugin install clawhub:openclaw-codex-app-servertalk to work agenttalk to agent for ~/Projects/workauditquit

การดำเนินงานและการอนุมัติ

OpenClaw ใช้การดำเนินงานแบบมีชนิดแทนการแก้ไขการกำหนดค่าเฉพาะหน้า

การดำเนินงานแบบอ่านอย่างเดียวจะทำงานทันที ได้แก่ แสดงภาพรวม แสดงรายการเอเจนต์ แสดงรายการ Plugin ที่ติดตั้ง ค้นหา Plugin ใน ClawHub แสดงสถานะโมเดล/แบ็กเอนด์ เรียกใช้การตรวจสอบสถานะ/สุขภาพ ตรวจสอบความสามารถในการเข้าถึง Gateway เรียกใช้ doctor โดยไม่มีการแก้ไขแบบโต้ตอบ ตรวจสอบความถูกต้องของการกำหนดค่า และแสดงพาธบันทึกการตรวจสอบ

การเริ่มการตั้งค่าช่องทางแบบมีคำแนะนำ (connect telegram) จะทำงานทันทีเช่นกัน วิซาร์ดจะรวบรวมคำตอบอย่างชัดเจนและรับผิดชอบการเขียนข้อมูลที่เกิดขึ้น

การดำเนินงานแบบถาวรต้องได้รับการอนุมัติผ่านบทสนทนา (หรือ --yes สำหรับคำสั่งโดยตรง) ได้แก่ เขียนการกำหนดค่า, config set, config set-ref, การบูตสแตรปสำหรับการตั้งค่า/การเริ่มต้นใช้งาน, เปลี่ยนโมเดลเริ่มต้น, เริ่ม/หยุด/รีสตาร์ต Gateway, สร้างเอเจนต์ และติดตั้ง Plugin

การซ่อมแซมด้วย Doctor ไม่พร้อมใช้งานภายใน OpenClaw เนื่องจากอาจเขียนทับเส้นทางการอนุมานของผู้ให้บริการ การยืนยันตัวตน หรือเอเจนต์เริ่มต้นที่ขับเคลื่อนเซสชันนี้ ให้ออกจาก OpenClaw และเรียกใช้ openclaw doctor --fix ในเทอร์มินัล ส่วน doctor แบบอ่านอย่างเดียวยังคงพร้อมใช้งานภายใน OpenClaw

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

config set และ config set-ref สามารถเปลี่ยนการตั้งค่าใดๆ ที่ผู้ใช้เปลี่ยนได้ โดยมีรายการปฏิเสธสั้นๆ สำหรับมนุษย์เท่านั้น ได้แก่ $include, auth.*, env.*, models.* และ secrets.* ซึ่งยังคงถูกปฏิเสธ เนื่องจากมีข้อมูลประจำตัว การรวมการกำหนดค่าทางเลือก หรือคำจำกัดความผู้ให้บริการ/แค็ตตาล็อกที่ใช้เป็นข้อมูลให้ การกำหนดเส้นทางการอนุมาน การกำหนดเส้นทางการอนุมานเองก็ได้รับการปกป้องเช่นกัน: เส้นทางโมเดล เริ่มต้น (ฟิลด์ model/params/runtime ของ agents.defaults) และฟิลด์การกำหนดเส้นทาง ของเอเจนต์ที่รองรับเส้นทางเริ่มต้นที่ใช้งานอยู่จะถูกปฏิเสธ เช่นเดียวกับฟิลด์ ข้อมูลประจำตัว/โทโพโลยีของเอเจนต์ (id, agentDir, default) ฟิลด์การกำหนดเส้นทางของ เอเจนต์อื่นยังคงเขียนได้เมื่อได้รับการอนุมัติ การยืนยันตัวตนของ Gateway และช่องทางยังคงเป็น พื้นผิวการกำหนดค่าปกติ ใช้ set default model <provider/model> สำหรับ เส้นทางที่กำหนดค่าไว้แล้ว โดยระบบจะทดสอบเส้นทางแบบสดก่อนบันทึก หากต้องการ กำหนดค่าหรือซ่อมแซมการเข้าถึงผู้ให้บริการ/การยืนยันตัวตน ให้ออกจาก OpenClaw และเรียกใช้ openclaw onboard

การเขียน plugins.entries.<id>.* (เปิดใช้/ปิดใช้/กำหนดค่า Plugin ที่ติดตั้ง) ได้รับอนุญาต เว้นแต่ Plugin นั้นรองรับเส้นทางการอนุมานที่ใช้งานอยู่ แหล่งติดตั้ง Plugin และนโยบายการโหลดยังคงรักษาขอบเขตความเชื่อถือไว้ในขั้นตอนการติดตั้ง Plugin แบบมีชนิด การถอนการติดตั้ง Plugin ที่รองรับเส้นทางดังกล่าวจะถูกปฏิเสธ ด้วยเหตุผลเดียวกัน ให้ออกจาก OpenClaw และเรียกใช้ openclaw plugins uninstall <id> จากเทอร์มินัล

การอนุมัติทำได้ด้วยถ้อยคำของผู้ใช้เอง: คำตอบที่ชัดเจน ("ใช่", "ได้เลย", "ดำเนินการเลย", "ยังไม่ใช่ตอนนี้") จะถูกตีความจากรายการแบบปิดที่กำหนดแน่นอน เมื่อเส้นทางที่กำหนดค่ารองรับการเรียก completion แยกต่างหาก คำตอบอื่นสามารถจำแนกได้จากเฉพาะข้อความของผู้ใช้และข้อเสนอที่รอการอนุมัติเท่านั้น โดยจะไม่ใช้โมเดลสนทนาเองเด็ดขาด เนื่องจากโมเดลไม่สามารถอนุมัติตนเองได้ คำตอบที่จำแนกไม่ได้หรือคลุมเครือจะทำให้ข้อเสนอยังคงรอการอนุมัติและบทสนทนาจะถามอีกครั้ง

ประวัติการเปลี่ยนแปลง

หน้า Ask OpenClaw สามารถแสดงการดำเนินงานล่าสุดของเอเจนต์ระบบที่นำไปใช้แล้ว การย้ายข้อมูลของ Doctor การเขียนการกำหนดค่าจาก Settings และ CLI และการแก้ไข openclaw.json ด้วยตนเอง บันทึกการกำหนดค่าจะตรวจจับการแก้ไขจากภายนอกขณะที่ Gateway กำลังเฝ้าดู ระหว่างการเขียนที่ OpenClaw เป็นผู้ดำเนินการ หรือเมื่อเริ่มต้นครั้งถัดไปหลังจาก การแก้ไขแบบออฟไลน์

ประวัติจะถูกจัดเก็บในตาราง diagnostic_events ของฐานข้อมูล ~/.openclaw/state/openclaw.sqlite ที่ใช้ร่วมกัน ภายใต้ขอบเขต system-agent-audit และ config-audit แต่ละขอบเขตจะเก็บระเบียนล่าสุด 50,000 รายการ ไม่รวมการค้นหาและการดำเนินงานแบบอ่านอย่างเดียว ข้อมูลลับจะไม่ปรากฏใน ประวัติการเปลี่ยนแปลง บันทึกการกำหนดค่าจะเก็บพาธที่เปลี่ยนแปลงแทนค่าการกำหนดค่า และการเปรียบเทียบค่าจะใช้ลายนิ้วมือที่ได้รับการปกป้อง

การตั้งค่าช่องทางสามารถดำเนินการเป็นบทสนทนาที่โฮสต์ไว้ได้จนกว่าจะถึงขั้นตอนข้อมูลลับ TUI ของ OpenClaw ในเครื่องไม่รับคำตอบที่ละเอียดอ่อนของวิซาร์ด เนื่องจากอินพุตแชตในเทอร์มินัล มองเห็นได้ ระบบจะเสนอ open channel wizard ทันที โดยส่งต่อ ช่องทางที่เลือกไปยังวิซาร์ดเทอร์มินัลแบบปกปิด และยังสามารถเรียกใช้ openclaw channels add --channel <channel> ภายหลังได้

การเปลี่ยนไปใช้การตั้งค่าช่องทางแบบปกปิด

แชตในเครื่องสามารถส่งต่อการควบคุมไปยังวิซาร์ดช่องทางแบบปกปิด:

text
open channel wizard for slackchannel info slack

open channel wizard for <channel> เปิดการตั้งค่าช่องทางแบบปกปิดหลังจาก TUI แชตปิดลง ใช้ channel info <channel> ก่อนเพื่อดูป้ายกำกับช่องทาง สถานะการตั้งค่า สรุปข้อกำหนดเบื้องต้น และลิงก์เอกสาร

OpenClaw จะไม่เปลี่ยนการเข้าถึงผู้ให้บริการ/การยืนยันตัวตนจากภายในเซสชันของตนเองเด็ดขาด เนื่องจาก เซสชันพึ่งพาเส้นทางการอนุมานนั้นอยู่แล้ว สำหรับการตั้งค่าหรือ ซ่อมแซมผู้ให้บริการโมเดล configure model provider จะส่งคืนคำแนะนำให้ออก/เริ่มต้นใช้งานโดยไม่ เริ่มวิซาร์ดหรือเขียนการกำหนดค่า ให้ออกจาก OpenClaw และเรียกใช้ openclaw onboard; การเริ่มต้นใช้งานจะเตรียมข้อมูลประจำตัวและบันทึกเฉพาะเส้นทางที่ ทำงานจริงครบหนึ่งรอบแบบสด เริ่ม OpenClaw อีกครั้งหลังจากการเริ่มต้นใช้งานสำเร็จ

การบูตสแตรปการตั้งค่า

setup กำหนดค่าสถานะพื้นที่ทำงานและ Gateway ที่เหลือ หลังจากการเริ่มต้นใช้งานแบบมีคำแนะนำได้ตั้งค่าการอนุมานแล้ว โดยจะเขียนผ่านการดำเนินงานการกำหนดค่าแบบมีชนิดเท่านั้นและขออนุมัติก่อน

text
setupsetup workspace ~/Projects/work

setup จะคงโมเดลที่มีผลและผ่านการตรวจสอบไว้ โดยจะไม่กำหนดค่าหรือ แทนที่การอนุมาน

หากไม่มีการอนุมานหรือการตรวจสอบแบบสดล้มเหลว ให้ออกจาก OpenClaw และเรียกใช้ openclaw onboard การเริ่มต้นใช้งานแบบมีคำแนะนำจะตรวจหาโมเดลที่กำหนดค่าไว้ คีย์ API และ CLI ในเครื่องที่ยืนยันตัวตนแล้ว ขอคำตอบจริงจากตัวเลือกแต่ละรายการ และคงไว้เฉพาะเส้นทางที่ผ่านการทดสอบ OpenClaw จะเริ่มทันทีหลังจากผ่านขอบเขตนั้น จากนั้นจึงสามารถกำหนดค่าพื้นที่ทำงาน Gateway ช่องทาง เอเจนต์ Plugin และคุณลักษณะเสริมอื่นๆ ได้

แอป macOS จะข้ามลำดับนี้ทั้งหมดเมื่อเข้าถึง Gateway ที่กำหนดค่าไว้ ซึ่งเอเจนต์เริ่มต้นมีโมเดลที่กำหนดค่าไว้แล้ว โดยจะเปิด UI ปกติของเอเจนต์ สำหรับ Gateway ใหม่หรือไม่สมบูรณ์ แอปจะดำเนินลำดับการอนุมานผ่าน เมธอด Gateway openclaw.setup.detect และ openclaw.setup.activate: detect จะแสดงรายการแบ็กเอนด์ที่เป็นตัวเลือกทั้งหมดที่พบ ส่วน activate จะทดสอบตัวเลือกหนึ่ง แบบสด (completion จริงแบบ "ตอบกลับด้วย OK") และจะคงไว้เฉพาะโมเดล ข้อมูลประจำตัว และสถานะผู้ให้บริการ/รันไทม์ที่จำเป็นสำหรับเส้นทางนั้นหลังจากการทดสอบผ่าน ค่าเริ่มต้นของพื้นที่ทำงานและ Gateway ยังคงเป็นหน้าที่ของ OpenClaw ตัวเลือกที่ล้มเหลว จะไม่เปลี่ยนการกำหนดค่า แอปจะไล่ลงตามลำดับโดยอัตโนมัติ และสุดท้าย เสนอขั้นตอนคีย์/โทเค็นด้วยตนเองที่เติมข้อมูลจาก Plugin ผู้ให้บริการ การอนุมานข้อความที่ใช้งานอยู่ของ Gateway ผู้ให้บริการที่เลือกจะเป็นเจ้าของโมเดลเริ่มต้น และการกำหนดค่าของตน และข้อมูลประจำตัวจะได้รับการตรวจสอบด้วยวิธีเดียวกันก่อนบันทึก

การควบคุม Codex และคุณลักษณะเสริมอื่นๆ ของ Plugin จะอยู่นอก ธุรกรรมการเปิดใช้งานการอนุมานนี้ ให้กำหนดค่าเฉพาะหลังจากการอนุมาน ทำงานและ OpenClaw เริ่มต้นแล้วเท่านั้น นโยบาย Plugin ที่มีอยู่และ การเลือกไม่ใช้การควบคุมอย่างชัดเจนจะไม่ถูกเปลี่ยนแปลงระหว่างการตั้งค่าการอนุมาน

บทสนทนา AI

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

โฮสต์จะไม่แยกวิเคราะห์คำขอภาษาธรรมชาติให้เป็นการดำเนินงาน ข้อความแบบอิสระ รวมถึงข้อความที่ดูเหมือนคำสั่งและคำถาม เช่น "เหตุใด gateway ของฉันจึงหยุดทำงาน?" จะถูกส่งไปยัง AI ซึ่งสามารถจับคู่คำขอกับการดำเนินงานแบบมีชนิด ผ่านเครื่องมือ openclaw

เมื่อมีการเปลี่ยนแปลงที่รอดำเนินการ ระบบจะแก้ไขโดยไม่อนุมานเฉพาะวลีอนุมัติหรือปฏิเสธที่ไม่กำกวมจาก รายการแบบปิดเท่านั้น ความยินยอมที่กำกวมจะถูกส่งไปยังการเรียก completion ที่กำหนดค่าไว้ แยกต่างหาก และหากไม่มีการเรียกดังกล่าวจะปฏิเสธโดยค่าเริ่มต้น ฟิลด์วิซาร์ดแบบมีโครงสร้าง และการนำทางโฮสต์ที่ตรงตามตัวอักษรเป็นตัวควบคุม UI ไม่ใช่การแยกวิเคราะห์การดำเนินการจากภาษาธรรมชาติ ข้อยกเว้นด้านสุขอนามัยของข้อมูลลับข้อหนึ่งมีความสำคัญเป็นพิเศษ: config set ที่ตรงตามตัวอักษร บนพาธที่ละเอียดอ่อน (โทเค็น คีย์ รหัสผ่าน) จะไม่ถูกส่งถึงโมเดล โฮสต์จะสร้างข้อเสนอที่ปกปิดข้อมูล และค่าจะถูกปิดบังในประวัติที่ AI มองเห็น สำหรับข้อมูลลับควรใช้ config set-ref <path> env &lt;ENV_VAR&gt;

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

โมเดลความเชื่อถือของชุดทดสอบ CLI

รันไทม์แบบฝังและชุดทดสอบ app-server ของ Codex บังคับใช้ข้อจำกัด ring-zero โดยตรง: การรันจะมีรายการเครื่องมือ OpenClaw ที่อนุญาต ซึ่งมีเฉพาะเครื่องมือ openclaw สำหรับ Codex นั้น OpenClaw ยังปิดใช้งานสภาพแวดล้อม การเรียกใช้แบบเนทีฟ หลายเอเจนต์ เป้าหมาย แอป/Plugin Skill/MCP การค้นหาเว็บ และพื้นผิว request_user_input สำหรับการรันนั้น Codex ยังคงแทรกยูทิลิตี update_plan แบบเนทีฟที่ไม่ก่อผลกระทบ ซึ่งสามารถอัปเดตรายการตรวจสอบชั่วคราวของโมเดลได้ แต่ไม่สามารถเขียนไฟล์ หรือการกำหนดค่า OpenClaw ได้ ชุดทดสอบ CLI ไม่ใช้รายการอนุญาตของ OpenClaw ดังนั้น OpenClaw จึงยอมรับเฉพาะแบ็กเอนด์ที่สัญญาการเลือกเครื่องมือของตนเองสามารถพิสูจน์ ข้อจำกัดเดียวกันได้:

  • แบ็กเอนด์ที่เลือกได้ รวมถึง Claude Code จะเริ่มทำงานโดยไม่มีการเลือกเครื่องมือเนทีฟ และมีเครื่องมือ MCP หนึ่งรายการคือ openclaw การกำหนดค่า MCP ที่ Claude สร้างขึ้น จะถูกใช้ร่วมกับ --strict-mcp-config จึงไม่มีการโหลดเซิร์ฟเวอร์ MCP อื่น
  • แบ็กเอนด์ที่ประกาศว่าไม่มีเครื่องมือเนทีฟจะได้รับเซิร์ฟเวอร์ MCP ของ OpenClaw เฉพาะแบบเดียวกัน
  • แบ็กเอนด์ที่มีเครื่องมือเนทีฟเปิดตลอดเวลาหรือไม่ทราบสถานะจะปฏิเสธโดยค่าเริ่มต้นก่อนการอนุมาน และไม่สามารถโฮสต์เซสชัน OpenClaw ได้

เฉพาะเซสชัน OpenClaw เท่านั้นที่ได้รับเซิร์ฟเวอร์ MCP ของ openclaw ส่วนการรันเอเจนต์ปกติ จะไม่เห็นเครื่องมือนี้ ดังนั้นแบ็กเอนด์ CLI แบบเลือกได้/ไม่มีเครื่องมือเนทีฟและโมเดลที่ใช้คีย์ API จึงบังคับใช้ลูปที่มีเครื่องมือเดียวอย่างเคร่งครัด โมเดล app-server ของ Codex บังคับใช้ เครื่องมือสิทธิ์ของ OpenClaw เพียงหนึ่งรายการร่วมกับยูทิลิตีการวางแผนแบบเนทีฟที่ไม่ก่อผลกระทบ ในทั้ง สามกรณี การเขียนค่าการตั้งค่ายังคงจำกัดอยู่ภายในสัญญาการอนุมัติที่ตรวจสอบได้ของ OpenClaw

Gemini CLI ยังคงใช้ได้สำหรับเอเจนต์ปกติ แต่ไม่สามารถบังคับใช้ โพรบที่ไม่มีเครื่องมือซึ่งเกตการอนุมานกำหนดให้ใช้ได้ จึงไม่สามารถโฮสต์ OpenClaw ได้

การสลับไปยังเอเจนต์

ใช้ตัวเลือกภาษาธรรมชาติเพื่อออกจาก OpenClaw และเปิด TUI ปกติ:

text
คุยกับเอเจนต์คุยกับเอเจนต์งานสลับไปยังเอเจนต์หลัก

openclaw tui, openclaw chat และ openclaw terminal จะเปิด TUI ของเอเจนต์ปกติโดยตรง โดยไม่เริ่ม OpenClaw หลังจากสลับเข้าสู่ TUI ปกติแล้ว /openclaw จะกลับไปยัง OpenClaw โดยอาจระบุคำขอต่อเนื่องเพิ่มเติมได้:

text
/openclaw/openclaw restart gateway

โหมดกู้คืนผ่านข้อความ

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

นี่คือตัวจัดการคำสั่งฉุกเฉินแบบกำหนดผลลัพธ์แน่นอน ไม่ใช่เอเจนต์ OpenClaw สำหรับการสนทนา ระบบจะไม่บูตสแตรปการตั้งค่าใหม่หรือผ่อนปรนเกตการอนุมาน สำหรับแชต OpenClaw

คำสั่งที่รองรับ: /openclaw <request> การกู้คืนยอมรับเฉพาะไวยากรณ์คำสั่งที่พิมพ์ตรงตามตัวอักษรเท่านั้น — ภาษาธรรมชาติจะถูกปฏิเสธพร้อมคำแนะนำ โดยจะไม่คาดเดาให้เป็นการดำเนินการ และจะไม่มีการเรียกใช้โมเดลโดยเด็ดขาด

text
คุณ ใน DM ของเจ้าของที่เชื่อถือได้: /openclaw statusOpenClaw: โหมดกู้คืนของ OpenClaw เข้าถึง Gateway ได้: ไม่ การกำหนดค่าถูกต้อง: ไม่คุณ: /openclaw restart gatewayOpenClaw: แผน: เริ่ม Gateway ใหม่ ตอบ /openclaw yes เพื่อดำเนินการคุณ: /openclaw yesOpenClaw: ดำเนินการแล้ว เขียนรายการบันทึกการตรวจสอบแล้ว

ยังสามารถจัดคิวการสร้างเอเจนต์ภายในเครื่องหรือผ่านการกู้คืนได้:

text
create agent work workspace ~/Projects/work model openai/gpt-5.6-sol/openclaw create agent work workspace ~/Projects/work

การสร้างเอเจนต์สามารถระบุได้เฉพาะโมเดลเริ่มต้นปัจจุบันที่ผ่านการตรวจสอบแบบสดแล้วเท่านั้น ไม่ต้องระบุ โมเดลหากต้องการสืบทอดเส้นทางนั้น

การกู้คืนจากระยะไกลเป็นพื้นผิวสำหรับผู้ดูแลระบบและต้องถือเป็นการซ่อมแซมการกำหนดค่าจากระยะไกล ไม่ใช่แชตปกติ

สัญญาความปลอดภัยสำหรับการกู้คืนจากระยะไกล:

  • ปิดใช้งานเมื่อแซนด์บ็อกซ์ทำงานสำหรับเอเจนต์/เซสชัน โดย OpenClaw จะปฏิเสธการกู้คืนจากระยะไกลและชี้ไปยังการซ่อมแซมผ่าน CLI ภายในเครื่อง
  • สถานะที่มีผลโดยค่าเริ่มต้นคือ auto: อนุญาตการกู้คืนจากระยะไกลเฉพาะในการทำงานแบบ YOLO ที่เชื่อถือได้ ซึ่งรันไทม์มีสิทธิ์ภายในเครื่องแบบไม่ใช้แซนด์บ็อกซ์อยู่แล้ว (tools.exec.security แปลงเป็น full และ tools.exec.ask แปลงเป็น off โดยมีโหมดแซนด์บ็อกซ์เป็น off)
  • ต้องมีข้อมูลประจำตัวเจ้าของที่ระบุชัดเจน ไม่อนุญาตกฎผู้ส่งแบบไวลด์การ์ด นโยบายกลุ่มแบบเปิด Webhook ที่ไม่ผ่านการยืนยันตัวตน หรือช่องทางนิรนาม
  • โดยค่าเริ่มต้นอนุญาตเฉพาะ DM ของเจ้าของ การกู้คืนในกลุ่ม/ช่องทางต้องเลือกเข้าร่วมอย่างชัดเจน
  • การค้นหาและแสดงรายการ Plugin เป็นแบบอ่านอย่างเดียว การติดตั้ง Plugin ทำได้เฉพาะภายในเครื่องเสมอ (ถูกบล็อกในการกู้คืน แม้จะเปิดใช้งานในกรณีอื่น) เนื่องจากเป็นการดาวน์โหลดโค้ดที่เรียกใช้ได้ การถอนการติดตั้ง Plugin จะถูกปฏิเสธทั้งใน OpenClaw ภายในเครื่องและในการกู้คืน ให้เรียกใช้ openclaw plugins uninstall <id> จากเทอร์มินัล
  • การกู้คืนจากระยะไกลไม่สามารถเปิด TUI ภายในเครื่องหรือสลับเข้าสู่เซสชันเอเจนต์แบบโต้ตอบได้ ให้ใช้ openclaw ภายในเครื่องเพื่อส่งต่องานให้เอเจนต์
  • การเขียนข้อมูลถาวรยังคงต้องได้รับการอนุมัติ แม้อยู่ในโหมดกู้คืน
  • การอนุมัติที่รอดำเนินการใช้ได้ครั้งเดียว คำสั่งกู้คืนที่ใหม่กว่าสำหรับบัญชี ช่องทาง และผู้ส่งเดียวกันจะเพิกถอนแผนเดิม การดำเนินการที่ล้มเหลวก็จะใช้สิทธิ์อนุมัตินั้นเช่นกัน ดังนั้นให้ส่งคำสั่งอีกครั้งเพื่อลองใหม่
  • การดำเนินการกู้คืนทุกครั้งที่นำไปใช้จะถูกตรวจสอบ การกู้คืนผ่านช่องทางข้อความจะบันทึกข้อมูลเมตาของช่องทาง บัญชี ผู้ส่ง และที่อยู่ต้นทาง ส่วนการดำเนินการที่เปลี่ยนแปลงการกำหนดค่าจะบันทึกแฮชการกำหนดค่าทั้งก่อนและหลังด้วย
  • จะไม่มีการแสดงข้อมูลลับกลับมา การตรวจสอบ SecretRef จะรายงานสถานะความพร้อมใช้งาน ไม่ใช่ค่า
  • หาก Gateway ยังทำงานอยู่ การกู้คืนจะเลือกใช้การดำเนินการแบบมีชนิดของ Gateway หาก Gateway หยุดทำงาน การกู้คืนจะใช้เฉพาะพื้นผิวซ่อมแซมภายในเครื่องขั้นต่ำที่ไม่ขึ้นกับลูปเอเจนต์ปกติ

รูปแบบการกำหนดค่า:

jsonc
{  "systemAgent": {    "rescue": {      "enabled": "auto",      "ownerDmOnly": true,      "pendingTtlMinutes": 15,    },  },}
  • enabled: "auto" (ค่าเริ่มต้น) อนุญาตการกู้คืนเฉพาะเมื่อรันไทม์ที่มีผลเป็น YOLO และปิดแซนด์บ็อกซ์อยู่ ส่วน false จะไม่อนุญาตการกู้คืนผ่านช่องทางข้อความ และ true จะอนุญาตการกู้คืนอย่างชัดเจนเมื่อผ่านการตรวจสอบเจ้าของ/ช่องทาง (แต่ยังอยู่ภายใต้การปฏิเสธเมื่อใช้แซนด์บ็อกซ์)
  • ownerDmOnly: จำกัดการกู้คืนไว้เฉพาะข้อความโดยตรงของเจ้าของ ค่าเริ่มต้นคือ true
  • pendingTtlMinutes: ระยะเวลาที่การเขียนข้อมูลกู้คืนซึ่งรอดำเนินการจะยังเปิดไว้สำหรับการอนุมัติ /openclaw yes ก่อนหมดอายุ ค่าเริ่มต้นคือ 15

openclaw doctor --fix จะย้ายบล็อกการกำหนดค่าเดิม crestodian ไปยัง systemAgent รันไทม์จะอ่านเฉพาะบล็อกมาตรฐานเท่านั้น

การกู้คืนจากระยะไกลครอบคลุมโดยเลน Docker:

bash
pnpm test:docker:system-agent-rescue

การทดสอบควันของพื้นผิวคำสั่งช่องทางแบบเลือกเข้าร่วมจะตรวจสอบ /openclaw status พร้อมการดำเนินการไปกลับของการอนุมัติแบบถาวรผ่านตัวจัดการการกู้คืน:

bash
pnpm test:live:system-agent-rescue-channel

การตั้งค่าแบบครั้งเดียวผ่านแพ็กเกจซึ่งมีเกตการอนุมานครอบคลุมโดย:

bash
pnpm test:docker:system-agent-first-run

เลน packaged-CLI นี้เริ่มต้นด้วยไดเรกทอรีสถานะว่างและพิสูจน์ว่า OpenClaw ปฏิเสธโดยค่าเริ่มต้นเมื่อไม่มีการอนุมาน จากนั้นจึงทดสอบและเปิดใช้งาน Claude จำลองผ่าน โมดูลเปิดใช้งานที่จัดแพ็กเกจไว้ หลังจากนั้นเท่านั้นคำขอแบบคลุมเครือจึงจะถูกส่งถึง ตัววางแผนและแปลงเป็นการตั้งค่าแบบมีชนิด ตามด้วยคำสั่งแบบครั้งเดียวที่สร้าง เอเจนต์เพิ่มเติม กำหนดค่า Discord ผ่านการเปิดใช้ Plugin พร้อม SecretRef ของโทเค็น ตรวจสอบความถูกต้องของการกำหนดค่า และตรวจสอบบันทึกการตรวจสอบ เลนนี้เป็นหลักฐานสนับสนุน เกต/การดำเนินการ โดยไม่ได้ทดสอบการเริ่มต้นใช้งานแบบโต้ตอบหรือบทสนทนา ระหว่างเอเจนต์/เครื่องมือ/การอนุมัติของ OpenClaw สถานการณ์ QA Lab ด้านล่างจะเปลี่ยนเส้นทาง ไปยังเลน Docker เดียวกัน:

bash
pnpm openclaw qa suite --scenario system-agent-ring-zero-setup

เนื้อหาที่เกี่ยวข้อง

Was this useful?
On this page

On this page