Bundled plugin guides

Plugin กระดานงาน

Plugin Workboard เพิ่มบอร์ดสไตล์ Kanban แบบเลือกใช้ได้ให้กับ Control UI ใช้เพื่อรวบรวมการ์ดงานขนาดเหมาะกับเอเจนต์ มอบหมาย ให้เอเจนต์ และติดตามงานเบื้องหลัง รัน และเซสชันแดชบอร์ดที่ลิงก์ไว้จากการ์ดเดียว

Workboard ถูกออกแบบให้มีขนาดเล็กโดยตั้งใจ ใช้ติดตามงานปฏิบัติการภายในเครื่องสำหรับ OpenClaw Gateway ไม่ใช่สิ่งทดแทน GitHub Issues, Linear, Jira หรือ ระบบจัดการโปรเจกต์ของทีมอื่นๆ

สถานะเริ่มต้น

Workboard เป็น Plugin ที่รวมมา และถูกปิดใช้งานโดยค่าเริ่มต้น เว้นแต่คุณจะเปิดใช้งาน ในคอนฟิก Plugin

เปิดใช้งานด้วย:

bash
openclaw plugins enable workboardopenclaw gateway restart

จากนั้นเปิดแดชบอร์ด:

bash
openclaw dashboard

แท็บ Workboard จะปรากฏในการนำทางของแดชบอร์ด หากแท็บมองเห็นได้ แต่ Plugin ถูกปิดใช้งานหรือถูกบล็อกโดย plugins.allow / plugins.deny มุมมองจะแสดงสถานะว่า Plugin ไม่พร้อมใช้งานแทนข้อมูลการ์ดภายในเครื่อง

สิ่งที่การ์ดมี

การ์ดแต่ละใบจัดเก็บ:

  • ชื่อและบันทึก
  • สถานะ: triage, backlog, todo, scheduled, ready, running, review, blocked หรือ done
  • ลำดับความสำคัญ: low, normal, high หรือ urgent
  • ป้ายกำกับ
  • id เอเจนต์แบบเลือกได้
  • งาน รัน เซสชัน หรือ URL แหล่งที่มาที่ลิงก์ไว้แบบเลือกได้
  • เมทาดาทาการดำเนินการแบบเลือกได้สำหรับรัน Codex หรือ Claude ที่เริ่มจากการ์ด
  • เมทาดาทาแบบกะทัดรัดสำหรับความพยายาม ความคิดเห็น ลิงก์ หลักฐาน อาร์ติแฟกต์ ระบบอัตโนมัติ ไฟล์แนบ บันทึกของผู้ปฏิบัติงาน สถานะโปรโตคอลของผู้ปฏิบัติงาน การอ้างสิทธิ์ การวินิจฉัย การแจ้งเตือน เทมเพลต สถานะการเก็บถาวร และการตรวจจับเซสชันค้าง
  • เหตุการณ์ล่าสุดของการ์ด เช่น การสร้าง การย้าย การลิงก์ การอ้างสิทธิ์ Heartbeat ความพยายาม หลักฐาน อาร์ติแฟกต์ การวินิจฉัย การแจ้งเตือน การส่งงาน การเก็บถาวร สถานะค้าง หรือการเปลี่ยนแปลงที่เอเจนต์อัปเดต

การ์ดถูกจัดเก็บในสถานะ Gateway ของ Plugin การ์ดเป็นข้อมูลภายในไดเรกทอรีสถานะของ Gateway และย้ายไปพร้อมกับสถานะ OpenClaw ที่เหลือของ Gateway นั้น

Workboard เก็บเมทาดาทาต่อการ์ดแบบกะทัดรัด เพื่อให้ผู้ปฏิบัติงานเห็นได้ว่าการ์ดเคลื่อนผ่าน บอร์ดอย่างไรโดยไม่ต้องเปิดเซสชันที่ลิงก์ไว้ เหตุการณ์ สรุปความพยายาม ส่วนย่อยหลักฐาน ลิงก์ที่เกี่ยวข้อง ความคิดเห็น เครื่องหมายเก็บถาวร และเครื่องหมายเซสชันค้าง เป็นเมทาดาทาภายในเครื่องโดยตั้งใจ ไม่ได้แทนที่ทรานสคริปต์เซสชันหรือประวัติ GitHub issue

การดำเนินการของการ์ดและงาน

การ์ดที่ยังไม่ลิงก์สามารถเริ่มงานจากการ์ดได้ การเริ่มแบบอัตโนมัติใช้เส้นทางรันเอเจนต์ ที่ติดตามงานของ Gateway จากนั้น Workboard จะลิงก์งานที่ได้ id รัน และคีย์เซสชัน กลับเข้ากับการ์ด การเริ่มใช้เอเจนต์และโมเดลเริ่มต้นที่กำหนดไว้ของ Gateway การกระทำ Codex และ Claude เป็นตัวเลือกโมเดลแบบชัดเจนที่เลือกใช้ได้:

  • Run Codex หรือ Run Claude เริ่มรันเอเจนต์ที่มีงานรองรับ ส่งพรอมป์ของการ์ด และทำเครื่องหมายการ์ดเป็น running
  • Open Codex หรือ Open Claude สร้างเซสชันแดชบอร์ดที่ลิงก์ไว้โดยไม่ส่งพรอมป์ของการ์ด หรือย้ายการ์ด เพื่อให้คุณทำงานด้วยตนเองได้ขณะที่การ์ดยังคงแนบอยู่กับบอร์ด

เมทาดาทาการดำเนินการจัดเก็บเอนจิน โหมด การอ้างอิงโมเดล คีย์เซสชัน id รัน id งานเมื่อมี และสถานะวงจรชีวิตที่เลือกไว้บนการ์ด การดำเนินการ Codex ใช้ openai/gpt-5.5; การดำเนินการ Claude ใช้ anthropic/claude-sonnet-4-6

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

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

การประสานงานเอเจนต์

Workboard ยังเปิดเผยเครื่องมือเอเจนต์แบบเลือกใช้ได้สำหรับเวิร์กโฟลว์ที่รับรู้บอร์ด:

  • workboard_list แสดงรายการการ์ดแบบกะทัดรัดพร้อมสถานะการอ้างสิทธิ์และการวินิจฉัย โดยมีตัวกรองบอร์ดแบบเลือกได้
  • workboard_read คืนการ์ดหนึ่งใบพร้อมบริบทผู้ปฏิบัติงานแบบจำกัดที่สร้างจากบันทึก ความพยายาม ความคิดเห็น ลิงก์ หลักฐาน อาร์ติแฟกต์ ผลลัพธ์พาเรนต์ งานล่าสุดของผู้รับมอบหมาย และการวินิจฉัยที่ใช้งานอยู่
  • workboard_create สร้างการ์ดพร้อมพาเรนต์ tenant, Skills, บอร์ด เมทาดาทาเวิร์กสเปซ คีย์ idempotency ขีดจำกัดรันไทม์ และงบประมาณการลองใหม่แบบเลือกได้
  • workboard_link ลิงก์การ์ดพาเรนต์เข้ากับการ์ดลูก ลูกจะคงอยู่ใน todo จนกว่าพาเรนต์ทุกใบจะถึง done; จากนั้นการเลื่อนขั้นจากการส่งงานจะย้ายลูกไปยัง ready
  • workboard_claim อ้างสิทธิ์การ์ดสำหรับเอเจนต์ที่เรียกใช้ และย้ายการ์ด backlog, todo หรือ ready ไปเป็น running
  • workboard_heartbeat รีเฟรช Heartbeat ของการอ้างสิทธิ์ระหว่างรันที่ใช้เวลานาน
  • workboard_release ปล่อยการอ้างสิทธิ์หลังเสร็จสิ้น หยุดพัก หรือส่งต่อ และสามารถย้ายการ์ดไปยังสถานะถัดไปได้
  • workboard_complete และ workboard_block เป็นเครื่องมือวงจรชีวิตแบบมีโครงสร้างสำหรับ สรุปสุดท้าย หลักฐาน อาร์ติแฟกต์ manifest ของการ์ดที่สร้างขึ้น และเหตุผลของตัวบล็อก manifest ของการ์ดที่สร้างขึ้นต้องอ้างอิงการ์ดที่ลิงก์กลับไปยังการ์ดที่เสร็จสิ้น ซึ่งช่วยกันไม่ให้ลูกล่องหนหลุดเข้าไปในสรุป
  • workboard_attachment_add, workboard_attachment_read และ workboard_attachment_delete จัดเก็บไฟล์แนบการ์ดขนาดเล็กในสถานะ SQLite ของ Plugin ทำดัชนีไว้บนการ์ด และเปิดเผยในบริบทผู้ปฏิบัติงาน
  • workboard_worker_log และ workboard_protocol_violation บันทึกบรรทัดล็อกของผู้ปฏิบัติงาน และบล็อกการ์ดเมื่อผู้ปฏิบัติงานอัตโนมัติหยุดโดยไม่เรียก workboard_complete หรือ workboard_block
  • workboard_board_create, workboard_board_archive และ workboard_board_delete จัดการเมทาดาทาบอร์ดที่คงอยู่ เช่น ชื่อที่แสดง คำอธิบาย สถานะการเก็บถาวร และเวิร์กสเปซเริ่มต้น
  • workboard_runs คืนประวัติความพยายามรันที่คงอยู่ซึ่งจัดเก็บบนการ์ด
  • workboard_specify เปลี่ยนการ์ด triage หรือ backlog แบบหยาบให้เป็นการ์ด todo ที่ชัดเจนขึ้น และบันทึกสรุปข้อกำหนดไว้บนการ์ด
  • workboard_decompose กระจายการ์ดจัดการพาเรนต์ออกเป็นลูกที่ลิงก์ไว้ รับช่วงเมทาดาทาบอร์ดและ tenant และสามารถทำให้พาเรนต์เสร็จสิ้นพร้อม manifest ของการ์ดที่สร้างขึ้น
  • workboard_notify_subscribe, workboard_notify_list, workboard_notify_events, workboard_notify_advance และ workboard_notify_unsubscribe จัดการการสมัครรับการแจ้งเตือนในสถานะ Plugin การอ่านเหตุการณ์ปลอดภัยต่อการเล่นซ้ำ; เครื่องมือ advance ย้ายเคอร์เซอร์ที่คงทน เพื่อให้ผู้เรียกกลับมาทำงานต่อได้โดยไม่สูญเสียหรืออ่านเหตุการณ์การ์ดที่เสร็จสิ้น ล้มเหลว หรือค้างซ้ำ
  • workboard_boards, workboard_stats, workboard_promote, workboard_reassign, workboard_reclaim, workboard_comment, workboard_proof, workboard_unblock และ workboard_dispatch ให้เอเจนต์ ตรวจสอบเนมสเปซบอร์ด ดูสถิติคิว กู้คืนงานที่ติดค้าง เพิ่มบันทึกการส่งต่อ แนบหลักฐานหรือการอ้างอิงอาร์ติแฟกต์ ย้ายงานที่ถูกบล็อกกลับไปยัง todo และกระตุ้นการเลื่อนขั้นตาม dependency หรือการล้างการอ้างสิทธิ์ที่ค้าง

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

Workboard จัดเก็บข้อมูลบอร์ดที่คงทนในฐานข้อมูล SQLite เชิงสัมพันธ์ที่ Plugin เป็นเจ้าของ ภายใต้ไดเรกทอรีสถานะ OpenClaw บอร์ด การ์ด ป้ายกำกับ เหตุการณ์วงจรชีวิต ความพยายามรัน ความคิดเห็น ลิงก์ dependency หลักฐาน การอ้างอิงอาร์ติแฟกต์ เมทาดาทาและ blob ของไฟล์แนบ การวินิจฉัย การแจ้งเตือน บันทึกของผู้ปฏิบัติงาน สถานะโปรโตคอล และการสมัครรับ ถูกคงอยู่ในตาราง Workboard แทนรายการ key-value ของ Plugin การส่งออกการ์ดยังคงรักษาเรื่องราวของบอร์ดไว้โดยไม่ฝังเนื้อหา blob ของไฟล์แนบไว้ภายใน

การติดตั้งที่ใช้ Workboard ในรีลีส .28 สามารถรัน openclaw doctor --fix เพื่อย้ายเนมสเปซสถานะ Plugin แบบเดิมที่เคยส่งมอบ (workboard.cards, workboard.boards และ workboard.notify) ไปยัง ฐานข้อมูลเชิงสัมพันธ์ หากมีเนมสเปซ workboard.attachments แบบเดิมอยู่ doctor จะย้าย blob ของไฟล์แนบเหล่านั้นด้วย

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

การส่งงานเป็นแบบภายใน Gateway โดยตั้งใจ ไม่ได้ spawn โปรเซสของระบบปฏิบัติการตามอำเภอใจ; เซสชัน subagent ปกติของ OpenClaw ยังคงเป็นเจ้าของการดำเนินการ การกระทำ dispatch เลื่อนขั้นการ์ดที่ dependency พร้อม บันทึกเมทาดาทาการส่งงานบนการ์ด ready บล็อกการอ้างสิทธิ์ที่หมดอายุหรือรันที่หมดเวลา ทำเครื่องหมายการ์ด triage ที่กำหนดค่าในบอร์ด เป็นผู้สมัครสำหรับการจัดการ จากนั้นอ้างสิทธิ์การ์ด ready ชุดเล็กๆ และเริ่มรันผู้ปฏิบัติงานผ่านรันไทม์ subagent ของ Gateway การ์ดที่มอบหมายแล้วใช้คีย์เซสชัน ผู้ปฏิบัติงาน agent:<id>:subagent:workboard-*; การ์ดที่ไม่ได้มอบหมายใช้คีย์ subagent:workboard-* แบบไม่มีสโคป เพื่อให้ Gateway ยังคง resolve เอเจนต์เริ่มต้นที่กำหนดไว้ ผู้ปฏิบัติงานได้รับบริบทการ์ดแบบจำกัดพร้อมโทเค็นการอ้างสิทธิ์ที่ต้องใช้เพื่อส่ง Heartbeat ทำให้เสร็จสิ้น หรือบล็อกการ์ดผ่านเครื่องมือ Workboard

การเลือกผู้ปฏิบัติงานของ dispatch

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

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

พรอมป์และวงจรชีวิตของผู้ปฏิบัติงาน

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

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

หากไม่สามารถเริ่มผู้ปฏิบัติงานหลังจากการ์ดถูกอ้างสิทธิ์ Workboard จะบล็อกการ์ด ล้างการอ้างสิทธิ์ บันทึกความล้มเหลวในการเริ่มรัน และเพิ่มบรรทัดล็อกผู้ปฏิบัติงาน ความล้มเหลวนั้นมองเห็นได้ในแดชบอร์ด CLI JSON เครื่องมือเอเจนต์ และการวินิจฉัยการ์ด

จุดเข้าของ dispatch

การเริ่มผู้ปฏิบัติงานสำหรับการ์ด ready สามารถเกิดขึ้นจาก:

  • การกระทำ dispatch ในแดชบอร์ด
  • openclaw workboard dispatch
  • /workboard dispatch บนช่องทางที่รองรับคำสั่ง

จุดเข้าทั้งสามใช้รันไทม์ subagent ของ Gateway เมื่อ Gateway พร้อมใช้งาน CLI มี fallback สำหรับผู้ปฏิบัติงานเพิ่มอีกหนึ่งอย่าง: หาก Gateway ออฟไลน์หรือ ไม่ได้เปิดเผยเมธอด dispatch ของ Workboard และไม่ได้ระบุเป้าหมาย --url หรือ --token อย่างชัดเจน CLI จะรัน dispatch แบบข้อมูลเท่านั้นกับสถานะ SQLite ภายในเครื่อง fallback นั้นสามารถเลื่อนขั้น dependency ล้างการอ้างสิทธิ์ค้าง และบล็อกรันที่หมดเวลา แต่ไม่สามารถเริ่มผู้ปฏิบัติงานได้

เมทาดาทาบอร์ดสามารถมีการตั้งค่าการจัดการ เช่น autoDecompose, autoDecomposePerDispatch, defaultAssignee และ orchestratorProfile OpenClaw บันทึกเจตนาการจัดการและเปิดเผยในบริบทผู้ปฏิบัติงาน; การระบุข้อกำหนด และการแยกย่อยจริงยังคงเกิดขึ้นผ่านเครื่องมือ Workboard ตามปกติ

CLI และคำสั่ง slash

Plugin ลงทะเบียนคำสั่ง CLI ระดับราก:

bash
openclaw workboard listopenclaw workboard create "Fix stale card lifecycle" --priority high --labels bug,workboardopenclaw workboard show <card-id>openclaw workboard dispatch

openclaw workboard dispatch เรียก Gateway ที่กำลังทำงานอยู่ เพื่อให้การเริ่ม worker ใช้ runtime ของ subagent เดียวกับแดชบอร์ด หาก Gateway ใช้งานไม่ได้ ระบบจะถอยกลับไปใช้ dispatch แบบข้อมูลเท่านั้น เพื่อให้การเลื่อนระดับ dependency, การล้าง stale claim และ การบล็อก timeout ยังทำงานได้ ความล้มเหลวด้าน Auth, permission และ validation ยังคง แสดงเป็นข้อผิดพลาดของคำสั่ง เช่นเดียวกับความล้มเหลวสำหรับเป้าหมาย --url หรือ --token ที่ระบุอย่างชัดเจน

คำสั่ง slash /workboard รองรับเส้นทาง operator แบบกะทัดรัดเดียวกัน: /workboard list, /workboard show <card-id>, /workboard create <title> และ /workboard dispatch List และ show เป็นการดำเนินการอ่านสำหรับผู้ส่งคำสั่งที่ได้รับอนุญาต Create และ dispatch ต้องมีสถานะ owner บนพื้นผิวแชต หรือเป็น client ของ Gateway ที่มี operator.write หรือ operator.admin

ดู Workboard CLI สำหรับแฟล็กคำสั่ง, เอาต์พุต JSON, พฤติกรรม fallback ของ Gateway, การจัดการ id-prefix ที่ไม่กำกวม, กฎการเลือก dispatch และการแก้ไขปัญหา

การซิงก์วงจรชีวิตของเซสชัน

การ์ดสามารถลิงก์กับเซสชันแดชบอร์ดที่มีอยู่ หรือกับเซสชันที่สร้างขึ้น เมื่อคุณเริ่มงานจากการ์ด การ์ดที่ลิงก์จะแสดงวงจรชีวิตของเซสชันแบบ inline: กำลังทำงาน, stale, idle ที่ลิงก์อยู่, เสร็จสิ้น, ล้มเหลว หรือหายไป

หากเซสชันที่ลิงก์หายไป การ์ดจะยังคงลิงก์ไว้เพื่อบริบท และยังคง มีตัวควบคุมเริ่มงานเพื่อให้คุณเริ่มงานใหม่ในเซสชันแดชบอร์ดใหม่ได้ หากเซสชันที่ลิงก์และยัง active หยุดรายงานกิจกรรมล่าสุด Workboard จะทำเครื่องหมาย การ์ดเป็น stale และเก็บเครื่องหมายนั้นเป็น metadata ของการ์ดจนกว่าวงจรชีวิตจะล้างออก

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

Workboard จะติดตามเซสชันที่ลิงก์อยู่ขณะที่การ์ดยังอยู่ในสถานะงานที่ active:

  • เซสชันที่ลิงก์และ active -> running
  • เซสชันที่ลิงก์และเสร็จสมบูรณ์ -> review
  • เซสชันที่ลิงก์และล้มเหลว, ถูก kill, timed out หรือถูก abort -> blocked

สถานะ review แบบแมนนวลมีความสำคัญกว่า หากคุณย้ายการ์ดไปที่ review, blocked หรือ done Workboard จะหยุดย้ายการ์ดนั้นโดยอัตโนมัติจนกว่าคุณจะย้ายกลับไปที่ todo หรือ running

เวิร์กโฟลว์แดชบอร์ด

  1. เปิดแท็บ Workboard ใน Control UI
  2. สร้างการ์ดพร้อมชื่อ, โน้ต, priority, labels, agent ทางเลือก และ เซสชันที่ลิงก์ทางเลือก
  3. หรือเปิด Sessions แล้วเลือก Add to Workboard สำหรับเซสชันที่มีอยู่
  4. ลากการ์ดระหว่างคอลัมน์ หรือโฟกัสตัวควบคุมสถานะแบบกะทัดรัดบนการ์ด แล้วใช้เมนูหรือ ArrowLeft/ArrowRight
  5. เริ่มงานจากการ์ดเพื่อสร้างหรือใช้เซสชันแดชบอร์ดซ้ำ
  6. เปิดเซสชันที่ลิงก์จากการ์ดขณะที่ agent ทำงาน
  7. ให้การซิงก์วงจรชีวิตย้ายงานที่กำลังทำงานไปยัง review หรือ blocked จากนั้นย้าย การ์ดไปที่ done ด้วยตนเองเมื่อยอมรับแล้ว

การเริ่มการ์ดใช้เซสชัน Gateway ตามปกติ Plugin Workboard เก็บเฉพาะ metadata และลิงก์ของการ์ด ส่วน transcript ของการสนทนา, การเลือกโมเดล และวงจรชีวิต ของ run ยังคงเป็นของระบบเซสชันปกติ

ใช้ Stop บนการ์ดที่ลิงก์และยัง live เพื่อ abort run ของเซสชันที่ active Workboard จะทำเครื่องหมาย การ์ดนั้นเป็น blocked เพื่อให้ยังมองเห็นได้สำหรับการติดตามผล

การ์ดใหม่สามารถเริ่มจากเทมเพลต Workboard สำหรับ bugfixes, docs, releases, PR reviews หรือ plugin work ได้ เทมเพลตจะเติม title, notes, labels และ priority ไว้ล่วงหน้า และ id ของเทมเพลตที่เลือกจะถูกเก็บเป็น metadata ของการ์ด

สิทธิ์

Plugin ลงทะเบียนเมธอด RPC ของ Gateway ใต้ namespace workboard.*:

  • workboard.cards.list ต้องใช้ operator.read
  • workboard.cards.export ต้องใช้ operator.read
  • workboard.cards.diagnostics ต้องใช้ operator.read
  • workboard.cards.diagnostics.refresh ต้องใช้ operator.write
  • การอ่านรายการ/ดึง attachment และเหตุการณ์ notification ต้องใช้ operator.read
  • การเลื่อน notification cursor ต้องใช้ operator.write
  • เมธอด create, update, move, delete, comment, link, dependency link, proof, artifact, attachment add/delete, worker log, protocol violation, claim, heartbeat, release, complete, block, unblock, dispatch, bulk และ archive ต้องใช้ operator.write

เบราว์เซอร์ที่เชื่อมต่อด้วยสิทธิ์ operator แบบ read-only สามารถตรวจดู board ได้ แต่ ไม่สามารถแก้ไขการ์ดได้

การกำหนดค่า

ปัจจุบัน Workboard ไม่มี config เฉพาะ Plugin เปิดหรือปิดด้วย รายการ Plugin มาตรฐาน:

json5
{  plugins: {    entries: {      workboard: {        enabled: true,        config: {},      },    },  },}

ปิดอีกครั้งด้วย:

bash
openclaw plugins disable workboardopenclaw gateway restart

การแก้ไขปัญหา

แท็บแจ้งว่า Workboard ใช้งานไม่ได้

ตรวจสอบนโยบาย Plugin:

bash
openclaw plugins inspect workboard --runtime --json

หากมีการกำหนดค่า plugins.allow ให้เพิ่ม workboard ไปยัง allowlist นั้น หาก plugins.deny มี workboard ให้ลบออกก่อนเปิดใช้ Plugin

การ์ดไม่บันทึก

ยืนยันว่าการเชื่อมต่อของเบราว์เซอร์มีสิทธิ์ operator.write เซสชัน operator แบบ read-only สามารถแสดงรายการการ์ดได้ แต่ไม่สามารถสร้าง, แก้ไข, ย้าย หรือลบได้

การเริ่มการ์ดไม่เปิดเซสชันที่คาดไว้

Workboard สร้างลิงก์ไปยังเซสชันแดชบอร์ดปกติ ตรวจสอบ agent id ของการ์ดและเซสชันที่ลิงก์ จากนั้นเปิดมุมมอง Sessions หรือ Chat เพื่อตรวจสอบ สถานะ run จริง

Dispatch ไม่เริ่ม worker

ยืนยันว่ามีการ์ด ready อย่างน้อยหนึ่งใบที่ไม่มี claim ที่ active:

bash
openclaw workboard list --status ready

หาก CLI รายงาน dispatch แบบข้อมูลเท่านั้น ให้เริ่มหรือรีสตาร์ท Gateway แล้วลองอีกครั้ง dispatch แบบข้อมูลเท่านั้นจะอัปเดตสถานะ board ภายในเครื่อง แต่ไม่สามารถเริ่ม run ของ subagent worker ได้

การ์ดยังอาจถูกข้ามเมื่อมีการ์ดอื่นสำหรับ owner หรือ agent เดียวกัน กำลังทำงานอยู่หรือรอ review อยู่แล้ว ให้ complete, block หรือ release งานที่ active นั้น ก่อน dispatch งานเพิ่มเติมสำหรับ owner เดียวกัน

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

Was this useful?
On this page

On this page