Çalışma panosu Plugin

Workboard Plugin, Kontrol UI içine isteğe bağlı Kanban tarzı bir pano ekler. Bunu ajan ölçeğindeki iş kartlarını toplamak, bunları ajanlara atamak ve bağlantılı arka plan görevini, çalıştırmayı ve dashboard oturumunu tek bir karttan izlemek için kullanın.

Workboard bilinçli olarak küçük tutulmuştur. Bir OpenClaw Gateway için yerel işletim işlerini izler; GitHub Issues, Linear, Jira veya diğer ekip proje yönetim sistemlerinin yerine geçmez.

Varsayılan durum

Workboard, paketlenmiş bir Plugin’dir ve Plugin yapılandırmasında etkinleştirmediğiniz sürece varsayılan olarak devre dışıdır.

Şununla etkinleştirin:

openclaw plugins enable workboardopenclaw gateway restart

Ardından dashboard’u açın:

openclaw dashboard

Workboard sekmesi dashboard gezintisinde görünür. Sekme görünürse ancak Plugin devre dışıysa veya plugins.allow / plugins.deny tarafından engellenmişse, görünüm yerel kart verileri yerine Plugin kullanılamıyor durumunu gösterir.

Kartların içerdiği bilgiler

Her kart şunları saklar:

• başlık ve notlar
• durum: triage, backlog, todo, scheduled, ready, running, review, blocked veya done
• öncelik: low, normal, high veya urgent
• etiketler
• isteğe bağlı ajan kimliği
• isteğe bağlı bağlantılı görev, çalıştırma, oturum veya kaynak URL’si
• karttan başlatılan bir Codex veya Claude çalıştırması için isteğe bağlı yürütme meta verileri
• denemeler, yorumlar, bağlantılar, kanıt, yapıtlar, otomasyon, ekler, çalışan günlükleri, çalışan protokol durumu, sahiplenmeler, tanılamalar, bildirimler, şablonlar, arşiv durumu ve bayat oturum algılama için kompakt meta veriler
• oluşturuldu, taşındı, bağlandı, sahiplenildi, Heartbeat, deneme, kanıt, yapıt, tanılama, bildirim, dispatch, arşiv, bayat veya ajan tarafından güncellendi değişiklikleri gibi son kart olayları

Kartlar Plugin’in Gateway durumunda saklanır. Gateway durum dizinine yereldir ve ilgili Gateway’in geri kalan OpenClaw durumuyla birlikte taşınır.

Workboard, operatörlerin bağlantılı oturumu açmadan bir kartın panoda nasıl ilerlediğini görebilmesi için kart başına kompakt meta veriler tutar. Olaylar, deneme özetleri, kanıt parçaları, ilişkili bağlantılar, yorumlar, arşiv işaretçileri ve bayat oturum işaretçileri bilinçli olarak yerel meta verilerdir; oturum dökümlerinin veya GitHub issue geçmişinin yerini almazlar.

Kart yürütmeleri ve görevler

Bağlantısız kartlar işi karttan başlatabilir. Otonom başlatmalar Gateway’in görev izlemeli ajan çalıştırma yolunu kullanır, ardından Workboard ortaya çıkan görevi, çalıştırma kimliğini ve oturum anahtarını karta geri bağlar. Başlatma, Gateway’in yapılandırılmış varsayılan ajanını ve modelini kullanır. Codex ve Claude eylemleri isteğe bağlı açık model seçimleridir:

• Run Codex veya Run Claude, görev destekli bir ajan çalıştırması başlatır, kart istemini gönderir ve kartı running olarak işaretler.
• Open Codex veya Open Claude, kart istemini göndermeden ya da kartı taşımadan bağlantılı bir dashboard oturumu oluşturur; böylece karta bağlı kalırken elle çalışabilirsiniz.

Yürütme meta verileri seçilen motoru, modu, model referansını, oturum anahtarını, çalıştırma kimliğini, varsa görev kimliğini ve yaşam döngüsü durumunu kartta saklar. Codex yürütmeleri openai/gpt-5.5 kullanır; Claude yürütmeleri anthropic/claude-sonnet-4-6 kullanır.

Her bağlantılı yürütme aynı kart kaydına bir deneme özeti de kaydeder. Deneme özeti motoru, modu, modeli, çalıştırma kimliğini, zaman damgalarını, durumu ve kayan hata sayısını tutar; böylece tekrarlanan hatalar panoda görünür kalır.

Dashboard, Gateway görev defterinden görev durumunu yeniler ve görevleri görev kimliği, çalıştırma kimliği veya bağlantılı oturum anahtarıyla kartlarla eşleştirir. Bir görev kuyruğa alınmış veya çalışıyorsa kart yaşam döngüsü etkin görev durumunu gösterir. Görev biterse, başarısız olursa, zaman aşımına uğrarsa veya iptal edilirse kart yaşam döngüsü, bağlantılı oturumlarla aynı yaşam döngüsü eşitlemesini kullanarak review veya blocked durumuna doğru ilerler.

Ajan koordinasyonu

Workboard ayrıca pano farkındalığı olan iş akışları için isteğe bağlı ajan araçları sunar:

• workboard_list, isteğe bağlı pano filtresiyle birlikte sahiplenme ve tanılama durumuna sahip kompakt kartları listeler.
• workboard_read, notlardan, denemelerden, yorumlardan, bağlantılardan, kanıttan, yapıtlardan, üst sonuçlardan, son atanan çalışmalarından ve etkin tanılamalardan oluşturulan sınırlı çalışan bağlamıyla birlikte bir kart döndürür.
• workboard_create, isteğe bağlı üst kartlar, kiracı, Skills, pano, çalışma alanı meta verileri, idempotency anahtarı, çalışma süresi sınırı ve yeniden deneme bütçesiyle bir kart oluşturur.
• workboard_link, bir üst kartı bir alt karta bağlar. Alt kartlar, her üst kart done durumuna ulaşana kadar todo içinde kalır; ardından dispatch yükseltmesi onları ready durumuna taşır.
• workboard_claim, çağıran ajan için bir kartı sahiplenir ve backlog, todo veya ready kartlarını running durumuna taşır.
• workboard_heartbeat, daha uzun çalıştırmalar sırasında sahiplenme Heartbeat’ini yeniler.
• workboard_release, tamamlanma, duraklama veya devretme sonrasında sahiplenmeyi serbest bırakır ve kartı bir sonraki duruma taşıyabilir.
• workboard_complete ve workboard_block, nihai özetler, kanıt, yapıtlar, oluşturulan kart manifestleri ve engelleyici nedenleri için yapılandırılmış yaşam döngüsü araçlarıdır. Oluşturulan kart manifestleri, tamamlanan karta geri bağlanmış kartlara referans vermelidir; bu, hayalet alt kartları özetlerin dışında tutar.
• workboard_attachment_add, workboard_attachment_read ve workboard_attachment_delete, küçük kart eklerini Plugin SQLite durumunda saklar, bunları kartta dizine ekler ve çalışan bağlamında sunar.
• workboard_worker_log ve workboard_protocol_violation, çalışan günlük satırlarını kaydeder ve otomatik bir çalışan workboard_complete veya workboard_block çağırmadan durduğunda kartları engeller.
• workboard_board_create, workboard_board_archive ve workboard_board_delete, görüntü adı, açıklama, arşiv durumu ve varsayılan çalışma alanı gibi kalıcı pano meta verilerini yönetir.
• workboard_runs, bir kartta saklanan kalıcı çalıştırma-deneme geçmişini döndürür.
• workboard_specify, kaba bir triage veya backlog kartını netleştirilmiş bir todo kartına dönüştürür ve belirtim özetini karta kaydeder.
• workboard_decompose, bir üst orkestrasyon kartını bağlantılı alt kartlara yayar, pano ve kiracı meta verilerini devralır ve üst kartı oluşturulan kart manifestiyle tamamlayabilir.
• workboard_notify_subscribe, workboard_notify_list, workboard_notify_events, workboard_notify_advance ve workboard_notify_unsubscribe, bildirim aboneliklerini Plugin durumunda yönetir. Olay okumaları tekrar oynatmaya güvenlidir; advance aracı dayanıklı imleci taşır, böylece çağıranlar tamamlanan, başarısız olan veya bayat kart olaylarını kaybetmeden ya da çift okumadan devam edebilir.
• workboard_boards, workboard_stats, workboard_promote, workboard_reassign, workboard_reclaim, workboard_comment, workboard_proof, workboard_unblock ve workboard_dispatch, bir ajanın pano ad alanlarını incelemesini, kuyruk istatistiklerini görüntülemesini, takılmış işleri kurtarmasını, devir notları eklemesini, kanıt veya yapıt referansları iliştirmesini, engellenmiş işi tekrar todo durumuna taşımasını ve bağımlılık yükseltmesini veya bayat sahiplenme temizliğini tetiklemesini sağlar.

Sahiplenilmiş kartlar, çağıranın workboard_claim tarafından döndürülen sahiplenme belirtecine sahip olmadığı sürece diğer ajanlardan gelen ajan-aracı mutasyonlarını reddeder. Dashboard operatörleri hâlâ normal Gateway RPC yüzeyini kullanır ve kartları kurtarabilir veya yeniden atayabilir.

Workboard, dayanıklı pano verilerini OpenClaw durum dizini altında Plugin’e ait ilişkisel SQLite veritabanında saklar. Panolar, kartlar, etiketler, yaşam döngüsü olayları, çalıştırma denemeleri, yorumlar, bağımlılık bağlantıları, kanıt, yapıt referansları, ek meta verileri ve blob’ları, tanılamalar, bildirimler, çalışan günlükleri, protokol durumu ve abonelikler Plugin anahtar-değer girdileri yerine Workboard tablolarında kalıcılaştırılır. Bir kart dışa aktarımı, ek blob içeriklerini satır içine almadan pano anlatısını yine de korur.

.28 sürümünde Workboard kullanan kurulumlar, gönderilmiş eski Plugin durum ad alanlarını (workboard.cards, workboard.boards ve workboard.notify) ilişkisel veritabanına geçirmek için openclaw doctor --fix çalıştırabilir. Eski bir workboard.attachments ad alanı varsa doctor bu ek blob’larını da geçirir.

Workboard tanılamaları yerel kart meta verilerinden hesaplanır. Yerleşik kontroller çok uzun bekleyen atanmış kartları, yakın zamanda Heartbeat almamış çalışan kartları, dikkat gerektiren engellenmiş kartları, tekrarlanan hataları, kanıtsız done kartlarını ve yalnızca gevşek bir oturum bağlantısı olan çalışan kartları işaretler.

Dispatch bilinçli olarak Gateway’e yereldir. Keyfi işletim sistemi süreçleri başlatmaz; normal OpenClaw alt ajan oturumları yürütmeye sahip olmaya devam eder. Dispatch eylemi bağımlılıkları hazır kartları yükseltir, ready kartlara dispatch meta verileri kaydeder, süresi dolmuş sahiplenmeleri veya zaman aşımına uğramış çalıştırmaları engeller, pano yapılandırmalı triage kartlarını orkestrasyon adayları olarak işaretler, ardından küçük bir ready kart grubunu sahiplenir ve Gateway alt ajan çalışma zamanı üzerinden çalışan çalıştırmaları başlatır. Atanmış kartlar agent:<id>:subagent:workboard-* çalışan oturum anahtarlarını kullanır; atanmamış kartlar kapsamlandırılmamış subagent:workboard-* anahtarlarını kullanır, böylece Gateway yapılandırılmış varsayılan ajanı yine çözer. Çalışanlar, Workboard araçları üzerinden kart için Heartbeat göndermek, kartı tamamlamak veya engellemek için ihtiyaç duydukları sahiplenme belirteciyle birlikte sınırlı kart bağlamı alır.

Dispatch çalışan seçimi

Her dispatch geçişi varsayılan olarak en fazla üç çalışan başlatır. Ready kartlar önceliğe, konuma ve oluşturulma zamanına göre sıralanır, ardından yinelenen etkin sahipliği önlemek için filtrelenir. Bir dispatch aynı geçişte belirli bir sahip veya ajan için yalnızca bir kart başlatır ve panoda zaten running veya review işi olan sahipleri atlar.

Arşivlenmiş kartlar, etkin sahiplenmesi olan kartlar ve ready durumunda olmayan kartlar çalışan başlatmaları için seçilmez. Bayat sahiplenmeler, bağımlılık yükseltmesi veya zaman aşımı temizliği geçerliyse dispatch’in veri tarafı bunları yine de etkileyebilir.

Çalışan istemi ve yaşam döngüsü

Çalışan istemi kart başlığını, sınırlı notları ve bağlamı, atanmış panoyu ve Workboard çalışan protokolünü içerir. Ayrıca sahiplenme sahibini ve sahiplenme belirtecini içerir; böylece çalışan, başka bir aktör kartı devralmadan workboard_heartbeat, workboard_complete veya workboard_block çağırabilir.

Bir çalışan başarıyla başladığında Workboard oturum anahtarını, çalıştırma kimliğini, motoru, modu, model etiketini, durumu ve çalışan günlüğünü kartta saklar. Oturum anahtarı pano ve kart için deterministiktir; bu, tekrarlanan dispatch işlemlerinin ilgisiz oturumlar oluşturmak yerine aynı çalışan hattına geri yönlenmesini sağlar.

Bir kart sahiplenildikten sonra çalışan başlatılamazsa Workboard kartı engeller, sahiplenmeyi temizler, çalıştırma başlatma hatasını kaydeder ve bir çalışan günlük satırı ekler. Bu hata dashboard’da, CLI JSON’da, ajan araçlarında ve kart tanılamalarında görünür.

Dispatch giriş noktaları

Ready kart çalışan başlatmaları şuradan gerçekleşebilir:

• dashboard dispatch eylemi
• openclaw workboard dispatch
• komut destekli bir kanalda /workboard dispatch

Üç giriş noktası da Gateway kullanılabilir olduğunda Gateway alt ajan çalışma zamanını kullanır. CLI’ın fazladan bir operatör geri dönüşü vardır: Gateway çevrimdışıysa veya Workboard dispatch yöntemini sunmuyorsa ve açık bir --url veya --token hedefi sağlanmamışsa, yerel SQLite durumuna karşı yalnızca veri dispatch çalıştırır. Bu geri dönüş bağımlılıkları yükseltebilir, bayat sahiplenmeleri temizleyebilir ve zaman aşımına uğramış çalıştırmaları engelleyebilir, ancak çalışan başlatamaz.

Pano meta verileri autoDecompose, autoDecomposePerDispatch, defaultAssignee ve orchestratorProfile gibi orkestrasyon ayarlarını içerebilir. OpenClaw orkestrasyon niyetini kaydeder ve bunu çalışan bağlamında sunar; asıl belirtim ve ayrıştırma yine normal Workboard araçları üzerinden gerçekleşir.

CLI ve eğik çizgi komutu

Plugin bir kök CLI komutu kaydeder:

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

openclaw workboard dispatch, çalışan Gateway'i çağırır; böylece worker başlangıçları dashboard ile aynı subagent runtime'ını kullanır. Gateway kullanılamıyorsa, dependency promotion, stale-claim cleanup ve timeout blocking işlemleri yine de çalışabilsin diye yalnızca veriyle dispatch yapmaya geri döner. Auth, permission ve validation hataları komut hataları olarak görünmeye devam eder; açık --url veya --token hedeflerine yönelik hatalar da aynı şekilde görünür.

/workboard slash komutu aynı kompakt operatör yolunu destekler: /workboard list, /workboard show <card-id>, /workboard create <title> ve /workboard dispatch. List ve show, yetkili komut gönderenler için okuma işlemleridir. Create ve dispatch, sohbet yüzeylerinde owner durumu ya da operator.write veya operator.admin yetkisine sahip bir Gateway istemcisi gerektirir.

Komut bayrakları, JSON çıktısı, Gateway fallback davranışı, belirsiz olmayan id öneki işleme, dispatch seçim kuralları ve sorun giderme için Workboard CLI bölümüne bakın.

Oturum yaşam döngüsü senkronizasyonu

Kartlar, mevcut dashboard oturumlarına veya bir karttan çalışmayı başlattığınızda oluşturulan oturuma bağlanabilir. Bağlı kartlar oturum yaşam döngüsünü satır içinde gösterir: çalışıyor, stale, bağlı boşta, tamamlandı, başarısız veya eksik.

Bağlı oturum eksikse, kart bağlam için bağlı kalır ve çalışmayı yeni bir dashboard oturumunda yeniden başlatabilmeniz için başlatma kontrollerini sunmaya devam eder. Etkin bir bağlı oturum yakın tarihli etkinlik bildirmeyi durdurursa, Workboard kartı stale olarak işaretler ve yaşam döngüsü bunu temizleyene kadar işareti kart metadata'sı olarak saklar.

Mevcut bir dashboard oturumunu Sessions sekmesinden Workboard'a Ekle ile de yakalayabilirsiniz. Kart bu oturuma bağlanır, başlık olarak oturum etiketini veya yakın tarihli kullanıcı istemini kullanır ve sohbet geçmişi mevcut olduğunda yakın tarihli kullanıcı istemi ile en son assistant yanıtından notları başlatır.

Workboard, kart hâlâ etkin bir çalışma durumundayken bağlı oturumu izler:

• etkin bağlı oturum -> running
• tamamlanmış bağlı oturum -> review
• başarısız, öldürülmüş, zaman aşımına uğramış veya iptal edilmiş bağlı oturum -> blocked

Manuel review durumları önceliklidir. Bir kartı review, blocked veya done durumuna taşırsanız, Workboard siz kartı tekrar todo veya running durumuna taşıyana kadar o kartı otomatik taşımayı durdurur.

Dashboard iş akışı

1. Control UI içinde Workboard sekmesini açın.
2. Başlık, notlar, öncelik, etiketler, isteğe bağlı ajan ve isteğe bağlı bağlı oturum içeren bir kart oluşturun.
3. Ya da Sessions'ı açıp mevcut bir oturum için Workboard'a Ekle'yi seçin.
4. Kartı sütunlar arasında sürükleyin veya karttaki kompakt durum kontrolüne odaklanıp menüsünü ya da ArrowLeft/ArrowRight kullanın.
5. Bir dashboard oturumu oluşturmak veya yeniden kullanmak için çalışmayı karttan başlatın.
6. Ajan çalışırken bağlı oturumu karttan açın.
7. Yaşam döngüsü senkronizasyonunun çalışan işi review veya blocked durumuna taşımasına izin verin, ardından kabul edildiğinde kartı manuel olarak done durumuna taşıyın.

Bir kartı başlatmak normal Gateway oturumlarını kullanır. Workboard Plugin'i yalnızca kart metadata'sını ve bağlantıları saklar; konuşma transcript'i, model seçimi ve run yaşam döngüsü normal oturum sistemine ait kalır.

Canlı bağlı bir kartta Stop kullanarak etkin oturum run'ını iptal edin. Workboard, takip için görünür kalması amacıyla bu kartı blocked olarak işaretler.

Yeni kartlar bugfix'ler, docs, release'ler, PR review'ları veya Plugin çalışması için Workboard şablonlarından başlayabilir. Şablonlar başlık, notlar, etiketler ve önceliği önceden doldurur; seçilen şablon id'si kart metadata'sı olarak saklanır.

İzinler

Plugin, Gateway RPC yöntemlerini workboard.* namespace'i altında kaydeder:

• workboard.cards.list, operator.read gerektirir
• workboard.cards.export, operator.read gerektirir
• workboard.cards.diagnostics, operator.read gerektirir
• workboard.cards.diagnostics.refresh, operator.write gerektirir
• attachment list/get ve notification event okumaları operator.read gerektirir
• notification cursor ilerletme operator.write gerektirir
• 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 ve archive yöntemleri operator.write gerektirir

Salt okunur operatör erişimiyle bağlanan tarayıcılar panoyu inceleyebilir, ancak kartları değiştiremez.

Yapılandırma

Workboard'un bugün Plugin'e özgü bir config'i yoktur. Standart Plugin girdisiyle etkinleştirin veya devre dışı bırakın:

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

Tekrar devre dışı bırakmak için:

openclaw plugins disable workboardopenclaw gateway restart

Sorun giderme

Sekme Workboard kullanılamıyor diyor

Plugin policy'sini kontrol edin:

openclaw plugins inspect workboard --runtime --json

plugins.allow yapılandırılmışsa, bu allowlist'e workboard ekleyin. plugins.deny, workboard içeriyorsa Plugin'i etkinleştirmeden önce kaldırın.

Kartlar kaydedilmiyor

Tarayıcı bağlantısının operator.write erişimine sahip olduğunu doğrulayın. Salt okunur operatör oturumları kartları listeleyebilir, ancak onları oluşturamaz, düzenleyemez, taşıyamaz veya silemez.

Bir kartı başlatmak beklenen oturumu açmıyor

Workboard normal dashboard oturumlarına bağlantılar oluşturur. Kartın ajan id'sini ve bağlı oturumu kontrol edin, ardından gerçek run durumunu incelemek için Sessions veya Chat görünümünü açın.

Dispatch bir worker başlatmıyor

Etkin claim'i olmayan en az bir ready kart bulunduğunu doğrulayın:

openclaw workboard list --status ready

CLI yalnızca veriyle dispatch bildiriyorsa, Gateway'i başlatın veya yeniden başlatın ve tekrar deneyin. Yalnızca veriyle dispatch yerel pano durumunu günceller, ancak subagent worker run'larını başlatamaz.

Aynı owner veya ajan için başka bir kart zaten çalışıyorsa ya da review bekliyorsa, kartlar atlanabilir. Aynı owner için daha fazla çalışma dispatch etmeden önce bu etkin çalışmayı tamamlayın, block edin veya release edin.

İlgili

• Control UI
• Workboard CLI
• Plugin'ler
• Plugin'leri yönet
• Oturumlar