OpenClaw คือการวนซ้ำ (loop): มันอ่านพื้นที่ทำงานของคุณ เรียกใช้คำสั่งเชลล์ผ่านเครื่องมือ exec อ่านผลลัพธ์ และตัดสินใจว่าจะทำอะไรต่อไป แล้วทำไมการทดสอบ API ของคุณจึงไม่อยู่ในลูปนั้น? มันถูกเก็บไว้ใน Apidog หลัง GUI และจะรันเมื่อมีคนจำได้ว่าต้องคลิก เอเจนต์ของคุณไม่เคยแตะต้องพวกมันเลย
วิธีแก้ไขคือบล็อกการตั้งค่าเพียงบล็อกเดียว Apidog CLI เป็นแพ็คเกจ npm, apidog-cli, ที่รันสถานการณ์การทดสอบที่คุณสร้างใน Apidog โดยตรงจากเทอร์มินัล เมื่อติดตั้ง CLI แล้วและ OpenClaw รู้ว่ามีอยู่จริง เอเจนต์ของคุณจะรันสถานการณ์ของ Apidog ในลักษณะเดียวกับการรันการทดสอบหน่วย (unit tests) ของคุณ: ยิงคำสั่ง อ่านรหัสออก (exit code) แก้ไขโค้ดหากเป็นสีแดง
คู่มือนี้ครอบคลุมส่วนที่เฉพาะเจาะจงของ OpenClaw ที่คู่มือการติดตั้งทั่วไปข้ามไป: จะวางกฎของ Apidog ไว้ที่ใดเพื่อให้เอเจนต์เก็บไว้, เครื่องมือ exec ของ OpenClaw รัน apidog run อย่างไร และวิธีอ่านผลลัพธ์
หากคุณยังไม่ได้ติดตั้ง CLI ให้ทำสิ่งนั้นก่อน วิธีติดตั้ง Apidog CLI ด้วย AI coding agent จะอธิบายการติดตั้ง npm, การยืนยันตัวตน และการรันครั้งแรก บทความนี้สมมติว่า apidog --version พิมพ์ตัวเลขและบัญชี Apidog ของคุณลงชื่อเข้าใช้แล้ว
OpenClaw ที่กล่าวถึงนี้คืออะไร
OpenClaw คือ AI agent แบบโอเพนซอร์สที่ทำงานในเครื่องของคุณ มีพื้นที่ทำงาน ชุดทักษะ และเครื่องมือ exec ที่รันคำสั่งเชลล์จริง มันไม่ใช่ปลั๊กอินสำหรับเติมโค้ดอัตโนมัติและไม่ใช่แชทบอทแบบโฮสต์ หากคุณเคยรัน openclaw บนเครื่องและเฝ้าดูมันแก้ไขไฟล์และรันคำสั่ง คุณมาถูกที่แล้ว สำหรับการตั้งค่าที่กว้างขึ้น โปรดดู การทำงานอัตโนมัติของเวิร์กโฟลว์การพัฒนา OpenClaw และคู่มือการ ติดตั้ง OpenClaw อย่างปลอดภัย ก่อนที่คุณจะมอบคำสั่งใดๆ ให้กับมัน
ความแตกต่างมีความสำคัญเพราะ OpenClaw เรียนรู้กฎของโปรเจกต์จากไฟล์ในพื้นที่ทำงาน และกลไกนั้นเปลี่ยน "รันการทดสอบของฉัน" แบบครั้งเดียว ให้กลายเป็นสิ่งที่ OpenClaw ดึงมาใช้เอง กลไกนั้นคือ AGENTS.md
ขั้นตอนที่ 1: เพิ่มกฎของ Apidog ลงใน AGENTS.md
OpenClaw อ่านไฟล์ในพื้นที่ทำงานเป็นคำสั่งถาวรและฉีดเข้าไปในบริบทของเอเจนต์ ไฟล์ที่คุณต้องการคือ AGENTS.md ซึ่งเป็นคู่มือกฎขั้นตอนที่บอกเอเจนต์ว่าต้องทำอะไรและอย่างไร คิดว่ามันเป็น CLAUDE.md สำหรับ Claude Code; OpenClaw ยังมีเทมเพลตเริ่มต้นที่คุณสามารถคัดลอกลงในพื้นที่ทำงานของคุณ และมันถือว่า symlink CLAUDE.md ที่อยู่ร่วมกันเป็นไฟล์เดียวกัน พื้นที่ทำงานเริ่มต้นคือ ~/.openclaw/workspace แต่คุณสามารถชี้เอเจนต์ไปยังไดเรกทอรีโปรเจกต์ของคุณด้วย agents.list[].workspace และ OpenClaw รองรับไฟล์ AGENTS.md ที่มีขอบเขตต่อไดเรกทอรีย่อย (ดู เอกสารอ้างอิง AGENTS.md ของ OpenClaw)
เพิ่มบล็อกสั้นๆ ลงใน AGENTS.md ของคุณ:
## การทดสอบ API ด้วย Apidog
- หากต้องการรันการทดสอบ API ให้ใช้ Apidog CLI: `apidog run -t <scenario_id> -e <env_id> -r cli`
- รหัสออก 0 หมายถึงการยืนยันทั้งหมดผ่าน ไม่ใช่ศูนย์หมายความว่ามีบางอย่างล้มเหลว ถือเป็นเกตผ่าน/ไม่ผ่าน
- เครื่องได้รับการยืนยันตัวตนด้วย `apidog login` แล้ว อย่าเพิ่มแฟล็ก --access-token และอย่าใส่โทเค็นในไฟล์นี้เด็ดขาด
- หากแฟล็กดูไม่คุ้นเคย ให้รัน `apidog run --help` แทนการคาดเดา
นี่คือเหตุผลที่คุณเขียน CLI ลงใน AGENTS.md แทนที่จะกล่าวถึงในแชท ID สถานการณ์ที่พิมพ์ลงในเซสชันจะหายไปเมื่อเซสชันสิ้นสุดลง ID ที่อยู่ใน AGENTS.md จะอยู่ตรงนั้นสำหรับเพื่อนร่วมทีมทุกคนและการรัน OpenClaw ทุกครั้งนับจากนี้ไป
ขั้นตอนที่ 2: รับคำสั่งจาก Apidog
คุณไม่จำเป็นต้องเขียน ID สถานการณ์ด้วยตนเอง เปิดสถานการณ์ทดสอบใน Apidog ไปที่แท็บ CI/CD แล้วคัดลอกคำสั่งที่สร้างขึ้น มันจะมีลักษณะดังนี้:
apidog run -t 1234567 -e 890123 -r cli
-t คือสถานการณ์ทดสอบ, -e คือสภาพแวดล้อม และ -r cli คือตัวรายงาน วาง ID จริงลงในบล็อก AGENTS.md จากขั้นตอนที่ 1 เพื่อให้ OpenClaw เรียกใช้สถานการณ์ที่ถูกต้องกับสภาพแวดล้อมที่ถูกต้องเสมอ คู่มือ Apidog CLI ฉบับสมบูรณ์ และ เอกสารอ้างอิงคำสั่ง apidog run ครอบคลุมทุกแฟล็กหากคุณต้องการปรับแต่ง
ขั้นตอนที่ 3: ให้เอเจนต์รันการทดสอบ
เมื่อบล็อกอยู่ในที่ที่ถูกต้อง ให้เริ่มต้น OpenClaw กับโปรเจกต์ของคุณและทำการเปลี่ยนแปลงที่เกี่ยวข้องกับ API ของคุณ หรือเพียงแค่ขอให้มันรันการตรวจสอบ เนื่องจาก AGENTS.md อยู่ในบริบทแล้ว เอเจนต์จึงรู้ว่า CLI มีอยู่และจะออกคำสั่ง apidog run ผ่านเครื่องมือ exec ของมัน
เครื่องมือ exec รันคำสั่งเชลล์ในพื้นที่ทำงาน และ OpenClaw จำกัดการเข้าถึงด้วยโหมดการอนุญาต โหมดต่างๆ ได้แก่ deny, allowlist, ask, auto และ full (มีเอกสารประกอบอยู่ใน หน้าโหมดการอนุญาตของ OpenClaw) สำหรับเอเจนต์การเขียนโค้ด auto เป็นการตั้งค่าที่เหมาะสม: คำสั่งที่อยู่ในรายการที่อนุญาตจะทำงานโดยไม่มีการแจ้งเตือน และสิ่งอื่นใดจะต้องผ่านการตรวจสอบก่อนที่จะถามคุณ หากโหมดของคุณคือ ask OpenClaw จะหยุดชั่วคราวและขอการอนุมัติก่อนที่จะรัน apidog run; อนุมัติเพียงครั้งเดียว หรือเพิ่มคำสั่งลงในรายการที่อนุญาตของคุณ เพื่อให้การทดสอบแบบอ่านอย่างเดียวกับ staging ทำงานได้เอง ตั้งค่าโหมดภายใต้ tools.exec ใน openclaw.json
ขั้นตอนที่ 4: อ่านรายงานภายใน OpenClaw
ตัวรายงาน -r cli จะพิมพ์ผลลัพธ์ทีละขั้นตอนในเทอร์มินัล: แต่ละคำขอ, การยืนยันแต่ละรายการ, และรายการที่ล้มเหลวพร้อมค่าที่คาดหวังเทียบกับค่าจริง การวิเคราะห์โดยละเอียดนั้นคือสิ่งที่ OpenClaw อ่านเพื่อตัดสินใจขั้นตอนต่อไป ดังนั้นให้เก็บ cli ไว้ในรายการ
เมื่อคุณต้องการรายงานที่คุณสามารถเปิดในเบราว์เซอร์หรือส่งให้เพื่อนร่วมทีม ให้เพิ่มตัวรายงาน HTML:
apidog run -t 1234567 -e 890123 -r cli,html
ตัวรายงาน html จะเขียนไฟล์ที่อยู่ในตัวมันเองไปยัง ./apidog-reports เก็บ cli ไว้ด้วยเพื่อให้ OpenClaw ยังคงได้รับผลลัพธ์แบบอินไลน์ สำหรับรูปแบบ JUnit ที่แดชบอร์ด CI สามารถแยกวิเคราะห์ได้และตัวรายงานอื่นๆ ทั้งหมด โปรดดู คู่มือรายงานการทดสอบ Apidog CLI
การทดสอบ OpenClaw ภายในลูปของตัวเอง
ประเด็นคือสิ่งที่เกิดขึ้นเมื่อคุณหยุดถาม และ OpenClaw รันสถานการณ์เองเพราะ AGENTS.md บอกให้ทำ
ลองนึกภาพ OpenClaw กำลังแก้ไขตัวจัดการที่สร้างการตอบกลับการชำระเงิน ลูปของมันเปลี่ยนไป: มันแก้ไขโค้ด จากนั้นแทนที่จะประกาศชัยชนะ มันจะรันสถานการณ์ Apidog ของคุณกับ staging อ่านรหัสออก และดำเนินการตามนั้น หากเป็นสีเขียว มันจะดำเนินการต่อไป หากเป็นสีแดง มันจะเปิดรายงาน อ่านว่าการยืนยันใดล้มเหลว (รหัสสถานะ, ฟิลด์ที่หายไป, ค่าที่ไม่ถูกต้อง) ลองแก้ไข และรันใหม่ การทดสอบ API กลายเป็นส่วนหนึ่งของลูปแก้ไข-ทดสอบ-แก้ไขเดียวกันที่ OpenClaw ใช้รันการทดสอบหน่วยของคุณอยู่แล้ว คุณเขียนคำสั่งเดียวและเอเจนต์ก็รวมคำสั่งเข้ากับการทำงานที่มีอยู่แล้ว
นี่คือโมเดล delegate-then-verify ที่ทำให้เวิร์กโฟลว์ของเอเจนต์ปลอดภัย OpenClaw รันคำสั่งและอ่านผลลัพธ์; คุณยังคงสร้างสถานการณ์ด้วยสายตาใน Apidog และตรวจสอบว่าเอเจนต์อ่านรหัสออกอย่างตรงไปตรงมา สำหรับรูปแบบที่กว้างขึ้น โปรดดู วิธีใช้ AI agents สำหรับการทดสอบ API และ test harness ของ Apidog AI
ตรวจสอบว่า OpenClaw กำลังรัน CLI จริงๆ
เอเจนต์รายงานความสำเร็จที่พวกเขาไม่สมควรได้รับ และ OpenClaw ก็ไม่มีข้อยกเว้น การตรวจสอบสามจุด ตามลำดับความถี่ที่พวกเขามักจะพบปัญหา
ขั้นแรก ยืนยันว่าคำสั่งทำงานจริงๆ บันทึกของ OpenClaw จะแสดงคำสั่ง exec ที่รันและผลลัพธ์ของมัน มองหาบรรทัด apidog run ... และผลลัพธ์ใต้บรรทัดนั้น หาก OpenClaw บอกว่ารันการทดสอบแล้วแต่คุณไม่เห็นคำสั่ง แสดงว่ามันสรุปสิ่งที่มันไม่เคยทำไป ถามให้รันอีกครั้งและแสดงผลลัพธ์ดิบ
ประการที่สอง ยืนยันรหัสออก ซึ่งเป็นสิ่งสำคัญ ถามมันโดยตรง:
What was the exit code of that apidog run command?
apidog run จะออกจาก 0 เมื่อการยืนยันทุกอย่างผ่าน และเป็นค่าที่ไม่ใช่ศูนย์เมื่อมีสิ่งใดล้มเหลว พฤติกรรมเดียวนี้ช่วยให้ OpenClaw หรือไปป์ไลน์ ถือว่าการรันนั้นเป็นเกตที่สะอาด เมื่อข้อความกล่าวว่า "การทดสอบผ่าน" แต่รหัสออกไม่เป็นศูนย์ รหัสออกคือสิ่งที่ถูกต้อง
ประการที่สาม ตรวจสอบว่าใช้สถานการณ์จริงหรือไม่ หากการรันล้มเหลวด้วยข้อความ "scenario not found" OpenClaw อาจสร้างหรือจำ ID ผิด ตรวจสอบค่า -t และ -e อีกครั้งเทียบกับ AGENTS.md และคำสั่งที่ Apidog สร้างขึ้นในแท็บ CI/CD ID ใน AGENTS.md คือความจริง
ทางเลือก: เชื่อมต่อเซิร์ฟเวอร์ Apidog MCP
การรัน apidog run ผ่านเครื่องมือ exec ครอบคลุมสิ่งที่คุณต้องการส่วนใหญ่ เส้นทางหนึ่งไปไกลกว่านั้น: Model Context Protocol (MCP)
OpenClaw รองรับเซิร์ฟเวอร์ MCP คุณสามารถเพิ่มได้ด้วย openclaw mcp add <name> ซึ่งจะเขียนคำจำกัดความของเซิร์ฟเวอร์ลงใน ~/.openclaw/openclaw.json ภายใต้ mcp.servers และยอมรับแฟล็ก stdio เช่น --command และ --arg (ดู เอกสารประกอบ MCP ของ OpenClaw) เซิร์ฟเวอร์ Apidog MCP เปิดเผยข้อกำหนด API ของคุณผ่าน MCP เพื่อให้ OpenClaw สามารถอ่านสคีมาของคุณในขณะที่เขียนโค้ด ไม่ใช่แค่หลังจากนั้น การแบ่งงานชัดเจน: CLI รันการทดสอบ และ MCP ป้อนข้อมูลจำเพาะให้กับเอเจนต์
เมื่อ OpenClaw ทำผิดพลาด
ความล้มเหลวบางประการมักเกิดขึ้นบ่อยครั้งในระหว่างการตั้งค่า
มันเพิกเฉยบล็อก AGENTS.md หาก OpenClaw รันคำสั่งทั่วไปหรือไม่รันเลย ไฟล์อาจไม่ถูกโหลดเข้าสู่บริบท ยืนยันว่าบล็อกอยู่ใน AGENTS.md ที่เป็นของพื้นที่ทำงานที่ใช้งานอยู่ของเอเจนต์ และจำไว้ว่า OpenClaw จะอ่านไฟล์ AGENTS.md ที่มีขอบเขตตามไดเรกทอรี ดังนั้นกฎที่ซ่อนอยู่ในโครงสร้างที่ไม่ถูกต้องจะถูกข้ามไป การรีสตาร์ทเซสชันจะบังคับให้มีการอ่านใหม่
มันไม่เคยรันอะไรเลยเพราะ exec ถูกบล็อก เนื่องจากนโยบายเริ่มต้นของ OpenClaw เข้มงวดขึ้น exec อาจถูกปฏิเสธหรือถูกจำกัดโดย allowlist หาก apidog run ถูกข้ามไปอย่างเงียบๆ ให้ตรวจสอบโหมดการอนุญาตของคุณภายใต้ tools.exec และเปลี่ยนเป็น auto หรือเพิ่ม apidog เข้าไปใน allowlist ดู คู่มือการติดตั้ง OpenClaw อย่างปลอดภัย เพื่อดูวิธีเปิดใช้งานเฉพาะคำสั่งนี้โดยไม่ต้องเปิดใช้งานทั้งหมด
มันส่งโทเค็นการเข้าถึงอยู่ดี หาก OpenClaw พยายามเพิ่ม --access-token แสดงว่ามันกำลังเดาจากตัวอย่างสาธารณะ บล็อกได้บอกไปแล้วว่าไม่ให้ทำ เนื่องจากเครื่องได้รับการยืนยันตัวตนผ่าน apidog login เสริมความเข้าใจในบรรทัดนั้น และอย่าใส่โทเค็นจริงลงใน AGENTS.md; สำหรับรูปแบบที่ถูกต้อง โปรดดู การยืนยันตัวตน Apidog CLI
มันสร้างแฟล็กขึ้นมาเอง ข้อผิดพลาด "unknown option" หมายความว่า OpenClaw เดาแฟล็กที่เวอร์ชันของคุณไม่มี บอกให้มันรัน apidog run --help และคัดลอกแฟล็กที่ถูกต้องจากที่นั่น ซึ่งจะถูกต้องเสมอสำหรับเวอร์ชันที่ติดตั้งของคุณ
มันรายงานว่าผ่านในการรันที่ล้มเหลว นี่เป็นข้อผิดพลาดที่แพงที่สุด และเป็นเหตุผลที่กฎรหัสออกอยู่ใน AGENTS.md ของคุณและขั้นตอนการตรวจสอบของคุณ เมื่อสรุปและรหัสออกไม่ตรงกัน รหัสออกจะเป็นฝ่ายชนะ หากคุณเคยใช้เอเจนต์อื่นสำหรับสิ่งนี้ กฎเดียวกันนี้ก็ใช้ได้ แนวทางนี้สะท้อนสิ่งที่เราครอบคลุมใน Apidog CLI ใน Codex และความแตกต่างใน Claude Code เทียบกับ OpenClaw
จากเอเจนต์รายวันสู่ลูปที่ผ่านการทดสอบ
นั่นคือการตั้งค่า ติดตั้ง apidog-cli เพียงครั้งเดียวตาม คู่มือการติดตั้ง เพิ่มบล็อก Apidog สั้นๆ ลงใน AGENTS.md ของพื้นที่ทำงานของคุณ ตั้งค่าโหมดการอนุญาต exec เพื่อให้คำสั่งสามารถรันได้ และ OpenClaw จะรู้วิธีรันการทดสอบ API ของคุณและอ่านผลลัพธ์ภายในลูปเดียวกันกับที่มันใช้แก้ไขโค้ดอยู่แล้ว จุดสิ้นสุดที่เสียจะถูกตรวจพบในขณะที่ OpenClaw ยังคงทำงานกับการเปลี่ยนแปลง ไม่ใช่หลังจากที่มันถูกเผยแพร่ไปแล้ว
การทดสอบที่อยู่หลัง GUI จะรันเมื่อมนุษย์คลิก; คำสั่งหนึ่งบรรทัดจะรันเมื่อใดก็ตามที่ OpenClaw ตัดสินใจ คุณยังคงสร้างสถานการณ์ด้วยสายตาใน Apidog และเอเจนต์ของคุณจะรันมันในที่ที่คุณไม่ได้เฝ้าดู ดาวน์โหลด Apidog สร้างสถานการณ์หนึ่งรายการ วางคำสั่ง apidog run ของมันลงใน AGENTS.md แล้วดู OpenClaw เลือกมันขึ้นมาในการเปลี่ยนแปลงครั้งต่อไป เมื่อคุณต้องการเกตเดียวกันในไปป์ไลน์โดยไม่มีเอเจนต์อยู่ด้วย Apidog CLI ใน GitHub Actions ครอบคลุมความลับ ตัวรายงาน และการตรวจสอบรหัสออก