Overview
ภาพรวม
ใช้หน้านี้เพื่อเลือกพื้นผิวความสามารถที่เหมาะสม เครื่องมือ คือการดำเนินการที่เรียกใช้ได้ Skills สอนเอเจนต์ถึงวิธีทำงาน และ Plugin เพิ่มความสามารถขณะรัน เช่น เครื่องมือ ผู้ให้บริการ ช่องทาง ฮุก และ Skills ที่จัดแพ็กเกจไว้
หน้านี้เป็นภาพรวมและหน้าแนะนำเส้นทาง สำหรับนโยบายเครื่องมือ ค่าเริ่มต้น การเป็นสมาชิกกลุ่ม ข้อจำกัดของผู้ให้บริการ และฟิลด์การกำหนดค่าอย่างครบถ้วน โปรดดู เครื่องมือและผู้ให้บริการแบบกำหนดเอง
เริ่มต้นที่นี่
สำหรับเอเจนต์ส่วนใหญ่ ให้เริ่มจากหมวดหมู่เครื่องมือในตัว แล้วจึงปรับนโยบายเฉพาะเมื่อเอเจนต์ควรเห็นเครื่องมือน้อยลง หรือต้องการสิทธิ์เข้าถึงโฮสต์อย่างชัดเจน
| หากคุณต้องการ... | ให้ใช้สิ่งนี้ก่อน | จากนั้นอ่าน |
|---|---|---|
| ให้เอเจนต์ดำเนินการด้วยความสามารถที่มีอยู่ | เครื่องมือในตัว | หมวดหมู่เครื่องมือ |
| ควบคุมสิ่งที่เอเจนต์สามารถเรียกใช้ได้ | นโยบายเครื่องมือ | เครื่องมือและผู้ให้บริการแบบกำหนดเอง |
| สอนเวิร์กโฟลว์ให้เอเจนต์ | Skills | Skills, การสร้าง Skills และ เวิร์กชอป Skills |
| เพิ่มการผสานรวมหรือพื้นผิวขณะรันใหม่ | Plugin | Plugin และ สร้าง Plugin |
| เรียกใช้งานภายหลังหรือในเบื้องหลัง | ระบบอัตโนมัติ | ภาพรวมระบบอัตโนมัติ |
| ประสานงานเอเจนต์หรือฮาร์เนสหลายรายการ | เอเจนต์ย่อย | เอเจนต์ ACP และ การส่งของเอเจนต์ |
| ค้นหาแค็ตตาล็อกเครื่องมือ 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, code_execution |
Exec, การเรียกใช้โค้ด |
| ไฟล์ | อ่านและเปลี่ยนไฟล์ในเวิร์กสเปซ | read, write, edit, apply_patch |
ใช้แพตช์ |
| เว็บ | ค้นหาเว็บ ค้นหาโพสต์บน X หรือดึงเนื้อหาหน้าที่อ่านได้ | web_search, x_search, web_fetch |
เครื่องมือเว็บ, การดึงข้อมูลเว็บ |
| เบราว์เซอร์ | ควบคุมเซสชันเบราว์เซอร์ | browser |
เบราว์เซอร์ |
| การส่งข้อความและช่องทาง | ส่งการตอบกลับหรือการดำเนินการในช่องทาง | message |
การส่งของเอเจนต์ |
| เซสชันและเอเจนต์ | ตรวจสอบเซสชัน มอบหมายงาน ควบคุมการรันอื่น หรือรายงานสถานะ | sessions_*, subagents, agents_list, session_status, get_goal, create_goal, update_goal |
เป้าหมาย, เอเจนต์ย่อย, เครื่องมือเซสชัน |
| ระบบอัตโนมัติ | กำหนดเวลางานหรือตอบสนองต่อเหตุการณ์เบื้องหลัง | cron, heartbeat_respond |
ระบบอัตโนมัติ |
| Gateway และ Node | ตรวจสอบสถานะ Gateway หรืออุปกรณ์เป้าหมายที่จับคู่ไว้ | gateway, nodes |
การกำหนดค่า Gateway, Node |
| สื่อ | วิเคราะห์ สร้าง หรือเปล่งเสียงสื่อ | image, image_generate, music_generate, video_generate, tts |
ภาพรวมสื่อ |
| แค็ตตาล็อก OpenClaw ขนาดใหญ่ | ค้นหาและเรียกใช้เครื่องมือที่เข้าเกณฑ์จำนวนมากโดยไม่ส่งทุกสคีมาไปยังโมเดล | tool_search_code, tool_search, tool_describe |
การค้นหาเครื่องมือ |
เครื่องมือที่ Plugin จัดหาให้
Plugin สามารถลงทะเบียนเครื่องมือเพิ่มเติมได้ ผู้เขียน Plugin เชื่อมต่อเครื่องมือผ่าน
api.registerTool(...) และ contracts.tools ในไฟล์กำกับ โปรดดู
SDK ของ Plugin และ ไฟล์กำกับ Plugin
สำหรับรายละเอียดสัญญา
เครื่องมือที่ Plugin จัดหาให้โดยทั่วไป ได้แก่:
- ความแตกต่าง สำหรับแสดงผลความแตกต่างของไฟล์และมาร์กดาวน์
- แสดงวิดเจ็ต สำหรับ SVG และ HTML แบบอินไลน์ที่ทำงานได้ในตัวเองในเว็บแชต
- งาน LLM สำหรับขั้นตอนเวิร์กโฟลว์ที่ใช้ JSON เท่านั้น
- Lobster สำหรับเวิร์กโฟลว์แบบมีชนิดพร้อมการอนุมัติที่กลับมาทำต่อได้
- Tokenjuice สำหรับย่อเอาต์พุตที่มีข้อมูลรบกวนจากเครื่องมือ
execและbash - การค้นหาเครื่องมือ สำหรับค้นหาและเรียกใช้แค็ตตาล็อกเครื่องมือ ขนาดใหญ่โดยไม่ใส่ทุกสคีมาไว้ในพรอมต์
- Canvas สำหรับควบคุม Canvas ของ Node และ การเรนเดอร์ A2UI
กำหนดค่าสิทธิ์เข้าถึงและการอนุมัติ
นโยบายเครื่องมือจะถูกบังคับใช้ก่อนการเรียกโมเดล หากนโยบายนำเครื่องมือออก โมเดลจะไม่ได้รับสคีมาของเครื่องมือนั้นสำหรับรอบดังกล่าว การรันอาจสูญเสียเครื่องมือ เนื่องจากการกำหนดค่าส่วนกลาง การกำหนดค่ารายเอเจนต์ นโยบายช่องทาง ข้อจำกัดของผู้ให้บริการ กฎแซนด์บ็อกซ์ นโยบายช่องทาง/รันไทม์ หรือความพร้อมใช้งานของ Plugin
- เครื่องมือและผู้ให้บริการแบบกำหนดเอง อธิบายโปรไฟล์เครื่องมือ รายการอนุญาต/ปฏิเสธ ข้อจำกัดเฉพาะผู้ให้บริการ การตรวจจับลูป และ การตั้งค่าเครื่องมือที่สนับสนุนโดยผู้ให้บริการ
- การอนุมัติ Exec อธิบายนโยบายการอนุมัติ คำสั่งโฮสต์
- Exec แบบยกระดับ อธิบายการเรียกใช้งานที่มีการควบคุมนอก แซนด์บ็อกซ์
- แซนด์บ็อกซ์ เทียบกับนโยบายเครื่องมือ เทียบกับแบบยกระดับ อธิบายว่าเลเยอร์ใดควบคุมการเข้าถึงไฟล์และกระบวนการ
- ข้อจำกัดแซนด์บ็อกซ์และเครื่องมือรายเอเจนต์ อธิบายข้อจำกัดเฉพาะเอเจนต์สำหรับการรันที่มอบหมาย
ขยายความสามารถ
เลือกเส้นทางการขยายตามงานที่คุณต้องการให้ OpenClaw ทำ:
- ติดตั้งหรือจัดการ Plugin ที่มีอยู่ด้วย Plugin
- สร้างการผสานรวม ผู้ให้บริการ ช่องทาง เครื่องมือ หรือฮุกใหม่ด้วย สร้าง Plugin
- เพิ่มหรือปรับแต่งคำสั่งเอเจนต์ที่นำกลับมาใช้ซ้ำได้ด้วย Skills และ การสร้าง Skills
- ใช้ SDK ของ Plugin และ ไฟล์กำกับ Plugin เมื่อคุณต้องการสัญญา การนำไปใช้
แก้ไขปัญหาเครื่องมือที่หายไป
หากโมเดลมองไม่เห็นหรือเรียกใช้เครื่องมือไม่ได้ ให้เริ่มจากนโยบายที่มีผลสำหรับ รอบปัจจุบัน:
- ตรวจสอบโปรไฟล์ที่ใช้งานอยู่
tools.allowและtools.denyใน เครื่องมือและผู้ให้บริการแบบกำหนดเอง - ตรวจสอบข้อจำกัดเฉพาะผู้ให้บริการใน เครื่องมือและผู้ให้บริการแบบกำหนดเอง และยืนยันว่า ผู้ให้บริการโมเดล ที่เลือก รองรับรูปแบบของเครื่องมือ
- ตรวจสอบสิทธิ์ของช่องทาง สถานะแซนด์บ็อกซ์ และสิทธิ์เข้าถึงแบบยกระดับด้วย แซนด์บ็อกซ์ เทียบกับนโยบายเครื่องมือ เทียบกับแบบยกระดับ และ Exec แบบยกระดับ
- ตรวจสอบว่า Plugin เจ้าของได้รับการติดตั้งและเปิดใช้งานใน Plugin แล้วหรือไม่
- สำหรับการรันที่มอบหมาย ให้ตรวจสอบข้อจำกัดรายเอเจนต์ใน ข้อจำกัดแซนด์บ็อกซ์และเครื่องมือรายเอเจนต์
- สำหรับแค็ตตาล็อก OpenClaw ขนาดใหญ่ ให้ยืนยันว่าการรันใช้การเปิดเผยเครื่องมือ โดยตรงหรือ การค้นหาเครื่องมือ
ที่เกี่ยวข้อง
- ระบบอัตโนมัติ สำหรับ Cron, งาน, Heartbeat, ข้อผูกพัน, ฮุก, คำสั่งถาวร และ TaskFlow
- เอเจนต์ สำหรับโมเดลเอเจนต์, เซสชัน, หน่วยความจำ และ การประสานงานระหว่างหลายเอเจนต์
- เครื่องมือและผู้ให้บริการแบบกำหนดเอง สำหรับเอกสารอ้างอิงมาตรฐานเกี่ยวกับ นโยบายเครื่องมือ
- Plugin สำหรับการติดตั้งและจัดการ Plugin
- SDK สำหรับ Plugin สำหรับเอกสารอ้างอิงของผู้สร้าง Plugin
- Skills สำหรับลำดับการโหลด Skills, การควบคุมสิทธิ์ และการกำหนดค่า
- เวิร์กช็อป Skills สำหรับการสร้าง Skills ที่ระบบสร้างและผ่านการตรวจสอบ
- การค้นหาเครื่องมือ สำหรับการค้นหาแค็ตตาล็อกเครื่องมือ OpenClaw แบบกระชับ
