Overview
ภาพรวม
ใช้หน้านี้เพื่อเลือกพื้นผิวความสามารถที่เหมาะสม เครื่องมือ คือการดำเนินการที่เรียกใช้ได้ Skills สอนเอเจนต์ให้ทำงาน และ Plugin เพิ่มความสามารถขณะรัน เช่น เครื่องมือ ผู้ให้บริการ ช่องทาง ฮุก และ Skills ที่จัดแพ็กเกจไว้
หน้านี้เป็นภาพรวมและหน้าสำหรับนำทาง หากต้องการรายละเอียดทั้งหมดเกี่ยวกับนโยบายเครื่องมือ ค่าเริ่มต้น การเป็นสมาชิกกลุ่ม ข้อจำกัดของผู้ให้บริการ และฟิลด์การกำหนดค่า โปรดดู เครื่องมือและผู้ให้บริการแบบกำหนดเอง
เริ่มต้นที่นี่
สำหรับเอเจนต์ส่วนใหญ่ ให้เริ่มจากหมวดหมู่เครื่องมือในตัว แล้วจึงปรับนโยบายเฉพาะเมื่อเอเจนต์ควรเห็นเครื่องมือน้อยลงหรือต้องเข้าถึงโฮสต์อย่างชัดเจน
| หากต้องการ... | ให้ใช้สิ่งนี้ก่อน | จากนั้นอ่าน |
|---|---|---|
| ให้เอเจนต์ดำเนินการด้วยความสามารถที่มีอยู่ | เครื่องมือในตัว | หมวดหมู่เครื่องมือ |
| ควบคุมสิ่งที่เอเจนต์เรียกใช้ได้ | นโยบายเครื่องมือ | เครื่องมือและผู้ให้บริการแบบกำหนดเอง |
| สอนเวิร์กโฟลว์ให้เอเจนต์ | Skills | Skills, การสร้าง Skills, เวิร์กช็อป Skills และ การเรียนรู้ด้วยตนเอง |
| เพิ่มการผสานรวมหรือพื้นผิวขณะรันใหม่ | Plugin | Plugin และ สร้าง Plugin |
| เรียกใช้งานภายหลังหรือในเบื้องหลัง | ระบบอัตโนมัติ | ภาพรวมระบบอัตโนมัติ |
| ประสานงานเอเจนต์หรือฮาร์เนสหลายรายการ | เอเจนต์ย่อย | เอเจนต์ ACP และ การส่งของเอเจนต์ |
| ควบคุมเอเจนต์ที่ทำงานพร้อมกันจากโค้ด | Swarm | โหมดโค้ด และ เอเจนต์ย่อย |
| ค้นหาแคตตาล็อกเครื่องมือขนาดใหญ่ของ OpenClaw | การค้นหาเครื่องมือ | การค้นหาเครื่องมือ |
| รวมเครื่องมือหลายรายการไว้ในโปรแกรมขนาดกะทัดรัดโปรแกรมเดียว | โหมดโค้ด | โหมดโค้ด |
เลือกเครื่องมือ Skills หรือ Plugin
ใช้เครื่องมือเมื่อเอเจนต์ต้องดำเนินการ
เครื่องมือคือฟังก์ชันแบบมีชนิดที่เอเจนต์เรียกใช้ได้ เช่น exec, browser,
web_search, message หรือ image_generate ใช้เครื่องมือเมื่อเอเจนต์
ต้องอ่านข้อมูล แก้ไขไฟล์ ส่งข้อความ เรียกผู้ให้บริการ หรือ
ควบคุมระบบอื่น เครื่องมือที่มองเห็นได้จะถูกส่งไปยังโมเดลเป็น
ข้อกำหนดฟังก์ชันแบบมีโครงสร้าง
โมเดลจะเห็นเฉพาะเครื่องมือที่ผ่านโปรไฟล์ที่ใช้งานอยู่ นโยบาย อนุญาต/ปฏิเสธ ข้อจำกัดของผู้ให้บริการ สถานะแซนด์บ็อกซ์ สิทธิ์ของช่องทาง และ ความพร้อมใช้งานของ Plugin
ใช้ Skill เมื่อเอเจนต์ต้องการคำแนะนำ
Skill คือชุดคำแนะนำ SKILL.md ที่โหลดเข้าสู่พรอมต์ของเอเจนต์ ใช้
Skill เมื่อเอเจนต์มีเครื่องมือที่ต้องการอยู่แล้ว แต่ต้องการ
เวิร์กโฟลว์ที่ทำซ้ำได้ เกณฑ์การรีวิว ลำดับคำสั่ง หรือข้อจำกัด
ในการปฏิบัติงาน
Skills สามารถอยู่ในพื้นที่ทำงาน ไดเรกทอรี Skills ที่ใช้ร่วมกัน ราก Skills ของ OpenClaw ที่มีการจัดการ หรือแพ็กเกจ Plugin
Skills | เวิร์กช็อป Skills | การเรียนรู้ด้วยตนเอง | การสร้าง Skills | การกำหนดค่า Skills
ใช้ Plugin เมื่อ OpenClaw ต้องการความสามารถใหม่
Plugin สามารถเพิ่มเครื่องมือ Skills ช่องทาง ผู้ให้บริการโมเดล เสียงพูด เสียงแบบเรียลไทม์ การสร้างสื่อ การค้นหาเว็บ การดึงข้อมูลเว็บ ฮุก และ ความสามารถขณะรันอื่นๆ ใช้ Plugin เมื่อความสามารถนั้นมีโค้ด ข้อมูลรับรอง ฮุกวงจรชีวิต เมทาดาทาของแมนิเฟสต์ หรือแพ็กเกจ ที่ติดตั้งได้ Plugin ที่มีอยู่สามารถติดตั้งจาก ClawHub, npm, git, ไดเรกทอรีในเครื่อง หรือไฟล์เก็บถาวร
หมวดหมู่เครื่องมือในตัว
ตารางนี้แสดงเครื่องมือตัวแทนเพื่อให้รู้จักพื้นผิวดังกล่าว แต่ไม่ใช่ เอกสารอ้างอิงนโยบายฉบับเต็ม สำหรับกลุ่ม ค่าเริ่มต้น และความหมายของการ อนุญาต/ปฏิเสธที่แน่นอน โปรดดู เครื่องมือและผู้ให้บริการแบบกำหนดเอง
| หมวดหมู่ | ใช้เมื่อเอเจนต์ต้องการ... | เครื่องมือตัวแทน | อ่านต่อ |
|---|---|---|---|
| รันไทม์ | เรียกใช้คำสั่ง จัดการกระบวนการ หรือใช้การวิเคราะห์ Python ที่รองรับโดยผู้ให้บริการ | exec, process, terminal, code_execution |
การดำเนินการ, เทอร์มินัล Control UI, การเรียกใช้โค้ด |
| ไฟล์ | อ่านและแก้ไขไฟล์ในพื้นที่ทำงาน | read, write, edit, apply_patch |
ใช้แพตช์ |
| ข้อมูลจากมนุษย์ | หยุดชั่วคราวเพื่อรอการตัดสินใจแบบมีโครงสร้างซึ่งเป็นหน้าที่ของผู้ใช้ | ask_user |
ถามผู้ใช้ |
| เว็บ | ค้นหาเว็บ ค้นหาโพสต์บน X หรือดึงเนื้อหาหน้าที่อ่านได้ | web_search, x_search, web_fetch |
เครื่องมือเว็บ, การดึงข้อมูลเว็บ |
| เบราว์เซอร์ | ควบคุมเซสชันเบราว์เซอร์ | browser |
เบราว์เซอร์ |
| UI ของผู้ปฏิบัติงาน | จัดเรียงบานหน้าต่าง แผง และการนำทางของ Control UI ที่เชื่อมต่ออยู่ | screen |
หน้าจอ |
| การส่งข้อความและช่องทาง | ส่งการตอบกลับหรือการดำเนินการของช่องทาง | message |
การส่งของเอเจนต์ |
| เซสชันและเอเจนต์ | ตรวจสอบเซสชัน มอบหมายงาน ควบคุมตัวรวบรวม ประสานการทำงานอีกรอบ หรือรายงานสถานะ | sessions_*, agents_wait, subagents, agents_list, session_status, get_goal, create_goal, update_goal |
เป้าหมาย, Swarm, เอเจนต์ย่อย, เครื่องมือเซสชัน |
| ระบบอัตโนมัติ | กำหนดเวลางานหรือตอบสนองต่อเหตุการณ์เบื้องหลัง | cron, heartbeat_respond |
ระบบอัตโนมัติ |
| Gateway และ Node | ตรวจสอบสถานะ Gateway หรืออุปกรณ์เป้าหมายที่จับคู่ไว้ | gateway, nodes |
การกำหนดค่า Gateway, Node |
| สื่อ | วิเคราะห์ สร้าง หรือเปล่งเสียงสื่อ | image, image_generate, music_generate, video_generate, tts |
ภาพรวมสื่อ |
| แคตตาล็อก OpenClaw ขนาดใหญ่ | ค้นหา เรียกใช้ และรวมเครื่องมือที่มีสิทธิ์จำนวนมากโดยไม่ส่งทุกสคีมาไปยังโมเดล | exec, wait, tool_search_code, tool_search, tool_describe |
โหมดโค้ด, การค้นหาเครื่องมือ |
เครื่องมือที่ Plugin จัดเตรียมให้
Plugin สามารถลงทะเบียนเครื่องมือเพิ่มเติมได้ ผู้เขียน Plugin เชื่อมต่อเครื่องมือผ่าน
api.registerTool(...) และ contracts.tools ของแมนิเฟสต์ โปรดดู
Plugin SDK และ แมนิเฟสต์ Plugin
สำหรับรายละเอียดสัญญา
เครื่องมือทั่วไปที่ Plugin จัดเตรียมให้ ได้แก่:
- Diffs สำหรับแสดงผล diff ของไฟล์และ Markdown
- แสดงวิดเจ็ต สำหรับ SVG และ HTML แบบอินไลน์ที่ทำงานได้ในตัวเองบนไคลเอนต์แชตที่รองรับ
- หน้าจอ สำหรับจัดวาง Control UI ที่เชื่อมต่ออยู่
- งาน LLM สำหรับขั้นตอนเวิร์กโฟลว์ที่ใช้เฉพาะ JSON
- Lobster สำหรับเวิร์กโฟลว์แบบมีชนิดพร้อมการอนุมัติที่ดำเนินการต่อได้
- Tokenjuice สำหรับย่อเอาต์พุตเครื่องมือ
execและbashที่มีข้อมูลรบกวนให้กระชับ - ค้นหาเครื่องมือ สำหรับค้นหาและเรียกใช้แค็ตตาล็อกเครื่องมือขนาดใหญ่ โดยไม่ต้องใส่ทุกสคีมาไว้ในพรอมต์
- Canvas สำหรับควบคุม Canvas ของ Node และ แสดงผล A2UI
กำหนดค่าการเข้าถึงและการอนุมัติ
นโยบายเครื่องมือจะถูกบังคับใช้ก่อนเรียกโมเดล หากนโยบายนำเครื่องมือออก โมเดลจะไม่ได้รับสคีมาของเครื่องมือนั้นสำหรับรอบนี้ การเรียกใช้งานอาจสูญเสียเครื่องมือ เนื่องจากการกำหนดค่าส่วนกลาง การกำหนดค่ารายเอเจนต์ นโยบายช่องทาง ข้อจำกัดของผู้ให้บริการ กฎแซนด์บ็อกซ์ นโยบายช่องทาง/รันไทม์ หรือความพร้อมใช้งานของ Plugin
- เครื่องมือและผู้ให้บริการแบบกำหนดเอง อธิบายโปรไฟล์เครื่องมือ รายการอนุญาต/ปฏิเสธ ข้อจำกัดเฉพาะผู้ให้บริการ การตรวจจับลูป และ การตั้งค่าเครื่องมือที่มีผู้ให้บริการรองรับ
- การอนุมัติ Exec อธิบายนโยบายการอนุมัติ คำสั่งโฮสต์
- Exec แบบยกระดับสิทธิ์ อธิบายการดำเนินการที่มีการควบคุมนอก แซนด์บ็อกซ์
- แซนด์บ็อกซ์เทียบกับนโยบายเครื่องมือเทียบกับการยกระดับสิทธิ์ อธิบายว่าแต่ละชั้นควบคุมการเข้าถึงไฟล์และกระบวนการอย่างไร
- ข้อจำกัดแซนด์บ็อกซ์และเครื่องมือรายเอเจนต์ อธิบายข้อจำกัดเฉพาะเอเจนต์สำหรับการเรียกใช้ที่มอบหมาย
ขยายความสามารถ
เลือกแนวทางการขยายตามงานที่ต้องการให้ OpenClaw ทำ:
- ติดตั้งหรือจัดการ Plugin ที่มีอยู่ด้วย Plugin
- สร้างการผสานรวม ผู้ให้บริการ ช่องทาง เครื่องมือ หรือฮุกใหม่ด้วย สร้าง Plugin
- เพิ่มหรือปรับแต่งคำสั่งเอเจนต์ที่นำกลับมาใช้ใหม่ได้ด้วย Skills และ การสร้าง Skills
- ใช้ Plugin SDK และ ไฟล์ Manifest ของ Plugin เมื่อต้องการสัญญา การนำไปใช้งาน
แก้ไขปัญหาเครื่องมือที่หายไป
หากโมเดลมองไม่เห็นหรือเรียกใช้เครื่องมือไม่ได้ ให้เริ่มจากนโยบายที่มีผลสำหรับ รอบปัจจุบัน:
- ตรวจสอบโปรไฟล์ที่ใช้งานอยู่
tools.allowและtools.denyใน เครื่องมือและผู้ให้บริการแบบกำหนดเอง - ตรวจสอบข้อจำกัดเฉพาะผู้ให้บริการใน เครื่องมือและผู้ให้บริการแบบกำหนดเอง และยืนยันว่า ผู้ให้บริการโมเดล ที่เลือก รองรับรูปแบบ ของเครื่องมือ
- ตรวจสอบสิทธิ์ของช่องทาง สถานะแซนด์บ็อกซ์ และการเข้าถึงแบบยกระดับสิทธิ์ด้วย แซนด์บ็อกซ์เทียบกับนโยบายเครื่องมือเทียบกับการยกระดับสิทธิ์ และ Exec แบบยกระดับสิทธิ์
- ตรวจสอบว่า Plugin ที่เป็นเจ้าของได้รับการติดตั้งและเปิดใช้งานแล้วใน Plugin
- สำหรับการเรียกใช้ที่มอบหมาย ให้ตรวจสอบข้อจำกัดรายเอเจนต์ใน ข้อจำกัดแซนด์บ็อกซ์และเครื่องมือรายเอเจนต์
- สำหรับแค็ตตาล็อก OpenClaw ขนาดใหญ่ ให้ยืนยันว่าการเรียกใช้เปิดเผยเครื่องมือโดยตรง ใช้ โหมดโค้ด หรือใช้ ค้นหาเครื่องมือ
ที่เกี่ยวข้อง
- ระบบอัตโนมัติ สำหรับ Cron งาน Heartbeat ข้อผูกพัน ฮุก คำสั่งถาวร และ Task Flow
- เอเจนต์ สำหรับโมเดลเอเจนต์ เซสชัน หน่วยความจำ และ การประสานงานแบบหลายเอเจนต์
- เครื่องมือและผู้ให้บริการแบบกำหนดเอง สำหรับข้อมูลอ้างอิงหลักของ นโยบายเครื่องมือ
- Plugin สำหรับการติดตั้งและจัดการ Plugin
- Plugin SDK สำหรับข้อมูลอ้างอิงของผู้สร้าง Plugin
- Skills สำหรับลำดับการโหลดสกิล การควบคุมการเข้าถึง และการกำหนดค่า
- เวิร์กช็อปสกิล สำหรับการสร้างสกิล ที่ผ่านการสร้างและตรวจทาน
- ค้นหาเครื่องมือ สำหรับการค้นหาแค็ตตาล็อกเครื่องมือ OpenClaw แบบกระชับ
- โหมดโค้ด สำหรับเวิร์กโฟลว์ JavaScript หรือ TypeScript แบบกระชับ บนแค็ตตาล็อกเครื่องมือ OpenClaw ที่ซ่อนอยู่
- Swarm สำหรับการกระจายงานและรวบรวมผลลัพธ์อย่างมีโครงสร้างจากโหมดโค้ด