CLI commands

บันทึกการตรวจสอบ

`openclaw audit`

สืบค้นบัญชีแยกประเภทการตรวจสอบเฉพาะข้อมูลเมตาของ Gateway สำหรับการทำงานของเอเจนต์ การดำเนินการของเครื่องมือ และ ระเบียนวงจรชีวิตข้อความที่เลือกเปิดใช้

บัญชีแยกประเภทเปิดใช้โดยค่าเริ่มต้นสำหรับเหตุการณ์การทำงานและเครื่องมือ ตั้งค่า audit.enabled: false แล้วรีสตาร์ต Gateway เพื่อหยุดบันทึกเหตุการณ์ใหม่ทั้งหมด ระเบียนข้อความจะปิดใช้แยกต่างหากโดย ค่าเริ่มต้น ให้ตั้งค่า audit.messages เป็น direct หรือ all แล้วรีสตาร์ต Gateway เพื่อ บันทึกระเบียนเหล่านั้น ระเบียนที่มีอยู่ยังคงสืบค้นได้จนกว่าจะหมดอายุ (30 วัน)

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

bash

openclaw auditopenclaw audit --agent main --status failedopenclaw audit --session "agent:main:main" --after 2026-07-01T00:00:00Zopenclaw audit --run 8c69f72e-8b11-4c54-98d5-1a3dd67450c3openclaw audit --kind tool_action --limit 50 --jsonopenclaw audit --kind message --direction outbound --channel telegram --json

ตัวกรอง

--agent <id>: รหัสเอเจนต์ที่ตรงกันทุกประการ
--session <key>: คีย์เซสชันที่ตรงกันทุกประการ
--run <id>: รหัสการทำงานที่ตรงกันทุกประการ
--kind <kind>: agent_run, tool_action หรือ message
--status <status>: started, succeeded, failed, cancelled, timed_out, blocked หรือ unknown
--direction <direction>: ทิศทางข้อความ inbound หรือ outbound
--channel <channel>: ช่องทางข้อความที่ตรงกันทุกประการ
--after <timestamp> / --before <timestamp>: การประทับเวลา ISO แบบรวมขอบเขต หรือ มิลลิวินาที Unix
--limit <count>: ขนาดหน้าตั้งแต่ 1 ถึง 500 ค่าเริ่มต้นคือ 100
--cursor <sequence>: ดำเนินการสืบค้นก่อนหน้าที่เรียงจากใหม่ที่สุดต่อ
--json: พิมพ์หน้าที่มีขอบเขตจำกัดเป็น JSON

CLI สืบค้น RPC กิจกรรมที่มีการกำหนดเวอร์ชัน เพื่อให้คำสั่งเดียวแสดงบัญชีแยกประเภทที่กำหนดค่าไว้ ทั้งหมด เอาต์พุตข้อความจะแสดงเวลา ชนิด ทิศทาง ช่องทาง สถานะ เอเจนต์ การทำงาน และการดำเนินการ ที่มาของข้อความที่หายไปจะแสดงเป็น -; OpenClaw จะไม่สร้างรหัสเอเจนต์หรือรหัสการทำงานขึ้นเอง การดำเนินการของเครื่องมือจะแสดงชื่อเครื่องมือด้วย เอาต์พุต JSON จะมี nextCursor เมื่อยังมีหน้าอื่นอยู่ ส่งค่านั้นไปยัง --cursor เพื่อดำเนินการต่อโดยไม่จัดลำดับระเบียนที่เข้ามาระหว่างการแบ่งหน้าใหม่

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

เหตุการณ์ที่บันทึก

Gateway ฉายสตรีมวงจรชีวิตที่เชื่อถือได้เป็นการดำเนินการหกรายการ:

agent.run.started
agent.run.finished
tool.action.started
tool.action.finished
message.inbound.processed
message.outbound.finished

ทุกระเบียนที่ส่งคืนมีรหัสเหตุการณ์ที่คงที่ ลำดับบัญชีแยกประเภทที่เพิ่มขึ้นอย่างต่อเนื่อง การประทับเวลาวงจรชีวิต ผู้กระทำ การดำเนินการ สถานะ เครื่องหมาย schemaVersion: 1 ลำดับต้นทาง และ redaction: "metadata_only" ข้อมูลที่มาของเอเจนต์/เซสชัน/การทำงานและฟิลด์เฉพาะเหตุการณ์จะมีเฉพาะเมื่อ แหล่งที่เชื่อถือได้ให้ข้อมูลดังกล่าว ระเบียนข้อความจงใจละเว้น sessionKey และ sessionId ดังนั้นตัวกรอง --session จึงใช้กับระเบียนการทำงานและเครื่องมือเท่านั้น

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

ระเบียนข้อความจะเพิ่มทิศทาง ช่องทาง ชนิดการสนทนา ผลลัพธ์ และ ชนิดการส่ง ขั้นตอนความล้มเหลว ระยะเวลา จำนวนผลลัพธ์ รหัสเหตุผลที่ปรับให้อยู่ในรูปแบบมาตรฐาน และนามแฝงแบบใช้คีย์ของบัญชี/การสนทนา/ข้อความ/เป้าหมาย ซึ่งเป็นข้อมูลแบบไม่บังคับ ขอบเขตขาเข้า ปัจจุบันครอบคลุมข้อความที่ยอมรับและไปถึงการจัดส่งต่อของแกนหลัก รวมถึงผลลัพธ์การประมวลผลรายการซ้ำและปลายทางของแกนหลัก ขอบเขตขาออก จะเขียนหนึ่งแถวปลายทางต่อเพย์โหลดการตอบกลับเชิงตรรกะต้นฉบับที่ไปถึง การส่งที่คงทนร่วมกัน การแบ่งส่วนและการกระจายไปยังอะแดปเตอร์หลายตัวจะถูกรวมไว้ใน resultCount การส่งที่อยู่ในคิวซึ่งลองใหม่ได้หรือมีผลลัพธ์กำกวมจะถูกบันทึกเฉพาะหลังจาก การตอบรับ จดหมายตาย หรือการกระทบยอดทำให้ผลลัพธ์เป็นปลายทางแล้ว เส้นทางภายใน Plugin และเส้นทางส่งโดยตรงที่ข้ามขอบเขตร่วมเหล่านี้ยังไม่ ครอบคลุม การไม่มีแถวไม่ได้พิสูจน์ว่าไม่เคยมีข้อความอยู่

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

สำหรับแถวขาเข้า durationMs วัดการจัดส่งต่อของแกนหลัก และ resultCount นับ เพย์โหลดเครื่องมือ บล็อก และการตอบกลับในคิวที่เสร็จสิ้นแล้ว สำหรับแถวขาออก durationMs รวมการเป็นเจ้าของการส่งจนถึงสถานะปลายทาง (และด้วยเหตุนี้จึง รวมเวลารอในคิว) ขณะที่ resultCount นับการส่งจริงบนแพลตฟอร์มที่ระบุได้ deliveryKind เมื่อมีอยู่ จะอธิบายเพย์โหลดที่มีผลหลังฮุกและ หลังการเรนเดอร์ แถวที่ถูกระงับและแถวที่กำกวมจากการขัดข้องจะละเว้นค่านี้

RPC ของ Gateway

audit.activity.list ต้องใช้ operator.read และยอมรับตัวกรองเดียวกัน โดย ส่งคืนยูเนียนเหตุการณ์กิจกรรม V1 ที่มีชื่อ ซึ่งรวมถึงระเบียนการทำงาน เครื่องมือ ข้อความขาเข้า และข้อความขาออก

bash

openclaw gateway call audit.activity.list --params '{"channel":"telegram","limit":50}'

ผลลัพธ์คือ { "events": AuditActivityEventV1[], "nextCursor"?: string } ผลลัพธ์เรียงจากใหม่ที่สุดก่อนและจำกัดไว้ที่ 500 ระเบียนต่อคำขอ

RPC audit.list ที่จัดส่งแล้วยังคงไม่เปลี่ยนแปลงสำหรับไคลเอนต์การทำงาน/เครื่องมือรุ่นเก่า เมื่อ audit.activity.list ไม่พร้อมใช้งานบน Gateway รุ่นเก่า CLI จะลอง audit.list อีกครั้งเฉพาะเมื่อวิธีแบบเดิมรองรับตัวกรองที่ร้องขอทั้งหมด --kind message, --direction และ --channel จะล้มเหลวพร้อมข้อความให้อัปเกรดบน Gateway รุ่นเก่า แทนที่จะถูกละทิ้งโดยไม่แจ้งให้ทราบ

ที่เกี่ยวข้อง

Was this useful?