feat: refactor sgclaw around zeroclaw compat runtime

2026-03-26 16:23:31 +08:00
parent bca5b75801
commit ff0771a83f
1059 changed files with 409460 additions and 23 deletions
--- a/third_party/zeroclaw/docs/README.ar.md
+++ b/third_party/zeroclaw/docs/README.ar.md
@@ -0,0 +1,96 @@
+# مركز توثيق ZeroClaw
+
+هذه الصفحة هي نقطة الدخول الرئيسية لنظام التوثيق.
+
+آخر تحديث: **20 فبراير 2026**.
+
+المراكز المترجمة: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## ابدأ من هنا
+
+| أريد أن…                                                            | اقرأ هذا                                                                       |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| تثبيت وتشغيل ZeroClaw بسرعة                                        | [README.md (البدء السريع)](../README.md#quick-start)                           |
+| إعداد بأمر واحد                                                     | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| البحث عن أوامر حسب المهمة                                           | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| التحقق السريع من مفاتيح وقيم الإعدادات الافتراضية                   | [config-reference.md](reference/api/config-reference.md)                       |
+| إعداد مزودين/نقاط وصول مخصصة                                       | [custom-providers.md](contributing/custom-providers.md)                         |
+| إعداد مزود Z.AI / GLM                                               | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| استخدام أنماط تكامل LangGraph                                       | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| تشغيل بيئة التنفيذ (دليل العمليات اليومية)                          | [operations-runbook.md](ops/operations-runbook.md)                             |
+| استكشاف مشاكل التثبيت/التشغيل/القنوات وإصلاحها                     | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| تشغيل إعداد وتشخيص غرف Matrix المشفرة                               | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| تصفح التوثيق حسب الفئة                                              | [SUMMARY.md](SUMMARY.md)                                                       |
+| عرض لقطة توثيق طلبات السحب/المشاكل                                  | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## شجرة القرار السريعة (10 ثوانٍ)
+
+- تحتاج إلى الإعداد أو التثبيت الأولي؟ ← [setup-guides/README.md](setup-guides/README.md)
+- تحتاج مفاتيح CLI/الإعدادات بالتحديد؟ ← [reference/README.md](reference/README.md)
+- تحتاج عمليات الإنتاج/الخدمة؟ ← [ops/README.md](ops/README.md)
+- ترى أعطالاً أو تراجعات؟ ← [troubleshooting.md](ops/troubleshooting.md)
+- تعمل على تقوية الأمان أو خارطة الطريق؟ ← [security/README.md](security/README.md)
+- تعمل مع لوحات/أجهزة طرفية؟ ← [hardware/README.md](hardware/README.md)
+- المساهمة/المراجعة/سير عمل CI؟ ← [contributing/README.md](contributing/README.md)
+- تريد الخريطة الكاملة؟ ← [SUMMARY.md](SUMMARY.md)
+
+## المجموعات (موصى بها)
+
+- البدء: [setup-guides/README.md](setup-guides/README.md)
+- كتالوجات المراجع: [reference/README.md](reference/README.md)
+- العمليات والنشر: [ops/README.md](ops/README.md)
+- توثيق الأمان: [security/README.md](security/README.md)
+- العتاد/الأجهزة الطرفية: [hardware/README.md](hardware/README.md)
+- المساهمة/CI: [contributing/README.md](contributing/README.md)
+- لقطات المشروع: [maintainers/README.md](maintainers/README.md)
+
+## حسب الجمهور
+
+### المستخدمون / المشغّلون
+
+- [commands-reference.md](reference/cli/commands-reference.md) — البحث عن أوامر حسب سير العمل
+- [providers-reference.md](reference/api/providers-reference.md) — معرّفات المزودين، الأسماء المستعارة، متغيرات بيئة بيانات الاعتماد
+- [channels-reference.md](reference/api/channels-reference.md) — قدرات القنوات ومسارات الإعداد
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — إعداد غرف Matrix المشفرة (E2EE) وتشخيص عدم الاستجابة
+- [config-reference.md](reference/api/config-reference.md) — مفاتيح الإعدادات عالية الأهمية والقيم الافتراضية الآمنة
+- [custom-providers.md](contributing/custom-providers.md) — أنماط تكامل المزود المخصص/عنوان URL الأساسي
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — إعداد Z.AI/GLM ومصفوفة نقاط الوصول
+- [langgraph-integration.md](contributing/langgraph-integration.md) — تكامل احتياطي لحالات حدود النموذج/استدعاء الأدوات
+- [operations-runbook.md](ops/operations-runbook.md) — عمليات التشغيل اليومية وتدفقات التراجع
+- [troubleshooting.md](ops/troubleshooting.md) — بصمات الأعطال الشائعة وخطوات الاسترداد
+
+### المساهمون / المشرفون
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### الأمان / الموثوقية
+
+> ملاحظة: يتضمن هذا القسم مستندات مقترحات/خارطة طريق. للسلوك الحالي، ابدأ بـ [config-reference.md](reference/api/config-reference.md) و[operations-runbook.md](ops/operations-runbook.md) و[troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## التنقل في النظام والحوكمة
+
+- جدول المحتويات الموحد: [SUMMARY.md](SUMMARY.md)
+- خريطة هيكل التوثيق (اللغة/القسم/الوظيفة): [structure/README.md](maintainers/structure-README.md)
+- جرد/تصنيف التوثيق: [docs-inventory.md](maintainers/docs-inventory.md)
+- لقطة فرز المشروع: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## لغات أخرى
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.bn.md
+++ b/third_party/zeroclaw/docs/README.bn.md
@@ -0,0 +1,96 @@
+# ZeroClaw ডকুমেন্টেশন হাব
+
+এই পৃষ্ঠাটি ডকুমেন্টেশন সিস্টেমের প্রধান প্রবেশ বিন্দু।
+
+সর্বশেষ আপডেট: **২০ ফেব্রুয়ারি ২০২৬**।
+
+স্থানীয়কৃত হাব: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## এখান থেকে শুরু করুন
+
+| আমি চাই…                                                            | এটি পড়ুন                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| দ্রুত ZeroClaw ইনস্টল ও চালু করতে                                   | [README.md (দ্রুত শুরু)](../README.md#quick-start)                             |
+| এক-ক্লিকে বুটস্ট্র্যাপ করতে                                        | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| কাজ অনুযায়ী কমান্ড খুঁজতে                                          | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| দ্রুত কনফিগ কী ও ডিফল্ট মান যাচাই করতে                             | [config-reference.md](reference/api/config-reference.md)                       |
+| কাস্টম প্রোভাইডার/এন্ডপয়েন্ট সেটআপ করতে                           | [custom-providers.md](contributing/custom-providers.md)                         |
+| Z.AI / GLM প্রোভাইডার সেটআপ করতে                                    | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| LangGraph ইন্টিগ্রেশন প্যাটার্ন ব্যবহার করতে                       | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| রানটাইম পরিচালনা করতে (দৈনন্দিন অপারেশন গাইড)                      | [operations-runbook.md](ops/operations-runbook.md)                             |
+| ইনস্টলেশন/রানটাইম/চ্যানেল সমস্যা সমাধান করতে                       | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Matrix এনক্রিপ্টেড রুম সেটআপ ও ডায়াগনস্টিক চালাতে                 | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| বিভাগ অনুযায়ী ডকুমেন্টেশন ব্রাউজ করতে                              | [SUMMARY.md](SUMMARY.md)                                                       |
+| প্রকল্পের PR/ইস্যু ডক স্ন্যাপশট দেখতে                              | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## দ্রুত সিদ্ধান্ত গাছ (১০ সেকেন্ড)
+
+- সেটআপ বা প্রাথমিক ইনস্টলেশন দরকার? → [setup-guides/README.md](setup-guides/README.md)
+- সুনির্দিষ্ট CLI/কনফিগ কী দরকার? → [reference/README.md](reference/README.md)
+- প্রোডাকশন/সার্ভিস অপারেশন দরকার? → [ops/README.md](ops/README.md)
+- ব্যর্থতা বা রিগ্রেশন দেখছেন? → [troubleshooting.md](ops/troubleshooting.md)
+- নিরাপত্তা শক্তিশালীকরণ বা রোডম্যাপে কাজ করছেন? → [security/README.md](security/README.md)
+- বোর্ড/পেরিফেরাল নিয়ে কাজ করছেন? → [hardware/README.md](hardware/README.md)
+- অবদান/রিভিউ/CI ওয়ার্কফ্লো? → [contributing/README.md](contributing/README.md)
+- সম্পূর্ণ মানচিত্র চান? → [SUMMARY.md](SUMMARY.md)
+
+## সংগ্রহ (প্রস্তাবিত)
+
+- শুরু করুন: [setup-guides/README.md](setup-guides/README.md)
+- রেফারেন্স ক্যাটালগ: [reference/README.md](reference/README.md)
+- অপারেশন ও ডিপ্লয়মেন্ট: [ops/README.md](ops/README.md)
+- নিরাপত্তা ডকুমেন্টেশন: [security/README.md](security/README.md)
+- হার্ডওয়্যার/পেরিফেরাল: [hardware/README.md](hardware/README.md)
+- অবদান/CI: [contributing/README.md](contributing/README.md)
+- প্রকল্প স্ন্যাপশট: [maintainers/README.md](maintainers/README.md)
+
+## দর্শক অনুযায়ী
+
+### ব্যবহারকারী / অপারেটর
+
+- [commands-reference.md](reference/cli/commands-reference.md) — ওয়ার্কফ্লো অনুযায়ী কমান্ড খোঁজা
+- [providers-reference.md](reference/api/providers-reference.md) — প্রোভাইডার আইডি, উপনাম, ক্রেডেনশিয়াল এনভায়রনমেন্ট ভেরিয়েবল
+- [channels-reference.md](reference/api/channels-reference.md) — চ্যানেল সক্ষমতা ও কনফিগারেশন পাথ
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix এনক্রিপ্টেড রুম (E2EE) সেটআপ ও সাড়া না দেওয়ার ডায়াগনস্টিক
+- [config-reference.md](reference/api/config-reference.md) — উচ্চ-গুরুত্বপূর্ণ কনফিগ কী ও নিরাপদ ডিফল্ট
+- [custom-providers.md](contributing/custom-providers.md) — কাস্টম প্রোভাইডার/বেস URL ইন্টিগ্রেশন প্যাটার্ন
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM সেটআপ ও এন্ডপয়েন্ট ম্যাট্রিক্স
+- [langgraph-integration.md](contributing/langgraph-integration.md) — মডেল/টুল-কল এজ কেসের জন্য ফলব্যাক ইন্টিগ্রেশন
+- [operations-runbook.md](ops/operations-runbook.md) — দৈনন্দিন রানটাইম অপারেশন ও রোলব্যাক ফ্লো
+- [troubleshooting.md](ops/troubleshooting.md) — সাধারণ ব্যর্থতার স্বাক্ষর ও পুনরুদ্ধার পদক্ষেপ
+
+### অবদানকারী / রক্ষণাবেক্ষণকারী
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### নিরাপত্তা / নির্ভরযোগ্যতা
+
+> দ্রষ্টব্য: এই বিভাগে প্রস্তাবনা/রোডম্যাপ ডকুমেন্ট রয়েছে। বর্তমান আচরণের জন্য [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), এবং [troubleshooting.md](ops/troubleshooting.md) দিয়ে শুরু করুন।
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## সিস্টেম নেভিগেশন ও গভর্ন্যান্স
+
+- একীভূত সূচিপত্র: [SUMMARY.md](SUMMARY.md)
+- ডক কাঠামো মানচিত্র (ভাষা/অংশ/ফাংশন): [structure/README.md](maintainers/structure-README.md)
+- ডকুমেন্টেশন তালিকা/শ্রেণীবিভাগ: [docs-inventory.md](maintainers/docs-inventory.md)
+- প্রকল্প ট্রায়াজ স্ন্যাপশট: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## অন্যান্য ভাষা
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.cs.md
+++ b/third_party/zeroclaw/docs/README.cs.md
@@ -0,0 +1,96 @@
+# Dokumentační hub ZeroClaw
+
+Tato stránka je hlavním vstupním bodem do dokumentačního systému.
+
+Poslední aktualizace: **20. února 2026**.
+
+Lokalizované huby: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Začněte zde
+
+| Chci…                                                                | Přečtěte si toto                                                               |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Rychle nainstalovat a spustit ZeroClaw                              | [README.md (Rychlý start)](../README.md#quick-start)                           |
+| Bootstrap jedním příkazem                                           | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Najít příkazy podle úkolu                                           | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Rychle ověřit konfigurační klíče a výchozí hodnoty                  | [config-reference.md](reference/api/config-reference.md)                       |
+| Nastavit vlastní poskytovatele/endpointy                            | [custom-providers.md](contributing/custom-providers.md)                         |
+| Nastavit poskytovatele Z.AI / GLM                                   | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Použít integrační vzory LangGraph                                   | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Provozovat runtime (provozní příručka)                              | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Řešit problémy s instalací/runtime/kanály                           | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Spustit nastavení a diagnostiku šifrovaných místností Matrix        | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Procházet dokumentaci podle kategorie                               | [SUMMARY.md](SUMMARY.md)                                                       |
+| Zobrazit snapshot dokumentace PR/issues projektu                    | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Rychlý rozhodovací strom (10 sekund)
+
+- Potřebujete nastavení nebo počáteční instalaci? → [setup-guides/README.md](setup-guides/README.md)
+- Potřebujete přesné CLI/konfigurační klíče? → [reference/README.md](reference/README.md)
+- Potřebujete produkční/servisní operace? → [ops/README.md](ops/README.md)
+- Vidíte selhání nebo regrese? → [troubleshooting.md](ops/troubleshooting.md)
+- Pracujete na posílení zabezpečení nebo roadmapě? → [security/README.md](security/README.md)
+- Pracujete s deskami/periferiemi? → [hardware/README.md](hardware/README.md)
+- Přispívání/revize/CI workflow? → [contributing/README.md](contributing/README.md)
+- Chcete kompletní mapu? → [SUMMARY.md](SUMMARY.md)
+
+## Kolekce (doporučené)
+
+- Začínáme: [setup-guides/README.md](setup-guides/README.md)
+- Referenční katalogy: [reference/README.md](reference/README.md)
+- Provoz a nasazení: [ops/README.md](ops/README.md)
+- Dokumentace zabezpečení: [security/README.md](security/README.md)
+- Hardware/periferie: [hardware/README.md](hardware/README.md)
+- Přispívání/CI: [contributing/README.md](contributing/README.md)
+- Snapshoty projektu: [maintainers/README.md](maintainers/README.md)
+
+## Podle publika
+
+### Uživatelé / Operátoři
+
+- [commands-reference.md](reference/cli/commands-reference.md) — vyhledávání příkazů podle workflow
+- [providers-reference.md](reference/api/providers-reference.md) — ID poskytovatelů, aliasy, proměnné prostředí pro přihlašovací údaje
+- [channels-reference.md](reference/api/channels-reference.md) — schopnosti kanálů a konfigurační cesty
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — nastavení šifrovaných místností Matrix (E2EE) a diagnostika nereagování
+- [config-reference.md](reference/api/config-reference.md) — klíčové konfigurační hodnoty a bezpečné výchozí nastavení
+- [custom-providers.md](contributing/custom-providers.md) — vzory integrace vlastního poskytovatele/base URL
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — nastavení Z.AI/GLM a matice endpointů
+- [langgraph-integration.md](contributing/langgraph-integration.md) — záložní integrace pro okrajové případy modelu/volání nástrojů
+- [operations-runbook.md](ops/operations-runbook.md) — každodenní runtime operace a postupy rollbacku
+- [troubleshooting.md](ops/troubleshooting.md) — běžné signatury selhání a kroky obnovy
+
+### Přispěvatelé / Správci
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Zabezpečení / Spolehlivost
+
+> Poznámka: tato sekce zahrnuje dokumenty návrhů/roadmapy. Pro aktuální chování začněte s [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) a [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Systémová navigace a správa
+
+- Jednotný obsah: [SUMMARY.md](SUMMARY.md)
+- Mapa struktury dokumentace (jazyk/část/funkce): [structure/README.md](maintainers/structure-README.md)
+- Inventář/klasifikace dokumentace: [docs-inventory.md](maintainers/docs-inventory.md)
+- Snapshot třídění projektu: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Další jazyky
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.da.md
+++ b/third_party/zeroclaw/docs/README.da.md
@@ -0,0 +1,96 @@
+# ZeroClaw Dokumentationshub
+
+Denne side er det primære indgangspunkt til dokumentationssystemet.
+
+Sidst opdateret: **20. februar 2026**.
+
+Lokaliserede hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Start her
+
+| Jeg vil…                                                             | Læs dette                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Hurtigt installere og køre ZeroClaw                                 | [README.md (Hurtig start)](../README.md#quick-start)                           |
+| Bootstrap med én kommando                                           | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Finde kommandoer efter opgave                                       | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Hurtigt tjekke konfigurationsnøgler og standardværdier              | [config-reference.md](reference/api/config-reference.md)                       |
+| Opsætte brugerdefinerede udbydere/endpoints                         | [custom-providers.md](contributing/custom-providers.md)                         |
+| Opsætte Z.AI / GLM-udbyderen                                       | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Bruge LangGraph-integrationsmønstre                                 | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Drifte runtime (driftshåndbog)                                      | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Fejlfinde installations-/runtime-/kanalproblemer                    | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Køre opsætning og diagnostik for krypterede Matrix-rum              | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Gennemse dokumentation efter kategori                               | [SUMMARY.md](SUMMARY.md)                                                       |
+| Se projektets PR/issue-dokumentationssnapshot                       | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Hurtigt beslutningstræ (10 sekunder)
+
+- Har du brug for opsætning eller førstegangsinstallation? → [setup-guides/README.md](setup-guides/README.md)
+- Har du brug for præcise CLI/konfigurationsnøgler? → [reference/README.md](reference/README.md)
+- Har du brug for produktions-/servicedrift? → [ops/README.md](ops/README.md)
+- Ser du fejl eller regressioner? → [troubleshooting.md](ops/troubleshooting.md)
+- Arbejder du på sikkerhedshærdning eller roadmap? → [security/README.md](security/README.md)
+- Arbejder du med boards/periferienheder? → [hardware/README.md](hardware/README.md)
+- Bidrag/review/CI-workflow? → [contributing/README.md](contributing/README.md)
+- Vil du se det fulde kort? → [SUMMARY.md](SUMMARY.md)
+
+## Samlinger (anbefalet)
+
+- Kom i gang: [setup-guides/README.md](setup-guides/README.md)
+- Referencekataloger: [reference/README.md](reference/README.md)
+- Drift og udrulning: [ops/README.md](ops/README.md)
+- Sikkerhedsdokumentation: [security/README.md](security/README.md)
+- Hardware/periferienheder: [hardware/README.md](hardware/README.md)
+- Bidrag/CI: [contributing/README.md](contributing/README.md)
+- Projektsnapshots: [maintainers/README.md](maintainers/README.md)
+
+## Efter målgruppe
+
+### Brugere / Operatører
+
+- [commands-reference.md](reference/cli/commands-reference.md) — kommandoopslag efter workflow
+- [providers-reference.md](reference/api/providers-reference.md) — udbyder-ID'er, aliaser, legitimationsoplysningers miljøvariabler
+- [channels-reference.md](reference/api/channels-reference.md) — kanalegenskaber og konfigurationsstier
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — opsætning af krypterede Matrix-rum (E2EE) og diagnostik ved manglende svar
+- [config-reference.md](reference/api/config-reference.md) — vigtige konfigurationsnøgler og sikre standardværdier
+- [custom-providers.md](contributing/custom-providers.md) — integrationsmønstre for brugerdefineret udbyder/base-URL
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM-opsætning og endpoint-matrix
+- [langgraph-integration.md](contributing/langgraph-integration.md) — fallback-integration for model/tool-call-edgecases
+- [operations-runbook.md](ops/operations-runbook.md) — daglig runtime-drift og rollback-flows
+- [troubleshooting.md](ops/troubleshooting.md) — almindelige fejlsignaturer og genoprettelsestrin
+
+### Bidragydere / Vedligeholdere
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Sikkerhed / Pålidelighed
+
+> Bemærk: dette afsnit inkluderer forslags-/roadmap-dokumenter. For aktuel adfærd, start med [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) og [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Systemnavigation og governance
+
+- Samlet indholdsfortegnelse: [SUMMARY.md](SUMMARY.md)
+- Dokumentationsstrukturkort (sprog/del/funktion): [structure/README.md](maintainers/structure-README.md)
+- Dokumentationsinventar/-klassificering: [docs-inventory.md](maintainers/docs-inventory.md)
+- Projekt-triage-snapshot: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Andre sprog
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.de.md
+++ b/third_party/zeroclaw/docs/README.de.md
@@ -0,0 +1,96 @@
+# ZeroClaw Dokumentations-Hub
+
+Diese Seite ist der zentrale Einstiegspunkt in das Dokumentationssystem.
+
+Zuletzt aktualisiert: **20. Februar 2026**.
+
+Lokalisierte Hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Hier starten
+
+| Ich möchte…                                                          | Dies lesen                                                                     |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| ZeroClaw schnell installieren und starten                           | [README.md (Schnellstart)](../README.md#quick-start)                           |
+| Bootstrap mit einem Befehl                                          | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Befehle nach Aufgabe finden                                         | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Schnell Konfigurationsschlüssel und Standardwerte prüfen            | [config-reference.md](reference/api/config-reference.md)                       |
+| Benutzerdefinierte Anbieter/Endpunkte einrichten                    | [custom-providers.md](contributing/custom-providers.md)                         |
+| Den Z.AI / GLM-Anbieter einrichten                                  | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| LangGraph-Integrationsmuster verwenden                              | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Die Laufzeitumgebung betreiben (Betriebshandbuch)                   | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Installations-/Laufzeit-/Kanalprobleme beheben                     | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Matrix-verschlüsselte-Raum-Einrichtung und Diagnose ausführen       | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Dokumentation nach Kategorie durchsuchen                            | [SUMMARY.md](SUMMARY.md)                                                       |
+| Projekt-PR/Issue-Dokumentations-Snapshot ansehen                    | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Schneller Entscheidungsbaum (10 Sekunden)
+
+- Einrichtung oder Erstinstallation nötig? → [setup-guides/README.md](setup-guides/README.md)
+- Genaue CLI-/Konfigurationsschlüssel benötigt? → [reference/README.md](reference/README.md)
+- Produktions-/Servicebetrieb benötigt? → [ops/README.md](ops/README.md)
+- Fehler oder Regressionen sichtbar? → [troubleshooting.md](ops/troubleshooting.md)
+- Arbeiten an Sicherheitshärtung oder Roadmap? → [security/README.md](security/README.md)
+- Arbeiten mit Boards/Peripheriegeräten? → [hardware/README.md](hardware/README.md)
+- Beitragen/Review/CI-Workflow? → [contributing/README.md](contributing/README.md)
+- Vollständige Karte gewünscht? → [SUMMARY.md](SUMMARY.md)
+
+## Sammlungen (empfohlen)
+
+- Einstieg: [setup-guides/README.md](setup-guides/README.md)
+- Referenzkataloge: [reference/README.md](reference/README.md)
+- Betrieb und Bereitstellung: [ops/README.md](ops/README.md)
+- Sicherheitsdokumentation: [security/README.md](security/README.md)
+- Hardware/Peripheriegeräte: [hardware/README.md](hardware/README.md)
+- Beitragen/CI: [contributing/README.md](contributing/README.md)
+- Projekt-Snapshots: [maintainers/README.md](maintainers/README.md)
+
+## Nach Zielgruppe
+
+### Benutzer / Betreiber
+
+- [commands-reference.md](reference/cli/commands-reference.md) — Befehlssuche nach Workflow
+- [providers-reference.md](reference/api/providers-reference.md) — Anbieter-IDs, Aliase, Umgebungsvariablen für Anmeldedaten
+- [channels-reference.md](reference/api/channels-reference.md) — Kanalfähigkeiten und Konfigurationspfade
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix-verschlüsselter-Raum-Einrichtung (E2EE) und Diagnose bei ausbleibender Antwort
+- [config-reference.md](reference/api/config-reference.md) — wichtige Konfigurationsschlüssel und sichere Standardwerte
+- [custom-providers.md](contributing/custom-providers.md) — Integrationsmuster für benutzerdefinierte Anbieter/Basis-URL
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM-Einrichtung und Endpunkt-Matrix
+- [langgraph-integration.md](contributing/langgraph-integration.md) — Fallback-Integration für Modell-/Tool-Call-Grenzfälle
+- [operations-runbook.md](ops/operations-runbook.md) — täglicher Laufzeitbetrieb und Rollback-Abläufe
+- [troubleshooting.md](ops/troubleshooting.md) — häufige Fehlersignaturen und Wiederherstellungsschritte
+
+### Mitwirkende / Betreuer
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Sicherheit / Zuverlässigkeit
+
+> Hinweis: Dieser Bereich enthält Vorschlags-/Roadmap-Dokumente. Für das aktuelle Verhalten beginnen Sie mit [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) und [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Systemnavigation und Governance
+
+- Einheitliches Inhaltsverzeichnis: [SUMMARY.md](SUMMARY.md)
+- Dokumentationsstrukturkarte (Sprache/Teil/Funktion): [structure/README.md](maintainers/structure-README.md)
+- Dokumentationsinventar/-klassifizierung: [docs-inventory.md](maintainers/docs-inventory.md)
+- Projekt-Triage-Snapshot: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Andere Sprachen
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.el.md
+++ b/third_party/zeroclaw/docs/README.el.md
@@ -0,0 +1,96 @@
+# Κέντρο Τεκμηρίωσης ZeroClaw
+
+Αυτή η σελίδα είναι το κύριο σημείο εισόδου για το σύστημα τεκμηρίωσης.
+
+Τελευταία ενημέρωση: **20 Φεβρουαρίου 2026**.
+
+Τοπικοποιημένα κέντρα: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Ξεκινήστε Εδώ
+
+| Θέλω να…                                                            | Διαβάστε αυτό                                                                  |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Εγκαταστήσω και εκτελέσω το ZeroClaw γρήγορα                       | [README.md (Γρήγορη Εκκίνηση)](../README.md#quick-start)                      |
+| Εκκίνηση με μία εντολή                                              | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| Βρω εντολές ανά εργασία                                             | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Ελέγξω γρήγορα κλειδιά και προεπιλογές ρυθμίσεων                   | [config-reference.md](reference/api/config-reference.md)                       |
+| Ρυθμίσω προσαρμοσμένους παρόχους/endpoints                         | [custom-providers.md](contributing/custom-providers.md)                        |
+| Ρυθμίσω τον πάροχο Z.AI / GLM                                      | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| Χρησιμοποιήσω τα πρότυπα ενσωμάτωσης LangGraph                     | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| Λειτουργήσω το runtime (runbook ημέρας-2)                           | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Αντιμετωπίσω προβλήματα εγκατάστασης/runtime/καναλιού               | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Εκτελέσω ρύθμιση και διαγνωστικά κρυπτογραφημένων δωματίων Matrix  | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| Περιηγηθώ στα έγγραφα ανά κατηγορία                                 | [SUMMARY.md](SUMMARY.md)                                                      |
+| Δω το στιγμιότυπο εγγράφων PR/issues του έργου                     | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Δέντρο Γρήγορης Απόφασης (10 δευτερόλεπτα)
+
+- Χρειάζεστε αρχική ρύθμιση ή εγκατάσταση; → [setup-guides/README.md](setup-guides/README.md)
+- Χρειάζεστε ακριβή κλειδιά CLI/ρυθμίσεων; → [reference/README.md](reference/README.md)
+- Χρειάζεστε λειτουργίες παραγωγής/υπηρεσίας; → [ops/README.md](ops/README.md)
+- Βλέπετε αποτυχίες ή παλινδρομήσεις; → [troubleshooting.md](ops/troubleshooting.md)
+- Εργάζεστε στη σκλήρυνση ασφαλείας ή τον οδικό χάρτη; → [security/README.md](security/README.md)
+- Εργάζεστε με πλακέτες/περιφερειακά; → [hardware/README.md](hardware/README.md)
+- Συνεισφορά/αξιολόγηση/ροή εργασίας CI; → [contributing/README.md](contributing/README.md)
+- Θέλετε τον πλήρη χάρτη; → [SUMMARY.md](SUMMARY.md)
+
+## Συλλογές (Συνιστώνται)
+
+- Εκκίνηση: [setup-guides/README.md](setup-guides/README.md)
+- Κατάλογοι αναφοράς: [reference/README.md](reference/README.md)
+- Λειτουργίες & ανάπτυξη: [ops/README.md](ops/README.md)
+- Έγγραφα ασφαλείας: [security/README.md](security/README.md)
+- Υλικό/περιφερειακά: [hardware/README.md](hardware/README.md)
+- Συνεισφορά/CI: [contributing/README.md](contributing/README.md)
+- Στιγμιότυπα έργου: [maintainers/README.md](maintainers/README.md)
+
+## Ανά Κοινό
+
+### Χρήστες / Χειριστές
+
+- [commands-reference.md](reference/cli/commands-reference.md) — αναζήτηση εντολών ανά ροή εργασίας
+- [providers-reference.md](reference/api/providers-reference.md) — αναγνωριστικά παρόχων, ψευδώνυμα, μεταβλητές περιβάλλοντος διαπιστευτηρίων
+- [channels-reference.md](reference/api/channels-reference.md) — δυνατότητες καναλιών και διαδρομές ρύθμισης
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — ρύθμιση κρυπτογραφημένων δωματίων Matrix (E2EE) και διαγνωστικά μη-απόκρισης
+- [config-reference.md](reference/api/config-reference.md) — κλειδιά ρυθμίσεων υψηλής σήμανσης και ασφαλείς προεπιλογές
+- [custom-providers.md](contributing/custom-providers.md) — πρότυπα ενσωμάτωσης προσαρμοσμένου παρόχου/βασικού URL
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — ρύθμιση Z.AI/GLM και πίνακας endpoints
+- [langgraph-integration.md](contributing/langgraph-integration.md) — εφεδρική ενσωμάτωση για ακραίες περιπτώσεις μοντέλου/κλήσης εργαλείου
+- [operations-runbook.md](ops/operations-runbook.md) — λειτουργίες runtime ημέρας-2 και ροές επαναφοράς
+- [troubleshooting.md](ops/troubleshooting.md) — συνήθεις υπογραφές αποτυχίας και βήματα αποκατάστασης
+
+### Συνεισφέροντες / Συντηρητές
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Ασφάλεια / Αξιοπιστία
+
+> Σημείωση: αυτή η περιοχή περιλαμβάνει έγγραφα πρότασης/οδικού χάρτη. Για την τρέχουσα συμπεριφορά, ξεκινήστε από [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), και [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Πλοήγηση Συστήματος & Διακυβέρνηση
+
+- Ενοποιημένος πίνακας περιεχομένων: [SUMMARY.md](SUMMARY.md)
+- Χάρτης δομής εγγράφων (γλώσσα/τμήμα/λειτουργία): [structure/README.md](maintainers/structure-README.md)
+- Απογραφή/ταξινόμηση τεκμηρίωσης: [docs-inventory.md](maintainers/docs-inventory.md)
+- Στιγμιότυπο διαλογής έργου: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Άλλες γλώσσες
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.es.md
+++ b/third_party/zeroclaw/docs/README.es.md
@@ -0,0 +1,96 @@
+# Centro de Documentación ZeroClaw
+
+Esta página es el punto de entrada principal del sistema de documentación.
+
+Última actualización: **20 de febrero de 2026**.
+
+Centros localizados: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Comience Aquí
+
+| Quiero…                                                             | Leer esto                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Instalar y ejecutar ZeroClaw rápidamente                            | [README.md (Inicio Rápido)](../README.md#quick-start)                          |
+| Arranque con un solo comando                                        | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| Encontrar comandos por tarea                                        | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Verificar rápidamente claves y valores predeterminados de config    | [config-reference.md](reference/api/config-reference.md)                       |
+| Configurar proveedores/endpoints personalizados                     | [custom-providers.md](contributing/custom-providers.md)                        |
+| Configurar el proveedor Z.AI / GLM                                  | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| Usar los patrones de integración LangGraph                          | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| Operar el runtime (runbook día-2)                                   | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Solucionar problemas de instalación/runtime/canal                   | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Ejecutar configuración y diagnósticos de salas cifradas Matrix      | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| Navegar la documentación por categoría                              | [SUMMARY.md](SUMMARY.md)                                                      |
+| Ver la instantánea de docs de PR/issues del proyecto                | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Árbol de Decisión Rápida (10 segundos)
+
+- ¿Necesita configuración o instalación inicial? → [setup-guides/README.md](setup-guides/README.md)
+- ¿Necesita claves exactas de CLI/configuración? → [reference/README.md](reference/README.md)
+- ¿Necesita operaciones de producción/servicio? → [ops/README.md](ops/README.md)
+- ¿Ve fallos o regresiones? → [troubleshooting.md](ops/troubleshooting.md)
+- ¿Trabaja en endurecimiento de seguridad o hoja de ruta? → [security/README.md](security/README.md)
+- ¿Trabaja con placas/periféricos? → [hardware/README.md](hardware/README.md)
+- ¿Contribución/revisión/flujo de trabajo CI? → [contributing/README.md](contributing/README.md)
+- ¿Quiere el mapa completo? → [SUMMARY.md](SUMMARY.md)
+
+## Colecciones (Recomendadas)
+
+- Inicio: [setup-guides/README.md](setup-guides/README.md)
+- Catálogos de referencia: [reference/README.md](reference/README.md)
+- Operaciones y despliegue: [ops/README.md](ops/README.md)
+- Documentación de seguridad: [security/README.md](security/README.md)
+- Hardware/periféricos: [hardware/README.md](hardware/README.md)
+- Contribución/CI: [contributing/README.md](contributing/README.md)
+- Instantáneas del proyecto: [maintainers/README.md](maintainers/README.md)
+
+## Por Audiencia
+
+### Usuarios / Operadores
+
+- [commands-reference.md](reference/cli/commands-reference.md) — búsqueda de comandos por flujo de trabajo
+- [providers-reference.md](reference/api/providers-reference.md) — IDs de proveedores, alias, variables de entorno de credenciales
+- [channels-reference.md](reference/api/channels-reference.md) — capacidades de canales y rutas de configuración
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — configuración de salas cifradas Matrix (E2EE) y diagnósticos de no-respuesta
+- [config-reference.md](reference/api/config-reference.md) — claves de configuración de alta señalización y valores predeterminados seguros
+- [custom-providers.md](contributing/custom-providers.md) — patrones de integración de proveedor personalizado/URL base
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — configuración Z.AI/GLM y matriz de endpoints
+- [langgraph-integration.md](contributing/langgraph-integration.md) — integración de respaldo para casos límite de modelo/llamada de herramienta
+- [operations-runbook.md](ops/operations-runbook.md) — operaciones runtime día-2 y flujos de rollback
+- [troubleshooting.md](ops/troubleshooting.md) — firmas de fallo comunes y pasos de recuperación
+
+### Contribuidores / Mantenedores
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Seguridad / Fiabilidad
+
+> Nota: esta zona incluye documentos de propuesta/hoja de ruta. Para el comportamiento actual, comience por [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), y [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Navegación del Sistema y Gobernanza
+
+- Tabla de contenidos unificada: [SUMMARY.md](SUMMARY.md)
+- Mapa de estructura de docs (idioma/sección/función): [structure/README.md](maintainers/structure-README.md)
+- Inventario/clasificación de la documentación: [docs-inventory.md](maintainers/docs-inventory.md)
+- Instantánea de triaje del proyecto: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Otros idiomas
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.fi.md
+++ b/third_party/zeroclaw/docs/README.fi.md
@@ -0,0 +1,96 @@
+# ZeroClaw-dokumentaatiokeskus
+
+Tämä sivu on dokumentaatiojärjestelmän ensisijainen aloituspiste.
+
+Viimeksi päivitetty: **20. helmikuuta 2026**.
+
+Lokalisoidut keskukset: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Aloita Tästä
+
+| Haluan…                                                             | Lue tämä                                                                       |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Asentaa ja ajaa ZeroClaw nopeasti                                   | [README.md (Pikaopas)](../README.md#quick-start)                               |
+| Käynnistys yhdellä komennolla                                       | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| Löytää komentoja tehtävän mukaan                                    | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Tarkistaa nopeasti asetusavaimet ja oletusarvot                     | [config-reference.md](reference/api/config-reference.md)                       |
+| Määrittää mukautettuja tarjoajia/päätepisteitä                      | [custom-providers.md](contributing/custom-providers.md)                        |
+| Määrittää Z.AI / GLM -tarjoajan                                     | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| Käyttää LangGraph-integrointimalleja                                | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| Käyttää ajonaikaa (päivä-2 runbook)                                 | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Ratkaista asennus-/ajonaika-/kanavaongelmia                         | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Ajaa Matrix-salattujen huoneiden asetukset ja diagnostiikka         | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| Selata dokumentaatiota kategorioittain                               | [SUMMARY.md](SUMMARY.md)                                                      |
+| Nähdä projektin PR/issue-dokumenttien tilannekuva                   | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Nopea Päätöspuu (10 sekuntia)
+
+- Tarvitsetko alkuasennuksen tai -määrityksen? → [setup-guides/README.md](setup-guides/README.md)
+- Tarvitsetko tarkat CLI/asetusavaimet? → [reference/README.md](reference/README.md)
+- Tarvitsetko tuotanto-/palvelutoimintoja? → [ops/README.md](ops/README.md)
+- Näetkö virheitä tai regressioita? → [troubleshooting.md](ops/troubleshooting.md)
+- Työskenteletkö tietoturvan koventamisen tai tiekartan parissa? → [security/README.md](security/README.md)
+- Työskenteletkö levyjen/oheislaitteiden kanssa? → [hardware/README.md](hardware/README.md)
+- Osallistuminen/katselmointi/CI-työnkulku? → [contributing/README.md](contributing/README.md)
+- Haluatko täydellisen kartan? → [SUMMARY.md](SUMMARY.md)
+
+## Kokoelmat (Suositellut)
+
+- Aloitus: [setup-guides/README.md](setup-guides/README.md)
+- Viiteluettelot: [reference/README.md](reference/README.md)
+- Toiminta ja käyttöönotto: [ops/README.md](ops/README.md)
+- Tietoturvadokumentit: [security/README.md](security/README.md)
+- Laitteisto/oheislaitteet: [hardware/README.md](hardware/README.md)
+- Osallistuminen/CI: [contributing/README.md](contributing/README.md)
+- Projektin tilannekuvat: [maintainers/README.md](maintainers/README.md)
+
+## Yleisön Mukaan
+
+### Käyttäjät / Operaattorit
+
+- [commands-reference.md](reference/cli/commands-reference.md) — komentojen haku työnkulun mukaan
+- [providers-reference.md](reference/api/providers-reference.md) — tarjoajien tunnisteet, aliakset, tunnistetietojen ympäristömuuttujat
+- [channels-reference.md](reference/api/channels-reference.md) — kanavien ominaisuudet ja asetuspolut
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix-salattujen huoneiden (E2EE) asetukset ja vastaamattomuuden diagnostiikka
+- [config-reference.md](reference/api/config-reference.md) — korkean signaalin asetusavaimet ja turvalliset oletusarvot
+- [custom-providers.md](contributing/custom-providers.md) — mukautetun tarjoajan/perus-URL:n integrointimallit
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM-asetukset ja päätepistematriisi
+- [langgraph-integration.md](contributing/langgraph-integration.md) — varaintegrointi mallin/työkalukutsun reunatapauksille
+- [operations-runbook.md](ops/operations-runbook.md) — ajonaikan päivä-2 toiminnot ja palautustyönkulut
+- [troubleshooting.md](ops/troubleshooting.md) — yleiset virhesignatuurit ja palautusaskeleet
+
+### Osallistujat / Ylläpitäjät
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Tietoturva / Luotettavuus
+
+> Huomautus: tämä alue sisältää ehdotus-/tiekartadokumentteja. Nykyisestä toiminnasta aloita kohdista [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) ja [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Järjestelmänavigaatio & Hallintotapa
+
+- Yhtenäinen sisällysluettelo: [SUMMARY.md](SUMMARY.md)
+- Dokumenttien rakennekartta (kieli/osio/toiminto): [structure/README.md](maintainers/structure-README.md)
+- Dokumentaation inventaario/luokittelu: [docs-inventory.md](maintainers/docs-inventory.md)
+- Projektin lajittelun tilannekuva: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Muut kielet
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.fr.md
+++ b/third_party/zeroclaw/docs/README.fr.md
@@ -0,0 +1,95 @@
+# Hub de Documentation ZeroClaw
+
+Cette page est le point d'entrée principal du système de documentation.
+
+Dernière mise à jour : **20 février 2026**.
+
+Hubs localisés : [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Commencez Ici
+
+| Je veux…                                                            | Lire ceci                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Installer et exécuter ZeroClaw rapidement                           | [README.md (Démarrage Rapide)](../README.md#quick-start)                       |
+| Bootstrap en une seule commande                                     | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Trouver des commandes par tâche                                     | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Vérifier rapidement les valeurs par défaut et clés de config        | [config-reference.md](reference/api/config-reference.md)                       |
+| Configurer des fournisseurs/endpoints personnalisés                 | [custom-providers.md](contributing/custom-providers.md)                         |
+| Configurer le fournisseur Z.AI / GLM                                | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Utiliser les modèles d'intégration LangGraph                        | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Opérer le runtime (runbook jour-2)                                  | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Dépanner les problèmes d'installation/runtime/canal                 | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Exécuter la configuration et diagnostics de salles chiffrées Matrix | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Parcourir les docs par catégorie                                    | [SUMMARY.md](SUMMARY.md)                                                       |
+| Voir l'instantané docs des PR/issues du projet                      | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Arbre de Décision Rapide (10 secondes)
+
+- Besoin de configuration ou installation initiale ? → [setup-guides/README.md](setup-guides/README.md)
+- Besoin de clés CLI/config exactes ? → [reference/README.md](reference/README.md)
+- Besoin d'opérations de production/service ? → [ops/README.md](ops/README.md)
+- Vous voyez des échecs ou régressions ? → [troubleshooting.md](ops/troubleshooting.md)
+- Vous travaillez sur le durcissement sécurité ou la roadmap ? → [security/README.md](security/README.md)
+- Vous travaillez avec des cartes/périphériques ? → [hardware/README.md](hardware/README.md)
+- Contribution/revue/workflow CI ? → [contributing/README.md](contributing/README.md)
+- Vous voulez la carte complète ? → [SUMMARY.md](SUMMARY.md)
+
+## Collections (Recommandées)
+
+- Démarrage : [setup-guides/README.md](setup-guides/README.md)
+- Catalogues de référence : [reference/README.md](reference/README.md)
+- Opérations & déploiement : [ops/README.md](ops/README.md)
+- Docs sécurité : [security/README.md](security/README.md)
+- Matériel/périphériques : [hardware/README.md](hardware/README.md)
+- Contribution/CI : [contributing/README.md](contributing/README.md)
+- Instantanés projet : [maintainers/README.md](maintainers/README.md)
+
+## Par Audience
+
+### Utilisateurs / Opérateurs
+
+- [commands-reference.md](reference/cli/commands-reference.md) — recherche de commandes par workflow
+- [providers-reference.md](reference/api/providers-reference.md) — IDs fournisseurs, alias, variables d'environnement d'identifiants
+- [channels-reference.md](reference/api/channels-reference.md) — capacités des canaux et chemins de configuration
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — configuration de salles chiffrées Matrix (E2EE) et diagnostics de non-réponse
+- [config-reference.md](reference/api/config-reference.md) — clés de configuration à haute signalisation et valeurs par défaut sécurisées
+- [custom-providers.md](contributing/custom-providers.md) — modèles d'intégration de fournisseur personnalisé/URL de base
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — configuration Z.AI/GLM et matrice d'endpoints
+- [langgraph-integration.md](contributing/langgraph-integration.md) — intégration de secours pour les cas limites de modèle/appel d'outil
+- [operations-runbook.md](ops/operations-runbook.md) — opérations runtime jour-2 et flux de rollback
+- [troubleshooting.md](ops/troubleshooting.md) — signatures d'échec courantes et étapes de récupération
+
+### Contributeurs / Mainteneurs
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Sécurité / Fiabilité
+
+> Note : cette zone inclut des docs de proposition/roadmap. Pour le comportement actuel, commencez par [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), et [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Navigation Système & Gouvernance
+
+- Table des matières unifiée : [SUMMARY.md](SUMMARY.md)
+- Carte de structure docs (langue/partie/fonction) : [structure/README.md](maintainers/structure-README.md)
+- Inventaire/classification de la documentation : [docs-inventory.md](maintainers/docs-inventory.md)
+- Instantané de triage du projet : [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Autres langues
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.he.md
+++ b/third_party/zeroclaw/docs/README.he.md
@@ -0,0 +1,96 @@
+# מרכז התיעוד של ZeroClaw
+
+דף זה הוא נקודת הכניסה הראשית למערכת התיעוד.
+
+עדכון אחרון: **20 בפברואר 2026**.
+
+מרכזים מתורגמים: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## התחילו כאן
+
+| אני רוצה…                                                          | קראו זאת                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| להתקין ולהריץ את ZeroClaw במהירות                                   | [README.md (התחלה מהירה)](../README.md#quick-start)                            |
+| אתחול בפקודה אחת                                                   | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| למצוא פקודות לפי משימה                                              | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| לבדוק במהירות מפתחות ובררות מחדל של הגדרות                         | [config-reference.md](reference/api/config-reference.md)                       |
+| להגדיר ספקים/נקודות קצה מותאמים אישית                               | [custom-providers.md](contributing/custom-providers.md)                        |
+| להגדיר את ספק Z.AI / GLM                                           | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| להשתמש בתבניות שילוב LangGraph                                     | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| להפעיל את סביבת הריצה (runbook יום-2)                               | [operations-runbook.md](ops/operations-runbook.md)                             |
+| לפתור בעיות התקנה/סביבת ריצה/ערוץ                                   | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| להריץ הגדרה ואבחון של חדרים מוצפנים ב-Matrix                       | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| לדפדף בתיעוד לפי קטגוריה                                           | [SUMMARY.md](SUMMARY.md)                                                      |
+| לראות תמונת מצב של PR/issues של הפרויקט                            | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## עץ החלטה מהיר (10 שניות)
+
+- צריכים הגדרה או התקנה ראשונית? → [setup-guides/README.md](setup-guides/README.md)
+- צריכים מפתחות CLI/הגדרות מדויקים? → [reference/README.md](reference/README.md)
+- צריכים פעולות ייצור/שירות? → [ops/README.md](ops/README.md)
+- רואים כשלים או רגרסיות? → [troubleshooting.md](ops/troubleshooting.md)
+- עובדים על הקשחת אבטחה או מפת דרכים? → [security/README.md](security/README.md)
+- עובדים עם לוחות/ציוד היקפי? → [hardware/README.md](hardware/README.md)
+- תרומה/סקירה/זרימת עבודה CI? → [contributing/README.md](contributing/README.md)
+- רוצים את המפה המלאה? → [SUMMARY.md](SUMMARY.md)
+
+## אוספים (מומלצים)
+
+- התחלה: [setup-guides/README.md](setup-guides/README.md)
+- קטלוגי עיון: [reference/README.md](reference/README.md)
+- תפעול ופריסה: [ops/README.md](ops/README.md)
+- תיעוד אבטחה: [security/README.md](security/README.md)
+- חומרה/ציוד היקפי: [hardware/README.md](hardware/README.md)
+- תרומה/CI: [contributing/README.md](contributing/README.md)
+- תמונות מצב של הפרויקט: [maintainers/README.md](maintainers/README.md)
+
+## לפי קהל יעד
+
+### משתמשים / מפעילים
+
+- [commands-reference.md](reference/cli/commands-reference.md) — חיפוש פקודות לפי זרימת עבודה
+- [providers-reference.md](reference/api/providers-reference.md) — מזהי ספקים, כינויים, משתני סביבה של אישורים
+- [channels-reference.md](reference/api/channels-reference.md) — יכולות ערוצים ונתיבי הגדרה
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — הגדרת חדרים מוצפנים ב-Matrix (E2EE) ואבחון אי-תגובה
+- [config-reference.md](reference/api/config-reference.md) — מפתחות הגדרה בעלי אות חזק ובררות מחדל בטוחות
+- [custom-providers.md](contributing/custom-providers.md) — תבניות שילוב ספק מותאם אישית/URL בסיס
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — הגדרת Z.AI/GLM ומטריצת נקודות קצה
+- [langgraph-integration.md](contributing/langgraph-integration.md) — שילוב חלופי למקרי קצה של מודל/קריאת כלי
+- [operations-runbook.md](ops/operations-runbook.md) — פעולות סביבת ריצה יום-2 וזרימות שחזור
+- [troubleshooting.md](ops/troubleshooting.md) — חתימות כשל נפוצות וצעדי שחזור
+
+### תורמים / מתחזקים
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### אבטחה / אמינות
+
+> הערה: אזור זה כולל מסמכי הצעה/מפת דרכים. להתנהגות הנוכחית, התחילו מ-[config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), ו-[troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## ניווט במערכת וממשל
+
+- תוכן עניינים מאוחד: [SUMMARY.md](SUMMARY.md)
+- מפת מבנה תיעוד (שפה/חלק/פונקציה): [structure/README.md](maintainers/structure-README.md)
+- מלאי/סיווג תיעוד: [docs-inventory.md](maintainers/docs-inventory.md)
+- תמונת מצב של מיון הפרויקט: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## שפות אחרות
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.hi.md
+++ b/third_party/zeroclaw/docs/README.hi.md
@@ -0,0 +1,96 @@
+# ZeroClaw दस्तावेज़ीकरण केंद्र
+
+यह पृष्ठ दस्तावेज़ीकरण प्रणाली का प्राथमिक प्रवेश बिंदु है।
+
+अंतिम अपडेट: **20 फरवरी 2026**।
+
+स्थानीयकृत केंद्र: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## यहाँ से शुरू करें
+
+| मैं चाहता/चाहती हूँ…                                                | यह पढ़ें                                                                       |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| ZeroClaw को जल्दी से इंस्टॉल और चलाना                              | [README.md (त्वरित प्रारंभ)](../README.md#quick-start)                         |
+| एक कमांड में बूटस्ट्रैप                                             | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| कार्य के अनुसार कमांड खोजना                                         | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| कॉन्फ़िग कुंजियों और डिफ़ॉल्ट मानों को जल्दी जाँचना                | [config-reference.md](reference/api/config-reference.md)                       |
+| कस्टम प्रदाता/एंडपॉइंट कॉन्फ़िगर करना                              | [custom-providers.md](contributing/custom-providers.md)                        |
+| Z.AI / GLM प्रदाता कॉन्फ़िगर करना                                   | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| LangGraph एकीकरण पैटर्न का उपयोग करना                               | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| रनटाइम संचालित करना (दिन-2 रनबुक)                                   | [operations-runbook.md](ops/operations-runbook.md)                             |
+| इंस्टॉलेशन/रनटाइम/चैनल समस्याओं का निवारण                         | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Matrix एन्क्रिप्टेड कमरों का सेटअप और डायग्नोस्टिक्स चलाना        | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| श्रेणी के अनुसार दस्तावेज़ ब्राउज़ करना                              | [SUMMARY.md](SUMMARY.md)                                                      |
+| प्रोजेक्ट PR/issues दस्तावेज़ स्नैपशॉट देखना                        | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## त्वरित निर्णय वृक्ष (10 सेकंड)
+
+- प्रारंभिक सेटअप या इंस्टॉलेशन चाहिए? → [setup-guides/README.md](setup-guides/README.md)
+- सटीक CLI/कॉन्फ़िग कुंजियाँ चाहिए? → [reference/README.md](reference/README.md)
+- प्रोडक्शन/सर्विस ऑपरेशन चाहिए? → [ops/README.md](ops/README.md)
+- विफलताएँ या रिग्रेशन दिख रहे हैं? → [troubleshooting.md](ops/troubleshooting.md)
+- सुरक्षा सख्ती या रोडमैप पर काम कर रहे हैं? → [security/README.md](security/README.md)
+- बोर्ड/पेरिफेरल्स के साथ काम कर रहे हैं? → [hardware/README.md](hardware/README.md)
+- योगदान/समीक्षा/CI वर्कफ़्लो? → [contributing/README.md](contributing/README.md)
+- पूरा नक्शा चाहिए? → [SUMMARY.md](SUMMARY.md)
+
+## संग्रह (अनुशंसित)
+
+- प्रारंभ: [setup-guides/README.md](setup-guides/README.md)
+- संदर्भ सूचियाँ: [reference/README.md](reference/README.md)
+- संचालन और तैनाती: [ops/README.md](ops/README.md)
+- सुरक्षा दस्तावेज़: [security/README.md](security/README.md)
+- हार्डवेयर/पेरिफेरल्स: [hardware/README.md](hardware/README.md)
+- योगदान/CI: [contributing/README.md](contributing/README.md)
+- प्रोजेक्ट स्नैपशॉट: [maintainers/README.md](maintainers/README.md)
+
+## दर्शक वर्ग के अनुसार
+
+### उपयोगकर्ता / ऑपरेटर
+
+- [commands-reference.md](reference/cli/commands-reference.md) — वर्कफ़्लो के अनुसार कमांड खोज
+- [providers-reference.md](reference/api/providers-reference.md) — प्रदाता ID, उपनाम, क्रेडेंशियल पर्यावरण चर
+- [channels-reference.md](reference/api/channels-reference.md) — चैनल क्षमताएँ और कॉन्फ़िगरेशन पथ
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix एन्क्रिप्टेड कमरा (E2EE) सेटअप और गैर-प्रतिक्रिया डायग्नोस्टिक्स
+- [config-reference.md](reference/api/config-reference.md) — उच्च-संकेत कॉन्फ़िग कुंजियाँ और सुरक्षित डिफ़ॉल्ट
+- [custom-providers.md](contributing/custom-providers.md) — कस्टम प्रदाता/बेस URL एकीकरण पैटर्न
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM सेटअप और एंडपॉइंट मैट्रिक्स
+- [langgraph-integration.md](contributing/langgraph-integration.md) — मॉडल/टूल-कॉल एज केस के लिए फ़ॉलबैक एकीकरण
+- [operations-runbook.md](ops/operations-runbook.md) — रनटाइम दिन-2 ऑपरेशन और रोलबैक फ़्लो
+- [troubleshooting.md](ops/troubleshooting.md) — सामान्य विफलता हस्ताक्षर और पुनर्प्राप्ति चरण
+
+### योगदानकर्ता / अनुरक्षक
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### सुरक्षा / विश्वसनीयता
+
+> नोट: इस क्षेत्र में प्रस्ताव/रोडमैप दस्तावेज़ शामिल हैं। वर्तमान व्यवहार के लिए, [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), और [troubleshooting.md](ops/troubleshooting.md) से शुरू करें।
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## सिस्टम नेविगेशन और शासन
+
+- एकीकृत विषय सूची: [SUMMARY.md](SUMMARY.md)
+- दस्तावेज़ संरचना नक्शा (भाषा/भाग/कार्य): [structure/README.md](maintainers/structure-README.md)
+- दस्तावेज़ीकरण सूची/वर्गीकरण: [docs-inventory.md](maintainers/docs-inventory.md)
+- प्रोजेक्ट ट्राइएज स्नैपशॉट: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## अन्य भाषाएँ
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.hu.md
+++ b/third_party/zeroclaw/docs/README.hu.md
@@ -0,0 +1,99 @@
+# ZeroClaw Dokumentációs Központ
+
+Ez az oldal a dokumentációs rendszer fő belépési pontja.
+
+Utolsó frissítés: **2026. február 21.**
+
+Honosított központok: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Kezdje itt
+
+| Szeretném…                                                          | Olvassa el                                                                     |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Gyorsan telepíteni és futtatni a ZeroClaw-t                         | [README.md (Gyorsindítás)](../README.md#quick-start)                           |
+| Egylépéses bootstrap                                                | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| Frissítés vagy eltávolítás macOS-en                                 | [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)            |
+| Parancsok keresése feladat szerint                                  | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Konfigurációs alapértékek és kulcsok gyors ellenőrzése              | [config-reference.md](reference/api/config-reference.md)                       |
+| Egyéni szolgáltatók/végpontok beállítása                            | [custom-providers.md](contributing/custom-providers.md)                        |
+| Z.AI / GLM szolgáltató beállítása                                   | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| LangGraph integrációs minták használata                             | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| Futtatókörnyezet üzemeltetése (2. napi kézikönyv)                  | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Telepítési/futtatási/csatorna problémák elhárítása                  | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Matrix titkosított szoba beállítás és diagnosztika futtatása        | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| Dokumentáció böngészése kategória szerint                           | [SUMMARY.md](SUMMARY.md)                                                      |
+| Projekt PR/issue dokumentációs pillanatkép megtekintése             | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Gyors Döntési Fa (10 másodperc)
+
+- Első telepítés vagy beállítás szükséges? → [setup-guides/README.md](setup-guides/README.md)
+- Pontos CLI/konfigurációs kulcsok kellenek? → [reference/README.md](reference/README.md)
+- Éles/szolgáltatás üzemeltetés szükséges? → [ops/README.md](ops/README.md)
+- Hibákat vagy regressziókat tapasztal? → [troubleshooting.md](ops/troubleshooting.md)
+- Biztonsági megerősítésen vagy ütemterven dolgozik? → [security/README.md](security/README.md)
+- Kártyákkal/perifériákkal dolgozik? → [hardware/README.md](hardware/README.md)
+- Hozzájárulás/áttekintés/CI munkafolyamat? → [contributing/README.md](contributing/README.md)
+- Teljes térképet szeretne? → [SUMMARY.md](SUMMARY.md)
+
+## Gyűjtemények (Ajánlott)
+
+- Első lépések: [setup-guides/README.md](setup-guides/README.md)
+- Referencia katalógusok: [reference/README.md](reference/README.md)
+- Üzemeltetés és telepítés: [ops/README.md](ops/README.md)
+- Biztonsági dokumentáció: [security/README.md](security/README.md)
+- Hardver/perifériák: [hardware/README.md](hardware/README.md)
+- Hozzájárulás/CI: [contributing/README.md](contributing/README.md)
+- Projekt pillanatképek: [maintainers/README.md](maintainers/README.md)
+
+## Célközönség szerint
+
+### Felhasználók / Üzemeltetők
+
+- [commands-reference.md](reference/cli/commands-reference.md) — parancskeresés munkafolyamat szerint
+- [providers-reference.md](reference/api/providers-reference.md) — szolgáltató azonosítók, álnevek, hitelesítési környezeti változók
+- [channels-reference.md](reference/api/channels-reference.md) — csatorna képességek és beállítási útvonalak
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix titkosított szoba (E2EE) beállítás és válaszhiány diagnosztika
+- [config-reference.md](reference/api/config-reference.md) — kiemelt konfigurációs kulcsok és biztonságos alapértékek
+- [custom-providers.md](contributing/custom-providers.md) — egyéni szolgáltató/alap URL integrációs sablonok
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM beállítás és végpont mátrix
+- [langgraph-integration.md](contributing/langgraph-integration.md) — tartalék integráció modell/eszközhívás szélsőséges esetekhez
+- [operations-runbook.md](ops/operations-runbook.md) — 2. napi futtatókörnyezet üzemeltetés és visszaállítási folyamat
+- [troubleshooting.md](ops/troubleshooting.md) — gyakori hibajelek és helyreállítási lépések
+
+### Közreműködők / Karbantartók
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Biztonság / Megbízhatóság
+
+> Megjegyzés: ez a terület javaslat/ütemterv dokumentumokat is tartalmaz. A jelenlegi viselkedésért kezdje a [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) és [troubleshooting.md](ops/troubleshooting.md) fájlokkal.
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Rendszernavigáció és Irányítás
+
+- Egységes tartalomjegyzék: [SUMMARY.md](SUMMARY.md)
+- Dokumentáció szerkezeti térkép (nyelv/rész/funkció): [structure/README.md](maintainers/structure-README.md)
+- Dokumentáció leltár/osztályozás: [docs-inventory.md](maintainers/docs-inventory.md)
+- i18n dokumentáció index: [i18n/README.md](i18n/README.md)
+- i18n lefedettségi térkép: [i18n-coverage.md](maintainers/i18n-coverage.md)
+- Projekt triage pillanatkép: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Más nyelvek
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.id.md
+++ b/third_party/zeroclaw/docs/README.id.md
@@ -0,0 +1,99 @@
+# Pusat Dokumentasi ZeroClaw
+
+Halaman ini adalah titik masuk utama untuk sistem dokumentasi.
+
+Pembaruan terakhir: **21 Februari 2026**.
+
+Hub terlokalisasi: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Mulai di Sini
+
+| Saya ingin…                                                         | Baca ini                                                                       |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Menginstal dan menjalankan ZeroClaw dengan cepat                    | [README.md (Mulai Cepat)](../README.md#quick-start)                            |
+| Bootstrap dalam satu perintah                                       | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| Memperbarui atau menghapus di macOS                                 | [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)            |
+| Mencari perintah berdasarkan tugas                                  | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Memeriksa default dan kunci konfigurasi dengan cepat                | [config-reference.md](reference/api/config-reference.md)                       |
+| Mengonfigurasi penyedia/endpoint kustom                             | [custom-providers.md](contributing/custom-providers.md)                        |
+| Mengonfigurasi penyedia Z.AI / GLM                                  | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| Menggunakan pola integrasi LangGraph                                | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| Mengoperasikan runtime (buku panduan hari ke-2)                     | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Memecahkan masalah instalasi/runtime/kanal                          | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Menjalankan pengaturan ruang terenkripsi Matrix dan diagnostik      | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| Menjelajahi dokumentasi berdasarkan kategori                        | [SUMMARY.md](SUMMARY.md)                                                      |
+| Melihat snapshot dokumen PR/issue proyek                            | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Pohon Keputusan Cepat (10 detik)
+
+- Butuh pengaturan atau instalasi pertama kali? → [setup-guides/README.md](setup-guides/README.md)
+- Butuh kunci CLI/konfigurasi yang tepat? → [reference/README.md](reference/README.md)
+- Butuh operasi produksi/layanan? → [ops/README.md](ops/README.md)
+- Melihat kegagalan atau regresi? → [troubleshooting.md](ops/troubleshooting.md)
+- Bekerja pada penguatan keamanan atau peta jalan? → [security/README.md](security/README.md)
+- Bekerja dengan papan/periferal? → [hardware/README.md](hardware/README.md)
+- Kontribusi/review/alur kerja CI? → [contributing/README.md](contributing/README.md)
+- Ingin peta lengkap? → [SUMMARY.md](SUMMARY.md)
+
+## Koleksi (Direkomendasikan)
+
+- Memulai: [setup-guides/README.md](setup-guides/README.md)
+- Katalog referensi: [reference/README.md](reference/README.md)
+- Operasi & deployment: [ops/README.md](ops/README.md)
+- Dokumentasi keamanan: [security/README.md](security/README.md)
+- Perangkat keras/periferal: [hardware/README.md](hardware/README.md)
+- Kontribusi/CI: [contributing/README.md](contributing/README.md)
+- Snapshot proyek: [maintainers/README.md](maintainers/README.md)
+
+## Berdasarkan Audiens
+
+### Pengguna / Operator
+
+- [commands-reference.md](reference/cli/commands-reference.md) — pencarian perintah berdasarkan alur kerja
+- [providers-reference.md](reference/api/providers-reference.md) — ID penyedia, alias, variabel lingkungan kredensial
+- [channels-reference.md](reference/api/channels-reference.md) — kemampuan kanal dan jalur pengaturan
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — pengaturan ruang terenkripsi Matrix (E2EE) dan diagnostik tanpa respons
+- [config-reference.md](reference/api/config-reference.md) — kunci konfigurasi penting dan default aman
+- [custom-providers.md](contributing/custom-providers.md) — template integrasi penyedia kustom/URL dasar
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — pengaturan Z.AI/GLM dan matriks endpoint
+- [langgraph-integration.md](contributing/langgraph-integration.md) — integrasi fallback untuk kasus tepi model/pemanggilan alat
+- [operations-runbook.md](ops/operations-runbook.md) — operasi runtime hari ke-2 dan alur rollback
+- [troubleshooting.md](ops/troubleshooting.md) — tanda kegagalan umum dan langkah pemulihan
+
+### Kontributor / Pengelola
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Keamanan / Keandalan
+
+> Catatan: area ini mencakup dokumen proposal/peta jalan. Untuk perilaku saat ini, mulailah dengan [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), dan [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Navigasi Sistem & Tata Kelola
+
+- Daftar isi terpadu: [SUMMARY.md](SUMMARY.md)
+- Peta struktur dokumentasi (bahasa/bagian/fungsi): [structure/README.md](maintainers/structure-README.md)
+- Inventaris/klasifikasi dokumentasi: [docs-inventory.md](maintainers/docs-inventory.md)
+- Indeks dokumentasi i18n: [i18n/README.md](i18n/README.md)
+- Peta cakupan i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+- Snapshot triase proyek: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Bahasa lain
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.it.md
+++ b/third_party/zeroclaw/docs/README.it.md
@@ -0,0 +1,99 @@
+# Hub della Documentazione ZeroClaw
+
+Questa pagina è il punto di ingresso principale del sistema di documentazione.
+
+Ultimo aggiornamento: **21 febbraio 2026**.
+
+Hub localizzati: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Inizia Qui
+
+| Voglio…                                                             | Leggi questo                                                                   |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Installare ed eseguire ZeroClaw rapidamente                         | [README.md (Avvio Rapido)](../README.md#quick-start)                           |
+| Bootstrap con un singolo comando                                    | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| Aggiornare o disinstallare su macOS                                 | [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)            |
+| Trovare comandi per attività                                        | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Controllare rapidamente valori predefiniti e chiavi di configurazione | [config-reference.md](reference/api/config-reference.md)                      |
+| Configurare provider/endpoint personalizzati                        | [custom-providers.md](contributing/custom-providers.md)                        |
+| Configurare il provider Z.AI / GLM                                  | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| Usare i pattern di integrazione LangGraph                           | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| Gestire il runtime (runbook giorno 2)                               | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Risolvere problemi di installazione/runtime/canale                  | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Eseguire configurazione e diagnostica delle stanze crittografate Matrix | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                      |
+| Sfogliare la documentazione per categoria                           | [SUMMARY.md](SUMMARY.md)                                                      |
+| Vedere lo snapshot dei documenti PR/issue del progetto              | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Albero Decisionale Rapido (10 secondi)
+
+- Serve configurazione o installazione iniziale? → [setup-guides/README.md](setup-guides/README.md)
+- Servono chiavi CLI/configurazione esatte? → [reference/README.md](reference/README.md)
+- Servono operazioni di produzione/servizio? → [ops/README.md](ops/README.md)
+- Si verificano errori o regressioni? → [troubleshooting.md](ops/troubleshooting.md)
+- Si lavora sul rafforzamento della sicurezza o sulla roadmap? → [security/README.md](security/README.md)
+- Si lavora con schede/periferiche? → [hardware/README.md](hardware/README.md)
+- Contribuzione/revisione/workflow CI? → [contributing/README.md](contributing/README.md)
+- Vuoi la mappa completa? → [SUMMARY.md](SUMMARY.md)
+
+## Collezioni (Raccomandate)
+
+- Per iniziare: [setup-guides/README.md](setup-guides/README.md)
+- Cataloghi di riferimento: [reference/README.md](reference/README.md)
+- Operazioni e deployment: [ops/README.md](ops/README.md)
+- Documentazione sulla sicurezza: [security/README.md](security/README.md)
+- Hardware/periferiche: [hardware/README.md](hardware/README.md)
+- Contribuzione/CI: [contributing/README.md](contributing/README.md)
+- Snapshot del progetto: [maintainers/README.md](maintainers/README.md)
+
+## Per Pubblico
+
+### Utenti / Operatori
+
+- [commands-reference.md](reference/cli/commands-reference.md) — ricerca comandi per workflow
+- [providers-reference.md](reference/api/providers-reference.md) — ID provider, alias, variabili d'ambiente per le credenziali
+- [channels-reference.md](reference/api/channels-reference.md) — capacità dei canali e percorsi di configurazione
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — configurazione stanze crittografate Matrix (E2EE) e diagnostica mancata risposta
+- [config-reference.md](reference/api/config-reference.md) — chiavi di configurazione importanti e valori predefiniti sicuri
+- [custom-providers.md](contributing/custom-providers.md) — template di integrazione provider personalizzato/URL base
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — configurazione Z.AI/GLM e matrice degli endpoint
+- [langgraph-integration.md](contributing/langgraph-integration.md) — integrazione di fallback per casi limite modello/chiamata strumenti
+- [operations-runbook.md](ops/operations-runbook.md) — operazioni runtime giorno 2 e flusso di rollback
+- [troubleshooting.md](ops/troubleshooting.md) — firme di errore comuni e passaggi di ripristino
+
+### Contributori / Manutentori
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Sicurezza / Affidabilità
+
+> Nota: quest'area include documenti di proposta/roadmap. Per il comportamento attuale, iniziare con [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) e [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Navigazione di Sistema e Governance
+
+- Indice unificato: [SUMMARY.md](SUMMARY.md)
+- Mappa della struttura documentale (lingua/parte/funzione): [structure/README.md](maintainers/structure-README.md)
+- Inventario/classificazione della documentazione: [docs-inventory.md](maintainers/docs-inventory.md)
+- Indice documentazione i18n: [i18n/README.md](i18n/README.md)
+- Mappa di copertura i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+- Snapshot di triage del progetto: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Altre lingue
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.ja.md
+++ b/third_party/zeroclaw/docs/README.ja.md
@@ -0,0 +1,92 @@
+# ZeroClaw ドキュメントハブ（日本語）
+
+このページは日本語のドキュメント入口です。
+
+最終同期日: **2026-02-18**。
+
+> 注: コマンド名・設定キー・API パスは英語のまま記載します。実装の一次情報は英語版ドキュメントを優先してください。
+
+## すぐに参照したい項目
+
+| やりたいこと | 参照先 |
+|---|---|
+| すぐにセットアップしたい | [../README.ja.md](../README.ja.md) / [../README.md](../README.md) |
+| ワンコマンドで導入したい | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) |
+| コマンドを用途別に確認したい | [commands-reference.md](reference/cli/commands-reference.md) |
+| 設定キーと既定値を確認したい | [config-reference.md](reference/api/config-reference.md) |
+| カスタム Provider / endpoint を追加したい | [custom-providers.md](contributing/custom-providers.md) |
+| Z.AI / GLM Provider を設定したい | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) |
+| LangGraph ツール連携を使いたい | [langgraph-integration.md](contributing/langgraph-integration.md) |
+| 日常運用（runbook）を確認したい | [operations-runbook.md](ops/operations-runbook.md) |
+| インストール/実行トラブルを解決したい | [troubleshooting.md](ops/troubleshooting.md) |
+| 統合 TOC から探したい | [SUMMARY.md](SUMMARY.md) |
+| PR/Issue の現状を把握したい | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## 10秒ルーティング（まずここ）
+
+- 初回セットアップや導入をしたい → [setup-guides/README.md](setup-guides/README.md)
+- CLI/設定キーを正確に確認したい → [reference/README.md](reference/README.md)
+- 本番運用やサービス管理をしたい → [ops/README.md](ops/README.md)
+- エラーや不具合を解消したい → [troubleshooting.md](ops/troubleshooting.md)
+- セキュリティ方針やロードマップを見たい → [security/README.md](security/README.md)
+- ボード/周辺機器を扱いたい → [hardware/README.md](hardware/README.md)
+- 貢献・レビュー・CIを確認したい → [contributing/README.md](contributing/README.md)
+- 全体マップを見たい → [SUMMARY.md](SUMMARY.md)
+
+## カテゴリ別ナビゲーション（推奨）
+
+- 入門: [setup-guides/README.md](setup-guides/README.md)
+- リファレンス: [reference/README.md](reference/README.md)
+- 運用 / デプロイ: [ops/README.md](ops/README.md)
+- セキュリティ: [security/README.md](security/README.md)
+- ハードウェア: [hardware/README.md](hardware/README.md)
+- コントリビュート / CI: [contributing/README.md](contributing/README.md)
+- プロジェクトスナップショット: [maintainers/README.md](maintainers/README.md)
+
+## ロール別
+
+### ユーザー / オペレーター
+
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+
+### コントリビューター / メンテナー
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### セキュリティ / 信頼性
+
+> 注: このセクションには proposal/roadmap 文書が含まれ、想定段階のコマンドや設定が記載される場合があります。現行動作は [config-reference.md](reference/api/config-reference.md)、[operations-runbook.md](ops/operations-runbook.md)、[troubleshooting.md](ops/troubleshooting.md) を優先してください。
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## ドキュメント運用 / 分類
+
+- 統合 TOC: [SUMMARY.md](SUMMARY.md)
+- ドキュメント構造マップ（言語/カテゴリ/機能）: [structure/README.md](maintainers/structure-README.md)
+- ドキュメント一覧 / 分類: [docs-inventory.md](maintainers/docs-inventory.md)
+
+## 他言語
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.ko.md
+++ b/third_party/zeroclaw/docs/README.ko.md
@@ -0,0 +1,99 @@
+# ZeroClaw 문서 허브
+
+이 페이지는 문서 시스템의 기본 진입점입니다.
+
+마지막 업데이트: **2026년 2월 21일**.
+
+현지화된 허브: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## 여기서 시작하세요
+
+| 하고 싶은 것…                                                       | 이것을 읽으세요                                                                |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| ZeroClaw를 빠르게 설치하고 실행                                     | [README.md (빠른 시작)](../README.md#quick-start)                              |
+| 한 번의 명령으로 부트스트랩                                         | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| macOS에서 업데이트 또는 제거                                        | [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)            |
+| 작업별 명령어 찾기                                                  | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| 구성 기본값과 키를 빠르게 확인                                      | [config-reference.md](reference/api/config-reference.md)                       |
+| 사용자 정의 프로바이더/엔드포인트 구성                              | [custom-providers.md](contributing/custom-providers.md)                        |
+| Z.AI / GLM 프로바이더 구성                                          | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| LangGraph 통합 패턴 사용                                            | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| 런타임 운영 (2일차 런북)                                            | [operations-runbook.md](ops/operations-runbook.md)                             |
+| 설치/런타임/채널 문제 해결                                          | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Matrix 암호화 방 설정 및 진단 실행                                  | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| 카테고리별 문서 찾아보기                                            | [SUMMARY.md](SUMMARY.md)                                                      |
+| 프로젝트 PR/이슈 문서 스냅샷 보기                                   | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## 빠른 의사결정 트리 (10초)
+
+- 초기 설정 또는 설치가 필요한가요? → [setup-guides/README.md](setup-guides/README.md)
+- 정확한 CLI/구성 키가 필요한가요? → [reference/README.md](reference/README.md)
+- 프로덕션/서비스 운영이 필요한가요? → [ops/README.md](ops/README.md)
+- 실패 또는 회귀가 발생하고 있나요? → [troubleshooting.md](ops/troubleshooting.md)
+- 보안 강화 또는 로드맵 작업 중인가요? → [security/README.md](security/README.md)
+- 보드/주변 장치 작업 중인가요? → [hardware/README.md](hardware/README.md)
+- 기여/검토/CI 워크플로우? → [contributing/README.md](contributing/README.md)
+- 전체 맵이 필요한가요? → [SUMMARY.md](SUMMARY.md)
+
+## 컬렉션 (권장)
+
+- 시작하기: [setup-guides/README.md](setup-guides/README.md)
+- 참조 카탈로그: [reference/README.md](reference/README.md)
+- 운영 및 배포: [ops/README.md](ops/README.md)
+- 보안 문서: [security/README.md](security/README.md)
+- 하드웨어/주변 장치: [hardware/README.md](hardware/README.md)
+- 기여/CI: [contributing/README.md](contributing/README.md)
+- 프로젝트 스냅샷: [maintainers/README.md](maintainers/README.md)
+
+## 대상별
+
+### 사용자 / 운영자
+
+- [commands-reference.md](reference/cli/commands-reference.md) — 워크플로우별 명령어 검색
+- [providers-reference.md](reference/api/providers-reference.md) — 프로바이더 ID, 별칭, 자격 증명 환경 변수
+- [channels-reference.md](reference/api/channels-reference.md) — 채널 기능 및 설정 경로
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix 암호화 방(E2EE) 설정 및 무응답 진단
+- [config-reference.md](reference/api/config-reference.md) — 주요 구성 키 및 보안 기본값
+- [custom-providers.md](contributing/custom-providers.md) — 사용자 정의 프로바이더/기본 URL 통합 템플릿
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM 설정 및 엔드포인트 매트릭스
+- [langgraph-integration.md](contributing/langgraph-integration.md) — 모델/도구 호출 엣지 케이스를 위한 폴백 통합
+- [operations-runbook.md](ops/operations-runbook.md) — 2일차 런타임 운영 및 롤백 흐름
+- [troubleshooting.md](ops/troubleshooting.md) — 일반적인 실패 시그니처 및 복구 단계
+
+### 기여자 / 유지보수자
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 보안 / 신뢰성
+
+> 참고: 이 영역에는 제안/로드맵 문서가 포함되어 있습니다. 현재 동작에 대해서는 [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), [troubleshooting.md](ops/troubleshooting.md)를 먼저 참조하세요.
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## 시스템 탐색 및 거버넌스
+
+- 통합 목차: [SUMMARY.md](SUMMARY.md)
+- 문서 구조 맵 (언어/부분/기능): [structure/README.md](maintainers/structure-README.md)
+- 문서 인벤토리/분류: [docs-inventory.md](maintainers/docs-inventory.md)
+- i18n 문서 색인: [i18n/README.md](i18n/README.md)
+- i18n 커버리지 맵: [i18n-coverage.md](maintainers/i18n-coverage.md)
+- 프로젝트 트리아지 스냅샷: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## 다른 언어
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.md
+++ b/third_party/zeroclaw/docs/README.md
@@ -0,0 +1,91 @@
+# ZeroClaw Documentation Hub
+
+This page is the primary entry point for the documentation system.
+
+Last refreshed: **February 21, 2026**.
+
+Localized hubs:
+[العربية](README.ar.md) · [বাংলা](README.bn.md) · [Čeština](README.cs.md) · [Dansk](README.da.md) · [Deutsch](README.de.md) · [Ελληνικά](README.el.md) · [Español](README.es.md) · [Suomi](README.fi.md) · [Français](README.fr.md) · [עברית](README.he.md) · [हिन्दी](README.hi.md) · [Magyar](README.hu.md) · [Bahasa Indonesia](README.id.md) · [Italiano](README.it.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Norsk Bokmål](README.nb.md) · [Nederlands](README.nl.md) · [Polski](README.pl.md) · [Português](README.pt.md) · [Română](README.ro.md) · [Русский](README.ru.md) · [Svenska](README.sv.md) · [ไทย](README.th.md) · [Tagalog](README.tl.md) · [Türkçe](README.tr.md) · [Українська](README.uk.md) · [اردو](README.ur.md) · [Tiếng Việt](README.vi.md) · [简体中文](README.zh-CN.md).
+
+## Start Here
+
+| I want to… | Read this |
+|---|---|
+| Install and run ZeroClaw quickly | [README.md (Quick Start)](../README.md#quick-start) |
+| Bootstrap in one command | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) |
+| Update or uninstall on macOS | [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md) |
+| Find commands by task | [commands-reference.md](reference/cli/commands-reference.md) |
+| Check config defaults and keys quickly | [config-reference.md](reference/api/config-reference.md) |
+| Configure custom providers/endpoints | [custom-providers.md](contributing/custom-providers.md) |
+| Configure Z.AI / GLM provider | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) |
+| Use LangGraph integration patterns | [langgraph-integration.md](contributing/langgraph-integration.md) |
+| Operate runtime (day-2 runbook) | [operations-runbook.md](ops/operations-runbook.md) |
+| Troubleshoot install/runtime/channel issues | [troubleshooting.md](ops/troubleshooting.md) |
+| Run Matrix encrypted-room setup and diagnostics | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) |
+| Browse docs by category | [SUMMARY.md](SUMMARY.md) |
+| See project PR/issue docs snapshot | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Quick Decision Tree (10 seconds)
+
+- Need first-time setup or install? → [setup-guides/README.md](setup-guides/README.md)
+- Need exact CLI/config keys? → [reference/README.md](reference/README.md)
+- Need production/service operations? → [ops/README.md](ops/README.md)
+- Seeing failures or regressions? → [troubleshooting.md](ops/troubleshooting.md)
+- Working on security hardening or roadmap? → [security/README.md](security/README.md)
+- Working with boards/peripherals? → [hardware/README.md](hardware/README.md)
+- Contributing/reviewing/CI workflow? → [contributing/README.md](contributing/README.md)
+- Want the full map? → [SUMMARY.md](SUMMARY.md)
+
+## Collections (Recommended)
+
+- Getting started: [setup-guides/README.md](setup-guides/README.md)
+- Reference catalogs: [reference/README.md](reference/README.md)
+- Operations & deployment: [ops/README.md](ops/README.md)
+- Security docs: [security/README.md](security/README.md)
+- Hardware/peripherals: [hardware/README.md](hardware/README.md)
+- Contributing/CI: [contributing/README.md](contributing/README.md)
+- Project snapshots: [maintainers/README.md](maintainers/README.md)
+
+## By Audience
+
+### Users / Operators
+
+- [commands-reference.md](reference/cli/commands-reference.md) — command lookup by workflow
+- [providers-reference.md](reference/api/providers-reference.md) — provider IDs, aliases, credential env vars
+- [channels-reference.md](reference/api/channels-reference.md) — channel capabilities and setup paths
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix encrypted-room (E2EE) setup and no-response diagnostics
+- [config-reference.md](reference/api/config-reference.md) — high-signal config keys and secure defaults
+- [custom-providers.md](contributing/custom-providers.md) — custom provider/base URL integration templates
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM setup and endpoint matrix
+- [langgraph-integration.md](contributing/langgraph-integration.md) — fallback integration for model/tool-calling edge cases
+- [operations-runbook.md](ops/operations-runbook.md) — day-2 runtime operations and rollback flow
+- [troubleshooting.md](ops/troubleshooting.md) — common failure signatures and recovery steps
+
+### Contributors / Maintainers
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Security / Reliability
+
+> Note: this area includes proposal/roadmap docs. For current behavior, start with [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), and [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## System Navigation & Governance
+
+- Unified TOC: [SUMMARY.md](SUMMARY.md)
+- Docs structure map (language/part/function): [structure/README.md](maintainers/structure-README.md)
+- Documentation inventory/classification: [docs-inventory.md](maintainers/docs-inventory.md)
+- i18n docs index: [i18n/README.md](i18n/README.md)
+- i18n coverage map: [i18n-coverage.md](maintainers/i18n-coverage.md)
+- Project triage snapshot: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
--- a/third_party/zeroclaw/docs/README.nb.md
+++ b/third_party/zeroclaw/docs/README.nb.md
@@ -0,0 +1,99 @@
+# ZeroClaw Dokumentasjonshub
+
+Denne siden er hovedinngangen til dokumentasjonssystemet.
+
+Sist oppdatert: **21. februar 2026**.
+
+Lokaliserte huber: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Start her
+
+| Jeg vil…                                                            | Les dette                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Installere og kjøre ZeroClaw raskt                                  | [README.md (Hurtigstart)](../README.md#quick-start)                            |
+| Bootstrap med en enkelt kommando                                    | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                  |
+| Oppdatere eller avinstallere på macOS                               | [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)            |
+| Finne kommandoer etter oppgave                                      | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Raskt sjekke konfigurasjonsstandarder og nøkler                     | [config-reference.md](reference/api/config-reference.md)                       |
+| Konfigurere egendefinerte leverandører/endepunkter                  | [custom-providers.md](contributing/custom-providers.md)                        |
+| Konfigurere Z.AI / GLM-leverandøren                                | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                             |
+| Bruke LangGraph-integrasjonsmønstre                                | [langgraph-integration.md](contributing/langgraph-integration.md)              |
+| Drifte kjøretidsmiljøet (dag 2-runbook)                             | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Feilsøke installasjon/kjøretid/kanal-problemer                     | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Kjøre Matrix-kryptert rom-oppsett og diagnostikk                   | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                          |
+| Bla gjennom dokumentasjon etter kategori                            | [SUMMARY.md](SUMMARY.md)                                                      |
+| Se prosjektets PR/issue-dokumentasjonsøyeblikksbilde                | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Raskt beslutningstre (10 sekunder)
+
+- Trenger førstegangsoppsett eller installasjon? → [setup-guides/README.md](setup-guides/README.md)
+- Trenger nøyaktige CLI/konfigurasjonsnøkler? → [reference/README.md](reference/README.md)
+- Trenger produksjons-/tjenestedrift? → [ops/README.md](ops/README.md)
+- Ser du feil eller regresjoner? → [troubleshooting.md](ops/troubleshooting.md)
+- Jobber med sikkerhetsherding eller veikart? → [security/README.md](security/README.md)
+- Jobber med kort/periferiutstyr? → [hardware/README.md](hardware/README.md)
+- Bidrag/gjennomgang/CI-arbeidsflyt? → [contributing/README.md](contributing/README.md)
+- Vil du ha det fullstendige kartet? → [SUMMARY.md](SUMMARY.md)
+
+## Samlinger (Anbefalt)
+
+- Kom i gang: [setup-guides/README.md](setup-guides/README.md)
+- Referansekataloger: [reference/README.md](reference/README.md)
+- Drift og utrulling: [ops/README.md](ops/README.md)
+- Sikkerhetsdokumentasjon: [security/README.md](security/README.md)
+- Maskinvare/periferiutstyr: [hardware/README.md](hardware/README.md)
+- Bidrag/CI: [contributing/README.md](contributing/README.md)
+- Prosjektøyeblikksbilder: [maintainers/README.md](maintainers/README.md)
+
+## Etter målgruppe
+
+### Brukere / Operatører
+
+- [commands-reference.md](reference/cli/commands-reference.md) — kommandooppslag etter arbeidsflyt
+- [providers-reference.md](reference/api/providers-reference.md) — leverandør-IDer, aliaser, legitimasjonsmiljøvariabler
+- [channels-reference.md](reference/api/channels-reference.md) — kanalegenskaper og oppsettstier
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix kryptert rom (E2EE)-oppsett og diagnostikk for manglende svar
+- [config-reference.md](reference/api/config-reference.md) — viktige konfigurasjonsnøkler og sikre standardverdier
+- [custom-providers.md](contributing/custom-providers.md) — maler for egendefinert leverandør/basis-URL-integrasjon
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM-oppsett og endepunktmatrise
+- [langgraph-integration.md](contributing/langgraph-integration.md) — reserveintegrasjon for modell/verktøykall-grensetilfeller
+- [operations-runbook.md](ops/operations-runbook.md) — dag 2 kjøretidsdrift og tilbakestillingsflyt
+- [troubleshooting.md](ops/troubleshooting.md) — vanlige feilsignaturer og gjenopprettingstrinn
+
+### Bidragsytere / Vedlikeholdere
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Sikkerhet / Pålitelighet
+
+> Merk: dette området inkluderer forslags-/veikartdokumenter. For nåværende oppførsel, start med [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) og [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Systemnavigasjon og styring
+
+- Samlet innholdsfortegnelse: [SUMMARY.md](SUMMARY.md)
+- Dokumentasjonsstrukturkart (språk/del/funksjon): [structure/README.md](maintainers/structure-README.md)
+- Dokumentasjonsinventar/klassifisering: [docs-inventory.md](maintainers/docs-inventory.md)
+- i18n-dokumentasjonsindeks: [i18n/README.md](i18n/README.md)
+- i18n-dekningskart: [i18n-coverage.md](maintainers/i18n-coverage.md)
+- Prosjekttriageringsøyeblikksbilde: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Andre språk
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.nl.md
+++ b/third_party/zeroclaw/docs/README.nl.md
@@ -0,0 +1,96 @@
+# ZeroClaw Documentatiehub
+
+Deze pagina is het primaire toegangspunt voor het documentatiesysteem.
+
+Laatst bijgewerkt: **20 februari 2026**.
+
+Gelokaliseerde hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Begin Hier
+
+| Ik wil…                                                             | Lees dit                                                                       |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| ZeroClaw snel installeren en uitvoeren                              | [README.md (Snelle Start)](../README.md#quick-start)                           |
+| Bootstrap met één commando                                          | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Commando's zoeken op taak                                           | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Snel configuratiesleutels en standaardwaarden controleren           | [config-reference.md](reference/api/config-reference.md)                       |
+| Aangepaste providers/endpoints configureren                         | [custom-providers.md](contributing/custom-providers.md)                         |
+| Z.AI / GLM-provider instellen                                      | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| LangGraph-integratiepatronen gebruiken                              | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| De runtime beheren (dag-2 runbook)                                  | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Installatie-/runtime-/kanaalproblemen oplossen                      | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Matrix versleutelde ruimtes configureren en diagnosticeren          | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Documentatie per categorie bekijken                                 | [SUMMARY.md](SUMMARY.md)                                                       |
+| Docs-momentopname van project-PR's/issues bekijken                  | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Snelle Beslisboom (10 seconden)
+
+- Eerste installatie of configuratie nodig? → [setup-guides/README.md](setup-guides/README.md)
+- Exacte CLI-/configuratiesleutels nodig? → [reference/README.md](reference/README.md)
+- Productie-/servicebeheer nodig? → [ops/README.md](ops/README.md)
+- Fouten of regressies? → [troubleshooting.md](ops/troubleshooting.md)
+- Bezig met beveiligingsverharding of roadmap? → [security/README.md](security/README.md)
+- Werken met boards/randapparatuur? → [hardware/README.md](hardware/README.md)
+- Bijdrage/review/CI-workflow? → [contributing/README.md](contributing/README.md)
+- De volledige kaart bekijken? → [SUMMARY.md](SUMMARY.md)
+
+## Collecties (Aanbevolen)
+
+- Aan de slag: [setup-guides/README.md](setup-guides/README.md)
+- Referentiecatalogi: [reference/README.md](reference/README.md)
+- Beheer & implementatie: [ops/README.md](ops/README.md)
+- Beveiligingsdocs: [security/README.md](security/README.md)
+- Hardware/randapparatuur: [hardware/README.md](hardware/README.md)
+- Bijdrage/CI: [contributing/README.md](contributing/README.md)
+- Projectmomentopnamen: [maintainers/README.md](maintainers/README.md)
+
+## Per Doelgroep
+
+### Gebruikers / Beheerders
+
+- [commands-reference.md](reference/cli/commands-reference.md) — commando's zoeken op workflow
+- [providers-reference.md](reference/api/providers-reference.md) — provider-ID's, aliassen, omgevingsvariabelen voor inloggegevens
+- [channels-reference.md](reference/api/channels-reference.md) — kanaalmogelijkheden en configuratiepaden
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix versleutelde ruimtes (E2EE) instellen en diagnostiek bij geen reactie
+- [config-reference.md](reference/api/config-reference.md) — configuratiesleutels met hoog belang en veilige standaardwaarden
+- [custom-providers.md](contributing/custom-providers.md) — integratie-patronen voor aangepaste providers/basis-URL
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM-configuratie en endpointmatrix
+- [langgraph-integration.md](contributing/langgraph-integration.md) — fallback-integratie voor model-/toolaanroep-randgevallen
+- [operations-runbook.md](ops/operations-runbook.md) — dag-2 runtime-operaties en rollbackflows
+- [troubleshooting.md](ops/troubleshooting.md) — veelvoorkomende foutpatronen en herstelstappen
+
+### Bijdragers / Beheerders
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Beveiliging / Betrouwbaarheid
+
+> Opmerking: dit gedeelte bevat voorstel-/roadmapdocumenten. Voor het huidige gedrag, begin met [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) en [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Systeemnavigatie & Governance
+
+- Uniforme inhoudsopgave: [SUMMARY.md](SUMMARY.md)
+- Documentatiestructuurkaart (taal/deel/functie): [structure/README.md](maintainers/structure-README.md)
+- Documentatie-inventaris/-classificatie: [docs-inventory.md](maintainers/docs-inventory.md)
+- Projecttriage-momentopname: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Andere talen
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.pl.md
+++ b/third_party/zeroclaw/docs/README.pl.md
@@ -0,0 +1,96 @@
+# Centrum Dokumentacji ZeroClaw
+
+Ta strona jest głównym punktem wejścia do systemu dokumentacji.
+
+Ostatnia aktualizacja: **20 lutego 2026**.
+
+Zlokalizowane centra: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Zacznij tutaj
+
+| Chcę…                                                               | Przeczytaj to                                                                  |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Szybko zainstalować i uruchomić ZeroClaw                            | [README.md (Szybki Start)](../README.md#quick-start)                           |
+| Bootstrap jednym poleceniem                                         | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Znaleźć polecenia według zadania                                    | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Szybko sprawdzić klucze konfiguracji i wartości domyślne            | [config-reference.md](reference/api/config-reference.md)                       |
+| Skonfigurować niestandardowych dostawców/endpointy                  | [custom-providers.md](contributing/custom-providers.md)                         |
+| Skonfigurować dostawcę Z.AI / GLM                                   | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Użyć wzorców integracji LangGraph                                   | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Zarządzać środowiskiem uruchomieniowym (runbook dzień-2)            | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Rozwiązać problemy z instalacją/runtime/kanałami                    | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Skonfigurować i zdiagnozować szyfrowane pokoje Matrix               | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Przeglądać dokumentację według kategorii                            | [SUMMARY.md](SUMMARY.md)                                                       |
+| Zobaczyć migawkę dokumentacji PR-ów/issues projektu                 | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Szybkie Drzewo Decyzyjne (10 sekund)
+
+- Potrzebujesz pierwszej instalacji lub konfiguracji? → [setup-guides/README.md](setup-guides/README.md)
+- Potrzebujesz dokładnych kluczy CLI/konfiguracji? → [reference/README.md](reference/README.md)
+- Potrzebujesz operacji produkcyjnych/serwisowych? → [ops/README.md](ops/README.md)
+- Widzisz błędy lub regresje? → [troubleshooting.md](ops/troubleshooting.md)
+- Pracujesz nad wzmocnieniem bezpieczeństwa lub mapą drogową? → [security/README.md](security/README.md)
+- Pracujesz z płytkami/peryferiami? → [hardware/README.md](hardware/README.md)
+- Kontrybuowanie/recenzja/workflow CI? → [contributing/README.md](contributing/README.md)
+- Chcesz zobaczyć pełną mapę? → [SUMMARY.md](SUMMARY.md)
+
+## Kolekcje (Zalecane)
+
+- Rozpoczęcie pracy: [setup-guides/README.md](setup-guides/README.md)
+- Katalogi referencyjne: [reference/README.md](reference/README.md)
+- Operacje i wdrożenie: [ops/README.md](ops/README.md)
+- Dokumentacja bezpieczeństwa: [security/README.md](security/README.md)
+- Hardware/peryferia: [hardware/README.md](hardware/README.md)
+- Kontrybuowanie/CI: [contributing/README.md](contributing/README.md)
+- Migawki projektu: [maintainers/README.md](maintainers/README.md)
+
+## Według Odbiorców
+
+### Użytkownicy / Operatorzy
+
+- [commands-reference.md](reference/cli/commands-reference.md) — wyszukiwanie poleceń według workflow
+- [providers-reference.md](reference/api/providers-reference.md) — ID dostawców, aliasy, zmienne środowiskowe uwierzytelniania
+- [channels-reference.md](reference/api/channels-reference.md) — możliwości kanałów i ścieżki konfiguracji
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — konfiguracja szyfrowanych pokojów Matrix (E2EE) i diagnostyka braku odpowiedzi
+- [config-reference.md](reference/api/config-reference.md) — klucze konfiguracji o wysokim znaczeniu i bezpieczne wartości domyślne
+- [custom-providers.md](contributing/custom-providers.md) — wzorce integracji niestandardowych dostawców/bazowego URL
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — konfiguracja Z.AI/GLM i matryca endpointów
+- [langgraph-integration.md](contributing/langgraph-integration.md) — integracja awaryjna dla przypadków brzegowych modelu/wywołania narzędzi
+- [operations-runbook.md](ops/operations-runbook.md) — operacje runtime dzień-2 i przepływy rollbacku
+- [troubleshooting.md](ops/troubleshooting.md) — typowe sygnatury błędów i kroki odzyskiwania
+
+### Kontrybutorzy / Opiekunowie
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Bezpieczeństwo / Niezawodność
+
+> Uwaga: ta sekcja zawiera dokumenty propozycji/mapy drogowej. Dla aktualnego zachowania zacznij od [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) i [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Nawigacja Systemowa i Zarządzanie
+
+- Ujednolicony spis treści: [SUMMARY.md](SUMMARY.md)
+- Mapa struktury dokumentacji (język/część/funkcja): [structure/README.md](maintainers/structure-README.md)
+- Inwentarz/klasyfikacja dokumentacji: [docs-inventory.md](maintainers/docs-inventory.md)
+- Migawka triażu projektu: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Inne języki
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.pt.md
+++ b/third_party/zeroclaw/docs/README.pt.md
@@ -0,0 +1,96 @@
+# Centro de Documentação ZeroClaw
+
+Esta página é o ponto de entrada principal do sistema de documentação.
+
+Última atualização: **20 de fevereiro de 2026**.
+
+Centros localizados: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Comece Aqui
+
+| Eu quero…                                                           | Leia isto                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Instalar e executar o ZeroClaw rapidamente                          | [README.md (Início Rápido)](../README.md#quick-start)                          |
+| Bootstrap com um único comando                                      | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Encontrar comandos por tarefa                                       | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Verificar rapidamente chaves de configuração e valores padrão       | [config-reference.md](reference/api/config-reference.md)                       |
+| Configurar provedores/endpoints personalizados                      | [custom-providers.md](contributing/custom-providers.md)                         |
+| Configurar o provedor Z.AI / GLM                                    | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Usar padrões de integração LangGraph                                | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Operar o runtime (runbook dia-2)                                    | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Resolver problemas de instalação/runtime/canal                      | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Configurar e diagnosticar salas criptografadas Matrix               | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Navegar na documentação por categoria                               | [SUMMARY.md](SUMMARY.md)                                                       |
+| Ver instantâneo de docs de PRs/issues do projeto                    | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Árvore de Decisão Rápida (10 segundos)
+
+- Precisa de instalação ou configuração inicial? → [setup-guides/README.md](setup-guides/README.md)
+- Precisa de chaves CLI/configuração exatas? → [reference/README.md](reference/README.md)
+- Precisa de operações de produção/serviço? → [ops/README.md](ops/README.md)
+- Vê falhas ou regressões? → [troubleshooting.md](ops/troubleshooting.md)
+- Trabalhando em endurecimento de segurança ou roadmap? → [security/README.md](security/README.md)
+- Trabalhando com placas/periféricos? → [hardware/README.md](hardware/README.md)
+- Contribuição/revisão/workflow CI? → [contributing/README.md](contributing/README.md)
+- Quer o mapa completo? → [SUMMARY.md](SUMMARY.md)
+
+## Coleções (Recomendadas)
+
+- Primeiros passos: [setup-guides/README.md](setup-guides/README.md)
+- Catálogos de referência: [reference/README.md](reference/README.md)
+- Operações e implantação: [ops/README.md](ops/README.md)
+- Documentação de segurança: [security/README.md](security/README.md)
+- Hardware/periféricos: [hardware/README.md](hardware/README.md)
+- Contribuição/CI: [contributing/README.md](contributing/README.md)
+- Instantâneos do projeto: [maintainers/README.md](maintainers/README.md)
+
+## Por Público
+
+### Usuários / Operadores
+
+- [commands-reference.md](reference/cli/commands-reference.md) — busca de comandos por workflow
+- [providers-reference.md](reference/api/providers-reference.md) — IDs de provedores, aliases, variáveis de ambiente de credenciais
+- [channels-reference.md](reference/api/channels-reference.md) — capacidades dos canais e caminhos de configuração
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — configuração de salas criptografadas Matrix (E2EE) e diagnóstico de não resposta
+- [config-reference.md](reference/api/config-reference.md) — chaves de configuração de alto sinal e valores padrão seguros
+- [custom-providers.md](contributing/custom-providers.md) — padrões de integração de provedor personalizado/URL base
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — configuração Z.AI/GLM e matriz de endpoints
+- [langgraph-integration.md](contributing/langgraph-integration.md) — integração de fallback para casos extremos de modelo/chamada de ferramenta
+- [operations-runbook.md](ops/operations-runbook.md) — operações runtime dia-2 e fluxos de rollback
+- [troubleshooting.md](ops/troubleshooting.md) — assinaturas de falha comuns e etapas de recuperação
+
+### Contribuidores / Mantenedores
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Segurança / Confiabilidade
+
+> Nota: esta seção inclui documentos de proposta/roadmap. Para o comportamento atual, comece com [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) e [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Navegação do Sistema e Governança
+
+- Índice unificado: [SUMMARY.md](SUMMARY.md)
+- Mapa da estrutura de docs (idioma/parte/função): [structure/README.md](maintainers/structure-README.md)
+- Inventário/classificação da documentação: [docs-inventory.md](maintainers/docs-inventory.md)
+- Instantâneo de triagem do projeto: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Outros idiomas
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.ro.md
+++ b/third_party/zeroclaw/docs/README.ro.md
@@ -0,0 +1,96 @@
+# Centrul de Documentație ZeroClaw
+
+Această pagină este punctul de intrare principal al sistemului de documentație.
+
+Ultima actualizare: **20 februarie 2026**.
+
+Centre localizate: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Începeți Aici
+
+| Vreau să…                                                           | Citiți aceasta                                                                 |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Instalez și rulez ZeroClaw rapid                                    | [README.md (Start Rapid)](../README.md#quick-start)                            |
+| Bootstrap cu o singură comandă                                      | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Găsesc comenzi după sarcină                                         | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Verific rapid cheile de configurare și valorile implicite           | [config-reference.md](reference/api/config-reference.md)                       |
+| Configurez furnizori/endpoint-uri personalizate                     | [custom-providers.md](contributing/custom-providers.md)                         |
+| Configurez furnizorul Z.AI / GLM                                    | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Folosesc modelele de integrare LangGraph                            | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Administrez runtime-ul (runbook ziua-2)                             | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Depanez probleme de instalare/runtime/canal                         | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Configurez și diagnostichez camerele criptate Matrix                | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Navighez documentația pe categorii                                  | [SUMMARY.md](SUMMARY.md)                                                       |
+| Văd instantaneul documentației PR-urilor/issue-urilor proiectului   | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Arbore de Decizie Rapid (10 secunde)
+
+- Aveți nevoie de instalare sau configurare inițială? → [setup-guides/README.md](setup-guides/README.md)
+- Aveți nevoie de chei CLI/configurare exacte? → [reference/README.md](reference/README.md)
+- Aveți nevoie de operațiuni de producție/serviciu? → [ops/README.md](ops/README.md)
+- Vedeți erori sau regresii? → [troubleshooting.md](ops/troubleshooting.md)
+- Lucrați la consolidarea securității sau foaia de parcurs? → [security/README.md](security/README.md)
+- Lucrați cu plăci/periferice? → [hardware/README.md](hardware/README.md)
+- Contribuție/recenzie/workflow CI? → [contributing/README.md](contributing/README.md)
+- Doriți harta completă? → [SUMMARY.md](SUMMARY.md)
+
+## Colecții (Recomandate)
+
+- Primii pași: [setup-guides/README.md](setup-guides/README.md)
+- Cataloage de referință: [reference/README.md](reference/README.md)
+- Operațiuni și implementare: [ops/README.md](ops/README.md)
+- Documentație de securitate: [security/README.md](security/README.md)
+- Hardware/periferice: [hardware/README.md](hardware/README.md)
+- Contribuție/CI: [contributing/README.md](contributing/README.md)
+- Instantanee ale proiectului: [maintainers/README.md](maintainers/README.md)
+
+## După Public
+
+### Utilizatori / Operatori
+
+- [commands-reference.md](reference/cli/commands-reference.md) — căutare comenzi după workflow
+- [providers-reference.md](reference/api/providers-reference.md) — ID-uri furnizori, aliasuri, variabile de mediu pentru acreditări
+- [channels-reference.md](reference/api/channels-reference.md) — capacitățile canalelor și căile de configurare
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — configurarea camerelor criptate Matrix (E2EE) și diagnosticarea lipsei de răspuns
+- [config-reference.md](reference/api/config-reference.md) — chei de configurare cu semnal ridicat și valori implicite sigure
+- [custom-providers.md](contributing/custom-providers.md) — modele de integrare furnizor personalizat/URL de bază
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — configurare Z.AI/GLM și matricea endpoint-urilor
+- [langgraph-integration.md](contributing/langgraph-integration.md) — integrare de rezervă pentru cazurile limită ale modelului/apelului de instrumente
+- [operations-runbook.md](ops/operations-runbook.md) — operațiuni runtime ziua-2 și fluxuri de rollback
+- [troubleshooting.md](ops/troubleshooting.md) — semnături de erori comune și pași de recuperare
+
+### Contribuitori / Întreținători
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Securitate / Fiabilitate
+
+> Notă: această secțiune include documente de propunere/foaie de parcurs. Pentru comportamentul actual, începeți cu [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) și [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Navigare în Sistem și Guvernanță
+
+- Cuprins unificat: [SUMMARY.md](SUMMARY.md)
+- Harta structurii documentației (limbă/parte/funcție): [structure/README.md](maintainers/structure-README.md)
+- Inventar/clasificare a documentației: [docs-inventory.md](maintainers/docs-inventory.md)
+- Instantaneu de triaj al proiectului: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Alte limbi
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.ru.md
+++ b/third_party/zeroclaw/docs/README.ru.md
@@ -0,0 +1,92 @@
+# Документация ZeroClaw (Русский)
+
+Эта страница — русскоязычная точка входа в документацию.
+
+Последняя синхронизация: **2026-02-18**.
+
+> Примечание: команды, ключи конфигурации и API-пути сохраняются на английском. Для первоисточника ориентируйтесь на англоязычные документы.
+
+## Быстрые ссылки
+
+| Что нужно | Куда смотреть |
+|---|---|
+| Быстро установить и запустить | [../README.ru.md](../README.ru.md) / [../README.md](../README.md) |
+| Установить одной командой | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) |
+| Найти команды по задаче | [commands-reference.md](reference/cli/commands-reference.md) |
+| Проверить ключи конфигурации и дефолты | [config-reference.md](reference/api/config-reference.md) |
+| Подключить кастомный provider / endpoint | [custom-providers.md](contributing/custom-providers.md) |
+| Настроить provider Z.AI / GLM | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) |
+| Использовать интеграцию LangGraph | [langgraph-integration.md](contributing/langgraph-integration.md) |
+| Операционный runbook (day-2) | [operations-runbook.md](ops/operations-runbook.md) |
+| Быстро устранить типовые проблемы | [troubleshooting.md](ops/troubleshooting.md) |
+| Открыть общий TOC docs | [SUMMARY.md](SUMMARY.md) |
+| Посмотреть snapshot PR/Issue | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Дерево решений на 10 секунд
+
+- Нужна первая установка и быстрый старт → [setup-guides/README.md](setup-guides/README.md)
+- Нужны точные команды и ключи конфигурации → [reference/README.md](reference/README.md)
+- Нужны операции/сервисный режим/деплой → [ops/README.md](ops/README.md)
+- Есть ошибки, сбои или регрессии → [troubleshooting.md](ops/troubleshooting.md)
+- Нужны материалы по безопасности и roadmap → [security/README.md](security/README.md)
+- Работаете с платами и периферией → [hardware/README.md](hardware/README.md)
+- Нужны процессы вклада, ревью и CI → [contributing/README.md](contributing/README.md)
+- Нужна полная карта docs → [SUMMARY.md](SUMMARY.md)
+
+## Навигация по категориям (рекомендуется)
+
+- Старт и установка: [setup-guides/README.md](setup-guides/README.md)
+- Справочники: [reference/README.md](reference/README.md)
+- Операции и деплой: [ops/README.md](ops/README.md)
+- Безопасность: [security/README.md](security/README.md)
+- Аппаратная часть: [hardware/README.md](hardware/README.md)
+- Вклад и CI: [contributing/README.md](contributing/README.md)
+- Снимки проекта: [maintainers/README.md](maintainers/README.md)
+
+## По ролям
+
+### Пользователи / Операторы
+
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+
+### Контрибьюторы / Мейнтейнеры
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Безопасность / Надёжность
+
+> Примечание: часть документов в этом разделе относится к proposal/roadmap и может содержать гипотетические команды/конфигурации. Для текущего поведения сначала смотрите [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Инвентаризация и структура docs
+
+- Единый TOC: [SUMMARY.md](SUMMARY.md)
+- Карта структуры docs (язык/раздел/функция): [structure/README.md](maintainers/structure-README.md)
+- Инвентарь и классификация docs: [docs-inventory.md](maintainers/docs-inventory.md)
+
+## Другие языки
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.sv.md
+++ b/third_party/zeroclaw/docs/README.sv.md
@@ -0,0 +1,96 @@
+# ZeroClaw Dokumentationshubb
+
+Denna sida är den primära ingångspunkten för dokumentationssystemet.
+
+Senast uppdaterad: **20 februari 2026**.
+
+Lokaliserade hubbar: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Börja Här
+
+| Jag vill…                                                           | Läs detta                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Installera och köra ZeroClaw snabbt                                 | [README.md (Snabbstart)](../README.md#quick-start)                             |
+| Bootstrap med ett enda kommando                                     | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Hitta kommandon efter uppgift                                       | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Snabbt kontrollera konfigurationsnycklar och standardvärden         | [config-reference.md](reference/api/config-reference.md)                       |
+| Konfigurera anpassade leverantörer/endpoints                        | [custom-providers.md](contributing/custom-providers.md)                         |
+| Konfigurera Z.AI / GLM-leverantören                                 | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Använda LangGraph-integrationsmönster                               | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Hantera runtime (dag-2 runbook)                                     | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Felsöka installations-/runtime-/kanalproblem                        | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Konfigurera och diagnostisera krypterade Matrix-rum                 | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Bläddra i dokumentation efter kategori                              | [SUMMARY.md](SUMMARY.md)                                                       |
+| Se dokumentationsöversikt för projektets PR:er/issues               | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Snabbt Beslutsträd (10 sekunder)
+
+- Behöver initial installation eller konfiguration? → [setup-guides/README.md](setup-guides/README.md)
+- Behöver exakta CLI-/konfigurationsnycklar? → [reference/README.md](reference/README.md)
+- Behöver produktions-/tjänsteoperationer? → [ops/README.md](ops/README.md)
+- Ser du fel eller regressioner? → [troubleshooting.md](ops/troubleshooting.md)
+- Arbetar med säkerhetshärdning eller färdplan? → [security/README.md](security/README.md)
+- Arbetar med kort/kringutrustning? → [hardware/README.md](hardware/README.md)
+- Bidrag/granskning/CI-arbetsflöde? → [contributing/README.md](contributing/README.md)
+- Vill du se hela kartan? → [SUMMARY.md](SUMMARY.md)
+
+## Samlingar (Rekommenderade)
+
+- Kom igång: [setup-guides/README.md](setup-guides/README.md)
+- Referenskataloger: [reference/README.md](reference/README.md)
+- Drift och driftsättning: [ops/README.md](ops/README.md)
+- Säkerhetsdokumentation: [security/README.md](security/README.md)
+- Hårdvara/kringutrustning: [hardware/README.md](hardware/README.md)
+- Bidrag/CI: [contributing/README.md](contributing/README.md)
+- Projektögonblicksbilder: [maintainers/README.md](maintainers/README.md)
+
+## Per Målgrupp
+
+### Användare / Operatörer
+
+- [commands-reference.md](reference/cli/commands-reference.md) — sök kommandon efter arbetsflöde
+- [providers-reference.md](reference/api/providers-reference.md) — leverantörs-ID:n, alias, miljövariabler för autentiseringsuppgifter
+- [channels-reference.md](reference/api/channels-reference.md) — kanalkapaciteter och konfigurationsvägar
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — konfiguration av krypterade Matrix-rum (E2EE) och diagnostik vid uteblivet svar
+- [config-reference.md](reference/api/config-reference.md) — konfigurationsnycklar med hög signalstyrka och säkra standardvärden
+- [custom-providers.md](contributing/custom-providers.md) — integrationsmönster för anpassad leverantör/bas-URL
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM-konfiguration och endpointmatris
+- [langgraph-integration.md](contributing/langgraph-integration.md) — reservintegration för modell-/verktygsanropsspecialfall
+- [operations-runbook.md](ops/operations-runbook.md) — dag-2 runtime-operationer och rollback-flöden
+- [troubleshooting.md](ops/troubleshooting.md) — vanliga felmönster och återställningssteg
+
+### Bidragsgivare / Underhållare
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Säkerhet / Tillförlitlighet
+
+> Observera: denna sektion innehåller förslags-/färdplansdokument. För aktuellt beteende, börja med [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) och [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Systemnavigering och Styrning
+
+- Enhetlig innehållsförteckning: [SUMMARY.md](SUMMARY.md)
+- Dokumentationsstrukturkarta (språk/del/funktion): [structure/README.md](maintainers/structure-README.md)
+- Dokumentationsinventering/-klassificering: [docs-inventory.md](maintainers/docs-inventory.md)
+- Projekttriageringsögonblicksbild: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Andra språk
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.th.md
+++ b/third_party/zeroclaw/docs/README.th.md
@@ -0,0 +1,96 @@
+# ศูนย์กลางเอกสาร ZeroClaw
+
+หน้านี้เป็นจุดเริ่มต้นหลักของระบบเอกสาร
+
+อัปเดตล่าสุด: **21 กุมภาพันธ์ 2026**
+
+ศูนย์กลางภาษาต่าง ๆ: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## เริ่มต้นที่นี่
+
+| ฉันต้องการ…                                                          | อ่านสิ่งนี้                                                                    |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| ติดตั้งและรัน ZeroClaw อย่างรวดเร็ว                                    | [README.md (เริ่มต้นอย่างรวดเร็ว)](../README.md#quick-start)                    |
+| ติดตั้งด้วยคำสั่งเดียว                                                | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| ค้นหาคำสั่งตามงาน                                                    | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| ตรวจสอบคีย์และค่าเริ่มต้นของการตั้งค่าอย่างรวดเร็ว                     | [config-reference.md](reference/api/config-reference.md)                       |
+| ตั้งค่าผู้ให้บริการ/endpoint แบบกำหนดเอง                               | [custom-providers.md](contributing/custom-providers.md)                         |
+| ตั้งค่าผู้ให้บริการ Z.AI / GLM                                        | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| ใช้รูปแบบการรวม LangGraph                                            | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| ดำเนินงาน runtime (คู่มือปฏิบัติการวันที่ 2)                          | [operations-runbook.md](ops/operations-runbook.md)                             |
+| แก้ไขปัญหาการติดตั้ง/runtime/ช่องทาง                                  | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| รันการตั้งค่าและวินิจฉัยห้อง Matrix แบบเข้ารหัส                        | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| เรียกดูเอกสารตามหมวดหมู่                                              | [SUMMARY.md](SUMMARY.md)                                                       |
+| ดูสแนปช็อตเอกสาร PR/issue ของโปรเจกต์                                 | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## แผนผังการตัดสินใจอย่างรวดเร็ว (10 วินาที)
+
+- ต้องการการตั้งค่าหรือการติดตั้งเบื้องต้น? → [setup-guides/README.md](setup-guides/README.md)
+- ต้องการคีย์ CLI/config ที่แน่นอน? → [reference/README.md](reference/README.md)
+- ต้องการการดำเนินงานระดับโปรดักชัน/เซอร์วิส? → [ops/README.md](ops/README.md)
+- พบความล้มเหลวหรือการถดถอย? → [troubleshooting.md](ops/troubleshooting.md)
+- ทำงานเกี่ยวกับการเสริมความปลอดภัยหรือแผนงาน? → [security/README.md](security/README.md)
+- ทำงานกับบอร์ด/อุปกรณ์ต่อพ่วง? → [hardware/README.md](hardware/README.md)
+- การมีส่วนร่วม/รีวิว/เวิร์กโฟลว์ CI? → [contributing/README.md](contributing/README.md)
+- ต้องการแผนที่ทั้งหมด? → [SUMMARY.md](SUMMARY.md)
+
+## คอลเลกชัน (แนะนำ)
+
+- เริ่มต้น: [setup-guides/README.md](setup-guides/README.md)
+- แคตตาล็อกอ้างอิง: [reference/README.md](reference/README.md)
+- การดำเนินงานและการปรับใช้: [ops/README.md](ops/README.md)
+- เอกสารความปลอดภัย: [security/README.md](security/README.md)
+- ฮาร์ดแวร์/อุปกรณ์ต่อพ่วง: [hardware/README.md](hardware/README.md)
+- การมีส่วนร่วม/CI: [contributing/README.md](contributing/README.md)
+- สแนปช็อตโปรเจกต์: [maintainers/README.md](maintainers/README.md)
+
+## ตามกลุ่มผู้ใช้
+
+### ผู้ใช้ / ผู้ดำเนินงาน
+
+- [commands-reference.md](reference/cli/commands-reference.md) — ค้นหาคำสั่งตามเวิร์กโฟลว์
+- [providers-reference.md](reference/api/providers-reference.md) — ID ผู้ให้บริการ, นามแฝง, ตัวแปรสภาพแวดล้อมข้อมูลรับรอง
+- [channels-reference.md](reference/api/channels-reference.md) — ความสามารถของช่องทางและเส้นทางการตั้งค่า
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — การตั้งค่าห้อง Matrix แบบเข้ารหัส (E2EE) และการวินิจฉัยการไม่ตอบสนอง
+- [config-reference.md](reference/api/config-reference.md) — คีย์การตั้งค่าที่สำคัญและค่าเริ่มต้นที่ปลอดภัย
+- [custom-providers.md](contributing/custom-providers.md) — รูปแบบการรวมผู้ให้บริการแบบกำหนดเอง/URL ฐาน
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — การตั้งค่า Z.AI/GLM และเมทริกซ์ endpoint
+- [langgraph-integration.md](contributing/langgraph-integration.md) — การรวมแบบ fallback สำหรับกรณีพิเศษของโมเดล/การเรียกเครื่องมือ
+- [operations-runbook.md](ops/operations-runbook.md) — การดำเนินงาน runtime วันที่ 2 และโฟลว์การย้อนกลับ
+- [troubleshooting.md](ops/troubleshooting.md) — ลายเซ็นความล้มเหลวทั่วไปและขั้นตอนการกู้คืน
+
+### ผู้มีส่วนร่วม / ผู้ดูแล
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### ความปลอดภัย / ความน่าเชื่อถือ
+
+> หมายเหตุ: ส่วนนี้รวมเอกสารข้อเสนอ/แผนงาน สำหรับพฤติกรรมปัจจุบัน เริ่มต้นที่ [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) และ [troubleshooting.md](ops/troubleshooting.md)
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## การนำทางระบบและการกำกับดูแล
+
+- สารบัญรวม: [SUMMARY.md](SUMMARY.md)
+- แผนที่โครงสร้างเอกสาร (ภาษา/ส่วน/ฟังก์ชัน): [structure/README.md](maintainers/structure-README.md)
+- รายการ/การจำแนกเอกสาร: [docs-inventory.md](maintainers/docs-inventory.md)
+- สแนปช็อตการคัดกรองโปรเจกต์: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## ภาษาอื่น ๆ
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.tl.md
+++ b/third_party/zeroclaw/docs/README.tl.md
@@ -0,0 +1,96 @@
+# Sentro ng Dokumentasyon ng ZeroClaw
+
+Ang pahinang ito ang pangunahing entry point ng sistema ng dokumentasyon.
+
+Huling na-update: **Pebrero 21, 2026**.
+
+Mga lokal na sentro: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Magsimula Dito
+
+| Gusto ko…                                                           | Basahin ito                                                                    |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| I-install at patakbuhin ang ZeroClaw nang mabilis                    | [README.md (Mabilis na Pagsisimula)](../README.md#quick-start)                 |
+| Bootstrap sa isang utos                                              | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Hanapin ang mga utos ayon sa gawain                                  | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Mabilisang suriin ang mga config key at default na halaga             | [config-reference.md](reference/api/config-reference.md)                       |
+| Mag-set up ng custom na provider/endpoint                            | [custom-providers.md](contributing/custom-providers.md)                         |
+| I-set up ang Z.AI / GLM provider                                    | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Gamitin ang mga pattern ng integrasyon ng LangGraph                  | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Pamahalaan ang runtime (day-2 runbook)                               | [operations-runbook.md](ops/operations-runbook.md)                             |
+| I-troubleshoot ang mga isyu sa pag-install/runtime/channel           | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Patakbuhin ang setup at diagnostics ng encrypted Matrix room         | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| I-browse ang mga dokumento ayon sa kategorya                         | [SUMMARY.md](SUMMARY.md)                                                       |
+| Tingnan ang snapshot ng mga PR/issue ng proyekto                     | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Mabilisang Decision Tree (10 segundo)
+
+- Kailangan ng setup o unang pag-install? → [setup-guides/README.md](setup-guides/README.md)
+- Kailangan ng eksaktong CLI/config key? → [reference/README.md](reference/README.md)
+- Kailangan ng production/service operations? → [ops/README.md](ops/README.md)
+- May nakikitang pagkabigo o regression? → [troubleshooting.md](ops/troubleshooting.md)
+- Nagtatrabaho sa security hardening o roadmap? → [security/README.md](security/README.md)
+- Nagtatrabaho sa mga board/peripheral? → [hardware/README.md](hardware/README.md)
+- Kontribusyon/review/CI workflow? → [contributing/README.md](contributing/README.md)
+- Gusto mo ang buong mapa? → [SUMMARY.md](SUMMARY.md)
+
+## Mga Koleksyon (Inirerekomenda)
+
+- Pagsisimula: [setup-guides/README.md](setup-guides/README.md)
+- Mga katalogo ng reference: [reference/README.md](reference/README.md)
+- Operasyon at deployment: [ops/README.md](ops/README.md)
+- Mga dokumento ng seguridad: [security/README.md](security/README.md)
+- Hardware/peripheral: [hardware/README.md](hardware/README.md)
+- Kontribusyon/CI: [contributing/README.md](contributing/README.md)
+- Mga snapshot ng proyekto: [maintainers/README.md](maintainers/README.md)
+
+## Ayon sa Audience
+
+### Mga Gumagamit / Operator
+
+- [commands-reference.md](reference/cli/commands-reference.md) — paghahanap ng utos ayon sa workflow
+- [providers-reference.md](reference/api/providers-reference.md) — mga ID ng provider, alias, credential environment variable
+- [channels-reference.md](reference/api/channels-reference.md) — mga kakayahan ng channel at landas ng configuration
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — setup ng encrypted Matrix room (E2EE) at diagnostics ng hindi pagtugon
+- [config-reference.md](reference/api/config-reference.md) — mahahalagang config key at secure na default
+- [custom-providers.md](contributing/custom-providers.md) — pattern ng integrasyon ng custom provider/base URL
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — setup ng Z.AI/GLM at endpoint matrix
+- [langgraph-integration.md](contributing/langgraph-integration.md) — fallback na integrasyon para sa edge case ng model/tool call
+- [operations-runbook.md](ops/operations-runbook.md) — day-2 runtime operations at rollback flow
+- [troubleshooting.md](ops/troubleshooting.md) — karaniwang failure signature at mga hakbang sa pagbawi
+
+### Mga Kontribyutor / Maintainer
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Seguridad / Pagiging Maaasahan
+
+> Paalala: Kasama sa seksyong ito ang mga proposal/roadmap na dokumento. Para sa kasalukuyang gawi, magsimula sa [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), at [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Nabigasyon ng Sistema at Pamamahala
+
+- Pinag-isang talaan ng nilalaman: [SUMMARY.md](SUMMARY.md)
+- Mapa ng istruktura ng docs (wika/bahagi/function): [structure/README.md](maintainers/structure-README.md)
+- Imbentaryo/klasipikasyon ng dokumentasyon: [docs-inventory.md](maintainers/docs-inventory.md)
+- Snapshot ng triage ng proyekto: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Iba Pang Wika
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.tr.md
+++ b/third_party/zeroclaw/docs/README.tr.md
@@ -0,0 +1,96 @@
+# ZeroClaw Dokümantasyon Merkezi
+
+Bu sayfa, dokümantasyon sisteminin ana giriş noktasıdır.
+
+Son güncelleme: **21 Şubat 2026**.
+
+Yerelleştirilmiş merkezler: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Buradan Başlayın
+
+| Yapmak istediğim…                                                    | Bunu oku                                                                       |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| ZeroClaw'ı hızlıca kurup çalıştırmak                                | [README.md (Hızlı Başlangıç)](../README.md#quick-start)                        |
+| Tek komutla kurulum                                                  | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Göreve göre komut bulmak                                             | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Yapılandırma anahtarlarını ve varsayılan değerleri hızlıca kontrol   | [config-reference.md](reference/api/config-reference.md)                       |
+| Özel sağlayıcı/endpoint yapılandırmak                               | [custom-providers.md](contributing/custom-providers.md)                         |
+| Z.AI / GLM sağlayıcısını yapılandırmak                              | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| LangGraph entegrasyon kalıplarını kullanmak                          | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Çalışma zamanını yönetmek (2. gün runbook)                          | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Kurulum/çalışma zamanı/kanal sorunlarını gidermek                    | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Şifreli Matrix odası kurulumu ve tanılama çalıştırmak                | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Dokümantasyonu kategoriye göre göz atmak                             | [SUMMARY.md](SUMMARY.md)                                                       |
+| Proje PR/sorun anlık görüntüsünü görmek                             | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Hızlı Karar Ağacı (10 saniye)
+
+- Kurulum veya ilk yükleme mi gerekiyor? → [setup-guides/README.md](setup-guides/README.md)
+- Tam CLI/yapılandırma anahtarları mı gerekiyor? → [reference/README.md](reference/README.md)
+- Üretim/servis operasyonları mı gerekiyor? → [ops/README.md](ops/README.md)
+- Hatalar veya gerilemeler mi görüyorsunuz? → [troubleshooting.md](ops/troubleshooting.md)
+- Güvenlik sertleştirme veya yol haritası üzerinde mi çalışıyorsunuz? → [security/README.md](security/README.md)
+- Kartlar/çevre birimleri ile mi çalışıyorsunuz? → [hardware/README.md](hardware/README.md)
+- Katkı/inceleme/CI iş akışı mı? → [contributing/README.md](contributing/README.md)
+- Tam haritayı mı istiyorsunuz? → [SUMMARY.md](SUMMARY.md)
+
+## Koleksiyonlar (Önerilen)
+
+- Başlangıç: [setup-guides/README.md](setup-guides/README.md)
+- Referans katalogları: [reference/README.md](reference/README.md)
+- Operasyonlar ve dağıtım: [ops/README.md](ops/README.md)
+- Güvenlik belgeleri: [security/README.md](security/README.md)
+- Donanım/çevre birimleri: [hardware/README.md](hardware/README.md)
+- Katkı/CI: [contributing/README.md](contributing/README.md)
+- Proje anlık görüntüleri: [maintainers/README.md](maintainers/README.md)
+
+## Hedef Kitleye Göre
+
+### Kullanıcılar / Operatörler
+
+- [commands-reference.md](reference/cli/commands-reference.md) — iş akışına göre komut arama
+- [providers-reference.md](reference/api/providers-reference.md) — sağlayıcı kimlikleri, takma adlar, kimlik bilgisi ortam değişkenleri
+- [channels-reference.md](reference/api/channels-reference.md) — kanal yetenekleri ve yapılandırma yolları
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — şifreli Matrix odası (E2EE) kurulumu ve yanıt vermeme tanılaması
+- [config-reference.md](reference/api/config-reference.md) — yüksek önemli yapılandırma anahtarları ve güvenli varsayılanlar
+- [custom-providers.md](contributing/custom-providers.md) — özel sağlayıcı/temel URL entegrasyon kalıpları
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM yapılandırması ve endpoint matrisi
+- [langgraph-integration.md](contributing/langgraph-integration.md) — model/araç çağrısı uç durumları için yedek entegrasyon
+- [operations-runbook.md](ops/operations-runbook.md) — 2. gün çalışma zamanı operasyonları ve geri alma akışı
+- [troubleshooting.md](ops/troubleshooting.md) — yaygın hata imzaları ve kurtarma adımları
+
+### Katkıda Bulunanlar / Bakımcılar
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Güvenlik / Güvenilirlik
+
+> Not: Bu bölüm öneri/yol haritası belgelerini içerir. Mevcut davranış için [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) ve [troubleshooting.md](ops/troubleshooting.md) ile başlayın.
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Sistem Navigasyonu ve Yönetişim
+
+- Birleşik içindekiler: [SUMMARY.md](SUMMARY.md)
+- Dokümantasyon yapı haritası (dil/bölüm/işlev): [structure/README.md](maintainers/structure-README.md)
+- Dokümantasyon envanteri/sınıflandırması: [docs-inventory.md](maintainers/docs-inventory.md)
+- Proje triyaj anlık görüntüsü: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Diğer Diller
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.uk.md
+++ b/third_party/zeroclaw/docs/README.uk.md
@@ -0,0 +1,96 @@
+# Центр документації ZeroClaw
+
+Ця сторінка є основною точкою входу до системи документації.
+
+Останнє оновлення: **21 лютого 2026**.
+
+Локалізовані центри: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+
+## Почніть тут
+
+| Я хочу…                                                             | Читати це                                                                      |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Швидко встановити та запустити ZeroClaw                               | [README.md (Швидкий старт)](../README.md#quick-start)                           |
+| Налаштування однією командою                                         | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Знайти команди за завданням                                          | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| Швидко перевірити ключі конфігурації та значення за замовчуванням     | [config-reference.md](reference/api/config-reference.md)                       |
+| Налаштувати власного провайдера/endpoint                             | [custom-providers.md](contributing/custom-providers.md)                         |
+| Налаштувати провайдера Z.AI / GLM                                   | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| Використовувати шаблони інтеграції LangGraph                         | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| Керувати середовищем виконання (runbook 2-го дня)                    | [operations-runbook.md](ops/operations-runbook.md)                             |
+| Усунути проблеми встановлення/виконання/каналів                      | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| Запустити налаштування та діагностику зашифрованих кімнат Matrix      | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| Переглянути документацію за категоріями                               | [SUMMARY.md](SUMMARY.md)                                                       |
+| Переглянути знімок PR/issues проекту                                 | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Дерево швидких рішень (10 секунд)
+
+- Потрібне налаштування або початкове встановлення? → [setup-guides/README.md](setup-guides/README.md)
+- Потрібні точні ключі CLI/конфігурації? → [reference/README.md](reference/README.md)
+- Потрібні операції виробництва/сервісу? → [ops/README.md](ops/README.md)
+- Бачите збої або регресії? → [troubleshooting.md](ops/troubleshooting.md)
+- Працюєте над зміцненням безпеки або дорожньою картою? → [security/README.md](security/README.md)
+- Працюєте з платами/периферією? → [hardware/README.md](hardware/README.md)
+- Внесок/рецензування/робочий процес CI? → [contributing/README.md](contributing/README.md)
+- Хочете повну карту? → [SUMMARY.md](SUMMARY.md)
+
+## Колекції (Рекомендовані)
+
+- Початок роботи: [setup-guides/README.md](setup-guides/README.md)
+- Довідкові каталоги: [reference/README.md](reference/README.md)
+- Операції та розгортання: [ops/README.md](ops/README.md)
+- Документація з безпеки: [security/README.md](security/README.md)
+- Обладнання/периферія: [hardware/README.md](hardware/README.md)
+- Внесок/CI: [contributing/README.md](contributing/README.md)
+- Знімки проекту: [maintainers/README.md](maintainers/README.md)
+
+## За аудиторією
+
+### Користувачі / Оператори
+
+- [commands-reference.md](reference/cli/commands-reference.md) — пошук команд за робочим процесом
+- [providers-reference.md](reference/api/providers-reference.md) — ідентифікатори провайдерів, псевдоніми, змінні середовища облікових даних
+- [channels-reference.md](reference/api/channels-reference.md) — можливості каналів та шляхи конфігурації
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — налаштування зашифрованих кімнат Matrix (E2EE) та діагностика відсутності відповіді
+- [config-reference.md](reference/api/config-reference.md) — ключові параметри конфігурації та безпечні значення за замовчуванням
+- [custom-providers.md](contributing/custom-providers.md) — шаблони інтеграції власного провайдера/базової URL-адреси
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — налаштування Z.AI/GLM та матриця endpoint
+- [langgraph-integration.md](contributing/langgraph-integration.md) — резервна інтеграція для крайніх випадків моделі/виклику інструментів
+- [operations-runbook.md](ops/operations-runbook.md) — операції середовища виконання 2-го дня та потік відкату
+- [troubleshooting.md](ops/troubleshooting.md) — типові сигнатури збоїв та кроки відновлення
+
+### Учасники / Супровідники
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### Безпека / Надійність
+
+> Примітка: цей розділ містить документи пропозицій/дорожньої карти. Для поточної поведінки почніть з [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md) та [troubleshooting.md](ops/troubleshooting.md).
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## Навігація системою та управління
+
+- Єдиний зміст: [SUMMARY.md](SUMMARY.md)
+- Карта структури документації (мова/розділ/функція): [structure/README.md](maintainers/structure-README.md)
+- Інвентаризація/класифікація документації: [docs-inventory.md](maintainers/docs-inventory.md)
+- Знімок тріажу проекту: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## Інші мови
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.ur.md
+++ b/third_party/zeroclaw/docs/README.ur.md
@@ -0,0 +1,96 @@
+# ZeroClaw دستاویزات کا مرکز
+
+یہ صفحہ دستاویزات کے نظام کا بنیادی داخلی نقطہ ہے۔
+
+آخری تازہ کاری: **21 فروری 2026**۔
+
+مقامی مراکز: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md)۔
+
+## یہاں سے شروع کریں
+
+| مجھے چاہیے…                                                          | یہ پڑھیں                                                                       |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| ZeroClaw کو تیزی سے انسٹال اور چلانا                                 | [README.md (فوری آغاز)](../README.md#quick-start)                               |
+| ایک کمانڈ سے بوٹسٹریپ                                                | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| کام کے مطابق کمانڈز تلاش کرنا                                        | [commands-reference.md](reference/cli/commands-reference.md)                   |
+| کنفیگریشن کیز اور ڈیفالٹ اقدار کی فوری جانچ                         | [config-reference.md](reference/api/config-reference.md)                       |
+| حسب ضرورت فراہم کنندہ/اینڈ پوائنٹ ترتیب دینا                         | [custom-providers.md](contributing/custom-providers.md)                         |
+| Z.AI / GLM فراہم کنندہ ترتیب دینا                                    | [zai-glm-setup.md](setup-guides/zai-glm-setup.md)                              |
+| LangGraph انضمام کے نمونے استعمال کرنا                                | [langgraph-integration.md](contributing/langgraph-integration.md)               |
+| رن ٹائم چلانا (دوسرے دن کا رن بک)                                    | [operations-runbook.md](ops/operations-runbook.md)                             |
+| تنصیب/رن ٹائم/چینل مسائل حل کرنا                                     | [troubleshooting.md](ops/troubleshooting.md)                                   |
+| خفیہ کردہ Matrix کمرے کی ترتیب اور تشخیص چلانا                       | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md)                           |
+| زمرے کے مطابق دستاویزات براؤز کرنا                                   | [SUMMARY.md](SUMMARY.md)                                                       |
+| پراجیکٹ PR/مسائل کا سنیپ شاٹ دیکھنا                                 | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## فوری فیصلے کا درخت (10 سیکنڈ)
+
+- سیٹ اپ یا ابتدائی تنصیب درکار ہے؟ → [setup-guides/README.md](setup-guides/README.md)
+- درست CLI/کنفیگریشن کیز درکار ہیں؟ → [reference/README.md](reference/README.md)
+- پروڈکشن/سروس آپریشنز درکار ہیں؟ → [ops/README.md](ops/README.md)
+- ناکامیاں یا رجعت نظر آ رہی ہے؟ → [troubleshooting.md](ops/troubleshooting.md)
+- سیکیورٹی مضبوطی یا روڈ میپ پر کام کر رہے ہیں؟ → [security/README.md](security/README.md)
+- بورڈز/پیریفرلز کے ساتھ کام کر رہے ہیں؟ → [hardware/README.md](hardware/README.md)
+- شراکت/جائزہ/CI ورک فلو؟ → [contributing/README.md](contributing/README.md)
+- مکمل نقشہ چاہیے؟ → [SUMMARY.md](SUMMARY.md)
+
+## مجموعے (تجویز کردہ)
+
+- آغاز: [setup-guides/README.md](setup-guides/README.md)
+- حوالہ جاتی فہرستیں: [reference/README.md](reference/README.md)
+- آپریشنز اور تعیناتی: [ops/README.md](ops/README.md)
+- سیکیورٹی دستاویزات: [security/README.md](security/README.md)
+- ہارڈویئر/پیریفرلز: [hardware/README.md](hardware/README.md)
+- شراکت/CI: [contributing/README.md](contributing/README.md)
+- پراجیکٹ سنیپ شاٹس: [maintainers/README.md](maintainers/README.md)
+
+## سامعین کے مطابق
+
+### صارفین / آپریٹرز
+
+- [commands-reference.md](reference/cli/commands-reference.md) — ورک فلو کے مطابق کمانڈ تلاش
+- [providers-reference.md](reference/api/providers-reference.md) — فراہم کنندہ IDs، عرفی نام، اسناد ماحولیاتی متغیرات
+- [channels-reference.md](reference/api/channels-reference.md) — چینل کی صلاحیتیں اور کنفیگریشن کے راستے
+- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — خفیہ کردہ Matrix کمرے (E2EE) کی ترتیب اور عدم جواب کی تشخیص
+- [config-reference.md](reference/api/config-reference.md) — اہم کنفیگریشن کیز اور محفوظ ڈیفالٹ اقدار
+- [custom-providers.md](contributing/custom-providers.md) — حسب ضرورت فراہم کنندہ/بیس URL انضمام کے نمونے
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM ترتیب اور اینڈ پوائنٹ میٹرکس
+- [langgraph-integration.md](contributing/langgraph-integration.md) — ماڈل/ٹول کال ایج کیسز کے لیے فال بیک انضمام
+- [operations-runbook.md](ops/operations-runbook.md) — دوسرے دن کے رن ٹائم آپریشنز اور رول بیک فلو
+- [troubleshooting.md](ops/troubleshooting.md) — عام ناکامی کے نشانات اور بحالی کے اقدامات
+
+### شراکت دار / دیکھ بھال کنندگان
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### سیکیورٹی / قابل اعتمادی
+
+> نوٹ: اس حصے میں تجویز/روڈ میپ دستاویزات شامل ہیں۔ موجودہ رویے کے لیے [config-reference.md](reference/api/config-reference.md)، [operations-runbook.md](ops/operations-runbook.md) اور [troubleshooting.md](ops/troubleshooting.md) سے شروع کریں۔
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [audit-logging.md](security/audit-logging.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+## نظام نیویگیشن اور گورننس
+
+- متحد فہرست مضامین: [SUMMARY.md](SUMMARY.md)
+- دستاویزات ساختی نقشہ (زبان/حصہ/فنکشن): [structure/README.md](maintainers/structure-README.md)
+- دستاویزات کی فہرست/درجہ بندی: [docs-inventory.md](maintainers/docs-inventory.md)
+- پراجیکٹ ٹرائج سنیپ شاٹ: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+
+## دیگر زبانیں
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/README.vi.md
+++ b/third_party/zeroclaw/docs/README.vi.md
@@ -0,0 +1,96 @@
+# Hub Tài liệu ZeroClaw (Tiếng Việt)
+
+Đây là trang chủ tiếng Việt của hệ thống tài liệu.
+
+Đồng bộ lần cuối: **2026-02-21**.
+
+> Lưu ý: Tên lệnh, khóa cấu hình và đường dẫn API giữ nguyên tiếng Anh. Khi có sai khác, tài liệu tiếng Anh là bản gốc. Cây tài liệu tiếng Việt đầy đủ nằm tại [i18n/vi/](i18n/vi/README.md).
+
+Hub bản địa hóa: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](README.vi.md).
+
+## Tra cứu nhanh
+
+| Tôi muốn…                                         | Xem tài liệu                                                                  |
+| -------------------------------------------------- | ------------------------------------------------------------------------------ |
+| Cài đặt và chạy nhanh                              | [README.vi.md (Khởi động nhanh)](../README.vi.md) / [../README.md](../README.md) |
+| Cài đặt bằng một lệnh                              | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)                   |
+| Tìm lệnh theo tác vụ                               | [commands-reference.md](i18n/vi/commands-reference.md)                         |
+| Kiểm tra giá trị mặc định và khóa cấu hình         | [config-reference.md](i18n/vi/config-reference.md)                             |
+| Kết nối provider / endpoint tùy chỉnh               | [custom-providers.md](i18n/vi/custom-providers.md)                             |
+| Cấu hình Z.AI / GLM provider                        | [zai-glm-setup.md](i18n/vi/zai-glm-setup.md)                                  |
+| Sử dụng tích hợp LangGraph                          | [langgraph-integration.md](i18n/vi/langgraph-integration.md)                   |
+| Vận hành hàng ngày (runbook)                        | [operations-runbook.md](i18n/vi/operations-runbook.md)                         |
+| Khắc phục sự cố cài đặt/chạy/kênh                   | [troubleshooting.md](i18n/vi/troubleshooting.md)                               |
+| Cấu hình Matrix phòng mã hóa (E2EE)                | [matrix-e2ee-guide.md](i18n/vi/matrix-e2ee-guide.md)                           |
+| Xem theo danh mục                                   | [SUMMARY.md](i18n/vi/SUMMARY.md)                                              |
+| Xem bản chụp PR/Issue                               | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+
+## Tìm nhanh (10 giây)
+
+- Cài đặt lần đầu hoặc khởi động nhanh → [getting-started/README.md](i18n/vi/getting-started/README.md)
+- Cần tra cứu lệnh CLI / khóa cấu hình → [reference/README.md](i18n/vi/reference/README.md)
+- Cần vận hành / triển khai sản phẩm → [operations/README.md](i18n/vi/operations/README.md)
+- Gặp lỗi hoặc hồi quy → [troubleshooting.md](i18n/vi/troubleshooting.md)
+- Tìm hiểu bảo mật và lộ trình → [security/README.md](i18n/vi/security/README.md)
+- Làm việc với bo mạch / thiết bị ngoại vi → [hardware/README.md](i18n/vi/hardware/README.md)
+- Đóng góp / review / quy trình CI → [contributing/README.md](i18n/vi/contributing/README.md)
+- Xem toàn bộ bản đồ tài liệu → [SUMMARY.md](i18n/vi/SUMMARY.md)
+
+## Danh mục (Khuyến nghị)
+
+- Bắt đầu: [getting-started/README.md](i18n/vi/getting-started/README.md)
+- Tra cứu: [reference/README.md](i18n/vi/reference/README.md)
+- Vận hành & triển khai: [operations/README.md](i18n/vi/operations/README.md)
+- Bảo mật: [security/README.md](i18n/vi/security/README.md)
+- Phần cứng & ngoại vi: [hardware/README.md](i18n/vi/hardware/README.md)
+- Đóng góp & CI: [contributing/README.md](i18n/vi/contributing/README.md)
+- Ảnh chụp dự án: [project/README.md](i18n/vi/project/README.md)
+
+## Theo vai trò
+
+### Người dùng / Vận hành
+
+- [commands-reference.md](i18n/vi/commands-reference.md) — tra cứu lệnh theo tác vụ
+- [providers-reference.md](i18n/vi/providers-reference.md) — ID provider, bí danh, biến môi trường xác thực
+- [channels-reference.md](i18n/vi/channels-reference.md) — khả năng kênh và hướng dẫn thiết lập
+- [matrix-e2ee-guide.md](i18n/vi/matrix-e2ee-guide.md) — thiết lập phòng mã hóa Matrix (E2EE)
+- [config-reference.md](i18n/vi/config-reference.md) — khóa cấu hình quan trọng và giá trị mặc định an toàn
+- [custom-providers.md](i18n/vi/custom-providers.md) — mẫu tích hợp provider / base URL tùy chỉnh
+- [zai-glm-setup.md](i18n/vi/zai-glm-setup.md) — thiết lập Z.AI/GLM và ma trận endpoint
+- [langgraph-integration.md](i18n/vi/langgraph-integration.md) — tích hợp dự phòng cho model/tool-calling
+- [operations-runbook.md](i18n/vi/operations-runbook.md) — vận hành runtime hàng ngày và quy trình rollback
+- [troubleshooting.md](i18n/vi/troubleshooting.md) — dấu hiệu lỗi thường gặp và cách khắc phục
+
+### Người đóng góp / Bảo trì
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](i18n/vi/pr-workflow.md)
+- [reviewer-playbook.md](i18n/vi/reviewer-playbook.md)
+- [ci-map.md](i18n/vi/ci-map.md)
+- [actions-source-policy.md](i18n/vi/actions-source-policy.md)
+
+### Bảo mật / Độ tin cậy
+
+> Lưu ý: Mục này gồm tài liệu đề xuất/lộ trình, có thể chứa lệnh hoặc cấu hình chưa triển khai. Để biết hành vi thực tế, xem [config-reference.md](i18n/vi/config-reference.md), [operations-runbook.md](i18n/vi/operations-runbook.md) và [troubleshooting.md](i18n/vi/troubleshooting.md) trước.
+
+- [security/README.md](i18n/vi/security/README.md)
+- [agnostic-security.md](i18n/vi/agnostic-security.md)
+- [frictionless-security.md](i18n/vi/frictionless-security.md)
+- [sandboxing.md](i18n/vi/sandboxing.md)
+- [audit-logging.md](i18n/vi/audit-logging.md)
+- [resource-limits.md](i18n/vi/resource-limits.md)
+- [security-roadmap.md](i18n/vi/security-roadmap.md)
+
+## Quản lý tài liệu
+
+- Mục lục thống nhất (TOC): [SUMMARY.md](i18n/vi/SUMMARY.md)
+- Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [structure/README.md](maintainers/structure-README.md)
+- Danh mục và phân loại tài liệu: [docs-inventory.md](maintainers/docs-inventory.md)
+
+## Ngôn ngữ khác
+
+- English: [README.md](README.md)
+- 简体中文: [README.zh-CN.md](README.zh-CN.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
--- a/third_party/zeroclaw/docs/README.zh-CN.md
+++ b/third_party/zeroclaw/docs/README.zh-CN.md
@@ -0,0 +1,98 @@
+# ZeroClaw 文档导航（简体中文）
+
+这是文档系统的中文入口页。
+
+最后对齐：**2026-03-14**。
+
+> 说明：命令、配置键、API 路径保持英文；实现细节以英文文档为准。
+
+## 快速入口
+
+| 我想要… | 建议阅读 |
+|---|---|
+| 快速安装并运行 | [../README.zh-CN.md](../README.zh-CN.md) / [../README.md](../README.md) |
+| macOS 平台更新与卸载 | [macos-update-uninstall.md](i18n/zh-CN/setup-guides/macos-update-uninstall.zh-CN.md) |
+| 一键安装与初始化 | [one-click-bootstrap.md](i18n/zh-CN/setup-guides/one-click-bootstrap.zh-CN.md) |
+| 按任务找命令 | [commands-reference.md](i18n/zh-CN/reference/cli/commands-reference.zh-CN.md) |
+| 快速查看配置默认值与关键项 | [config-reference.md](i18n/zh-CN/reference/api/config-reference.zh-CN.md) |
+| 接入自定义 Provider / endpoint | [custom-providers.md](i18n/zh-CN/contributing/custom-providers.zh-CN.md) |
+| 配置 Z.AI / GLM Provider | [zai-glm-setup.md](i18n/zh-CN/setup-guides/zai-glm-setup.zh-CN.md) |
+| 使用 LangGraph 工具调用集成 | [langgraph-integration.md](i18n/zh-CN/contributing/langgraph-integration.zh-CN.md) |
+| 进行日常运维（runbook） | [operations-runbook.md](i18n/zh-CN/ops/operations-runbook.zh-CN.md) |
+| 快速排查安装/运行/通道问题 | [troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md) |
+| Matrix 加密房间配置与诊断 | [matrix-e2ee-guide.md](i18n/zh-CN/security/matrix-e2ee-guide.zh-CN.md) |
+| 统一目录导航 | [SUMMARY.md](SUMMARY.md) |
+| 查看 PR/Issue 扫描快照 | [project-triage-snapshot-2026-02-18.md](i18n/zh-CN/maintainers/project-triage-snapshot-2026-02-18.zh-CN.md) |
+
+## 10 秒决策树（先看这个）
+
+- 首次安装或快速启动 → [setup-guides/README.md](i18n/zh-CN/setup-guides/README.zh-CN.md)
+- 需要精确命令或配置键 → [reference/README.md](i18n/zh-CN/reference/README.zh-CN.md)
+- 需要部署与服务化运维 → [ops/README.md](i18n/zh-CN/ops/README.zh-CN.md)
+- 遇到报错、异常或回归 → [troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md)
+- 查看安全现状与路线图 → [security/README.md](i18n/zh-CN/security/README.zh-CN.md)
+- 接入板卡与外设 → [hardware/README.md](i18n/zh-CN/hardware/README.zh-CN.md)
+- 参与贡献、评审与 CI → [contributing/README.md](i18n/zh-CN/contributing/README.zh-CN.md)
+- 查看完整文档地图 → [SUMMARY.md](SUMMARY.md)
+
+## 按目录浏览（推荐）
+
+- 入门文档： [setup-guides/README.md](i18n/zh-CN/setup-guides/README.zh-CN.md)
+- 参考手册： [reference/README.md](i18n/zh-CN/reference/README.zh-CN.md)
+- 运维与部署： [ops/README.md](i18n/zh-CN/ops/README.zh-CN.md)
+- 安全文档： [security/README.md](i18n/zh-CN/security/README.zh-CN.md)
+- 硬件与外设： [hardware/README.md](i18n/zh-CN/hardware/README.zh-CN.md)
+- 贡献与 CI： [contributing/README.md](i18n/zh-CN/contributing/README.zh-CN.md)
+- 项目快照： [maintainers/README.md](i18n/zh-CN/maintainers/README.zh-CN.md)
+
+## 按角色
+
+### 用户 / 运维
+
+- [commands-reference.md](i18n/zh-CN/reference/cli/commands-reference.zh-CN.md) — 按工作流查询命令
+- [providers-reference.md](i18n/zh-CN/reference/api/providers-reference.zh-CN.md) — Provider ID、别名、凭证环境变量
+- [channels-reference.md](i18n/zh-CN/reference/api/channels-reference.zh-CN.md) — 通道功能与配置路径
+- [matrix-e2ee-guide.md](i18n/zh-CN/security/matrix-e2ee-guide.zh-CN.md) — Matrix 加密房间（E2EE）配置与无响应诊断
+- [config-reference.md](i18n/zh-CN/reference/api/config-reference.zh-CN.md) — 高优先级配置项与安全默认值
+- [custom-providers.md](i18n/zh-CN/contributing/custom-providers.zh-CN.md) — 自定义 Provider/基础 URL 集成模板
+- [zai-glm-setup.md](i18n/zh-CN/setup-guides/zai-glm-setup.zh-CN.md) — Z.AI/GLM 配置与端点矩阵
+- [langgraph-integration.md](i18n/zh-CN/contributing/langgraph-integration.zh-CN.md) — 模型/工具调用边缘场景的降级集成方案
+- [operations-runbook.md](i18n/zh-CN/ops/operations-runbook.zh-CN.md) — 日常运行时运维与回滚流程
+- [troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md) — 常见故障特征与恢复步骤
+
+### 贡献者 / 维护者
+
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](i18n/zh-CN/contributing/pr-workflow.zh-CN.md)
+- [reviewer-playbook.md](i18n/zh-CN/contributing/reviewer-playbook.zh-CN.md)
+- [ci-map.md](i18n/zh-CN/contributing/ci-map.zh-CN.md)
+- [actions-source-policy.md](i18n/zh-CN/contributing/actions-source-policy.zh-CN.md)
+
+### 安全 / 稳定性
+
+> 说明：本分组内有 proposal/roadmap 文档，可能包含设想中的命令或配置。当前可执行行为请优先阅读 [config-reference.md](i18n/zh-CN/reference/api/config-reference.md)、[operations-runbook.md](i18n/zh-CN/ops/operations-runbook.md)、[troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md)。
+
+- [security/README.md](i18n/zh-CN/security/README.zh-CN.md)
+- [agnostic-security.md](i18n/zh-CN/security/agnostic-security.zh-CN.md)
+- [frictionless-security.md](i18n/zh-CN/security/frictionless-security.zh-CN.md)
+- [sandboxing.md](i18n/zh-CN/security/sandboxing.zh-CN.md)
+- [resource-limits.md](i18n/zh-CN/ops/resource-limits.zh-CN.md)
+- [audit-logging.md](i18n/zh-CN/security/audit-logging.zh-CN.md)
+- [security-roadmap.md](i18n/zh-CN/security/security-roadmap.zh-CN.md)
+
+## 文档治理与分类
+
+- 统一目录（TOC）：[SUMMARY.md](SUMMARY.md)
+- 文档结构图（按语言/分区/功能）：[structure/README.md](i18n/zh-CN/maintainers/structure-README.zh-CN.md)
+- 文档清单与分类：[docs-inventory.md](i18n/zh-CN/maintainers/docs-inventory.zh-CN.md)
+- 国际化文档索引：[i18n/README.md](i18n/README.md)
+- 国际化覆盖度地图：[i18n-coverage.md](i18n/zh-CN/maintainers/i18n-coverage.zh-CN.md)
+- 项目分诊快照：[project-triage-snapshot-2026-02-18.md](i18n/zh-CN/maintainers/project-triage-snapshot-2026-02-18.zh-CN.md)
+
+## 其他语言
+
+- English: [README.md](README.md)
+- 日本語: [README.ja.md](README.ja.md)
+- Русский: [README.ru.md](README.ru.md)
+- Français: [README.fr.md](README.fr.md)
+- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md)
--- a/third_party/zeroclaw/docs/SUMMARY.ar.md
+++ b/third_party/zeroclaw/docs/SUMMARY.ar.md
@@ -0,0 +1,89 @@
+# ملخص توثيق ZeroClaw (جدول المحتويات الموحد)
+
+هذا الملف هو جدول المحتويات المرجعي لنظام التوثيق.
+
+> 📖 [النسخة الإنجليزية](SUMMARY.md)
+
+آخر تحديث: **18 فبراير 2026**.
+
+## نقاط الدخول حسب اللغة
+
+- خريطة هيكل التوثيق (اللغة/القسم/الوظيفة): [structure/README.md](maintainers/structure-README.md)
+- README بالإنجليزية: [../README.md](../README.md)
+- README بالصينية: [../README.zh-CN.md](../README.zh-CN.md)
+- README باليابانية: [../README.ja.md](../README.ja.md)
+- README بالروسية: [../README.ru.md](../README.ru.md)
+- README بالفرنسية: [../README.fr.md](../README.fr.md)
+- README بالفيتنامية: [../README.vi.md](../README.vi.md)
+- التوثيق بالإنجليزية: [README.md](README.md)
+- التوثيق بالصينية: [README.zh-CN.md](README.zh-CN.md)
+- التوثيق باليابانية: [README.ja.md](README.ja.md)
+- التوثيق بالروسية: [README.ru.md](README.ru.md)
+- التوثيق بالفرنسية: [README.fr.md](README.fr.md)
+- التوثيق بالفيتنامية: [i18n/vi/README.md](i18n/vi/README.md)
+- فهرس الترجمة: [i18n/README.md](i18n/README.md)
+- خريطة تغطية الترجمة: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## الفئات
+
+### 1) البدء السريع
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) مرجع الأوامر والإعدادات والتكاملات
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) التشغيل والنشر
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) تصميم الأمان والمقترحات
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) العتاد والأجهزة الطرفية
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) المساهمة وCI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) حالة المشروع واللقطات
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.bn.md
+++ b/third_party/zeroclaw/docs/SUMMARY.bn.md
@@ -0,0 +1,89 @@
+# ZeroClaw ডকুমেন্টেশন সারাংশ (একীভূত সূচিপত্র)
+
+এই ফাইলটি ডকুমেন্টেশন সিস্টেমের প্রামাণিক সূচিপত্র।
+
+> 📖 [ইংরেজি সংস্করণ](SUMMARY.md)
+
+সর্বশেষ আপডেট: **১৮ ফেব্রুয়ারি ২০২৬**।
+
+## ভাষা অনুযায়ী প্রবেশ বিন্দু
+
+- ডক কাঠামো মানচিত্র (ভাষা/অংশ/ফাংশন): [structure/README.md](maintainers/structure-README.md)
+- ইংরেজি README: [../README.md](../README.md)
+- চীনা README: [../README.zh-CN.md](../README.zh-CN.md)
+- জাপানি README: [../README.ja.md](../README.ja.md)
+- রুশ README: [../README.ru.md](../README.ru.md)
+- ফরাসি README: [../README.fr.md](../README.fr.md)
+- ভিয়েতনামি README: [../README.vi.md](../README.vi.md)
+- ইংরেজি ডকুমেন্টেশন: [README.md](README.md)
+- চীনা ডকুমেন্টেশন: [README.zh-CN.md](README.zh-CN.md)
+- জাপানি ডকুমেন্টেশন: [README.ja.md](README.ja.md)
+- রুশ ডকুমেন্টেশন: [README.ru.md](README.ru.md)
+- ফরাসি ডকুমেন্টেশন: [README.fr.md](README.fr.md)
+- ভিয়েতনামি ডকুমেন্টেশন: [i18n/vi/README.md](i18n/vi/README.md)
+- স্থানীয়করণ সূচক: [i18n/README.md](i18n/README.md)
+- i18n কভারেজ মানচিত্র: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## বিভাগসমূহ
+
+### ১) দ্রুত শুরু
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### ২) কমান্ড, কনফিগারেশন ও ইন্টিগ্রেশন রেফারেন্স
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### ৩) পরিচালনা ও ডিপ্লয়মেন্ট
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### ৪) নিরাপত্তা নকশা ও প্রস্তাবনা
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### ৫) হার্ডওয়্যার ও পেরিফেরাল
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### ৬) অবদান ও CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### ৭) প্রকল্পের অবস্থা ও স্ন্যাপশট
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.cs.md
+++ b/third_party/zeroclaw/docs/SUMMARY.cs.md
@@ -0,0 +1,89 @@
+# Souhrn dokumentace ZeroClaw (Jednotný obsah)
+
+Tento soubor je kanonický obsah dokumentačního systému.
+
+> 📖 [Anglická verze](SUMMARY.md)
+
+Poslední aktualizace: **18. února 2026**.
+
+## Vstupní body podle jazyka
+
+- Mapa struktury dokumentace (jazyk/část/funkce): [structure/README.md](maintainers/structure-README.md)
+- README v angličtině: [../README.md](../README.md)
+- README v čínštině: [../README.zh-CN.md](../README.zh-CN.md)
+- README v japonštině: [../README.ja.md](../README.ja.md)
+- README v ruštině: [../README.ru.md](../README.ru.md)
+- README ve francouzštině: [../README.fr.md](../README.fr.md)
+- README ve vietnamštině: [../README.vi.md](../README.vi.md)
+- Dokumentace v angličtině: [README.md](README.md)
+- Dokumentace v čínštině: [README.zh-CN.md](README.zh-CN.md)
+- Dokumentace v japonštině: [README.ja.md](README.ja.md)
+- Dokumentace v ruštině: [README.ru.md](README.ru.md)
+- Dokumentace ve francouzštině: [README.fr.md](README.fr.md)
+- Dokumentace ve vietnamštině: [i18n/vi/README.md](i18n/vi/README.md)
+- Index lokalizace: [i18n/README.md](i18n/README.md)
+- Mapa pokrytí i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Kategorie
+
+### 1) Rychlý start
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Reference příkazů, konfigurace a integrací
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Provoz a nasazení
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Návrh zabezpečení a návrhy
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware a periferie
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Přispívání a CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Stav projektu a snapshoty
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.da.md
+++ b/third_party/zeroclaw/docs/SUMMARY.da.md
@@ -0,0 +1,89 @@
+# ZeroClaw Dokumentationsoversigt (Samlet indholdsfortegnelse)
+
+Denne fil er den kanoniske indholdsfortegnelse for dokumentationssystemet.
+
+> 📖 [Engelsk version](SUMMARY.md)
+
+Sidst opdateret: **18. februar 2026**.
+
+## Indgangspunkter efter sprog
+
+- Dokumentationsstrukturkort (sprog/del/funktion): [structure/README.md](maintainers/structure-README.md)
+- README på engelsk: [../README.md](../README.md)
+- README på kinesisk: [../README.zh-CN.md](../README.zh-CN.md)
+- README på japansk: [../README.ja.md](../README.ja.md)
+- README på russisk: [../README.ru.md](../README.ru.md)
+- README på fransk: [../README.fr.md](../README.fr.md)
+- README på vietnamesisk: [../README.vi.md](../README.vi.md)
+- Dokumentation på engelsk: [README.md](README.md)
+- Dokumentation på kinesisk: [README.zh-CN.md](README.zh-CN.md)
+- Dokumentation på japansk: [README.ja.md](README.ja.md)
+- Dokumentation på russisk: [README.ru.md](README.ru.md)
+- Dokumentation på fransk: [README.fr.md](README.fr.md)
+- Dokumentation på vietnamesisk: [i18n/vi/README.md](i18n/vi/README.md)
+- Lokaliseringsindeks: [i18n/README.md](i18n/README.md)
+- i18n-dækningskort: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Kategorier
+
+### 1) Hurtig start
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Kommando-, konfigurations- og integrationsreference
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Drift og udrulning
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Sikkerhedsdesign og forslag
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware og periferienheder
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Bidrag og CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Projektstatus og snapshots
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.de.md
+++ b/third_party/zeroclaw/docs/SUMMARY.de.md
@@ -0,0 +1,89 @@
+# ZeroClaw Dokumentationsübersicht (Einheitliches Inhaltsverzeichnis)
+
+Diese Datei ist das kanonische Inhaltsverzeichnis des Dokumentationssystems.
+
+> 📖 [Englische Version](SUMMARY.md)
+
+Zuletzt aktualisiert: **18. Februar 2026**.
+
+## Einstiegspunkte nach Sprache
+
+- Dokumentationsstrukturkarte (Sprache/Teil/Funktion): [structure/README.md](maintainers/structure-README.md)
+- README auf Englisch: [../README.md](../README.md)
+- README auf Chinesisch: [../README.zh-CN.md](../README.zh-CN.md)
+- README auf Japanisch: [../README.ja.md](../README.ja.md)
+- README auf Russisch: [../README.ru.md](../README.ru.md)
+- README auf Französisch: [../README.fr.md](../README.fr.md)
+- README auf Vietnamesisch: [../README.vi.md](../README.vi.md)
+- Dokumentation auf Englisch: [README.md](README.md)
+- Dokumentation auf Chinesisch: [README.zh-CN.md](README.zh-CN.md)
+- Dokumentation auf Japanisch: [README.ja.md](README.ja.md)
+- Dokumentation auf Russisch: [README.ru.md](README.ru.md)
+- Dokumentation auf Französisch: [README.fr.md](README.fr.md)
+- Dokumentation auf Vietnamesisch: [i18n/vi/README.md](i18n/vi/README.md)
+- Lokalisierungsindex: [i18n/README.md](i18n/README.md)
+- i18n-Abdeckungskarte: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Kategorien
+
+### 1) Schnellstart
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Befehls-, Konfigurations- und Integrationsreferenz
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Betrieb und Bereitstellung
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Sicherheitsdesign und Vorschläge
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware und Peripheriegeräte
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Beitragen und CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Projektstatus und Snapshots
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.el.md
+++ b/third_party/zeroclaw/docs/SUMMARY.el.md
@@ -0,0 +1,89 @@
+# Περίληψη Τεκμηρίωσης ZeroClaw (Ενοποιημένος Πίνακας Περιεχομένων)
+
+Αυτό το αρχείο αποτελεί τον κανονικό πίνακα περιεχομένων του συστήματος τεκμηρίωσης.
+
+> 📖 [English version](SUMMARY.md)
+
+Τελευταία ενημέρωση: **18 Φεβρουαρίου 2026**.
+
+## Σημεία εισόδου ανά γλώσσα
+
+- Χάρτης δομής εγγράφων (γλώσσα/τμήμα/λειτουργία): [structure/README.md](maintainers/structure-README.md)
+- README στα αγγλικά: [../README.md](../README.md)
+- README στα κινέζικα: [../README.zh-CN.md](../README.zh-CN.md)
+- README στα ιαπωνικά: [../README.ja.md](../README.ja.md)
+- README στα ρωσικά: [../README.ru.md](../README.ru.md)
+- README στα γαλλικά: [../README.fr.md](../README.fr.md)
+- README στα βιετναμέζικα: [../README.vi.md](../README.vi.md)
+- Τεκμηρίωση στα αγγλικά: [README.md](README.md)
+- Τεκμηρίωση στα κινέζικα: [README.zh-CN.md](README.zh-CN.md)
+- Τεκμηρίωση στα ιαπωνικά: [README.ja.md](README.ja.md)
+- Τεκμηρίωση στα ρωσικά: [README.ru.md](README.ru.md)
+- Τεκμηρίωση στα γαλλικά: [README.fr.md](README.fr.md)
+- Τεκμηρίωση στα βιετναμέζικα: [i18n/vi/README.md](i18n/vi/README.md)
+- Ευρετήριο τοπικοποίησης: [i18n/README.md](i18n/README.md)
+- Χάρτης κάλυψης i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Κατηγορίες
+
+### 1) Γρήγορη εκκίνηση
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Αναφορά εντολών, ρυθμίσεων και ενσωματώσεων
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Λειτουργία και ανάπτυξη
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Σχεδιασμός ασφαλείας και προτάσεις
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Υλικό και περιφερειακά
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Συνεισφορά και CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Κατάσταση έργου και στιγμιότυπα
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.es.md
+++ b/third_party/zeroclaw/docs/SUMMARY.es.md
@@ -0,0 +1,89 @@
+# Resumen de Documentación ZeroClaw (Tabla de Contenidos Unificada)
+
+Este archivo constituye la tabla de contenidos canónica del sistema de documentación.
+
+> 📖 [English version](SUMMARY.md)
+
+Última actualización: **18 de febrero de 2026**.
+
+## Puntos de entrada por idioma
+
+- Mapa de estructura de docs (idioma/sección/función): [structure/README.md](maintainers/structure-README.md)
+- README en inglés: [../README.md](../README.md)
+- README en chino: [../README.zh-CN.md](../README.zh-CN.md)
+- README en japonés: [../README.ja.md](../README.ja.md)
+- README en ruso: [../README.ru.md](../README.ru.md)
+- README en francés: [../README.fr.md](../README.fr.md)
+- README en vietnamita: [../README.vi.md](../README.vi.md)
+- Documentación en inglés: [README.md](README.md)
+- Documentación en chino: [README.zh-CN.md](README.zh-CN.md)
+- Documentación en japonés: [README.ja.md](README.ja.md)
+- Documentación en ruso: [README.ru.md](README.ru.md)
+- Documentación en francés: [README.fr.md](README.fr.md)
+- Documentación en vietnamita: [i18n/vi/README.md](i18n/vi/README.md)
+- Índice de localización: [i18n/README.md](i18n/README.md)
+- Mapa de cobertura i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Categorías
+
+### 1) Inicio rápido
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Referencia de comandos, configuración e integraciones
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Operaciones y despliegue
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Diseño de seguridad y propuestas
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware y periféricos
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Contribución y CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Estado del proyecto e instantáneas
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.fi.md
+++ b/third_party/zeroclaw/docs/SUMMARY.fi.md
@@ -0,0 +1,89 @@
+# ZeroClaw-dokumentaation yhteenveto (Yhtenäinen sisällysluettelo)
+
+Tämä tiedosto muodostaa dokumentaatiojärjestelmän kanonisen sisällysluettelon.
+
+> 📖 [English version](SUMMARY.md)
+
+Viimeksi päivitetty: **18. helmikuuta 2026**.
+
+## Aloituspisteet kielen mukaan
+
+- Dokumenttien rakennekartta (kieli/osio/toiminto): [structure/README.md](maintainers/structure-README.md)
+- README englanniksi: [../README.md](../README.md)
+- README kiinaksi: [../README.zh-CN.md](../README.zh-CN.md)
+- README japaniksi: [../README.ja.md](../README.ja.md)
+- README venäjäksi: [../README.ru.md](../README.ru.md)
+- README ranskaksi: [../README.fr.md](../README.fr.md)
+- README vietnamiksi: [../README.vi.md](../README.vi.md)
+- Dokumentaatio englanniksi: [README.md](README.md)
+- Dokumentaatio kiinaksi: [README.zh-CN.md](README.zh-CN.md)
+- Dokumentaatio japaniksi: [README.ja.md](README.ja.md)
+- Dokumentaatio venäjäksi: [README.ru.md](README.ru.md)
+- Dokumentaatio ranskaksi: [README.fr.md](README.fr.md)
+- Dokumentaatio vietnamiksi: [i18n/vi/README.md](i18n/vi/README.md)
+- Lokalisointiluettelo: [i18n/README.md](i18n/README.md)
+- i18n-kattavuuskartta: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Kategoriat
+
+### 1) Pikaopas
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Komento-, asetus- ja integrointiviitteet
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Toiminta ja käyttöönotto
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Tietoturvasuunnittelu ja ehdotukset
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Laitteisto ja oheislaitteet
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Osallistuminen ja CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Projektin tila ja tilannekuvat
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.fr.md
+++ b/third_party/zeroclaw/docs/SUMMARY.fr.md
@@ -0,0 +1,89 @@
+# Sommaire de la documentation ZeroClaw (Table des matières unifiée)
+
+Ce fichier constitue la table des matières canonique du système de documentation.
+
+> 📖 [English version](SUMMARY.md)
+
+Dernière mise à jour : **18 février 2026**.
+
+## Points d'entrée par langue
+
+- Carte de structure docs (langue/partie/fonction) : [structure/README.md](maintainers/structure-README.md)
+- README en anglais : [../README.md](../README.md)
+- README en chinois : [../README.zh-CN.md](../README.zh-CN.md)
+- README en japonais : [../README.ja.md](../README.ja.md)
+- README en russe : [../README.ru.md](../README.ru.md)
+- README en français : [../README.fr.md](../README.fr.md)
+- README en vietnamien : [../README.vi.md](../README.vi.md)
+- Documentation en anglais : [README.md](README.md)
+- Documentation en chinois : [README.zh-CN.md](README.zh-CN.md)
+- Documentation en japonais : [README.ja.md](README.ja.md)
+- Documentation en russe : [README.ru.md](README.ru.md)
+- Documentation en français : [README.fr.md](README.fr.md)
+- Documentation en vietnamien : [i18n/vi/README.md](i18n/vi/README.md)
+- Index de localisation : [i18n/README.md](i18n/README.md)
+- Carte de couverture i18n : [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Catégories
+
+### 1) Démarrage rapide
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Référence des commandes, configuration et intégrations
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Exploitation et déploiement
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Conception de la sécurité et propositions
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Matériel et périphériques
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Contribution et CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) État du projet et instantanés
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.he.md
+++ b/third_party/zeroclaw/docs/SUMMARY.he.md
@@ -0,0 +1,89 @@
+# סיכום תיעוד ZeroClaw (תוכן עניינים מאוחד)
+
+קובץ זה מהווה את תוכן העניינים הקנוני של מערכת התיעוד.
+
+> 📖 [English version](SUMMARY.md)
+
+עדכון אחרון: **18 בפברואר 2026**.
+
+## נקודות כניסה לפי שפה
+
+- מפת מבנה תיעוד (שפה/חלק/פונקציה): [structure/README.md](maintainers/structure-README.md)
+- README באנגלית: [../README.md](../README.md)
+- README בסינית: [../README.zh-CN.md](../README.zh-CN.md)
+- README ביפנית: [../README.ja.md](../README.ja.md)
+- README ברוסית: [../README.ru.md](../README.ru.md)
+- README בצרפתית: [../README.fr.md](../README.fr.md)
+- README בווייטנאמית: [../README.vi.md](../README.vi.md)
+- תיעוד באנגלית: [README.md](README.md)
+- תיעוד בסינית: [README.zh-CN.md](README.zh-CN.md)
+- תיעוד ביפנית: [README.ja.md](README.ja.md)
+- תיעוד ברוסית: [README.ru.md](README.ru.md)
+- תיעוד בצרפתית: [README.fr.md](README.fr.md)
+- תיעוד בווייטנאמית: [i18n/vi/README.md](i18n/vi/README.md)
+- אינדקס תרגום: [i18n/README.md](i18n/README.md)
+- מפת כיסוי i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## קטגוריות
+
+### 1) התחלה מהירה
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) עיון בפקודות, הגדרות ושילובים
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) תפעול ופריסה
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) עיצוב אבטחה והצעות
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) חומרה וציוד היקפי
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) תרומה ו-CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) מצב הפרויקט ותמונות מצב
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.hi.md
+++ b/third_party/zeroclaw/docs/SUMMARY.hi.md
@@ -0,0 +1,89 @@
+# ZeroClaw दस्तावेज़ीकरण सारांश (एकीकृत विषय सूची)
+
+यह फ़ाइल दस्तावेज़ीकरण प्रणाली की कैनोनिकल विषय सूची है।
+
+> 📖 [English version](SUMMARY.md)
+
+अंतिम अपडेट: **18 फरवरी 2026**।
+
+## भाषा के अनुसार प्रवेश बिंदु
+
+- दस्तावेज़ संरचना नक्शा (भाषा/भाग/कार्य): [structure/README.md](maintainers/structure-README.md)
+- अंग्रेज़ी README: [../README.md](../README.md)
+- चीनी README: [../README.zh-CN.md](../README.zh-CN.md)
+- जापानी README: [../README.ja.md](../README.ja.md)
+- रूसी README: [../README.ru.md](../README.ru.md)
+- फ़्रेंच README: [../README.fr.md](../README.fr.md)
+- वियतनामी README: [../README.vi.md](../README.vi.md)
+- अंग्रेज़ी दस्तावेज़ीकरण: [README.md](README.md)
+- चीनी दस्तावेज़ीकरण: [README.zh-CN.md](README.zh-CN.md)
+- जापानी दस्तावेज़ीकरण: [README.ja.md](README.ja.md)
+- रूसी दस्तावेज़ीकरण: [README.ru.md](README.ru.md)
+- फ़्रेंच दस्तावेज़ीकरण: [README.fr.md](README.fr.md)
+- वियतनामी दस्तावेज़ीकरण: [i18n/vi/README.md](i18n/vi/README.md)
+- स्थानीयकरण सूचकांक: [i18n/README.md](i18n/README.md)
+- i18n कवरेज नक्शा: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## श्रेणियाँ
+
+### 1) त्वरित प्रारंभ
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) कमांड, कॉन्फ़िगरेशन और एकीकरण संदर्भ
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) संचालन और तैनाती
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) सुरक्षा डिज़ाइन और प्रस्ताव
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) हार्डवेयर और पेरिफेरल्स
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) योगदान और CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) प्रोजेक्ट स्थिति और स्नैपशॉट
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.hu.md
+++ b/third_party/zeroclaw/docs/SUMMARY.hu.md
@@ -0,0 +1,92 @@
+# ZeroClaw Dokumentáció Összefoglaló (Egységes tartalomjegyzék)
+
+Ez a fájl a dokumentációs rendszer kanonikus tartalomjegyzéke.
+
+> 📖 [English version](SUMMARY.md)
+
+Utolsó frissítés: **2026. február 18.**
+
+## Nyelvi belépési pontok
+
+- Dokumentáció szerkezeti térkép (nyelv/rész/funkció): [structure/README.md](maintainers/structure-README.md)
+- Angol README: [../README.md](../README.md)
+- Kínai README: [../README.zh-CN.md](../README.zh-CN.md)
+- Japán README: [../README.ja.md](../README.ja.md)
+- Orosz README: [../README.ru.md](../README.ru.md)
+- Francia README: [../README.fr.md](../README.fr.md)
+- Vietnámi README: [../README.vi.md](../README.vi.md)
+- Angol dokumentációs központ: [README.md](README.md)
+- Kínai dokumentációs központ: [README.zh-CN.md](README.zh-CN.md)
+- Japán dokumentációs központ: [README.ja.md](README.ja.md)
+- Orosz dokumentációs központ: [README.ru.md](README.ru.md)
+- Francia dokumentációs központ: [README.fr.md](README.fr.md)
+- Vietnámi dokumentációs központ: [i18n/vi/README.md](i18n/vi/README.md)
+- Honosítási dokumentáció index: [i18n/README.md](i18n/README.md)
+- i18n lefedettségi térkép: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Kategóriák
+
+### 1) Első lépések
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Parancs/konfiguráció referencia és integrációk
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Üzemeltetés és telepítés
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Biztonsági tervezés és javaslatok
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardver és perifériák
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Közreműködés és CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+- [extension-examples.md](contributing/extension-examples.md)
+- [testing.md](contributing/testing.md)
+
+### 7) Projekt állapot és pillanatképek
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.id.md
+++ b/third_party/zeroclaw/docs/SUMMARY.id.md
@@ -0,0 +1,92 @@
+# Ringkasan Dokumentasi ZeroClaw (Daftar Isi Terpadu)
+
+File ini adalah daftar isi kanonik untuk sistem dokumentasi.
+
+> 📖 [English version](SUMMARY.md)
+
+Pembaruan terakhir: **18 Februari 2026**.
+
+## Titik Masuk Bahasa
+
+- Peta struktur dokumentasi (bahasa/bagian/fungsi): [structure/README.md](maintainers/structure-README.md)
+- README Inggris: [../README.md](../README.md)
+- README Cina: [../README.zh-CN.md](../README.zh-CN.md)
+- README Jepang: [../README.ja.md](../README.ja.md)
+- README Rusia: [../README.ru.md](../README.ru.md)
+- README Prancis: [../README.fr.md](../README.fr.md)
+- README Vietnam: [../README.vi.md](../README.vi.md)
+- Hub dokumentasi Inggris: [README.md](README.md)
+- Hub dokumentasi Cina: [README.zh-CN.md](README.zh-CN.md)
+- Hub dokumentasi Jepang: [README.ja.md](README.ja.md)
+- Hub dokumentasi Rusia: [README.ru.md](README.ru.md)
+- Hub dokumentasi Prancis: [README.fr.md](README.fr.md)
+- Hub dokumentasi Vietnam: [i18n/vi/README.md](i18n/vi/README.md)
+- Indeks dokumentasi lokalisasi: [i18n/README.md](i18n/README.md)
+- Peta cakupan i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Koleksi
+
+### 1) Memulai
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Referensi perintah/konfigurasi & integrasi
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Operasi & deployment
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Desain keamanan & proposal
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Perangkat keras & periferal
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Kontribusi & CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+- [extension-examples.md](contributing/extension-examples.md)
+- [testing.md](contributing/testing.md)
+
+### 7) Status proyek & snapshot
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.it.md
+++ b/third_party/zeroclaw/docs/SUMMARY.it.md
@@ -0,0 +1,92 @@
+# Riepilogo della Documentazione ZeroClaw (Indice Unificato)
+
+Questo file è l'indice canonico del sistema di documentazione.
+
+> 📖 [English version](SUMMARY.md)
+
+Ultimo aggiornamento: **18 febbraio 2026**.
+
+## Punti di ingresso per lingua
+
+- Mappa della struttura documentale (lingua/parte/funzione): [structure/README.md](maintainers/structure-README.md)
+- README inglese: [../README.md](../README.md)
+- README cinese: [../README.zh-CN.md](../README.zh-CN.md)
+- README giapponese: [../README.ja.md](../README.ja.md)
+- README russo: [../README.ru.md](../README.ru.md)
+- README francese: [../README.fr.md](../README.fr.md)
+- README vietnamita: [../README.vi.md](../README.vi.md)
+- Hub documentazione inglese: [README.md](README.md)
+- Hub documentazione cinese: [README.zh-CN.md](README.zh-CN.md)
+- Hub documentazione giapponese: [README.ja.md](README.ja.md)
+- Hub documentazione russo: [README.ru.md](README.ru.md)
+- Hub documentazione francese: [README.fr.md](README.fr.md)
+- Hub documentazione vietnamita: [i18n/vi/README.md](i18n/vi/README.md)
+- Indice documentazione localizzazione: [i18n/README.md](i18n/README.md)
+- Mappa di copertura i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Collezioni
+
+### 1) Per iniziare
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Riferimento comandi/configurazione e integrazioni
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Operazioni e deployment
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Progettazione della sicurezza e proposte
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware e periferiche
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Contribuzione e CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+- [extension-examples.md](contributing/extension-examples.md)
+- [testing.md](contributing/testing.md)
+
+### 7) Stato del progetto e snapshot
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.ja.md
+++ b/third_party/zeroclaw/docs/SUMMARY.ja.md
@@ -0,0 +1,89 @@
+# ZeroClaw ドキュメント目次（統合目次）
+
+このファイルはドキュメントシステムの正規の目次です。
+
+> 📖 [English version](SUMMARY.md)
+
+最終更新：**2026年2月18日**。
+
+## 言語別入口
+
+- ドキュメント構造マップ（言語/カテゴリ/機能）: [structure/README.md](maintainers/structure-README.md)
+- 英語 README：[../README.md](../README.md)
+- 中国語 README：[../README.zh-CN.md](../README.zh-CN.md)
+- 日本語 README：[../README.ja.md](../README.ja.md)
+- ロシア語 README：[../README.ru.md](../README.ru.md)
+- フランス語 README：[../README.fr.md](../README.fr.md)
+- ベトナム語 README：[../README.vi.md](../README.vi.md)
+- 英語ドキュメントハブ：[README.md](README.md)
+- 中国語ドキュメントハブ：[README.zh-CN.md](README.zh-CN.md)
+- 日本語ドキュメントハブ：[README.ja.md](README.ja.md)
+- ロシア語ドキュメントハブ：[README.ru.md](README.ru.md)
+- フランス語ドキュメントハブ：[README.fr.md](README.fr.md)
+- ベトナム語ドキュメントハブ：[i18n/vi/README.md](i18n/vi/README.md)
+- 国際化ドキュメント索引：[i18n/README.md](i18n/README.md)
+- 国際化カバレッジマップ：[i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## カテゴリ
+
+### 1) はじめに
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) コマンド・設定リファレンスと統合
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) 運用とデプロイ
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) セキュリティ設計と提案
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) ハードウェアと周辺機器
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) コントリビューションと CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) プロジェクト状況とスナップショット
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.ko.md
+++ b/third_party/zeroclaw/docs/SUMMARY.ko.md
@@ -0,0 +1,92 @@
+# ZeroClaw 문서 요약 (통합 목차)
+
+이 파일은 문서 시스템의 정식 목차입니다.
+
+> 📖 [English version](SUMMARY.md)
+
+마지막 업데이트: **2026년 2월 18일**.
+
+## 언어별 진입점
+
+- 문서 구조 맵 (언어/부분/기능): [structure/README.md](maintainers/structure-README.md)
+- 영어 README: [../README.md](../README.md)
+- 중국어 README: [../README.zh-CN.md](../README.zh-CN.md)
+- 일본어 README: [../README.ja.md](../README.ja.md)
+- 러시아어 README: [../README.ru.md](../README.ru.md)
+- 프랑스어 README: [../README.fr.md](../README.fr.md)
+- 베트남어 README: [../README.vi.md](../README.vi.md)
+- 영어 문서 허브: [README.md](README.md)
+- 중국어 문서 허브: [README.zh-CN.md](README.zh-CN.md)
+- 일본어 문서 허브: [README.ja.md](README.ja.md)
+- 러시아어 문서 허브: [README.ru.md](README.ru.md)
+- 프랑스어 문서 허브: [README.fr.md](README.fr.md)
+- 베트남어 문서 허브: [i18n/vi/README.md](i18n/vi/README.md)
+- 현지화 문서 색인: [i18n/README.md](i18n/README.md)
+- i18n 커버리지 맵: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## 컬렉션
+
+### 1) 시작하기
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) 명령어/구성 참조 및 통합
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) 운영 및 배포
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) 보안 설계 및 제안
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) 하드웨어 및 주변 장치
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) 기여 및 CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+- [extension-examples.md](contributing/extension-examples.md)
+- [testing.md](contributing/testing.md)
+
+### 7) 프로젝트 상태 및 스냅샷
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.md
+++ b/third_party/zeroclaw/docs/SUMMARY.md
@@ -0,0 +1,140 @@
+# ZeroClaw Docs Summary (Unified TOC)
+
+This file is the canonical table of contents for the documentation system.
+
+Last refreshed: **February 18, 2026**.
+
+## Language Entry
+
+- Docs Structure Map (language/part/function): [structure/README.md](maintainers/structure-README.md)
+- English README: [../README.md](../README.md)
+- Arabic README: [../README.ar.md](../README.ar.md)
+- Bengali README: [../README.bn.md](../README.bn.md)
+- Czech README: [../README.cs.md](../README.cs.md)
+- Danish README: [../README.da.md](../README.da.md)
+- German README: [../README.de.md](../README.de.md)
+- Greek README: [../README.el.md](../README.el.md)
+- Spanish README: [../README.es.md](../README.es.md)
+- Finnish README: [../README.fi.md](../README.fi.md)
+- French README: [../README.fr.md](../README.fr.md)
+- Hebrew README: [../README.he.md](../README.he.md)
+- Hindi README: [../README.hi.md](../README.hi.md)
+- Hungarian README: [../README.hu.md](../README.hu.md)
+- Indonesian README: [../README.id.md](../README.id.md)
+- Italian README: [../README.it.md](../README.it.md)
+- Japanese README: [../README.ja.md](../README.ja.md)
+- Korean README: [../README.ko.md](../README.ko.md)
+- Norwegian Bokmål README: [../README.nb.md](../README.nb.md)
+- Dutch README: [../README.nl.md](../README.nl.md)
+- Polish README: [../README.pl.md](../README.pl.md)
+- Portuguese README: [../README.pt.md](../README.pt.md)
+- Romanian README: [../README.ro.md](../README.ro.md)
+- Russian README: [../README.ru.md](../README.ru.md)
+- Swedish README: [../README.sv.md](../README.sv.md)
+- Thai README: [../README.th.md](../README.th.md)
+- Tagalog README: [../README.tl.md](../README.tl.md)
+- Turkish README: [../README.tr.md](../README.tr.md)
+- Ukrainian README: [../README.uk.md](../README.uk.md)
+- Urdu README: [../README.ur.md](../README.ur.md)
+- Vietnamese README: [../README.vi.md](../README.vi.md)
+- Chinese README: [../README.zh-CN.md](../README.zh-CN.md)
+- English Docs Hub: [README.md](README.md)
+- Arabic Docs Hub: [README.ar.md](README.ar.md)
+- Bengali Docs Hub: [README.bn.md](README.bn.md)
+- Czech Docs Hub: [README.cs.md](README.cs.md)
+- Danish Docs Hub: [README.da.md](README.da.md)
+- German Docs Hub: [README.de.md](README.de.md)
+- Greek Docs Hub: [README.el.md](README.el.md)
+- Spanish Docs Hub: [README.es.md](README.es.md)
+- Finnish Docs Hub: [README.fi.md](README.fi.md)
+- French Docs Hub: [README.fr.md](README.fr.md)
+- Hebrew Docs Hub: [README.he.md](README.he.md)
+- Hindi Docs Hub: [README.hi.md](README.hi.md)
+- Hungarian Docs Hub: [README.hu.md](README.hu.md)
+- Indonesian Docs Hub: [README.id.md](README.id.md)
+- Italian Docs Hub: [README.it.md](README.it.md)
+- Japanese Docs Hub: [README.ja.md](README.ja.md)
+- Korean Docs Hub: [README.ko.md](README.ko.md)
+- Norwegian Bokmål Docs Hub: [README.nb.md](README.nb.md)
+- Dutch Docs Hub: [README.nl.md](README.nl.md)
+- Polish Docs Hub: [README.pl.md](README.pl.md)
+- Portuguese Docs Hub: [README.pt.md](README.pt.md)
+- Romanian Docs Hub: [README.ro.md](README.ro.md)
+- Russian Docs Hub: [README.ru.md](README.ru.md)
+- Swedish Docs Hub: [README.sv.md](README.sv.md)
+- Thai Docs Hub: [README.th.md](README.th.md)
+- Tagalog Docs Hub: [README.tl.md](README.tl.md)
+- Turkish Docs Hub: [README.tr.md](README.tr.md)
+- Ukrainian Docs Hub: [README.uk.md](README.uk.md)
+- Urdu Docs Hub: [README.ur.md](README.ur.md)
+- Vietnamese Docs Hub: [README.vi.md](README.vi.md)
+- Chinese Docs Hub: [README.zh-CN.md](README.zh-CN.md)
+- i18n Docs Index: [i18n/README.md](i18n/README.md)
+- i18n Coverage Map: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Collections
+
+### 1) Getting Started
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Command/Config References & Integrations
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Operations & Deployment
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Security Design & Proposals
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware & Peripherals
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Contribution & CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+- [extension-examples.md](contributing/extension-examples.md)
+- [testing.md](contributing/testing.md)
+
+### 7) Project Status & Snapshot
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.nb.md
+++ b/third_party/zeroclaw/docs/SUMMARY.nb.md
@@ -0,0 +1,92 @@
+# ZeroClaw Dokumentasjonssammendrag (Samlet innholdsfortegnelse)
+
+Denne filen er den kanoniske innholdsfortegnelsen for dokumentasjonssystemet.
+
+> 📖 [English version](SUMMARY.md)
+
+Sist oppdatert: **18. februar 2026**.
+
+## Språkinngangspunkter
+
+- Dokumentasjonsstrukturkart (språk/del/funksjon): [structure/README.md](maintainers/structure-README.md)
+- Engelsk README: [../README.md](../README.md)
+- Kinesisk README: [../README.zh-CN.md](../README.zh-CN.md)
+- Japansk README: [../README.ja.md](../README.ja.md)
+- Russisk README: [../README.ru.md](../README.ru.md)
+- Fransk README: [../README.fr.md](../README.fr.md)
+- Vietnamesisk README: [../README.vi.md](../README.vi.md)
+- Engelsk dokumentasjonshub: [README.md](README.md)
+- Kinesisk dokumentasjonshub: [README.zh-CN.md](README.zh-CN.md)
+- Japansk dokumentasjonshub: [README.ja.md](README.ja.md)
+- Russisk dokumentasjonshub: [README.ru.md](README.ru.md)
+- Fransk dokumentasjonshub: [README.fr.md](README.fr.md)
+- Vietnamesisk dokumentasjonshub: [i18n/vi/README.md](i18n/vi/README.md)
+- Lokaliseringsdokumentasjonsindeks: [i18n/README.md](i18n/README.md)
+- i18n-dekningskart: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Samlinger
+
+### 1) Kom i gang
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Kommando-/konfigurasjonsreferanse og integrasjoner
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Drift og utrulling
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Sikkerhetsdesign og forslag
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Maskinvare og periferiutstyr
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Bidrag og CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+- [extension-examples.md](contributing/extension-examples.md)
+- [testing.md](contributing/testing.md)
+
+### 7) Prosjektstatus og øyeblikksbilder
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.nl.md
+++ b/third_party/zeroclaw/docs/SUMMARY.nl.md
@@ -0,0 +1,89 @@
+# ZeroClaw Documentatieoverzicht (Uniforme Inhoudsopgave)
+
+Dit bestand is de canonieke inhoudsopgave van het documentatiesysteem.
+
+> 📖 [English version](SUMMARY.md)
+
+Laatst bijgewerkt: **18 februari 2026**.
+
+## Toegangspunten per taal
+
+- Documentatiestructuurkaart (taal/deel/functie): [structure/README.md](maintainers/structure-README.md)
+- README in het Engels: [../README.md](../README.md)
+- README in het Chinees: [../README.zh-CN.md](../README.zh-CN.md)
+- README in het Japans: [../README.ja.md](../README.ja.md)
+- README in het Russisch: [../README.ru.md](../README.ru.md)
+- README in het Frans: [../README.fr.md](../README.fr.md)
+- README in het Vietnamees: [../README.vi.md](../README.vi.md)
+- Documentatie in het Engels: [README.md](README.md)
+- Documentatie in het Chinees: [README.zh-CN.md](README.zh-CN.md)
+- Documentatie in het Japans: [README.ja.md](README.ja.md)
+- Documentatie in het Russisch: [README.ru.md](README.ru.md)
+- Documentatie in het Frans: [README.fr.md](README.fr.md)
+- Documentatie in het Vietnamees: [i18n/vi/README.md](i18n/vi/README.md)
+- Lokalisatie-index: [i18n/README.md](i18n/README.md)
+- i18n-dekkingskaart: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Categorieën
+
+### 1) Snelle start
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Commando-, configuratie- en integratiereferentie
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Beheer en implementatie
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Beveiligingsontwerp en voorstellen
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware en randapparatuur
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Bijdrage en CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Projectstatus en momentopnamen
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.pl.md
+++ b/third_party/zeroclaw/docs/SUMMARY.pl.md
@@ -0,0 +1,89 @@
+# Podsumowanie Dokumentacji ZeroClaw (Ujednolicony Spis Treści)
+
+Ten plik stanowi kanoniczny spis treści systemu dokumentacji.
+
+> 📖 [English version](SUMMARY.md)
+
+Ostatnia aktualizacja: **18 lutego 2026**.
+
+## Punkty wejścia według języka
+
+- Mapa struktury dokumentacji (język/część/funkcja): [structure/README.md](maintainers/structure-README.md)
+- README po angielsku: [../README.md](../README.md)
+- README po chińsku: [../README.zh-CN.md](../README.zh-CN.md)
+- README po japońsku: [../README.ja.md](../README.ja.md)
+- README po rosyjsku: [../README.ru.md](../README.ru.md)
+- README po francusku: [../README.fr.md](../README.fr.md)
+- README po wietnamsku: [../README.vi.md](../README.vi.md)
+- Dokumentacja po angielsku: [README.md](README.md)
+- Dokumentacja po chińsku: [README.zh-CN.md](README.zh-CN.md)
+- Dokumentacja po japońsku: [README.ja.md](README.ja.md)
+- Dokumentacja po rosyjsku: [README.ru.md](README.ru.md)
+- Dokumentacja po francusku: [README.fr.md](README.fr.md)
+- Dokumentacja po wietnamsku: [i18n/vi/README.md](i18n/vi/README.md)
+- Indeks lokalizacji: [i18n/README.md](i18n/README.md)
+- Mapa pokrycia i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Kategorie
+
+### 1) Szybki start
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Polecenia, konfiguracja i referencje integracji
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Eksploatacja i wdrożenie
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Projektowanie bezpieczeństwa i propozycje
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware i peryferia
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Kontrybuowanie i CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Status projektu i migawki
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.pt.md
+++ b/third_party/zeroclaw/docs/SUMMARY.pt.md
@@ -0,0 +1,89 @@
+# Resumo da Documentação ZeroClaw (Índice Unificado)
+
+Este arquivo constitui o índice canônico do sistema de documentação.
+
+> 📖 [English version](SUMMARY.md)
+
+Última atualização: **18 de fevereiro de 2026**.
+
+## Pontos de entrada por idioma
+
+- Mapa da estrutura de docs (idioma/parte/função): [structure/README.md](maintainers/structure-README.md)
+- README em inglês: [../README.md](../README.md)
+- README em chinês: [../README.zh-CN.md](../README.zh-CN.md)
+- README em japonês: [../README.ja.md](../README.ja.md)
+- README em russo: [../README.ru.md](../README.ru.md)
+- README em francês: [../README.fr.md](../README.fr.md)
+- README em vietnamita: [../README.vi.md](../README.vi.md)
+- Documentação em inglês: [README.md](README.md)
+- Documentação em chinês: [README.zh-CN.md](README.zh-CN.md)
+- Documentação em japonês: [README.ja.md](README.ja.md)
+- Documentação em russo: [README.ru.md](README.ru.md)
+- Documentação em francês: [README.fr.md](README.fr.md)
+- Documentação em vietnamita: [i18n/vi/README.md](i18n/vi/README.md)
+- Índice de localização: [i18n/README.md](i18n/README.md)
+- Mapa de cobertura i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Categorias
+
+### 1) Início rápido
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Referência de comandos, configuração e integrações
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Operações e implantação
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Design de segurança e propostas
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware e periféricos
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Contribuição e CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Estado do projeto e instantâneos
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.ro.md
+++ b/third_party/zeroclaw/docs/SUMMARY.ro.md
@@ -0,0 +1,89 @@
+# Rezumatul Documentației ZeroClaw (Cuprins Unificat)
+
+Acest fișier constituie cuprinsul canonic al sistemului de documentație.
+
+> 📖 [English version](SUMMARY.md)
+
+Ultima actualizare: **18 februarie 2026**.
+
+## Puncte de intrare pe limbă
+
+- Harta structurii documentației (limbă/parte/funcție): [structure/README.md](maintainers/structure-README.md)
+- README în engleză: [../README.md](../README.md)
+- README în chineză: [../README.zh-CN.md](../README.zh-CN.md)
+- README în japoneză: [../README.ja.md](../README.ja.md)
+- README în rusă: [../README.ru.md](../README.ru.md)
+- README în franceză: [../README.fr.md](../README.fr.md)
+- README în vietnameză: [../README.vi.md](../README.vi.md)
+- Documentație în engleză: [README.md](README.md)
+- Documentație în chineză: [README.zh-CN.md](README.zh-CN.md)
+- Documentație în japoneză: [README.ja.md](README.ja.md)
+- Documentație în rusă: [README.ru.md](README.ru.md)
+- Documentație în franceză: [README.fr.md](README.fr.md)
+- Documentație în vietnameză: [i18n/vi/README.md](i18n/vi/README.md)
+- Index de localizare: [i18n/README.md](i18n/README.md)
+- Hartă de acoperire i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Categorii
+
+### 1) Start rapid
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Referință comenzi, configurare și integrări
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Operațiuni și implementare
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Design de securitate și propuneri
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware și periferice
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Contribuție și CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Starea proiectului și instantanee
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.ru.md
+++ b/third_party/zeroclaw/docs/SUMMARY.ru.md
@@ -0,0 +1,89 @@
+# Содержание документации ZeroClaw (Единое оглавление)
+
+Этот файл является каноническим оглавлением системы документации.
+
+> 📖 [English version](SUMMARY.md)
+
+Последнее обновление: **18 февраля 2026 г.**
+
+## Языковые точки входа
+
+- Карта структуры docs (язык/раздел/функция): [structure/README.md](maintainers/structure-README.md)
+- README на английском: [../README.md](../README.md)
+- README на китайском: [../README.zh-CN.md](../README.zh-CN.md)
+- README на японском: [../README.ja.md](../README.ja.md)
+- README на русском: [../README.ru.md](../README.ru.md)
+- README на французском: [../README.fr.md](../README.fr.md)
+- README на вьетнамском: [../README.vi.md](../README.vi.md)
+- Документация на английском: [README.md](README.md)
+- Документация на китайском: [README.zh-CN.md](README.zh-CN.md)
+- Документация на японском: [README.ja.md](README.ja.md)
+- Документация на русском: [README.ru.md](README.ru.md)
+- Документация на французском: [README.fr.md](README.fr.md)
+- Документация на вьетнамском: [i18n/vi/README.md](i18n/vi/README.md)
+- Индекс локализации: [i18n/README.md](i18n/README.md)
+- Карта покрытия локализации: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Разделы
+
+### 1) Начало работы
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Справочник команд, конфигурации и интеграций
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Эксплуатация и развёртывание
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Проектирование безопасности и предложения
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Оборудование и периферия
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Участие в проекте и CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Состояние проекта и снимки
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.sv.md
+++ b/third_party/zeroclaw/docs/SUMMARY.sv.md
@@ -0,0 +1,89 @@
+# ZeroClaw Dokumentationssammanfattning (Enhetlig Innehållsförteckning)
+
+Denna fil utgör den kanoniska innehållsförteckningen för dokumentationssystemet.
+
+> 📖 [English version](SUMMARY.md)
+
+Senast uppdaterad: **18 februari 2026**.
+
+## Ingångspunkter per språk
+
+- Dokumentationsstrukturkarta (språk/del/funktion): [structure/README.md](maintainers/structure-README.md)
+- README på engelska: [../README.md](../README.md)
+- README på kinesiska: [../README.zh-CN.md](../README.zh-CN.md)
+- README på japanska: [../README.ja.md](../README.ja.md)
+- README på ryska: [../README.ru.md](../README.ru.md)
+- README på franska: [../README.fr.md](../README.fr.md)
+- README på vietnamesiska: [../README.vi.md](../README.vi.md)
+- Dokumentation på engelska: [README.md](README.md)
+- Dokumentation på kinesiska: [README.zh-CN.md](README.zh-CN.md)
+- Dokumentation på japanska: [README.ja.md](README.ja.md)
+- Dokumentation på ryska: [README.ru.md](README.ru.md)
+- Dokumentation på franska: [README.fr.md](README.fr.md)
+- Dokumentation på vietnamesiska: [i18n/vi/README.md](i18n/vi/README.md)
+- Lokaliseringsindex: [i18n/README.md](i18n/README.md)
+- i18n-täckningskarta: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Kategorier
+
+### 1) Snabbstart
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Kommando-, konfigurations- och integrationsreferens
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Drift och driftsättning
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Säkerhetsdesign och förslag
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hårdvara och kringutrustning
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Bidrag och CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Projektstatus och ögonblicksbilder
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.th.md
+++ b/third_party/zeroclaw/docs/SUMMARY.th.md
@@ -0,0 +1,89 @@
+# สรุปเอกสาร ZeroClaw (สารบัญรวม)
+
+ไฟล์นี้เป็นสารบัญหลักของระบบเอกสาร
+
+> 📖 [English version](SUMMARY.md)
+
+อัปเดตล่าสุด: **18 กุมภาพันธ์ 2026**
+
+## จุดเริ่มต้นตามภาษา
+
+- แผนที่โครงสร้างเอกสาร (ภาษา/ส่วน/ฟังก์ชัน): [structure/README.md](maintainers/structure-README.md)
+- README ภาษาอังกฤษ: [../README.md](../README.md)
+- README ภาษาจีน: [../README.zh-CN.md](../README.zh-CN.md)
+- README ภาษาญี่ปุ่น: [../README.ja.md](../README.ja.md)
+- README ภาษารัสเซีย: [../README.ru.md](../README.ru.md)
+- README ภาษาฝรั่งเศส: [../README.fr.md](../README.fr.md)
+- README ภาษาเวียดนาม: [../README.vi.md](../README.vi.md)
+- เอกสารภาษาอังกฤษ: [README.md](README.md)
+- เอกสารภาษาจีน: [README.zh-CN.md](README.zh-CN.md)
+- เอกสารภาษาญี่ปุ่น: [README.ja.md](README.ja.md)
+- เอกสารภาษารัสเซีย: [README.ru.md](README.ru.md)
+- เอกสารภาษาฝรั่งเศส: [README.fr.md](README.fr.md)
+- เอกสารภาษาเวียดนาม: [i18n/vi/README.md](i18n/vi/README.md)
+- ดัชนีการแปล: [i18n/README.md](i18n/README.md)
+- แผนที่ความครอบคลุม i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## หมวดหมู่
+
+### 1) เริ่มต้นอย่างรวดเร็ว
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) คู่มือคำสั่ง การตั้งค่า และการรวมระบบ
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) การดำเนินงานและการปรับใช้
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) การออกแบบความปลอดภัยและข้อเสนอ
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) ฮาร์ดแวร์และอุปกรณ์ต่อพ่วง
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) การมีส่วนร่วมและ CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) สถานะโปรเจกต์และสแนปช็อต
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.tl.md
+++ b/third_party/zeroclaw/docs/SUMMARY.tl.md
@@ -0,0 +1,89 @@
+# Buod ng Dokumentasyon ng ZeroClaw (Pinag-isang Talaan ng Nilalaman)
+
+Ang file na ito ang canonical na talaan ng nilalaman ng sistema ng dokumentasyon.
+
+> 📖 [English version](SUMMARY.md)
+
+Huling na-update: **Pebrero 18, 2026**.
+
+## Mga Entry Point Ayon sa Wika
+
+- Mapa ng istruktura ng docs (wika/bahagi/function): [structure/README.md](maintainers/structure-README.md)
+- README sa Ingles: [../README.md](../README.md)
+- README sa Tsino: [../README.zh-CN.md](../README.zh-CN.md)
+- README sa Hapones: [../README.ja.md](../README.ja.md)
+- README sa Ruso: [../README.ru.md](../README.ru.md)
+- README sa Pranses: [../README.fr.md](../README.fr.md)
+- README sa Vietnamese: [../README.vi.md](../README.vi.md)
+- Dokumentasyon sa Ingles: [README.md](README.md)
+- Dokumentasyon sa Tsino: [README.zh-CN.md](README.zh-CN.md)
+- Dokumentasyon sa Hapones: [README.ja.md](README.ja.md)
+- Dokumentasyon sa Ruso: [README.ru.md](README.ru.md)
+- Dokumentasyon sa Pranses: [README.fr.md](README.fr.md)
+- Dokumentasyon sa Vietnamese: [i18n/vi/README.md](i18n/vi/README.md)
+- Index ng lokalisasyon: [i18n/README.md](i18n/README.md)
+- Mapa ng saklaw ng i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Mga Kategorya
+
+### 1) Mabilis na Pagsisimula
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Reference ng Utos, Configuration, at Integrasyon
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Operasyon at Deployment
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Disenyo ng Seguridad at mga Panukala
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Hardware at Peripheral
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Kontribusyon at CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Estado ng Proyekto at mga Snapshot
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.tr.md
+++ b/third_party/zeroclaw/docs/SUMMARY.tr.md
@@ -0,0 +1,89 @@
+# ZeroClaw Dokümantasyon Özeti (Birleşik İçindekiler)
+
+Bu dosya, dokümantasyon sisteminin kanonik içindekiler tablosudur.
+
+> 📖 [English version](SUMMARY.md)
+
+Son güncelleme: **18 Şubat 2026**.
+
+## Dile Göre Giriş Noktaları
+
+- Dokümantasyon yapı haritası (dil/bölüm/işlev): [structure/README.md](maintainers/structure-README.md)
+- İngilizce README: [../README.md](../README.md)
+- Çince README: [../README.zh-CN.md](../README.zh-CN.md)
+- Japonca README: [../README.ja.md](../README.ja.md)
+- Rusça README: [../README.ru.md](../README.ru.md)
+- Fransızca README: [../README.fr.md](../README.fr.md)
+- Vietnamca README: [../README.vi.md](../README.vi.md)
+- İngilizce dokümantasyon: [README.md](README.md)
+- Çince dokümantasyon: [README.zh-CN.md](README.zh-CN.md)
+- Japonca dokümantasyon: [README.ja.md](README.ja.md)
+- Rusça dokümantasyon: [README.ru.md](README.ru.md)
+- Fransızca dokümantasyon: [README.fr.md](README.fr.md)
+- Vietnamca dokümantasyon: [i18n/vi/README.md](i18n/vi/README.md)
+- Yerelleştirme dizini: [i18n/README.md](i18n/README.md)
+- i18n kapsam haritası: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Kategoriler
+
+### 1) Hızlı Başlangıç
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Komut, Yapılandırma ve Entegrasyon Referansı
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Operasyonlar ve Dağıtım
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Güvenlik Tasarımı ve Öneriler
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Donanım ve Çevre Birimleri
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Katkı ve CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Proje Durumu ve Anlık Görüntüler
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.uk.md
+++ b/third_party/zeroclaw/docs/SUMMARY.uk.md
@@ -0,0 +1,89 @@
+# Зміст документації ZeroClaw (Єдиний зміст)
+
+Цей файл є канонічним змістом системи документації.
+
+> 📖 [English version](SUMMARY.md)
+
+Останнє оновлення: **18 лютого 2026**.
+
+## Точки входу за мовою
+
+- Карта структури документації (мова/розділ/функція): [structure/README.md](maintainers/structure-README.md)
+- README англійською: [../README.md](../README.md)
+- README китайською: [../README.zh-CN.md](../README.zh-CN.md)
+- README японською: [../README.ja.md](../README.ja.md)
+- README російською: [../README.ru.md](../README.ru.md)
+- README французькою: [../README.fr.md](../README.fr.md)
+- README в'єтнамською: [../README.vi.md](../README.vi.md)
+- Документація англійською: [README.md](README.md)
+- Документація китайською: [README.zh-CN.md](README.zh-CN.md)
+- Документація японською: [README.ja.md](README.ja.md)
+- Документація російською: [README.ru.md](README.ru.md)
+- Документація французькою: [README.fr.md](README.fr.md)
+- Документація в'єтнамською: [i18n/vi/README.md](i18n/vi/README.md)
+- Індекс локалізації: [i18n/README.md](i18n/README.md)
+- Карта покриття i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Категорії
+
+### 1) Швидкий старт
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Довідник команд, конфігурації та інтеграцій
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Експлуатація та розгортання
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Проектування безпеки та пропозиції
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Обладнання та периферія
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Внесок та CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Стан проекту та знімки
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.ur.md
+++ b/third_party/zeroclaw/docs/SUMMARY.ur.md
@@ -0,0 +1,89 @@
+# ZeroClaw دستاویزات کا خلاصہ (متحد فہرست مضامین)
+
+یہ فائل دستاویزات کے نظام کی معیاری فہرست مضامین ہے۔
+
+> 📖 [English version](SUMMARY.md)
+
+آخری تازہ کاری: **18 فروری 2026**۔
+
+## زبان کے مطابق داخلی نقاط
+
+- دستاویزات ساختی نقشہ (زبان/حصہ/فنکشن): [structure/README.md](maintainers/structure-README.md)
+- انگریزی README: [../README.md](../README.md)
+- چینی README: [../README.zh-CN.md](../README.zh-CN.md)
+- جاپانی README: [../README.ja.md](../README.ja.md)
+- روسی README: [../README.ru.md](../README.ru.md)
+- فرانسیسی README: [../README.fr.md](../README.fr.md)
+- ویتنامی README: [../README.vi.md](../README.vi.md)
+- انگریزی دستاویزات: [README.md](README.md)
+- چینی دستاویزات: [README.zh-CN.md](README.zh-CN.md)
+- جاپانی دستاویزات: [README.ja.md](README.ja.md)
+- روسی دستاویزات: [README.ru.md](README.ru.md)
+- فرانسیسی دستاویزات: [README.fr.md](README.fr.md)
+- ویتنامی دستاویزات: [i18n/vi/README.md](i18n/vi/README.md)
+- لوکلائزیشن انڈیکس: [i18n/README.md](i18n/README.md)
+- i18n کوریج نقشہ: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## زمرے
+
+### 1) فوری آغاز
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) کمانڈز، کنفیگریشن اور انضمام کا حوالہ
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) آپریشنز اور تعیناتی
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) سیکیورٹی ڈیزائن اور تجاویز
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) ہارڈویئر اور پیریفرلز
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) شراکت اور CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) پراجیکٹ کی حالت اور سنیپ شاٹس
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.vi.md
+++ b/third_party/zeroclaw/docs/SUMMARY.vi.md
@@ -0,0 +1,89 @@
+# Tóm tắt Tài liệu ZeroClaw (Mục lục Thống nhất)
+
+Tệp này là mục lục chính thức của hệ thống tài liệu.
+
+> 📖 [English version](SUMMARY.md)
+
+Cập nhật lần cuối: **18 tháng 2, 2026**.
+
+## Điểm vào theo Ngôn ngữ
+
+- Bản đồ cấu trúc tài liệu (ngôn ngữ/phần/chức năng): [structure/README.md](maintainers/structure-README.md)
+- README tiếng Anh: [../README.md](../README.md)
+- README tiếng Trung: [../README.zh-CN.md](../README.zh-CN.md)
+- README tiếng Nhật: [../README.ja.md](../README.ja.md)
+- README tiếng Nga: [../README.ru.md](../README.ru.md)
+- README tiếng Pháp: [../README.fr.md](../README.fr.md)
+- README tiếng Việt: [../README.vi.md](../README.vi.md)
+- Tài liệu tiếng Anh: [README.md](README.md)
+- Tài liệu tiếng Trung: [README.zh-CN.md](README.zh-CN.md)
+- Tài liệu tiếng Nhật: [README.ja.md](README.ja.md)
+- Tài liệu tiếng Nga: [README.ru.md](README.ru.md)
+- Tài liệu tiếng Pháp: [README.fr.md](README.fr.md)
+- Tài liệu tiếng Việt: [README.vi.md](README.vi.md)
+- Chỉ mục bản địa hóa: [i18n/README.md](i18n/README.md)
+- Bản đồ phủ sóng i18n: [i18n-coverage.md](maintainers/i18n-coverage.md)
+
+## Danh mục
+
+### 1) Bắt đầu Nhanh
+
+- [setup-guides/README.md](setup-guides/README.md)
+- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+
+### 2) Tham chiếu Lệnh, Cấu hình và Tích hợp
+
+- [reference/README.md](reference/README.md)
+- [commands-reference.md](reference/cli/commands-reference.md)
+- [providers-reference.md](reference/api/providers-reference.md)
+- [channels-reference.md](reference/api/channels-reference.md)
+- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md)
+- [config-reference.md](reference/api/config-reference.md)
+- [custom-providers.md](contributing/custom-providers.md)
+- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
+- [langgraph-integration.md](contributing/langgraph-integration.md)
+
+### 3) Vận hành và Triển khai
+
+- [ops/README.md](ops/README.md)
+- [operations-runbook.md](ops/operations-runbook.md)
+- [release-process.md](contributing/release-process.md)
+- [troubleshooting.md](ops/troubleshooting.md)
+- [network-deployment.md](ops/network-deployment.md)
+- [mattermost-setup.md](setup-guides/mattermost-setup.md)
+
+### 4) Thiết kế Bảo mật và Đề xuất
+
+- [security/README.md](security/README.md)
+- [agnostic-security.md](security/agnostic-security.md)
+- [frictionless-security.md](security/frictionless-security.md)
+- [sandboxing.md](security/sandboxing.md)
+- [resource-limits.md](ops/resource-limits.md)
+- [audit-logging.md](security/audit-logging.md)
+- [security-roadmap.md](security/security-roadmap.md)
+
+### 5) Phần cứng và Thiết bị Ngoại vi
+
+- [hardware/README.md](hardware/README.md)
+- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md)
+- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md)
+- [nucleo-setup.md](hardware/nucleo-setup.md)
+- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md)
+- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md)
+- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md)
+- [datasheets/esp32.md](hardware/datasheets/esp32.md)
+
+### 6) Đóng góp và CI
+
+- [contributing/README.md](contributing/README.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](contributing/pr-workflow.md)
+- [reviewer-playbook.md](contributing/reviewer-playbook.md)
+- [ci-map.md](contributing/ci-map.md)
+- [actions-source-policy.md](contributing/actions-source-policy.md)
+
+### 7) Trạng thái Dự án và Ảnh chụp
+
+- [maintainers/README.md](maintainers/README.md)
+- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md)
+- [docs-inventory.md](maintainers/docs-inventory.md)
--- a/third_party/zeroclaw/docs/SUMMARY.zh-CN.md
+++ b/third_party/zeroclaw/docs/SUMMARY.zh-CN.md
@@ -0,0 +1,114 @@
+# ZeroClaw 文档目录（统一目录）
+
+本文件为文档系统的规范目录。
+
+> 📖 [English version](SUMMARY.md)
+
+最后更新：**2026年3月14日**。
+
+## 语言入口
+
+- 文档结构图（按语言/分区/功能）：[structure/README.md](i18n/zh-CN/maintainers/structure-README.zh-CN.md)
+- 英文 README：[../README.md](../README.md)
+- 中文 README：[../README.zh-CN.md](../README.zh-CN.md)
+- 日文 README：[../README.ja.md](../README.ja.md)
+- 俄文 README：[../README.ru.md](../README.ru.md)
+- 法文 README：[../README.fr.md](../README.fr.md)
+- 越南文 README：[../README.vi.md](../README.vi.md)
+- 英文文档中心：[README.md](README.md)
+- 中文文档中心：[README.zh-CN.md](README.zh-CN.md)
+- 日文文档中心：[README.ja.md](README.ja.md)
+- 俄文文档中心：[README.ru.md](README.ru.md)
+- 法文文档中心：[README.fr.md](README.fr.md)
+- 越南文文档中心：[i18n/vi/README.md](i18n/vi/README.md)
+- 国际化文档索引：[i18n/README.md](i18n/README.md)
+- 国际化覆盖图：[i18n-coverage.md](i18n/zh-CN/maintainers/i18n-coverage.zh-CN.md)
+
+## 分类
+
+### 1) 快速入门
+
+- [setup-guides/README.md](i18n/zh-CN/setup-guides/README.zh-CN.md)
+- [macos-update-uninstall.md](i18n/zh-CN/setup-guides/macos-update-uninstall.zh-CN.md)
+- [one-click-bootstrap.md](i18n/zh-CN/setup-guides/one-click-bootstrap.zh-CN.md)
+- [mattermost-setup.md](i18n/zh-CN/setup-guides/mattermost-setup.zh-CN.md)
+- [nextcloud-talk-setup.md](i18n/zh-CN/setup-guides/nextcloud-talk-setup.zh-CN.md)
+- [zai-glm-setup.md](i18n/zh-CN/setup-guides/zai-glm-setup.zh-CN.md)
+
+### 2) 命令 / 配置参考与集成
+
+- [reference/README.md](i18n/zh-CN/reference/README.zh-CN.md)
+- [commands-reference.md](i18n/zh-CN/reference/cli/commands-reference.zh-CN.md)
+- [providers-reference.md](i18n/zh-CN/reference/api/providers-reference.zh-CN.md)
+- [channels-reference.md](i18n/zh-CN/reference/api/channels-reference.zh-CN.md)
+- [config-reference.md](i18n/zh-CN/reference/api/config-reference.zh-CN.md)
+- [custom-providers.md](i18n/zh-CN/contributing/custom-providers.zh-CN.md)
+- [langgraph-integration.md](i18n/zh-CN/contributing/langgraph-integration.zh-CN.md)
+
+### 3) SOP（标准操作流程）
+
+- [reference/sop/README.md](i18n/zh-CN/reference/sop/README.zh-CN.md)
+- [reference/sop/syntax.md](i18n/zh-CN/reference/sop/syntax.zh-CN.md)
+- [reference/sop/cookbook.md](i18n/zh-CN/reference/sop/cookbook.zh-CN.md)
+- [reference/sop/connectivity.md](i18n/zh-CN/reference/sop/connectivity.zh-CN.md)
+- [reference/sop/observability.md](i18n/zh-CN/reference/sop/observability.zh-CN.md)
+
+### 4) 运维与部署
+
+- [ops/README.md](i18n/zh-CN/ops/README.zh-CN.md)
+- [operations-runbook.md](i18n/zh-CN/ops/operations-runbook.zh-CN.md)
+- [release-process.md](i18n/zh-CN/contributing/release-process.zh-CN.md)
+- [troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md)
+- [network-deployment.md](i18n/zh-CN/ops/network-deployment.zh-CN.md)
+- [proxy-agent-playbook.md](i18n/zh-CN/ops/proxy-agent-playbook.zh-CN.md)
+- [resource-limits.md](i18n/zh-CN/ops/resource-limits.zh-CN.md)
+
+### 5) 安全设计与提案
+
+- [security/README.md](i18n/zh-CN/security/README.zh-CN.md)
+- [matrix-e2ee-guide.md](i18n/zh-CN/security/matrix-e2ee-guide.zh-CN.md)
+- [agnostic-security.md](i18n/zh-CN/security/agnostic-security.zh-CN.md)
+- [frictionless-security.md](i18n/zh-CN/security/frictionless-security.zh-CN.md)
+- [sandboxing.md](i18n/zh-CN/security/sandboxing.zh-CN.md)
+- [audit-logging.md](i18n/zh-CN/security/audit-logging.zh-CN.md)
+- [security-roadmap.md](i18n/zh-CN/security/security-roadmap.zh-CN.md)
+
+### 6) 硬件与外设
+
+- [hardware/README.md](i18n/zh-CN/hardware/README.zh-CN.md)
+- [hardware-peripherals-design.md](i18n/zh-CN/hardware/hardware-peripherals-design.zh-CN.md)
+- [adding-boards-and-tools.md](i18n/zh-CN/contributing/adding-boards-and-tools.zh-CN.md)
+- [nucleo-setup.md](i18n/zh-CN/hardware/nucleo-setup.zh-CN.md)
+- [arduino-uno-q-setup.md](i18n/zh-CN/hardware/arduino-uno-q-setup.zh-CN.md)
+- [android-setup.md](i18n/zh-CN/hardware/android-setup.zh-CN.md)
+- [datasheets/nucleo-f401re.md](i18n/zh-CN/hardware/datasheets/nucleo-f401re.zh-CN.md)
+- [datasheets/arduino-uno.md](i18n/zh-CN/hardware/datasheets/arduino-uno.zh-CN.md)
+- [datasheets/esp32.md](i18n/zh-CN/hardware/datasheets/esp32.zh-CN.md)
+
+### 7) 贡献与 CI
+
+- [contributing/README.md](i18n/zh-CN/contributing/README.zh-CN.md)
+- [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- [pr-workflow.md](i18n/zh-CN/contributing/pr-workflow.zh-CN.md)
+- [reviewer-playbook.md](i18n/zh-CN/contributing/reviewer-playbook.zh-CN.md)
+- [ci-map.md](i18n/zh-CN/contributing/ci-map.zh-CN.md)
+- [actions-source-policy.md](i18n/zh-CN/contributing/actions-source-policy.zh-CN.md)
+- [extension-examples.md](i18n/zh-CN/contributing/extension-examples.zh-CN.md)
+- [testing.md](i18n/zh-CN/contributing/testing.zh-CN.md)
+- [testing-telegram.md](i18n/zh-CN/contributing/testing-telegram.zh-CN.md)
+- [cargo-slicer-speedup.md](i18n/zh-CN/contributing/cargo-slicer-speedup.zh-CN.md)
+- [change-playbooks.md](i18n/zh-CN/contributing/change-playbooks.zh-CN.md)
+- [cla.md](i18n/zh-CN/contributing/cla.zh-CN.md)
+- [doc-template.md](i18n/zh-CN/contributing/doc-template.zh-CN.md)
+- [docs-contract.md](i18n/zh-CN/contributing/docs-contract.zh-CN.md)
+- [pr-discipline.md](i18n/zh-CN/contributing/pr-discipline.zh-CN.md)
+
+### 8) 项目状态与快照
+
+- [maintainers/README.md](i18n/zh-CN/maintainers/README.zh-CN.md)
+- [project-triage-snapshot-2026-02-18.md](i18n/zh-CN/maintainers/project-triage-snapshot-2026-02-18.zh-CN.md)
+- [docs-inventory.md](i18n/zh-CN/maintainers/docs-inventory.zh-CN.md)
+- [refactor-candidates.md](i18n/zh-CN/maintainers/refactor-candidates.zh-CN.md)
+- [repo-map.md](i18n/zh-CN/maintainers/repo-map.zh-CN.md)
+- [structure-README.md](i18n/zh-CN/maintainers/structure-README.zh-CN.md)
+- [trademark.md](i18n/zh-CN/maintainers/trademark.zh-CN.md)
--- a/third_party/zeroclaw/docs/aardvark-integration.md
+++ b/third_party/zeroclaw/docs/aardvark-integration.md
@@ -0,0 +1,325 @@
+# Aardvark Integration — How It Works
+
+A plain-language walkthrough of every piece and how they connect.
+
+---
+
+## The Big Picture
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                        STARTUP (boot)                        │
+│                                                              │
+│  1. Ask aardvark-sys: "any adapters plugged in?"            │
+│  2. For each one found → register a device + transport       │
+│  3. Load tools only if hardware was found                    │
+└──────────────────────────────────────────┬───────────────────┘
+                                           │
+                    ┌──────────────────────▼──────────────────────┐
+                    │              RUNTIME (agent loop)            │
+                    │                                              │
+                    │  User: "scan i2c bus"                        │
+                    │     → agent calls i2c_scan tool              │
+                    │     → tool builds a ZcCommand                │
+                    │     → AardvarkTransport sends to hardware     │
+                    │     → response flows back as text            │
+                    └──────────────────────────────────────────────┘
+```
+
+---
+
+## Layer by Layer
+
+### Layer 1 — `aardvark-sys` (the USB talker)
+
+**File:** `crates/aardvark-sys/src/lib.rs`
+
+This is the only layer that ever touches the raw C library.
+Think of it as a thin translator: it turns C function calls into safe Rust.
+
+**Algorithm:**
+
+```
+find_devices()
+  → call aa_find_devices(16, buf)       // ask C lib how many adapters
+  → return Vec of port numbers          // [0, 1, ...] one per adapter
+
+open_port(port)
+  → call aa_open(port)                  // open that specific adapter
+  → if handle ≤ 0, return OpenFailed
+  → else return AardvarkHandle{ _port: handle }
+
+i2c_scan(handle)
+  → for addr in 0x08..=0x77            // every valid 7-bit address
+      try aa_i2c_read(addr, 1 byte)    // knock on the door
+      if ACK → add to list             // device answered
+  → return list of live addresses
+
+i2c_read(handle, addr, len)
+  → aa_i2c_read(addr, len bytes)
+  → return bytes as Vec<u8>
+
+i2c_write(handle, addr, data)
+  → aa_i2c_write(addr, data)
+
+spi_transfer(handle, bytes_to_send)
+  → aa_spi_write(bytes)                // full-duplex: sends + receives
+  → return received bytes
+
+gpio_set(handle, direction, value)
+  → aa_gpio_direction(direction)       // which pins are outputs
+  → aa_gpio_put(value)                 // set output levels
+
+gpio_get(handle)
+  → aa_gpio_get()                      // read all pin levels as bitmask
+
+Drop(handle)
+  → aa_close(handle._port)            // always close on drop
+```
+
+**In stub mode** (no SDK): every method returns `Err(NotFound)` immediately. `find_devices()` returns `[]`. Nothing crashes.
+
+---
+
+### Layer 2 — `AardvarkTransport` (the bridge)
+
+**File:** `src/hardware/aardvark.rs`
+
+The rest of ZeroClaw speaks a single language: `ZcCommand` → `ZcResponse`.
+`AardvarkTransport` translates between that protocol and the aardvark-sys calls above.
+
+**Algorithm:**
+
+```
+send(ZcCommand) → ZcResponse
+
+  extract command name from cmd.name
+  extract parameters from cmd.params (serde_json values)
+
+  match cmd.name:
+
+    "i2c_scan"   → open handle → call i2c_scan()
+                   → format found addresses as hex list
+                   → return ZcResponse{ output: "0x48, 0x68" }
+
+    "i2c_read"   → parse addr (hex string) + len (number)
+                   → open handle → i2c_enable(bitrate)
+                   → call i2c_read(addr, len)
+                   → format bytes as hex
+                   → return ZcResponse{ output: "0xAB 0xCD" }
+
+    "i2c_write"  → parse addr + data bytes
+                   → open handle → i2c_write(addr, data)
+                   → return ZcResponse{ output: "ok" }
+
+    "spi_transfer" → parse bytes_hex string → decode to Vec<u8>
+                     → open handle → spi_enable(bitrate)
+                     → spi_transfer(bytes)
+                     → return received bytes as hex
+
+    "gpio_set"   → parse direction + value bitmasks
+                   → open handle → gpio_set(dir, val)
+                   → return ZcResponse{ output: "ok" }
+
+    "gpio_get"   → open handle → gpio_get()
+                   → return bitmask value as string
+
+  on any AardvarkError → return ZcResponse{ error: "..." }
+```
+
+**Key design choice — lazy open:** The handle is opened fresh for every command and dropped at the end. This means no held connection, no state to clean up, and no "is it still open?" logic anywhere.
+
+---
+
+### Layer 3 — Tools (what the agent calls)
+
+**File:** `src/hardware/aardvark_tools.rs`
+
+Each tool is a thin wrapper. It:
+1. Validates the agent's JSON input
+2. Resolves which physical device to use
+3. Builds a `ZcCommand`
+4. Calls `AardvarkTransport.send()`
+5. Returns the result as text
+
+```
+I2cScanTool.call(args)
+  → look up "device" in args (default: "aardvark0")
+  → find that device in the registry
+  → build ZcCommand{ name: "i2c_scan", params: {} }
+  → send to AardvarkTransport
+  → return "Found: 0x48, 0x68" (or "No devices found")
+
+I2cReadTool.call(args)
+  → require args["addr"] and args["len"]
+  → build ZcCommand{ name: "i2c_read", params: {addr, len} }
+  → send → return hex bytes
+
+I2cWriteTool.call(args)
+  → require args["addr"] and args["data"] (hex or array)
+  → build ZcCommand{ name: "i2c_write", params: {addr, data} }
+  → send → return "ok" or error
+
+SpiTransferTool.call(args)
+  → require args["bytes"] (hex string)
+  → build ZcCommand{ name: "spi_transfer", params: {bytes} }
+  → send → return received bytes
+
+GpioAardvarkTool.call(args)
+  → require args["direction"] + args["value"]  (set)
+         OR no extra args                       (get)
+  → build appropriate ZcCommand
+  → send → return result
+
+DatasheetTool.call(args)
+  → action = args["action"]: "search" | "download" | "list" | "read"
+  → "search":   return a Google/vendor search URL for the device
+  → "download": fetch PDF from args["url"] → save to ~/.zeroclaw/hardware/datasheets/
+  → "list":     scan the datasheets directory → return filenames
+  → "read":     open a saved PDF and return its text
+```
+
+---
+
+### Layer 4 — Device Registry (the address book)
+
+**File:** `src/hardware/device.rs`
+
+The registry is a runtime map of every connected device.
+Each entry stores: alias, kind, capabilities, transport handle.
+
+```
+register("aardvark", vid=0x2b76, ...)
+  → DeviceKind::from_vid(0x2b76)  → DeviceKind::Aardvark
+  → DeviceRuntime::from_kind()    → DeviceRuntime::Aardvark
+  → assign alias "aardvark0" (then "aardvark1" for second, etc.)
+  → store entry in HashMap
+
+attach_transport("aardvark0", AardvarkTransport, capabilities{i2c,spi,gpio})
+  → store Arc<dyn Transport> in the entry
+
+has_aardvark()
+  → any entry where kind == Aardvark  → true / false
+
+resolve_aardvark_device(args)
+  → read "device" param (default: "aardvark0")
+  → look up alias in HashMap
+  → return (alias, DeviceContext{ transport, capabilities })
+```
+
+---
+
+### Layer 5 — `boot()` (startup wiring)
+
+**File:** `src/hardware/mod.rs`
+
+`boot()` runs once at startup. For Aardvark:
+
+```
+boot()
+  ...
+  aardvark_ports = aardvark_sys::AardvarkHandle::find_devices()
+  // → [] in stub mode, [0] if one adapter is plugged in
+
+  for (i, port) in aardvark_ports:
+    alias = registry.register("aardvark", vid=0x2b76, ...)
+    // → "aardvark0", "aardvark1", ...
+
+    transport = AardvarkTransport::new(port, bitrate=100kHz)
+    registry.attach_transport(alias, transport, {i2c:true, spi:true, gpio:true})
+
+    log "[registry] aardvark0 ready → Total Phase port 0"
+  ...
+```
+
+---
+
+### Layer 6 — Tool Registry (the loader)
+
+**File:** `src/hardware/tool_registry.rs`
+
+After `boot()`, the tool registry checks what hardware is present and loads
+only the relevant tools:
+
+```
+ToolRegistry::load(devices)
+
+  # always loaded (Pico / GPIO)
+  register: gpio_write, gpio_read, gpio_toggle, pico_flash, device_list, device_status
+
+  # only loaded if an Aardvark was found at boot
+  if devices.has_aardvark():
+    register: i2c_scan, i2c_read, i2c_write, spi_transfer, gpio_aardvark, datasheet
+```
+
+This is why the `hardware_feature_registers_all_six_tools` test still passes in stub mode — `has_aardvark()` returns false, 0 extra tools load, count stays at 6.
+
+---
+
+## Full Flow Diagram
+
+```
+ SDK FILES          aardvark-sys            ZeroClaw core
+ (vendor/)          (crates/)               (src/)
+─────────────────────────────────────────────────────────────────
+
+ aardvark.h  ──►  build.rs         boot()
+ aardvark.so       (bindgen)    ──►  find_devices()
+                       │                │
+                  bindings.rs           │  vec![0]  (one adapter)
+                       │                ▼
+                  lib.rs           register("aardvark0")
+                  AardvarkHandle   attach_transport(AardvarkTransport)
+                       │                │
+                       │                ▼
+                       │         ToolRegistry::load()
+                       │           has_aardvark() == true
+                       │           → load 6 aardvark tools
+                       │
+─────────────────────────────────────────────────────────────────
+
+ USER MESSAGE: "scan the i2c bus"
+
+  agent loop
+      │
+      ▼
+  I2cScanTool.call()
+      │
+      ▼
+  resolve_aardvark_device("aardvark0")
+      │  returns transport Arc
+      ▼
+  AardvarkTransport.send(ZcCommand{ name: "i2c_scan" })
+      │
+      ▼
+  AardvarkHandle::open_port(0)    ← opens USB connection
+      │
+      ▼
+  aa_i2c_read(0x08..0x77)         ← probes each address
+      │
+      ▼
+  AardvarkHandle dropped           ← USB connection closed
+      │
+      ▼
+  ZcResponse{ output: "Found: 0x48, 0x68" }
+      │
+      ▼
+  agent sends reply to user: "I found two I2C devices: 0x48 and 0x68"
+```
+
+---
+
+## Stub vs Real Side by Side
+
+| | Stub mode (now) | Real hardware |
+|---|---|---|
+| `find_devices()` | returns `[]` | returns `[0]` |
+| `open_port(0)` | `Err(NotFound)` | opens USB, returns handle |
+| `i2c_scan()` | `[]` | probes bus, returns addresses |
+| tools loaded | only the 6 Pico tools | 6 Pico + 6 Aardvark tools |
+| `has_aardvark()` | `false` | `true` |
+| SDK needed | no | yes (`vendor/aardvark.h` + `.so`) |
+
+The only code that changes when you plug in real hardware is inside
+`crates/aardvark-sys/src/lib.rs` — every other layer is already wired up
+and waiting.
--- a/third_party/zeroclaw/docs/architecture/adr-004-tool-shared-state-ownership.md
+++ b/third_party/zeroclaw/docs/architecture/adr-004-tool-shared-state-ownership.md
@@ -0,0 +1,202 @@
+# ADR-004: Tool Shared State Ownership Contract
+
+**Status:** Accepted
+
+**Date:** 2026-03-22
+
+**Issue:** [#4057](https://github.com/zeroclaw/zeroclaw/issues/4057)
+
+## Context
+
+ZeroClaw tools execute in a multi-client environment where a single daemon
+process serves requests from multiple connected clients simultaneously. Several
+tools already maintain long-lived shared state:
+
+- **`DelegateParentToolsHandle`** (`src/tools/mod.rs`):
+  `Arc<RwLock<Vec<Arc<dyn Tool>>>>` — holds parent tools for delegate agents
+  with no per-client isolation.
+- **`ChannelMapHandle`** (`src/tools/reaction.rs`):
+  `Arc<RwLock<HashMap<String, Arc<dyn Channel>>>>` — global channel map shared
+  across all clients.
+- **`CanvasStore`** (`src/tools/canvas.rs`):
+  `Arc<RwLock<HashMap<String, CanvasEntry>>>` — canvas IDs are plain strings
+  with no client namespace.
+
+These patterns emerged organically. As the tool surface grows and more clients
+connect concurrently, we need a clear contract governing ownership, identity,
+isolation, lifecycle, and reload behavior for tool-held shared state. Without
+this contract, new tools risk introducing data leaks between clients, stale
+state after config reloads, or inconsistent initialization timing.
+
+Additional context:
+
+- The tool registry is immutable after startup, built once in
+  `all_tools_with_runtime()`.
+- Client identity is currently derived from IP address only
+  (`src/gateway/mod.rs`), which is insufficient for reliable namespacing.
+- `SecurityPolicy` is scoped per agent, not per client.
+- `WorkspaceManager` provides some isolation but workspace switching is global.
+
+## Decision
+
+### 1. Ownership: May tools own long-lived shared state?
+
+**Yes.** Tools MAY own long-lived shared state, provided they follow the
+established **handle pattern**: wrap the state in `Arc<RwLock<T>>` (or
+`Arc<parking_lot::RwLock<T>>`) and expose a cloneable handle type.
+
+This pattern is already proven by three independent implementations:
+
+| Handle | Location | Inner type |
+|--------|----------|-----------|
+| `DelegateParentToolsHandle` | `src/tools/mod.rs` | `Vec<Arc<dyn Tool>>` |
+| `ChannelMapHandle` | `src/tools/reaction.rs` | `HashMap<String, Arc<dyn Channel>>` |
+| `CanvasStore` | `src/tools/canvas.rs` | `HashMap<String, CanvasEntry>` |
+
+Tools that need shared state MUST:
+
+- Define a named handle type alias (e.g., `pub type FooHandle = Arc<RwLock<T>>`).
+- Accept the handle at construction time rather than creating global state.
+- Document the concurrency contract in the handle type's doc comment.
+
+Tools MUST NOT use static mutable state (`lazy_static!`, `OnceCell` with
+interior mutability) for per-request or per-client data.
+
+### 2. Identity assignment: Who constructs identity keys?
+
+**The daemon SHOULD provide identity.** Tools MUST NOT construct their own
+client identity keys.
+
+A new `ClientId` type should be introduced (opaque, `Clone + Eq + Hash + Send + Sync`)
+that the daemon assigns at connection time. This replaces the current approach
+of using raw IP addresses (`src/gateway/mod.rs:259-306`), which breaks when
+multiple clients share a NAT address or when proxied connections arrive.
+
+`ClientId` is passed to tools that require per-client state namespacing as part
+of the tool execution context. Tools that do not need per-client isolation
+(e.g., the immutable tool registry) may ignore it.
+
+The `ClientId` contract:
+
+- Generated by the gateway layer at connection establishment.
+- Opaque to tools — tools must not parse or derive meaning from the value.
+- Stable for the lifetime of a single client session.
+- Passed through the execution context, not stored globally.
+
+### 3. Lifecycle: When may tools run startup-style validation?
+
+**Validation runs once at first registration, and again when config changes
+are detected.**
+
+The lifecycle phases are:
+
+1. **Construction** — tool is instantiated with handles and config. No I/O or
+   validation occurs here.
+2. **Registration** — tool is registered in the tool registry via
+   `all_tools_with_runtime()`. At this point the tool MAY perform one-time
+   startup validation (e.g., checking that required credentials exist, verifying
+   external service connectivity).
+3. **Execution** — tool handles individual requests. No re-validation unless
+   the config-change signal fires (see Reload Semantics below).
+4. **Shutdown** — daemon is stopping. Tools with open resources SHOULD clean up
+   gracefully via `Drop` or an explicit shutdown method.
+
+Tools MUST NOT perform blocking validation during execution-phase calls.
+Validation results SHOULD be cached in the tool's handle state and checked
+via a fast path during execution.
+
+### 4. Isolation: What must be isolated per client?
+
+State falls into two categories with different isolation requirements:
+
+**MUST be isolated per client:**
+
+- Security-sensitive state: credentials, API keys, quotas, rate-limit counters,
+  per-client authorization decisions.
+- User-specific session data: conversation context, user preferences,
+  workspace-scoped file paths.
+
+Isolation mechanism: tools holding per-client state MUST key their internal
+maps by `ClientId`. The handle pattern naturally supports this by using
+`HashMap<ClientId, T>` inside the `RwLock`.
+
+**MAY be shared across clients (with namespace prefixing):**
+
+- Broadcast/display state: canvas frames (`CanvasStore`), notification channels
+  (`ChannelMapHandle`).
+- Read-only reference data: tool registry, static configuration, model
+  metadata.
+
+When shared state uses string keys (e.g., canvas IDs, channel names), tools
+SHOULD support optional namespace prefixing (e.g., `{client_id}:{canvas_name}`)
+to allow per-client isolation when needed without mandating it for broadcast
+use cases.
+
+Tools MUST NOT store per-client secrets in shared (non-isolated) state
+structures.
+
+### 5. Reload semantics: What invalidates prior shared state on config change?
+
+**Config changes detected via hash comparison MUST invalidate cached
+validation state.**
+
+The reload contract:
+
+- The daemon computes a hash of the tool-relevant config section at startup and
+  after each config reload event.
+- When the hash changes, the daemon signals affected tools to re-run their
+  registration-phase validation.
+- Tools MUST treat their cached validation result as stale when signaled and
+  re-validate before the next execution.
+
+Specific invalidation rules:
+
+| Config change | Invalidation scope |
+|--------------|-------------------|
+| Credential/secret rotation | Per-tool validation cache; per-client credential state |
+| Tool enable/disable | Full tool registry rebuild via `all_tools_with_runtime()` |
+| Security policy change | `SecurityPolicy` re-derivation; per-agent policy state |
+| Workspace directory change | `WorkspaceManager` state; file-path-dependent tool state |
+| Provider config change | Provider-dependent tools re-validate connectivity |
+
+Tools MAY retain non-security shared state (e.g., canvas content, channel
+subscriptions) across config reloads unless the reload explicitly affects that
+state's validity.
+
+## Consequences
+
+### Positive
+
+- **Consistency:** All new tools follow the same handle pattern, making shared
+  state discoverable and auditable.
+- **Safety:** Per-client isolation of security-sensitive state prevents data
+  leaks in multi-tenant scenarios.
+- **Clarity:** Explicit lifecycle phases eliminate ambiguity about when
+  validation runs.
+- **Evolvability:** The `ClientId` abstraction decouples tools from transport
+  details, supporting future identity mechanisms (tokens, certificates).
+
+### Negative
+
+- **Migration cost:** Existing tools (`CanvasStore`, `ReactionTool`) may need
+  refactoring to accept `ClientId` and namespace their state.
+- **Complexity:** Tools that were simple singletons now need to consider
+  multi-client semantics even if they currently have one client.
+- **Performance:** Per-client keying adds a hash lookup on each access, though
+  this is negligible compared to I/O costs.
+
+### Neutral
+
+- The tool registry remains immutable after startup; this ADR does not change
+  that invariant.
+- `SecurityPolicy` remains per-agent; this ADR documents that client isolation
+  is orthogonal to agent-level policy.
+
+## References
+
+- `src/tools/mod.rs` — `DelegateParentToolsHandle`, `all_tools_with_runtime()`
+- `src/tools/reaction.rs` — `ChannelMapHandle`, `ReactionTool`
+- `src/tools/canvas.rs` — `CanvasStore`, `CanvasEntry`
+- `src/tools/traits.rs` — `Tool` trait
+- `src/gateway/mod.rs` — client IP extraction (`forwarded_client_ip`, `resolve_client_ip`)
+- `src/security/` — `SecurityPolicy`
--- a/third_party/zeroclaw/docs/assets/Hardware_architecture.jpg
+++ b/third_party/zeroclaw/docs/assets/Hardware_architecture.jpg
--- a/third_party/zeroclaw/docs/assets/architecture-diagrams.md
+++ b/third_party/zeroclaw/docs/assets/architecture-diagrams.md
@@ -0,0 +1,832 @@
+# ZeroClaw Architecture Diagrams
+
+This document provides visual representations of ZeroClaw's architecture, execution modes, and data flows.
+
+---
+
+## 1. Execution Modes
+
+**Ways ZeroClaw can be run:**
+
+```mermaid
+flowchart TD
+    Start[zeroclaw CLI] --> Onboard[onboard<br/>Setup wizard]
+    Start --> Agent[agent<br/>Interactive CLI]
+    Start --> Gateway[gateway<br/>HTTP server]
+    Start --> Daemon[daemon<br/>Long-running runtime]
+    Start --> Channel[channel<br/>Messaging platforms]
+    Start --> Service[service<br/>OS service mgmt]
+    Start --> Models[models<br/>Provider catalog]
+    Start --> Cron[cron<br/>Scheduled tasks]
+    Start --> Hardware[hardware<br/>Peripheral discovery]
+    Start --> Peripheral[peripheral<br/>Hardware management]
+    Start --> Status[status<br/>System overview]
+    Start --> Doctor[doctor<br/>Diagnostics]
+    Start --> Migrate[migrate<br/>Data import]
+    Start --> Skills[skills<br/>User capabilities]
+    Start --> Integrations[integrations<br/>Browse 50+ apps]
+
+    Agent --> AgentSingle[-m message<br/>One-shot]
+    Agent --> AgentInteractive[Interactive REPL<br/>stdin/stdout]
+
+    Daemon --> DaemonSupervised[Supervised runtime<br/>Gateway + Channels + Scheduler]
+```
+
+---
+
+## 2. System Architecture Overview
+
+**High-level component structure:**
+
+```mermaid
+flowchart TB
+    subgraph CLI[CLI Entry Point]
+        Main[main.rs]
+    end
+
+    subgraph Core[Core Subsystems]
+        Config[config/<br/>Configuration & Schema]
+        Agent[agent/<br/>Orchestration Loop]
+        Providers[providers/<br/>LLM Adapters]
+        Channels[channels/<br/>Messaging Platforms]
+        Tools[tools/<br/>Tool Execution]
+        Memory[memory/<br/>Storage Backends]
+        Security[security/<br/>Policy & Pairing]
+        Runtime[runtime/<br/>Execution Adapters]
+        Gateway[gateway/<br/>HTTP/Webhook Server]
+        Daemon[daemon/<br/>Supervised Runtime]
+        Peripherals[peripherals/<br/>Hardware Control]
+        Observability[observability/<br/>Telemetry & Metrics]
+        RAG[rag/<br/>Hardware Documentation]
+        Cron[cron/<br/>Scheduler]
+        Skills[skills/<br/>User Capabilities]
+    end
+
+    subgraph Integrations[Integrations]
+        Composio[Composio<br/>1000+ Apps]
+        Browser[Browser<br/>Brave Integration]
+        Tunnel[Tunnel<br/>Cloudflare/boringproxy]
+    end
+
+    Main --> Config
+    Main --> Agent
+    Main --> Gateway
+    Main --> Daemon
+    Main --> Channels
+
+    Agent --> Providers
+    Agent --> Tools
+    Agent --> Memory
+    Agent --> Security
+    Agent --> Runtime
+    Agent --> Peripherals
+    Agent --> RAG
+    Agent --> Skills
+
+    Channels --> Agent
+    Gateway --> Agent
+
+    Daemon --> Gateway
+    Daemon --> Channels
+    Daemon --> Cron
+    Daemon --> Observability
+
+    Tools --> Composio
+    Tools --> Browser
+    Gateway --> Tunnel
+
+    classDef coreComp fill:#4A90E2,stroke:#1E3A5F,color:#fff
+    classDef integComp fill:#50C878,stroke:#1E3A5F,color:#fff
+    classDef cliComp fill:#F5A623,stroke:#1E3A5F,color:#fff
+
+    class Config,Agent,Providers,Channels,Tools,Memory,Security,Runtime,Gateway,Daemon,Peripherals,Observability,RAG,Cron,Skills coreComp
+    class Composio,Browser,Tunnel integComp
+    class Main cliComp
+```
+
+---
+
+## 3. Message Flow Through The System
+
+**How a user message becomes a response:**
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant Channel as Channel Layer
+    participant Dispatcher as Message Dispatcher
+    participant Agent as Agent Loop
+    participant Provider as LLM Provider
+    participant Tools as Tool Registry
+    participant Memory as Memory Backend
+
+    User->>Channel: Send message
+    Channel->>Dispatcher: ChannelMessage{id, sender, content}
+    Dispatcher->>Memory: Recall context
+    Memory-->>Dispatcher: Relevant memories
+    Dispatcher->>Agent: process_message()
+
+    Note over Agent: Build system prompt<br/>+ memory context
+
+    Agent->>Provider: chat_with_tools(history)
+    Provider-->>Agent: LLM response
+
+    alt Tool calls present
+        loop For each tool call
+            Agent->>Tools: execute(args)
+            Tools-->>Agent: ToolResult
+        end
+        Agent->>Provider: chat_with_tools(+ tool results)
+        Provider-->>Agent: Final response
+    end
+
+    Agent-->>Dispatcher: Response text
+    Dispatcher->>Memory: Store conversation
+    Dispatcher-->>Channel: SendMessage{content, recipient}
+    Channel-->>User: Reply
+```
+
+---
+
+## 4. Agent Loop Execution Flow
+
+**The core agent orchestration loop:**
+
+```mermaid
+flowchart TD
+    Start[[Start: User Message]] --> BuildContext[Build Context]
+
+    BuildContext --> MemoryRecall[Memory.recall<br/>Retrieve relevant entries]
+    BuildContext --> HardwareRAG{Hardware<br/>enabled?}
+    HardwareRAG -->|Yes| LoadDatasheets[Load Hardware RAG<br/>Pin aliases + chunks]
+    HardwareRAG -->|No| BuildPrompt[Build System Prompt]
+    LoadDatasheets --> BuildPrompt
+
+    MemoryRecall --> Enrich[Enrich Message<br/>memory + RAG context]
+    Enrich --> BuildPrompt
+
+    BuildPrompt --> InitHistory[Initialize History<br/>system + user message]
+
+    InitHistory --> ToolLoop{Tool Call Loop<br/>max 10 iterations}
+
+    ToolLoop --> LLMRequest[Provider.chat_with_tools<br/>or chat_with_history]
+    LLMRequest --> ParseResponse[Parse Response]
+
+    ParseResponse --> HasTools{Tool calls<br/>present?}
+
+    HasTools -->|No| SaveResponse[Push assistant response]
+    SaveResponse --> Return[[Return: Final Response]]
+
+    HasTools -->|Yes| Approval{Needs<br/>approval?}
+    Approval -->|Yes & Denied| DenyTool[Record denied]
+    DenyTool --> NextIteration
+
+    Approval -->|No / Approved| ExecuteTools[Execute Tools<br/>in parallel]
+
+    ExecuteTools --> ScrubResults[Scrub credentials<br/>from output]
+    ScrubResults --> AddResults[Add tool results<br/>to history]
+    AddResults --> NextIteration
+
+    DenyTool --> NextIteration[Increment iteration]
+    NextIteration --> MaxIter{Reached<br/>max 10?}
+    MaxIter -->|Yes| Error[[Error: Max iterations]]
+    MaxIter -->|No| ToolLoop
+
+    classDef contextStep fill:#E8F4FD,stroke:#4A90E2
+    classDef llmStep fill:#FFF4E6,stroke:#F5A623
+    classDef toolStep fill:#E8FDF5,stroke:#50C878
+    classDef errorStep fill:#FDE8E8,stroke:#D0021B
+
+    class BuildContext,MemoryRecall,HardwareRAG,LoadDatasheets,Enrich,BuildPrompt,InitHistory contextStep
+    class LLMRequest,ParseResponse llmStep
+    class ExecuteTools,ScrubResults,AddResults toolStep
+    class Error errorStep
+```
+
+---
+
+## 5. Daemon Supervision Model
+
+**How the daemon keeps components alive:**
+
+```mermaid
+flowchart TB
+    Start[[zeroclaw daemon]] --> SpawnComponents
+
+    SpawnComponents --> SpawnState[Spawn State Writer<br/>5s flush interval]
+    SpawnComponents --> SpawnGateway[Spawn Gateway Supervisor]
+    SpawnComponents --> SpawnChannels{Channels<br/>configured?}
+    SpawnComponents --> SpawnHeartbeat{Heartbeat<br/>enabled?}
+    SpawnComponents --> SpawnScheduler{Cron<br/>enabled?}
+
+    SpawnChannels -->|Yes| SpawnChannelSup[Spawn Channel Supervisor]
+    SpawnChannels -->|No| MarkChannelsOK[Mark channels OK<br/>disabled]
+
+    SpawnHeartbeat -->|Yes| SpawnHeartbeatWorker[Spawn Heartbeat Worker]
+    SpawnHeartbeat -->|No| MarkHeartbeatOK[Mark heartbeat OK<br/>disabled]
+
+    SpawnScheduler -->|Yes| SpawnSchedulerWorker[Spawn Cron Scheduler]
+    SpawnScheduler -->|No| MarkSchedulerOK[Mark scheduler OK<br/>disabled]
+
+    SpawnGateway --> GatewayLoop{Gateway Loop}
+    SpawnChannelSup --> ChannelLoop{Channel Loop}
+    SpawnHeartbeatWorker --> HeartbeatLoop{Heartbeat Loop}
+    SpawnSchedulerWorker --> SchedulerLoop{Scheduler Loop}
+
+    GatewayLoop --> GatewayRun[run_gateway]
+    GatewayRun --> GatewayExit{Exit OK?}
+    GatewayExit -->|No| GatewayError[Mark error + log]
+    GatewayExit -->|Yes| GatewayUnexpected[Mark: unexpected exit]
+    GatewayError --> GatewayBackoff[Wait with backoff]
+    GatewayUnexpected --> GatewayBackoff
+    GatewayBackoff --> GatewayLoop
+
+    ChannelLoop --> ChannelRun[start_channels]
+    ChannelRun --> ChannelExit{Exit OK?}
+    ChannelExit -->|No| ChannelError[Mark error + log]
+    ChannelExit -->|Yes| ChannelUnexpected[Mark: unexpected exit]
+    ChannelError --> ChannelBackoff[Wait with backoff]
+    ChannelUnexpected --> ChannelBackoff
+    ChannelBackoff --> ChannelLoop
+
+    HeartbeatLoop --> HeartbeatRun[Collect tasks + Agent runs]
+    HeartbeatRun --> HeartbeatExit{Exit OK?}
+    HeartbeatExit -->|No| HeartbeatError[Mark error + log]
+    HeartbeatExit -->|Yes| HeartbeatUnexpected[Mark: unexpected exit]
+    HeartbeatError --> HeartbeatBackoff[Wait with backoff]
+    HeartbeatUnexpected --> HeartbeatBackoff
+    HeartbeatBackoff --> HeartbeatLoop
+
+    SchedulerLoop --> SchedulerRun[cron::scheduler::run]
+    SchedulerRun --> SchedulerExit{Exit OK?}
+    SchedulerExit -->|No| SchedulerError[Mark error + log]
+    SchedulerExit -->|Yes| SchedulerUnexpected[Mark: unexpected exit]
+    SchedulerError --> SchedulerBackoff[Wait with backoff]
+    SchedulerUnexpected --> SchedulerBackoff
+    SchedulerBackoff --> SchedulerLoop
+
+    MarkChannelsOK --> Running[Daemon Running<br/>Ctrl+C to stop]
+    MarkHeartbeatOK --> Running
+    MarkSchedulerOK --> Running
+    SpawnState --> Running
+
+    Running --> StopRequest[Ctrl+C received]
+    StopRequest --> AbortAll[Abort all tasks]
+    AbortAll --> JoinAll[Wait for tasks]
+    JoinAll --> Done[[Daemon stopped]]
+
+    classDef supervisor fill:#FDE8E8,stroke:#D0021B
+    classDef running fill:#E8FDF5,stroke:#50C878
+    classDef component fill:#E8F4FD,stroke:#4A90E2
+
+    class SpawnGateway,SpawnChannelSup,SpawnHeartbeatWorker,SpawnSchedulerWorker,SpawnState supervisor
+    class Running running
+    class GatewayRun,ChannelRun,HeartbeatRun,SchedulerRun component
+```
+
+---
+
+## 6. Gateway HTTP Endpoints
+
+**The gateway's HTTP API structure:**
+
+```mermaid
+flowchart TB
+    Client[HTTP Client] --> Gateway[ZeroClaw Gateway]
+
+    Gateway --> PairPOST[POST /pair<br/>Exchange one-time code<br/>for bearer token]
+    Gateway --> HealthGET[GET /health<br/>Status check]
+    Gateway --> WebhookPOST[POST /webhook<br/>Main agent endpoint]
+    Gateway --> WAVerify[GET /whatsapp<br/>Meta verification]
+    Gateway --> WAMessage[POST /whatsapp<br/>WhatsApp webhook]
+
+    PairPOST --> PairLimiter[Rate Limiter<br/>pair req/min]
+    PairLimiter --> PairGuard[PairingGuard<br/>Code validation]
+    PairGuard --> PairResponse[{paired, token, persisted}]
+
+    WebhookPOST --> WebhookLimiter[Rate Limiter<br/>webhook req/min]
+    WebhookLimiter --> WebhookPairing{Pairing<br/>required?}
+    WebhookPairing -->|Yes| BearerAuth[Bearer token check]
+    WebhookPairing -->|No| WebhookSecret{Secret<br/>configured?}
+    WebhookSecret -->|Yes| SecretCheck[X-Webhook-Secret<br/>HMAC-SHA256 verify]
+    WebhookSecret -->|No| Idempotency[Idempotency check<br/>X-Idempotency-Key]
+    BearerAuth --> Idempotency
+    SecretCheck --> Idempotency
+
+    Idempotency --> MemoryStore[Auto-save to memory]
+    MemoryStore --> ProviderCall[Provider.simple_chat]
+    ProviderCall --> WebhookResponse[{response, model}]
+
+    WAVerify --> TokenCheck[verify_token check<br/>constant-time compare]
+    TokenCheck --> Challenge[Return hub.challenge]
+
+    WAMessage --> SignatureCheck[X-Hub-Signature-256<br/>HMAC-SHA256 verify]
+    SignatureCheck --> ParsePayload[Parse messages]
+    ParsePayload --> ForEach[For each message]
+    ForEach --> WAMemory[Auto-save to memory]
+    WAMemory --> WAProvider[Provider.simple_chat]
+    WAProvider --> WASend[WhatsAppChannel.send]
+
+    classDef auth fill:#FDE8E8,stroke:#D0021B
+    classDef processing fill:#E8F4FD,stroke:#4A90E2
+    classDef response fill:#E8FDF5,stroke:#50C878
+
+    class PairLimiter,PairGuard,BearerAuth,SecretCheck auth
+    class MemoryStore,ProviderCall,TokenCheck,ParsePayload,ForEach,WAMemory,WAProvider processing
+    class PairResponse,WebhookResponse,Challenge,WASend response
+```
+
+---
+
+## 7. Channel Message Dispatch
+
+**How channels route messages to the agent:**
+
+```mermaid
+flowchart TB
+    subgraph Channels[Channel Listeners]
+        TG[Telegram]
+        DC[Discord]
+        SL[Slack]
+        IM[iMessage]
+        MX[Matrix]
+        SIG[Signal]
+        WA[WhatsApp]
+        Email[Email]
+        IRC[IRC]
+        Lark[Lark]
+        DT[DingTalk]
+        QQ[QQ]
+    end
+
+    Channels --> MPSC[MPSC Channel<br/>100-buffer queue]
+
+    MPSC --> Semaphore[Semaphore<br/>Max in-flight limit]
+    Semaphore --> WorkerPool[Worker Pool<br/>JoinSet]
+
+    WorkerPool --> Process[process_channel_message]
+
+    Process --> LogReceive[Log: 💬 from user]
+    LogReceive --> MemoryRecall[build_memory_context]
+    MemoryRecall --> AutoSave[Auto-save if enabled]
+
+    AutoSave --> StartTyping[channel.start_typing]
+    StartTyping --> Timeout[300s timeout guard]
+
+    Timeout --> AgentCall[run_tool_call_loop<br/>silent mode]
+    AgentCall --> StopTyping[channel.stop_typing]
+
+    StopTyping --> Success{Success?}
+    Success -->|Yes| LogReply[Log: 🤖 Reply time]
+    Success -->|No| LogError[Log: ❌ LLM error]
+    Success -->|Timeout| LogTimeout[Log: ❌ Timeout]
+
+    LogReply --> SendReply[channel.send reply]
+    LogError --> SendError[channel.send error msg]
+    LogTimeout --> SendTimeout[channel.send timeout msg]
+
+    SendReply --> Done[Message complete]
+    SendError --> Done
+    SendTimeout --> Done
+
+    Done --> NextWorker[Join next worker]
+    NextWorker --> WorkerPool
+
+    classDef channel fill:#E8F4FD,stroke:#4A90E2
+    classDef queue fill:#FFF4E6,stroke:#F5A623
+    classDef process fill:#FDE8E8,stroke:#D0021B
+    classDef success fill:#E8FDF5,stroke:#50C878
+
+    class TG,DC,SL,IM,MX,SIG,WA,Email,IRC,Lark,DT,QQ channel
+    class MPSC,Semaphore,WorkerPool queue
+    class Process,LogReceive,MemoryRecall,AutoSave,StartTyping,Timeout,AgentCall,StopTyping process
+    class LogReply,SendReply,Done,NextWorker success
+```
+
+---
+
+## 8. Memory System Architecture
+
+**Storage backends and data flow:**
+
+```mermaid
+flowchart TB
+    subgraph Frontend[Memory Frontends]
+        AutoSave[Auto-save hooks<br/>user_msg, assistant_resp]
+        StoreTool[memory_store tool]
+        RecallTool[memory_recall tool]
+        ForgetTool[memory_forget tool]
+        GetTool[memory_get tool]
+        ListTool[memory_list tool]
+        CountTool[memory_count tool]
+    end
+
+    subgraph Backends[Memory Backends]
+        Sqlite[(sqlite<br/>Default, local file)]
+        Markdown[(markdown<br/>Daily .md files)]
+        Lucid[(lucid<br/>Cloud sync)]
+        None[(none<br/>In-memory only)]
+    end
+
+    subgraph Categories[Memory Categories]
+        Conv[Conversation<br/>Chat transcripts]
+        Daily[Daily<br/>Session summaries]
+        Core[Core<br/>Long-term facts]
+    end
+
+    AutoSave --> MemoryTrait[Memory trait]
+    StoreTool --> MemoryTrait
+    RecallTool --> MemoryTrait
+    ForgetTool --> MemoryTrait
+    GetTool --> MemoryTrait
+    ListTool --> MemoryTrait
+    CountTool --> MemoryTrait
+
+    MemoryTrait --> Factory[create_memory factory]
+    Factory -->|config.memory.backend| BackendSelect{Backend?}
+
+    BackendSelect -->|sqlite| Sqlite
+    BackendSelect -->|markdown| Markdown
+    BackendSelect -->|lucid| Lucid
+    BackendSelect -->|none| None
+
+    Sqlite --> Categories
+    Markdown --> Categories
+    Lucid --> Categories
+
+    Categories --> Storage[(Persistent Storage)]
+
+    RAG[Hardware RAG] -.->|load_chunks| Markdown
+
+    classDef frontend fill:#E8F4FD,stroke:#4A90E2
+    classDef backend fill:#FFF4E6,stroke:#F5A623
+    classDef category fill:#E8FDF5,stroke:#50C878
+    classDef storage fill:#FDE8E8,stroke:#D0021B
+
+    class AutoSave,StoreTool,RecallTool,ForgetTool,GetTool,ListTool,CountTool frontend
+    class Sqlite,Markdown,Lucid,None backend
+    class Conv,Daily,Core category
+    class Storage storage
+```
+
+---
+
+## 9. Provider and Model Routing
+
+**LLM provider abstraction and routing:**
+
+```mermaid
+flowchart TB
+    subgraph Providers[Supported Providers]
+        OR[OpenRouter]
+        Anth[Anthropic]
+        OAI[OpenAI]
+        OpenRouter[openrouter]
+        MiniMax[minimax]
+        DeepSeek[deepseek]
+        Kimi[kimi]
+        Custom[custom URL]
+    end
+
+    subgraph Routing[Model Routing]
+        Routes[model_routes config<br/>Pattern -> Provider]
+    end
+
+    subgraph Factory[Provider Factory]
+        Resilient[create_resilient_provider<br/>Retry + Timeout]
+        Routed[create_routed_provider<br/>Model-based routing]
+    end
+
+    subgraph Traits[Provider Trait]
+        ChatSystem[chat_with_system<br/>Simple chat]
+        ChatHistory[chat_with_history<br/>Multi-turn]
+        ChatTools[chat_with_tools<br/>Native function calling]
+        Warmup[warmup<br/>Connection pool warmup]
+        SupportsNative[supports_native_tools<br/>Capability check]
+    end
+
+    Providers --> Factory
+    Routes --> Factory
+
+    Factory --> Traits
+
+    ChatSystem --> LLM1[LLM API Call]
+    ChatHistory --> LLM2[LLM API Call]
+    ChatTools --> LLM3[LLM API Call + Functions]
+
+    LLM1 --> Response[ChatMessage<br/>text + role]
+    LLM2 --> Response
+    LLM3 --> ToolResponse[ChatMessage + ToolCalls<br/>id, name, arguments]
+
+    classDef provider fill:#E8F4FD,stroke:#4A90E2
+    classDef routing fill:#FFF4E6,stroke:#F5A623
+    classDef factory fill:#E8FDF5,stroke:#50C878
+    classDef trait fill:#FDE8E8,stroke:#D0021B
+
+    class OR,Anth,OAI,OpenRouter,MiniMax,DeepSeek,Kimi,Custom provider
+    class Routes routing
+    class Resilient,Routed factory
+    class ChatSystem,ChatHistory,ChatTools,Warmup,SupportsNative trait
+```
+
+---
+
+## 10. Tool Execution Architecture
+
+**Tool registry, execution, and security:**
+
+```mermaid
+flowchart TB
+    subgraph ToolCategories[Tool Categories]
+        Core[Core Tools<br/>shell, file_read, file_write]
+        Memory[Memory Tools<br/>store, recall, forget]
+        Schedule[Schedule Tools<br/>cron_add, cron_list, etc.]
+        Browser[Browser<br/>Brave integration]
+        Composio[Composio<br/>1000+ app actions]
+        Hardware[Hardware<br/>gpio_read, gpio_write,<br/>arduino_upload, etc.]
+        Delegate[Delegate<br/>Sub-agent routing]
+        Screenshot[screenshot<br/>Screen capture]
+    end
+
+    subgraph Registry[Tool Registry]
+        AllTools[all_tools_with_runtime<br/>Factory function]
+        DefaultTools[default_tools<br/>Base set]
+        PeripheralTools[create_peripheral_tools<br/>Hardware-specific]
+    end
+
+    subgraph Security[Security Policy]
+        AllowedCmds[allowed_commands<br/>Allowlist]
+        WorkspaceOnly[workspace_only<br/>Path restriction]
+        MaxActions[max_actions_per_hour<br/>Rate limit]
+        MaxCost[max_cost_per_day_cents<br/>Cost cap]
+        Approval[approval manager<br/>Supervised tools]
+    end
+
+    subgraph Execution[Tool Execution]
+        Validate[Input validation<br/>Schema check]
+        Approve{Approval<br/>needed?}
+        Execute[execute async]
+        Scrub[Scrub credentials<br/>from output]
+        Result[ToolResult<br/>success, output, error]
+    end
+
+    ToolCategories --> Registry
+    Registry --> Security
+    Security --> Execution
+
+    Validate --> Approve
+    Approve -->|Yes| Prompt[Prompt CLI]
+    Approve -->|No / Approved| Execute
+    Approve -->|Denied| Denied[Return denied]
+
+    Prompt --> UserChoice{User choice?}
+    UserChoice -->|Yes| Execute
+    UserChoice -->|No| Denied
+
+    Execute --> Scrub
+    Scrub --> Result
+    Result --> Return[Return to agent loop]
+
+    classDef tools fill:#E8F4FD,stroke:#4A90E2
+    classDef registry fill:#FFF4E6,stroke:#F5A623
+    classDef security fill:#FDE8E8,stroke:#D0021B
+    classDef exec fill:#E8FDF5,stroke:#50C878
+
+    class Core,Memory,Schedule,Browser,Composio,Hardware,Delegate,Screenshot tools
+    class AllTools,DefaultTools,PeripheralTools registry
+    class AllowedCmds,WorkspaceOnly,MaxActions,MaxCost,Approval security
+    class Validate,Approve,Prompt,Execute,Scrub,Result,Return exec
+```
+
+---
+
+## 11. Configuration Loading
+
+**How configuration is loaded and merged:**
+
+```mermaid
+flowchart TB
+    Start[Config::load_or_init] --> Exists{Config file<br/>exists?}
+
+    Exists -->|No| RunWizard[Run onboard wizard]
+    RunWizard --> Save[Save config.toml]
+    Save --> Load[Load from file]
+
+    Exists -->|Yes| Load
+
+    Load --> Parse[TOML parse]
+    Parse --> Defaults[Apply defaults<br/>Config::default]
+
+    Defaults --> EnvOverrides[apply_env_overrides<br/>ZEROCLAW_* env vars]
+
+    EnvOverrides --> Validate[Schema validation]
+
+    Validate --> Valid{Valid?}
+    Valid -->|No| Error[[Error: invalid config]]
+    Valid -->|Yes| Complete[Complete Config]
+
+    Complete --> Paths[Paths<br/>workspace_dir, config_path]
+    Complete --> Providers[default_provider,<br/>api_key, api_url]
+    Complete --> Model[default_model,<br/>default_temperature]
+    Complete --> Gateway[gateway config<br/>port, host, pairing]
+    Complete --> Channels[channels_config<br/>telegram, discord, etc.]
+    Complete --> Memory[memory config<br/>backend, auto_save]
+    Complete --> Security[autonomy config<br/>level, allowed_commands]
+    Complete --> Reliability[reliability config<br/>timeouts, retries]
+    Complete --> Observability[observability<br/>backend, metrics]
+    Complete --> Runtime[runtime config<br/>kind, exec]
+    Complete --> Peripherals[peripherals<br/>boards, datasheet_dir]
+    Complete --> Cron[cron config<br/>enabled, db_path]
+    Complete --> Composio[composio<br/>enabled, api_key]
+    Complete --> Browser[browser<br/>enabled, allowlist]
+    Complete --> Tunnel[tunnel<br/>provider, token]
+
+    classDef config fill:#E8F4FD,stroke:#4A90E2
+    classDef error fill:#FDE8E8,stroke:#D0021B
+    classDef section fill:#FFF4E6,stroke:#F5A623
+
+    class Load,Parse,Defaults,EnvOverrides,Validate,Complete config
+    class Error error
+    class Paths,Providers,Model,Gateway,Channels,Memory,Security,Reliability,Observability,Runtime,Peripherals,Cron,Composio,Browser,Tunnel section
+```
+
+---
+
+## 12. Hardware Peripherals Integration
+
+**Hardware board support and control:**
+
+```mermaid
+flowchart TB
+    subgraph Boards[Supported Boards]
+        Nucleo[Nucleo-F401RE<br/>STM32F401RETx]
+        Uno[Arduino Uno<br/>ATmega328P]
+        UnoQ[Uno Q<br/>ESP32 WiFi bridge]
+        RPi[RPi GPIO<br/>Native Linux]
+        ESP32[ESP32<br/>Direct serial]
+    end
+
+    subgraph Transport[Transport Layer]
+        Serial[Serial port<br/>/dev/ttyACM0, /dev/ttyUSB0]
+        USB[USB probe-rs<br/>ST-Link JTAG]
+        Native[Native GPIO<br/>Linux sysfs]
+    end
+
+    subgraph Peripherals[Peripheral System]
+        Create[create_peripheral_tools<br/>Factory function]
+        GPIO[gpio_read/write<br/>Digital I/O]
+        Upload[arduino_upload<br/>Sketch flash]
+        MemMap[hardware_memory_map<br/>Address ranges]
+        BoardInfo[hardware_board_info<br/>Chip identification]
+        MemRead[hardware_memory_read<br/>Register dump]
+        Capabilities[hardware_capabilities<br/>Pin enumeration]
+    end
+
+    subgraph RAG[Hardware RAG]
+        Datasheets[datasheet_dir<br/>.md documentation]
+        Chunks[Chunked embedding<br/>Semantic search]
+        PinAliases[Pin alias mapping<br/>red_led → 13]
+    end
+
+    Boards --> Transport
+    Transport --> Peripherals
+
+    RAG -.->|Context injection| Peripherals
+
+    Create --> ToolRegistry[Tool registry]
+    GPIO --> ToolRegistry
+    Upload --> ToolRegistry
+    MemMap --> ToolRegistry
+    BoardInfo --> ToolRegistry
+    MemRead --> ToolRegistry
+    Capabilities --> ToolRegistry
+
+    ToolRegistry --> Agent[Agent loop integration]
+
+    classDef board fill:#E8F4FD,stroke:#4A90E2
+    classDef transport fill:#FFF4E6,stroke:#F5A623
+    classDef peripheral fill:#E8FDF5,stroke:#50C878
+    classDef rag fill:#FDE8E8,stroke:#D0021B
+
+    class Nucleo,Uno,UnoQ,RPi,ESP32 board
+    class Serial,USB,Native transport
+    class Create,GPIO,Upload,MemMap,BoardInfo,MemRead,Capabilities,ToolRegistry peripheral
+    class Datasheets,Chunks,PinAliases rag
+```
+
+---
+
+## 13. Observable Events
+
+**Telemetry and observability flow:**
+
+```mermaid
+flowchart TB
+    subgraph Observers[Observer Backends]
+        Noop[NoopObserver<br/>No-op / testing]
+        Console[ConsoleObserver<br/>Stdout logging]
+        Metrics[MetricsObserver<br/>Prometheus format]
+    end
+
+    subgraph Events[Observable Events]
+        AgentStart[AgentStart<br/>provider, model]
+        LlmRequest[LlmRequest<br/>provider, model, msg_count]
+        LlmResponse[LlmResponse<br/>duration, success, error]
+        ToolCallStart[ToolCallStart<br/>tool name]
+        ToolCall[ToolCall<br/>tool, duration, success]
+        TurnComplete[TurnComplete<br/>end of agent loop]
+        AgentEnd[AgentEnd<br/>duration, tokens, cost]
+    end
+
+    subgraph Outputs[Outputs]
+        Stdout[stdout trace logs]
+        MetricsFile[metrics.json<br/>JSON lines]
+        Prometheus[Prometheus<br/>Text format]
+    end
+
+    Events --> Observers
+    Observers --> Outputs
+
+    AgentStart --> Record[record_event]
+    LlmRequest --> Record
+    LlmResponse --> Record
+    ToolCallStart --> Record
+    ToolCall --> Record
+    TurnComplete --> Record
+    AgentEnd --> Record
+
+    Record --> Dispatch[Dispatch to backend]
+    Dispatch --> Console
+    Dispatch --> Metrics
+
+    Console --> Stdout
+    Metrics --> MetricsFile
+
+    classDef observer fill:#E8F4FD,stroke:#4A90E2
+    classDef event fill:#FFF4E6,stroke:#F5A623
+    classDef output fill:#E8FDF5,stroke:#50C878
+
+    class Noop,Console,Metrics observer
+    class AgentStart,LlmRequest,LlmResponse,ToolCallStart,ToolCall,TurnComplete,AgentEnd,Record,Dispatch event
+    class Stdout,MetricsFile,Prometheus output
+```
+
+---
+
+## Summary Diagram
+
+**Quick reference overview:**
+
+```mermaid
+mindmap
+    root((ZeroClaw))
+        Modes
+            Agent CLI
+                Interactive
+                Single-shot
+            Gateway
+                HTTP API
+                Webhooks
+            Daemon
+                Supervised
+                Multi-component
+            Channels
+                12+ platforms
+        Components
+            Agent Loop
+                Tool calling
+                Memory aware
+            Providers
+                50+ LLMs
+                Model routing
+            Channels
+                Real-time
+                Supervised
+            Tools
+                30+ tools
+                Hardware control
+            Memory
+                4 backends
+                RAG-capable
+            Security
+                Pairing
+                Approval
+                Policy
+        Integrations
+            Composio
+                1000+ apps
+            Browser
+                Brave
+            Tunnel
+                Cloudflare
+                boringproxy
+        Hardware
+            STM32
+            Arduino
+            ESP32
+            RPi GPIO
+```
+
+---
+
+*Generated for ZeroClaw v0.1.0 - Architecture Documentation*
--- a/third_party/zeroclaw/docs/assets/architecture.svg
+++ b/third_party/zeroclaw/docs/assets/architecture.svg
@@ -0,0 +1,312 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1100 950" font-family="'Segoe UI', system-ui, -apple-system, sans-serif">
+  <defs>
+    <filter id="shadow" x="-4%" y="-4%" width="108%" height="108%">
+      <feDropShadow dx="0" dy="2" stdDeviation="3" flood-opacity="0.15"/>
+    </filter>
+    <linearGradient id="bgGrad" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#0d1117"/>
+      <stop offset="100%" stop-color="#161b22"/>
+    </linearGradient>
+    <linearGradient id="agentGrad" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#1a1e2e"/>
+      <stop offset="100%" stop-color="#1e2436"/>
+    </linearGradient>
+    <linearGradient id="memGrad" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#1a1a2e"/>
+      <stop offset="100%" stop-color="#1e1e36"/>
+    </linearGradient>
+    <marker id="arrowBlue" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6" fill="#3b82f6"/></marker>
+    <marker id="arrowAmber" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6" fill="#f59e0b"/></marker>
+    <marker id="arrowGreen" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6" fill="#4ade80"/></marker>
+    <marker id="arrowCyan" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6" fill="#06b6d4"/></marker>
+    <marker id="arrowPurple" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6" fill="#c084fc"/></marker>
+    <marker id="arrowViolet" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6" fill="#8b5cf6"/></marker>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1100" height="950" rx="12" fill="url(#bgGrad)"/>
+
+  <!-- Title -->
+  <text x="550" y="38" text-anchor="middle" fill="#e6edf3" font-size="22" font-weight="700">ZeroClaw Architecture</text>
+  <text x="550" y="58" text-anchor="middle" fill="#7d8590" font-size="12">Zero overhead. Zero compromise. 100% Rust. 100% Agnostic. 8 pluggable traits.</text>
+
+  <!-- ═══════════ LEFT: Chat Apps ═══════════ -->
+  <rect x="20" y="80" width="150" height="310" rx="10" fill="#1c2333" stroke="#3b82f6" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="95" y="105" text-anchor="middle" fill="#93c5fd" font-size="13" font-weight="600">Chat Apps</text>
+
+  <rect x="35" y="120" width="120" height="24" rx="6" fill="#1e293b"/>
+  <text x="95" y="137" text-anchor="middle" fill="#60a5fa" font-size="10">Telegram</text>
+  <rect x="35" y="150" width="120" height="24" rx="6" fill="#1e293b"/>
+  <text x="95" y="167" text-anchor="middle" fill="#818cf8" font-size="10">Discord</text>
+  <rect x="35" y="180" width="120" height="24" rx="6" fill="#1e293b"/>
+  <text x="95" y="197" text-anchor="middle" fill="#a78bfa" font-size="10">Slack</text>
+  <rect x="35" y="210" width="120" height="24" rx="6" fill="#1e293b"/>
+  <text x="95" y="227" text-anchor="middle" fill="#c084fc" font-size="10">iMessage</text>
+  <rect x="35" y="240" width="120" height="24" rx="6" fill="#1e293b"/>
+  <text x="95" y="257" text-anchor="middle" fill="#e879f9" font-size="10">Matrix</text>
+  <rect x="35" y="270" width="120" height="24" rx="6" fill="#1e293b"/>
+  <text x="95" y="287" text-anchor="middle" fill="#f472b6" font-size="10">Webhook</text>
+  <rect x="35" y="300" width="120" height="24" rx="6" fill="#1e293b"/>
+  <text x="95" y="317" text-anchor="middle" fill="#fb923c" font-size="10">CLI</text>
+
+  <text x="95" y="355" text-anchor="middle" fill="#7d8590" font-size="9" font-style="italic">+ any Channel trait</text>
+
+  <!-- Arrow: Chat Apps → Security -->
+  <line x1="170" y1="230" x2="195" y2="230" stroke="#3b82f6" stroke-width="2" marker-end="url(#arrowBlue)"/>
+
+  <!-- ═══════════ CENTER-LEFT: Security Layer ═══════════ -->
+  <rect x="200" y="80" width="190" height="310" rx="10" fill="#1c2333" stroke="#f59e0b" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="295" y="105" text-anchor="middle" fill="#fbbf24" font-size="13" font-weight="600">Security Layer</text>
+
+  <!-- Gateway Pairing -->
+  <rect x="213" y="120" width="165" height="50" rx="8" fill="#292524" stroke="#f59e0b" stroke-width="1" stroke-dasharray="4,2"/>
+  <text x="295" y="138" text-anchor="middle" fill="#fbbf24" font-size="10" font-weight="600">Gateway Pairing</text>
+  <text x="295" y="153" text-anchor="middle" fill="#a8a29e" font-size="8">6-digit OTP + bearer tokens</text>
+  <text x="295" y="164" text-anchor="middle" fill="#a8a29e" font-size="8">constant-time comparison</text>
+
+  <!-- Auth Gate -->
+  <rect x="213" y="178" width="165" height="45" rx="8" fill="#292524" stroke="#f59e0b" stroke-width="1" stroke-dasharray="4,2"/>
+  <text x="295" y="196" text-anchor="middle" fill="#fbbf24" font-size="10" font-weight="600">Auth Gate</text>
+  <text x="295" y="210" text-anchor="middle" fill="#a8a29e" font-size="8">Channel allowlists + webhook_secret</text>
+
+  <!-- Rate Limiter -->
+  <rect x="213" y="230" width="165" height="45" rx="8" fill="#292524" stroke="#f59e0b" stroke-width="1" stroke-dasharray="4,2"/>
+  <text x="295" y="248" text-anchor="middle" fill="#fbbf24" font-size="10" font-weight="600">Rate Limiter</text>
+  <text x="295" y="262" text-anchor="middle" fill="#a8a29e" font-size="8">sliding window, cost/day cap</text>
+
+  <!-- Filesystem Sandbox -->
+  <rect x="213" y="282" width="165" height="50" rx="8" fill="#292524" stroke="#f59e0b" stroke-width="1" stroke-dasharray="4,2"/>
+  <text x="295" y="300" text-anchor="middle" fill="#fbbf24" font-size="10" font-weight="600">Filesystem Sandbox</text>
+  <text x="295" y="314" text-anchor="middle" fill="#a8a29e" font-size="8">path jail + null byte block</text>
+  <text x="295" y="325" text-anchor="middle" fill="#a8a29e" font-size="8">symlink escape detection</text>
+
+  <!-- Encrypted Secrets -->
+  <rect x="213" y="340" width="165" height="38" rx="8" fill="#292524" stroke="#f59e0b" stroke-width="1" stroke-dasharray="4,2"/>
+  <text x="295" y="358" text-anchor="middle" fill="#fbbf24" font-size="10" font-weight="600">Encrypted Secrets</text>
+  <text x="295" y="372" text-anchor="middle" fill="#a8a29e" font-size="8">XOR + local key file (0600)</text>
+
+  <!-- Arrow: Security → Agent -->
+  <line x1="295" y1="390" x2="295" y2="415" stroke="#f59e0b" stroke-width="2" marker-end="url(#arrowAmber)"/>
+
+  <!-- ═══════════ CENTER: Tunnel ═══════════ -->
+  <rect x="405" y="80" width="180" height="200" rx="10" fill="#1c2333" stroke="#06b6d4" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="495" y="105" text-anchor="middle" fill="#67e8f9" font-size="13" font-weight="600">Agnostic Tunnel</text>
+  <text x="495" y="120" text-anchor="middle" fill="#7d8590" font-size="9">Bring Your Own</text>
+
+  <rect x="418" y="132" width="155" height="22" rx="5" fill="#1e293b"/>
+  <text x="495" y="148" text-anchor="middle" fill="#22d3ee" font-size="10">Cloudflare</text>
+  <rect x="418" y="160" width="155" height="22" rx="5" fill="#1e293b"/>
+  <text x="495" y="176" text-anchor="middle" fill="#22d3ee" font-size="10">Tailscale</text>
+  <rect x="418" y="188" width="155" height="22" rx="5" fill="#1e293b"/>
+  <text x="495" y="204" text-anchor="middle" fill="#22d3ee" font-size="10">ngrok</text>
+  <rect x="418" y="216" width="155" height="22" rx="5" fill="#1e293b"/>
+  <text x="495" y="232" text-anchor="middle" fill="#22d3ee" font-size="10">Custom (bore, frp, ssh...)</text>
+
+  <text x="495" y="265" text-anchor="middle" fill="#7d8590" font-size="9" font-style="italic">+ any Tunnel trait</text>
+
+  <!-- Arrow: Tunnel → Agent -->
+  <line x1="495" y1="280" x2="495" y2="415" stroke="#06b6d4" stroke-width="2" marker-end="url(#arrowCyan)"/>
+
+  <!-- ═══════════ RIGHT: AI Providers ═══════════ -->
+  <rect x="600" y="80" width="480" height="200" rx="10" fill="#1c2333" stroke="#22c55e" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="840" y="105" text-anchor="middle" fill="#4ade80" font-size="13" font-weight="600">AI Providers (22+)</text>
+  <text x="840" y="120" text-anchor="middle" fill="#7d8590" font-size="9">Any OpenAI-compatible API</text>
+
+  <!-- Provider grid: 4 columns x 4 rows -->
+  <rect x="615" y="132" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="667" y="148" text-anchor="middle" fill="#86efac" font-size="9">OpenRouter</text>
+  <rect x="730" y="132" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="782" y="148" text-anchor="middle" fill="#86efac" font-size="9">Anthropic</text>
+  <rect x="845" y="132" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="897" y="148" text-anchor="middle" fill="#86efac" font-size="9">OpenAI</text>
+  <rect x="960" y="132" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="1012" y="148" text-anchor="middle" fill="#86efac" font-size="9">Ollama</text>
+
+  <rect x="615" y="160" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="667" y="176" text-anchor="middle" fill="#86efac" font-size="9">Venice</text>
+  <rect x="730" y="160" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="782" y="176" text-anchor="middle" fill="#86efac" font-size="9">Groq</text>
+  <rect x="845" y="160" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="897" y="176" text-anchor="middle" fill="#86efac" font-size="9">Mistral</text>
+  <rect x="960" y="160" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="1012" y="176" text-anchor="middle" fill="#86efac" font-size="9">xAI / Grok</text>
+
+  <rect x="615" y="188" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="667" y="204" text-anchor="middle" fill="#86efac" font-size="9">DeepSeek</text>
+  <rect x="730" y="188" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="782" y="204" text-anchor="middle" fill="#86efac" font-size="9">Together AI</text>
+  <rect x="845" y="188" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="897" y="204" text-anchor="middle" fill="#86efac" font-size="9">Fireworks</text>
+  <rect x="960" y="188" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="1012" y="204" text-anchor="middle" fill="#86efac" font-size="9">Perplexity</text>
+
+  <rect x="615" y="216" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="667" y="232" text-anchor="middle" fill="#86efac" font-size="9">Cohere</text>
+  <rect x="730" y="216" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="782" y="232" text-anchor="middle" fill="#86efac" font-size="9">Cloudflare AI</text>
+  <rect x="845" y="216" width="105" height="22" rx="5" fill="#1a2e1a"/>
+  <text x="897" y="232" text-anchor="middle" fill="#86efac" font-size="9">Bedrock</text>
+  <rect x="960" y="216" width="105" height="22" rx="5" fill="#1e3a1e" stroke="#4ade80" stroke-width="1" stroke-dasharray="3,2"/>
+  <text x="1012" y="232" text-anchor="middle" fill="#4ade80" font-size="9" font-weight="600">custom:URL</text>
+
+  <text x="840" y="262" text-anchor="middle" fill="#7d8590" font-size="9" font-style="italic">+ any Provider trait / custom:URL</text>
+
+  <!-- Arrow: Providers → Agent LLM -->
+  <line x1="840" y1="280" x2="560" y2="440" stroke="#22c55e" stroke-width="1.5" stroke-dasharray="6,3" marker-end="url(#arrowGreen)"/>
+
+  <!-- ═══════════ CENTER: Agent Loop ═══════════ -->
+  <rect x="20" y="420" width="1060" height="130" rx="12" fill="url(#agentGrad)" stroke="#22c55e" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="550" y="445" text-anchor="middle" fill="#4ade80" font-size="14" font-weight="700">Agent Loop</text>
+
+  <!-- Message → LLM → Tools → Response flow -->
+  <rect x="50" y="460" width="110" height="42" rx="8" fill="#1a2e1a" stroke="#4ade80" stroke-width="1"/>
+  <text x="105" y="478" text-anchor="middle" fill="#4ade80" font-size="10" font-weight="600">Message</text>
+  <text x="105" y="495" text-anchor="middle" fill="#86efac" font-size="14">In</text>
+
+  <rect x="200" y="460" width="110" height="42" rx="8" fill="#1a2e1a" stroke="#4ade80" stroke-width="1"/>
+  <text x="255" y="478" text-anchor="middle" fill="#4ade80" font-size="10" font-weight="600">Memory Recall</text>
+  <text x="255" y="495" text-anchor="middle" fill="#86efac" font-size="14">ctx</text>
+
+  <rect x="350" y="460" width="110" height="42" rx="8" fill="#1a2e1a" stroke="#4ade80" stroke-width="1"/>
+  <text x="405" y="478" text-anchor="middle" fill="#4ade80" font-size="10" font-weight="600">LLM</text>
+  <text x="405" y="495" text-anchor="middle" fill="#86efac" font-size="14">AI</text>
+
+  <rect x="500" y="460" width="110" height="42" rx="8" fill="#1a2e1a" stroke="#4ade80" stroke-width="1"/>
+  <text x="555" y="478" text-anchor="middle" fill="#4ade80" font-size="10" font-weight="600">Tools</text>
+  <text x="555" y="495" text-anchor="middle" fill="#86efac" font-size="14">exec</text>
+
+  <rect x="650" y="460" width="110" height="42" rx="8" fill="#1a2e1a" stroke="#4ade80" stroke-width="1"/>
+  <text x="705" y="478" text-anchor="middle" fill="#4ade80" font-size="10" font-weight="600">Memory Save</text>
+  <text x="705" y="495" text-anchor="middle" fill="#86efac" font-size="14">store</text>
+
+  <rect x="800" y="460" width="110" height="42" rx="8" fill="#1a2e1a" stroke="#4ade80" stroke-width="1"/>
+  <text x="855" y="478" text-anchor="middle" fill="#4ade80" font-size="10" font-weight="600">Response</text>
+  <text x="855" y="495" text-anchor="middle" fill="#86efac" font-size="14">Out</text>
+
+  <!-- Composio (optional) -->
+  <rect x="950" y="460" width="110" height="42" rx="8" fill="#1a2e1a" stroke="#4ade80" stroke-width="1" stroke-dasharray="4,2"/>
+  <text x="1005" y="478" text-anchor="middle" fill="#4ade80" font-size="9" font-weight="600">Composio</text>
+  <text x="1005" y="493" text-anchor="middle" fill="#7d8590" font-size="8">1000+ OAuth</text>
+
+  <!-- Agent loop arrows -->
+  <line x1="160" y1="481" x2="200" y2="481" stroke="#4ade80" stroke-width="1.5" marker-end="url(#arrowGreen)"/>
+  <line x1="310" y1="481" x2="350" y2="481" stroke="#4ade80" stroke-width="1.5" marker-end="url(#arrowGreen)"/>
+  <line x1="460" y1="481" x2="500" y2="481" stroke="#4ade80" stroke-width="1.5" marker-end="url(#arrowGreen)"/>
+  <line x1="610" y1="481" x2="650" y2="481" stroke="#4ade80" stroke-width="1.5" marker-end="url(#arrowGreen)"/>
+  <line x1="760" y1="481" x2="800" y2="481" stroke="#4ade80" stroke-width="1.5" marker-end="url(#arrowGreen)"/>
+
+  <!-- ═══════════ BOTTOM-LEFT: Memory Search Engine ═══════════ -->
+  <rect x="20" y="570" width="530" height="170" rx="10" fill="url(#memGrad)" stroke="#8b5cf6" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="285" y="595" text-anchor="middle" fill="#c4b5fd" font-size="13" font-weight="700">Memory Search Engine (All Custom)</text>
+  <text x="285" y="610" text-anchor="middle" fill="#7d8590" font-size="9">No Pinecone, no Elasticsearch, no LangChain</text>
+
+  <!-- Memory layers: 2 columns -->
+  <rect x="35" y="622" width="245" height="24" rx="5" fill="#1e1a2e" stroke="#8b5cf6" stroke-width="0.5"/>
+  <text x="45" y="639" fill="#c4b5fd" font-size="9" font-weight="600">Vector DB</text>
+  <text x="157" y="639" text-anchor="middle" fill="#a78bfa" font-size="8">SQLite BLOB + cosine similarity</text>
+
+  <rect x="290" y="622" width="245" height="24" rx="5" fill="#1e1a2e" stroke="#8b5cf6" stroke-width="0.5"/>
+  <text x="300" y="639" fill="#c4b5fd" font-size="9" font-weight="600">Keyword</text>
+  <text x="412" y="639" text-anchor="middle" fill="#a78bfa" font-size="8">FTS5 virtual tables + BM25</text>
+
+  <rect x="35" y="652" width="245" height="24" rx="5" fill="#1e1a2e" stroke="#8b5cf6" stroke-width="0.5"/>
+  <text x="45" y="669" fill="#c4b5fd" font-size="9" font-weight="600">Hybrid Merge</text>
+  <text x="157" y="669" text-anchor="middle" fill="#a78bfa" font-size="8">Weighted vector + keyword fusion</text>
+
+  <rect x="290" y="652" width="245" height="24" rx="5" fill="#1e1a2e" stroke="#8b5cf6" stroke-width="0.5"/>
+  <text x="300" y="669" fill="#c4b5fd" font-size="9" font-weight="600">Embeddings</text>
+  <text x="412" y="669" text-anchor="middle" fill="#a78bfa" font-size="8">OpenAI / custom URL / noop</text>
+
+  <rect x="35" y="682" width="245" height="24" rx="5" fill="#1e1a2e" stroke="#8b5cf6" stroke-width="0.5"/>
+  <text x="45" y="699" fill="#c4b5fd" font-size="9" font-weight="600">Chunking</text>
+  <text x="157" y="699" text-anchor="middle" fill="#a78bfa" font-size="8">Markdown-aware + heading ctx</text>
+
+  <rect x="290" y="682" width="245" height="24" rx="5" fill="#1e1a2e" stroke="#8b5cf6" stroke-width="0.5"/>
+  <text x="300" y="699" fill="#c4b5fd" font-size="9" font-weight="600">Caching</text>
+  <text x="412" y="699" text-anchor="middle" fill="#a78bfa" font-size="8">embedding_cache + LRU eviction</text>
+
+  <rect x="35" y="712" width="500" height="20" rx="5" fill="#1e1a2e" stroke="#8b5cf6" stroke-width="0.5"/>
+  <text x="285" y="726" text-anchor="middle" fill="#a78bfa" font-size="8">Safe Reindex: rebuild FTS5 + re-embed missing vectors atomically | LIKE fallback | Upsert/Delete/Reindex</text>
+
+  <!-- Arrow: Agent → Memory -->
+  <line x1="255" y1="550" x2="255" y2="570" stroke="#8b5cf6" stroke-width="2" marker-end="url(#arrowViolet)"/>
+
+  <!-- ═══════════ BOTTOM-RIGHT: Sandbox + Heartbeat ═══════════ -->
+  <rect x="570" y="570" width="250" height="170" rx="10" fill="#1c2333" stroke="#ef4444" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="695" y="595" text-anchor="middle" fill="#fca5a5" font-size="13" font-weight="600">Sandbox</text>
+
+  <text x="695" y="618" text-anchor="middle" fill="#ef4444" font-size="9">Command allowlist</text>
+  <text x="695" y="635" text-anchor="middle" fill="#ef4444" font-size="9">Path jail + traversal block</text>
+  <text x="695" y="652" text-anchor="middle" fill="#ef4444" font-size="9">Browser domain allowlist</text>
+  <text x="695" y="669" text-anchor="middle" fill="#ef4444" font-size="9">Null byte + Symlink escape block</text>
+  <text x="695" y="686" text-anchor="middle" fill="#ef4444" font-size="9">System dirs + Dotfiles blocked</text>
+  <text x="695" y="706" text-anchor="middle" fill="#ef4444" font-size="9">Default: Supervised + workspace-only</text>
+  <text x="695" y="726" text-anchor="middle" fill="#ef4444" font-size="9">Levels: ReadOnly / Supervised / Full</text>
+
+  <!-- Arrow: Agent → Sandbox -->
+  <line x1="695" y1="550" x2="695" y2="570" stroke="#ef4444" stroke-width="2"/>
+
+  <rect x="840" y="570" width="240" height="170" rx="10" fill="#1c2333" stroke="#06b6d4" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="960" y="595" text-anchor="middle" fill="#67e8f9" font-size="13" font-weight="600">Heartbeat &amp; Cron</text>
+
+  <text x="960" y="620" text-anchor="middle" fill="#22d3ee" font-size="9">HEARTBEAT.md periodic tasks</text>
+  <text x="960" y="640" text-anchor="middle" fill="#22d3ee" font-size="9">Scheduled actions</text>
+  <text x="960" y="660" text-anchor="middle" fill="#22d3ee" font-size="9">Skills loader (TOML manifests)</text>
+  <text x="960" y="680" text-anchor="middle" fill="#22d3ee" font-size="9">50+ integrations registry</text>
+  <text x="960" y="700" text-anchor="middle" fill="#22d3ee" font-size="9">Observability (noop/log/multi)</text>
+
+  <!-- Arrow: Agent → Heartbeat -->
+  <line x1="960" y1="550" x2="960" y2="570" stroke="#06b6d4" stroke-width="2"/>
+
+  <!-- ═══════════ BOTTOM: Setup Wizard ═══════════ -->
+  <rect x="20" y="760" width="1060" height="170" rx="10" fill="#1c2333" stroke="#f472b6" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="550" y="785" text-anchor="middle" fill="#f9a8d4" font-size="14" font-weight="700">Setup Wizard  --  zeroclaw onboard (quick default | --interactive for full wizard)</text>
+  <text x="550" y="802" text-anchor="middle" fill="#7d8590" font-size="10">7 steps, under 60 seconds | Live connection testing | Secure defaults</text>
+
+  <!-- Wizard steps: 7 -->
+  <rect x="30" y="815" width="130" height="38" rx="8" fill="#2d1f3d" stroke="#c084fc" stroke-width="1"/>
+  <text x="95" y="831" text-anchor="middle" fill="#e9d5ff" font-size="8" font-weight="600">1. Workspace</text>
+  <text x="95" y="845" text-anchor="middle" fill="#a78bfa" font-size="7">~/.zeroclaw/</text>
+
+  <rect x="170" y="815" width="130" height="38" rx="8" fill="#2d1f3d" stroke="#c084fc" stroke-width="1"/>
+  <text x="235" y="831" text-anchor="middle" fill="#e9d5ff" font-size="8" font-weight="600">2. AI Provider</text>
+  <text x="235" y="845" text-anchor="middle" fill="#a78bfa" font-size="7">22+ or custom URL</text>
+
+  <rect x="310" y="815" width="130" height="38" rx="8" fill="#2d1f3d" stroke="#c084fc" stroke-width="1"/>
+  <text x="375" y="831" text-anchor="middle" fill="#e9d5ff" font-size="8" font-weight="600">3. Channels</text>
+  <text x="375" y="845" text-anchor="middle" fill="#a78bfa" font-size="7">7 channels + live test</text>
+
+  <rect x="450" y="815" width="130" height="38" rx="8" fill="#2d1f3d" stroke="#c084fc" stroke-width="1"/>
+  <text x="515" y="831" text-anchor="middle" fill="#e9d5ff" font-size="8" font-weight="600">4. Tunnel</text>
+  <text x="515" y="845" text-anchor="middle" fill="#a78bfa" font-size="7">5 providers or skip</text>
+
+  <rect x="590" y="815" width="130" height="38" rx="8" fill="#2d1f3d" stroke="#c084fc" stroke-width="1"/>
+  <text x="655" y="831" text-anchor="middle" fill="#e9d5ff" font-size="8" font-weight="600">5. Tool Mode</text>
+  <text x="655" y="845" text-anchor="middle" fill="#a78bfa" font-size="7">Sovereign / Composio</text>
+
+  <rect x="730" y="815" width="130" height="38" rx="8" fill="#2d1f3d" stroke="#c084fc" stroke-width="1"/>
+  <text x="795" y="831" text-anchor="middle" fill="#e9d5ff" font-size="8" font-weight="600">6. Personalize</text>
+  <text x="795" y="845" text-anchor="middle" fill="#a78bfa" font-size="7">name, style, timezone</text>
+
+  <rect x="870" y="815" width="130" height="38" rx="8" fill="#2d1f3d" stroke="#c084fc" stroke-width="1"/>
+  <text x="935" y="831" text-anchor="middle" fill="#e9d5ff" font-size="8" font-weight="600">7. Scaffold</text>
+  <text x="935" y="845" text-anchor="middle" fill="#a78bfa" font-size="7">8 workspace MD files</text>
+
+  <!-- Step arrows -->
+  <line x1="160" y1="834" x2="170" y2="834" stroke="#c084fc" stroke-width="1" marker-end="url(#arrowPurple)"/>
+  <line x1="300" y1="834" x2="310" y2="834" stroke="#c084fc" stroke-width="1" marker-end="url(#arrowPurple)"/>
+  <line x1="440" y1="834" x2="450" y2="834" stroke="#c084fc" stroke-width="1" marker-end="url(#arrowPurple)"/>
+  <line x1="580" y1="834" x2="590" y2="834" stroke="#c084fc" stroke-width="1" marker-end="url(#arrowPurple)"/>
+  <line x1="720" y1="834" x2="730" y2="834" stroke="#c084fc" stroke-width="1" marker-end="url(#arrowPurple)"/>
+  <line x1="860" y1="834" x2="870" y2="834" stroke="#c084fc" stroke-width="1" marker-end="url(#arrowPurple)"/>
+
+  <!-- Wizard output summary -->
+  <text x="550" y="872" text-anchor="middle" fill="#7d8590" font-size="9">Full summary: Provider, Model, Channels, Tunnel, Composio, Secrets, Gateway, Autonomy, Memory</text>
+
+  <!-- Ready badge -->
+  <rect x="380" y="888" width="340" height="28" rx="14" fill="#166534" stroke="#4ade80" stroke-width="1"/>
+  <text x="550" y="907" text-anchor="middle" fill="#4ade80" font-size="12" font-weight="600">Ready -- zeroclaw agent</text>
+
+  <!-- Footer stats -->
+  <text x="550" y="942" text-anchor="middle" fill="#7d8590" font-size="10">~3.4MB binary  |  &lt;10ms startup  |  1,050 tests  |  22+ providers  |  8 traits  |  18,900+ lines of Rust  |  0 clippy warnings</text>
+</svg>
--- a/third_party/zeroclaw/docs/assets/zeroclaw-banner.png
+++ b/third_party/zeroclaw/docs/assets/zeroclaw-banner.png
--- a/third_party/zeroclaw/docs/assets/zeroclaw-comparison.jpeg
+++ b/third_party/zeroclaw/docs/assets/zeroclaw-comparison.jpeg
--- a/third_party/zeroclaw/docs/assets/zeroclaw-trans.png
+++ b/third_party/zeroclaw/docs/assets/zeroclaw-trans.png
--- a/third_party/zeroclaw/docs/assets/zeroclaw.png
+++ b/third_party/zeroclaw/docs/assets/zeroclaw.png
--- a/third_party/zeroclaw/docs/browser-setup.md
+++ b/third_party/zeroclaw/docs/browser-setup.md
@@ -0,0 +1,215 @@
+# Browser Automation Setup Guide
+
+This guide covers setting up browser automation capabilities in ZeroClaw, including both headless automation and GUI access via VNC.
+
+## Overview
+
+ZeroClaw supports multiple browser access methods:
+
+| Method | Use Case | Requirements |
+|--------|----------|--------------|
+| **agent-browser CLI** | Headless automation, AI agents | npm, Chrome |
+| **VNC + noVNC** | GUI access, debugging | Xvfb, x11vnc, noVNC |
+| **Chrome Remote Desktop** | Remote GUI via Google | XFCE, Google account |
+
+## Quick Start: Headless Automation
+
+### 1. Install agent-browser
+
+```bash
+# Install CLI
+npm install -g agent-browser
+
+# Download Chrome for Testing
+agent-browser install --with-deps  # Linux (includes system deps)
+agent-browser install              # macOS/Windows
+```
+
+### 2. Verify ZeroClaw Config
+
+The browser tool is enabled by default. To verify or customize, edit
+`~/.zeroclaw/config.toml`:
+
+```toml
+[browser]
+enabled = true              # default: true
+allowed_domains = ["*"]     # default: ["*"] (all public hosts)
+backend = "agent_browser"   # default: "agent_browser"
+native_headless = true      # default: true
+```
+
+To restrict domains or disable the browser tool:
+
+```toml
+[browser]
+enabled = false                              # disable entirely
+# or restrict to specific domains:
+allowed_domains = ["example.com", "docs.example.com"]
+```
+
+### 3. Test
+
+```bash
+echo "Open https://example.com and tell me what it says" | zeroclaw agent
+```
+
+## VNC Setup (GUI Access)
+
+For debugging or when you need visual browser access:
+
+### Install Dependencies
+
+```bash
+# Ubuntu/Debian
+apt-get install -y xvfb x11vnc fluxbox novnc websockify
+
+# Optional: Desktop environment for Chrome Remote Desktop
+apt-get install -y xfce4 xfce4-goodies
+```
+
+### Start VNC Server
+
+```bash
+#!/bin/bash
+# Start virtual display with VNC access
+
+DISPLAY_NUM=99
+VNC_PORT=5900
+NOVNC_PORT=6080
+RESOLUTION=1920x1080x24
+
+# Start Xvfb
+Xvfb :$DISPLAY_NUM -screen 0 $RESOLUTION -ac &
+sleep 1
+
+# Start window manager
+fluxbox -display :$DISPLAY_NUM &
+sleep 1
+
+# Start x11vnc
+x11vnc -display :$DISPLAY_NUM -rfbport $VNC_PORT -forever -shared -nopw -bg
+sleep 1
+
+# Start noVNC (web-based VNC)
+websockify --web=/usr/share/novnc $NOVNC_PORT localhost:$VNC_PORT &
+
+echo "VNC available at:"
+echo "  VNC Client: localhost:$VNC_PORT"
+echo "  Web Browser: http://localhost:$NOVNC_PORT/vnc.html"
+```
+
+### VNC Access
+
+- **VNC Client**: Connect to `localhost:5900`
+- **Web Browser**: Open `http://localhost:6080/vnc.html`
+
+### Start Browser on VNC Display
+
+```bash
+DISPLAY=:99 google-chrome --no-sandbox https://example.com &
+```
+
+## Chrome Remote Desktop
+
+### Install
+
+```bash
+# Download and install
+wget https://dl.google.com/linux/direct/chrome-remote-desktop_current_amd64.deb
+apt-get install -y ./chrome-remote-desktop_current_amd64.deb
+
+# Configure session
+echo "xfce4-session" > ~/.chrome-remote-desktop-session
+chmod +x ~/.chrome-remote-desktop-session
+```
+
+### Setup
+
+1. Visit <https://remotedesktop.google.com/headless>
+2. Copy the "Debian Linux" setup command
+3. Run it on your server
+4. Start the service: `systemctl --user start chrome-remote-desktop`
+
+### Remote Access
+
+Go to <https://remotedesktop.google.com/access> from any device.
+
+## Testing
+
+### CLI Tests
+
+```bash
+# Basic open and close
+agent-browser open https://example.com
+agent-browser get title
+agent-browser close
+
+# Snapshot with refs
+agent-browser open https://example.com
+agent-browser snapshot -i
+agent-browser close
+
+# Screenshot
+agent-browser open https://example.com
+agent-browser screenshot /tmp/test.png
+agent-browser close
+```
+
+### ZeroClaw Integration Tests
+
+```bash
+# Content extraction
+echo "Open https://example.com and summarize it" | zeroclaw agent
+
+# Navigation
+echo "Go to https://github.com/trending and list the top 3 repos" | zeroclaw agent
+
+# Form interaction
+echo "Go to Wikipedia, search for 'Rust programming language', and summarize" | zeroclaw agent
+```
+
+## Troubleshooting
+
+### "Element not found"
+
+The page may not be fully loaded. Add a wait:
+
+```bash
+agent-browser open https://slow-site.com
+agent-browser wait --load networkidle
+agent-browser snapshot -i
+```
+
+### Cookie dialogs blocking access
+
+Handle cookie consent first:
+
+```bash
+agent-browser open https://site-with-cookies.com
+agent-browser snapshot -i
+agent-browser click @accept_cookies  # Click the accept button
+agent-browser snapshot -i  # Now get the actual content
+```
+
+### Docker sandbox network restrictions
+
+If `web_fetch` fails inside Docker sandbox, use agent-browser instead:
+
+```bash
+# Instead of web_fetch, use:
+agent-browser open https://example.com
+agent-browser get text body
+```
+
+## Security Notes
+
+- `agent-browser` runs Chrome in headless mode with sandboxing
+- For sensitive sites, use `--session-name` to persist auth state
+- The `--allowed-domains` config restricts navigation to specific domains
+- VNC ports (5900, 6080) should be behind a firewall or Tailscale
+
+## Related
+
+- [agent-browser Documentation](https://github.com/vercel-labs/agent-browser)
+- [ZeroClaw Configuration Reference](./config-reference.md)
+- [Skills Documentation](../skills/)
--- a/third_party/zeroclaw/docs/contributing/README.md
+++ b/third_party/zeroclaw/docs/contributing/README.md
@@ -0,0 +1,20 @@
+# Contributing, Review, and CI Docs
+
+For contributors, reviewers, and maintainers.
+
+## Core Policies
+
+- Contribution guide: [../../CONTRIBUTING.md](../../CONTRIBUTING.md)
+- PR workflow rules: [./pr-workflow.md](./pr-workflow.md)
+- Reviewer playbook: [./reviewer-playbook.md](./reviewer-playbook.md)
+- CI map and ownership: [./ci-map.md](./ci-map.md)
+- Actions source policy: [./actions-source-policy.md](./actions-source-policy.md)
+- Extension examples: [./extension-examples.md](./extension-examples.md)
+- Testing guide: [./testing.md](./testing.md)
+
+## Suggested Reading Order
+
+1. `CONTRIBUTING.md`
+2. `pr-workflow.md`
+3. `reviewer-playbook.md`
+4. `ci-map.md`
--- a/third_party/zeroclaw/docs/contributing/actions-source-policy.md
+++ b/third_party/zeroclaw/docs/contributing/actions-source-policy.md
@@ -0,0 +1,82 @@
+# Actions Source Policy
+
+This document defines the current GitHub Actions source-control policy for this repository.
+
+## Current Policy
+
+- Repository Actions permissions: enabled
+- Allowed actions mode: selected
+
+Selected allowlist (all actions currently used across Quality Gate, Release Beta, and Release Stable workflows):
+
+| Action | Used In | Purpose |
+|--------|---------|---------|
+| `actions/checkout@v4` | All workflows | Repository checkout |
+| `actions/upload-artifact@v4` | release, promote-release | Upload build artifacts |
+| `actions/download-artifact@v4` | release, promote-release | Download build artifacts for packaging |
+| `dtolnay/rust-toolchain@stable` | All workflows | Install Rust toolchain (1.92.0) |
+| `Swatinem/rust-cache@v2` | All workflows | Cargo build/dependency caching |
+| `softprops/action-gh-release@v2` | release, promote-release | Create GitHub Releases |
+| `docker/setup-buildx-action@v3` | release, promote-release | Docker Buildx setup |
+| `docker/login-action@v3` | release, promote-release | GHCR authentication |
+| `docker/build-push-action@v6` | release, promote-release | Multi-platform Docker image build and push |
+| `actions/labeler@v5` | pr-path-labeler | Apply path/scope labels from `labeler.yml` |
+
+Equivalent allowlist patterns:
+
+- `actions/*`
+- `dtolnay/rust-toolchain@*`
+- `Swatinem/rust-cache@*`
+- `softprops/action-gh-release@*`
+- `docker/*`
+
+## Workflows
+
+| Workflow | File | Trigger |
+|----------|------|---------|
+| Quality Gate | `.github/workflows/checks-on-pr.yml` | Pull requests to `master` |
+| Release Beta | `.github/workflows/release-beta-on-push.yml` | Push to `master` |
+| Release Stable | `.github/workflows/release-stable-manual.yml` | Manual `workflow_dispatch` |
+| PR Path Labeler | `.github/workflows/pr-path-labeler.yml` | `pull_request_target` (opened, synchronize, reopened) |
+
+## Change Control
+
+Record each policy change with:
+
+- change date/time (UTC)
+- actor
+- reason
+- allowlist delta (added/removed patterns)
+- rollback note
+
+Use these commands to export the current effective policy:
+
+```bash
+gh api repos/zeroclaw-labs/zeroclaw/actions/permissions
+gh api repos/zeroclaw-labs/zeroclaw/actions/permissions/selected-actions
+```
+
+## Guardrails
+
+- Any PR that adds or changes `uses:` action sources must include an allowlist impact note.
+- New third-party actions require explicit maintainer review before allowlisting.
+- Expand allowlist only for verified missing actions; avoid broad wildcard exceptions.
+
+## Change Log
+
+- 2026-03-23: Added PR Path Labeler (`pr-path-labeler.yml`) using `actions/labeler@v5`. No allowlist change needed — covered by existing `actions/*` pattern.
+- 2026-03-10: Renamed workflows — CI → Quality Gate (`checks-on-pr.yml`), Beta Release → Release Beta (`release-beta-on-push.yml`), Promote Release → Release Stable (`release-stable-manual.yml`). Added `lint` and `security` jobs to Quality Gate. Added Cross-Platform Build (`cross-platform-build-manual.yml`).
+- 2026-03-05: Complete workflow overhaul — replaced 22 workflows with 3 (CI, Beta Release, Promote Release)
+    - Removed patterns no longer in use: `DavidAnson/markdownlint-cli2-action@*`, `lycheeverse/lychee-action@*`, `EmbarkStudios/cargo-deny-action@*`, `rustsec/audit-check@*`, `rhysd/actionlint@*`, `sigstore/cosign-installer@*`, `Checkmarx/vorpal-reviewdog-github-action@*`, `useblacksmith/*`
+    - Added: `Swatinem/rust-cache@*` (replaces `useblacksmith/*` rust-cache fork)
+    - Retained: `actions/*`, `dtolnay/rust-toolchain@*`, `softprops/action-gh-release@*`, `docker/*`
+- 2026-03-05: CI build optimization — added mold linker, cargo-nextest, CARGO_INCREMENTAL=0
+    - sccache removed due to fragile GHA cache backend causing build failures
+
+## Rollback
+
+Emergency unblock path:
+
+1. Temporarily set Actions policy back to `all`.
+2. Restore selected allowlist after identifying missing entries.
+3. Record incident and final allowlist delta.
--- a/third_party/zeroclaw/docs/contributing/adding-boards-and-tools.md
+++ b/third_party/zeroclaw/docs/contributing/adding-boards-and-tools.md
@@ -0,0 +1,116 @@
+# Adding Boards and Tools — ZeroClaw Hardware Guide
+
+This guide explains how to add new hardware boards and custom tools to ZeroClaw.
+
+## Quick Start: Add a Board via CLI
+
+```bash
+# Add a board (updates ~/.zeroclaw/config.toml)
+zeroclaw peripheral add nucleo-f401re /dev/ttyACM0
+zeroclaw peripheral add arduino-uno /dev/cu.usbmodem12345
+zeroclaw peripheral add rpi-gpio native   # for Raspberry Pi GPIO (Linux)
+
+# Restart daemon to apply
+zeroclaw daemon --host 127.0.0.1 --port 42617
+```
+
+## Supported Boards
+
+| Board           | Transport | Path Example              |
+|-----------------|-----------|---------------------------|
+| nucleo-f401re   | serial    | /dev/ttyACM0, /dev/cu.usbmodem* |
+| arduino-uno     | serial    | /dev/ttyACM0, /dev/cu.usbmodem* |
+| arduino-uno-q   | bridge    | (Uno Q IP)                |
+| rpi-gpio        | native    | native                    |
+| esp32           | serial    | /dev/ttyUSB0              |
+
+## Manual Config
+
+Edit `~/.zeroclaw/config.toml`:
+
+```toml
+[peripherals]
+enabled = true
+datasheet_dir = "docs/datasheets" # optional: RAG for "turn on red led" → pin 13
+
+[[peripherals.boards]]
+board = "nucleo-f401re"
+transport = "serial"
+path = "/dev/ttyACM0"
+baud = 115200
+
+[[peripherals.boards]]
+board = "arduino-uno"
+transport = "serial"
+path = "/dev/cu.usbmodem12345"
+baud = 115200
+```
+
+## Adding a Datasheet (RAG)
+
+Place `.md` or `.txt` files in `docs/datasheets/` (or your `datasheet_dir`). Name files by board: `nucleo-f401re.md`, `arduino-uno.md`.
+
+### Pin Aliases (Recommended)
+
+Add a `## Pin Aliases` section so the agent can map "red led" → pin 13:
+
+```markdown
+# My Board
+
+## Pin Aliases
+
+| alias       | pin |
+|-------------|-----|
+| red_led     | 13  |
+| builtin_led | 13  |
+| user_led    | 5   |
+```
+
+Or use key-value format:
+
+```markdown
+## Pin Aliases
+red_led: 13
+builtin_led: 13
+```
+
+### PDF Datasheets
+
+With the `rag-pdf` feature, ZeroClaw can index PDF files:
+
+```bash
+cargo build --features hardware,rag-pdf
+```
+
+Place PDFs in the datasheet directory. They are extracted and chunked for RAG.
+
+## Adding a New Board Type
+
+1. **Create a datasheet** — `docs/datasheets/my-board.md` with pin aliases and GPIO info.
+2. **Add to config** — `zeroclaw peripheral add my-board /dev/ttyUSB0`
+3. **Implement a peripheral** (optional) — For custom protocols, implement the `Peripheral` trait in `src/peripherals/` and register in `create_peripheral_tools`.
+
+See [`docs/hardware/hardware-peripherals-design.md`](../hardware/hardware-peripherals-design.md) for the full design.
+
+## Adding a Custom Tool
+
+1. Implement the `Tool` trait in `src/tools/`.
+2. Register in `create_peripheral_tools` (for hardware tools) or the agent tool registry.
+3. Add a tool description to the agent's `tool_descs` in `src/agent/loop_.rs`.
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `zeroclaw peripheral list` | List configured boards |
+| `zeroclaw peripheral add <board> <path>` | Add board (writes config) |
+| `zeroclaw peripheral flash` | Flash Arduino firmware |
+| `zeroclaw peripheral flash-nucleo` | Flash Nucleo firmware |
+| `zeroclaw hardware discover` | List USB devices |
+| `zeroclaw hardware info` | Chip info via probe-rs |
+
+## Troubleshooting
+
+- **Serial port not found** — On macOS use `/dev/cu.usbmodem*`; on Linux use `/dev/ttyACM0` or `/dev/ttyUSB0`.
+- **Build with hardware** — `cargo build --features hardware`
+- **Probe-rs for Nucleo** — `cargo build --features hardware,probe`
--- a/third_party/zeroclaw/docs/contributing/cargo-slicer-speedup.md
+++ b/third_party/zeroclaw/docs/contributing/cargo-slicer-speedup.md
@@ -0,0 +1,57 @@
+# Faster Builds with cargo-slicer
+
+[cargo-slicer](https://github.com/nickel-org/cargo-slicer) is a `RUSTC_WRAPPER` that stubs unreachable library functions at the MIR level, skipping LLVM codegen for code the final binary never calls.
+
+## Benchmark Results
+
+| Environment | Mode | Baseline | With cargo-slicer | Wall-time savings |
+|---|---|---|---|---|
+| 48-core server | syn pre-analysis | 3m 52s | 3m 31s | **-9.1%** |
+| 48-core server | MIR-precise | 3m 52s | 2m 49s | **-27.2%** |
+| Raspberry Pi 4 | syn pre-analysis | 25m 03s | 17m 54s | **-28.6%** |
+
+All measurements are clean `cargo +nightly build --release`. MIR-precise mode reads actual compiler MIR to build a more accurate call graph, stubbing 1,060 mono items vs 799 with syn-based analysis.
+
+## CI Integration
+
+The workflow `.github/workflows/ci-build-fast.yml` (not yet implemented) is intended to run an accelerated release build alongside the standard one. It triggers on Rust-code changes and workflow changes, does not gate merges, and runs in parallel as a non-blocking check.
+
+CI uses a resilient two-path strategy:
+- **Fast path**: install `cargo-slicer` plus the `rustc-driver` binaries and run the MIR-precise sliced build.
+- **Fallback path**: if `rustc-driver` install fails (for example due to nightly `rustc` API drift), run a plain `cargo +nightly build --release` instead of failing the check.
+
+This keeps the check useful and green while preserving acceleration whenever the toolchain is compatible.
+
+## Local Usage
+
+```bash
+# One-time install
+cargo install cargo-slicer
+rustup component add rust-src rustc-dev llvm-tools-preview --toolchain nightly
+cargo +nightly install cargo-slicer --profile release-rustc \
+  --bin cargo-slicer-rustc --bin cargo_slicer_dispatch \
+  --features rustc-driver
+
+# Build with syn pre-analysis (from zeroclaw root)
+cargo-slicer pre-analyze
+CARGO_SLICER_VIRTUAL=1 CARGO_SLICER_CODEGEN_FILTER=1 \
+  RUSTC_WRAPPER=$(which cargo_slicer_dispatch) \
+  cargo +nightly build --release
+
+# Build with MIR-precise analysis (more stubs, bigger savings)
+# Step 1: generate .mir-cache (first build with MIR_PRECISE)
+CARGO_SLICER_MIR_PRECISE=1 CARGO_SLICER_WORKSPACE_CRATES=zeroclaw,zeroclaw_robot_kit \
+  CARGO_SLICER_VIRTUAL=1 CARGO_SLICER_CODEGEN_FILTER=1 \
+  RUSTC_WRAPPER=$(which cargo_slicer_dispatch) \
+  cargo +nightly build --release
+# Step 2: subsequent builds automatically use .mir-cache
+```
+
+## How It Works
+
+1. **Pre-analysis** scans workspace sources via `syn` to build a cross-crate call graph (~2 s).
+2. **Cross-crate BFS** from `main()` identifies which public library functions are actually reachable.
+3. **MIR stubbing** replaces unreachable bodies with `Unreachable` terminators — the mono collector finds no callees and prunes entire codegen subtrees.
+4. **MIR-precise mode** (optional) reads actual compiler MIR from the binary crate's perspective, building a ground-truth call graph that identifies even more unreachable functions.
+
+No source files are modified. The output binary is functionally identical.
--- a/third_party/zeroclaw/docs/contributing/change-playbooks.md
+++ b/third_party/zeroclaw/docs/contributing/change-playbooks.md
@@ -0,0 +1,64 @@
+# Change Playbooks
+
+Step-by-step guides for common extension and modification patterns in ZeroClaw.
+
+For complete code examples of each extension trait, see [extension-examples.md](./extension-examples.md).
+
+## Adding a Provider
+
+- Implement `Provider` in `src/providers/`.
+- Register in `src/providers/mod.rs` factory.
+- Add focused tests for factory wiring and error paths.
+- Avoid provider-specific behavior leaks into shared orchestration code.
+
+## Adding a Channel
+
+- Implement `Channel` in `src/channels/`.
+- Keep `send`, `listen`, `health_check`, typing semantics consistent.
+- Cover auth/allowlist/health behavior with tests.
+
+## Adding a Tool
+
+- Implement `Tool` in `src/tools/` with strict parameter schema.
+- Validate and sanitize all inputs.
+- Return structured `ToolResult`; avoid panics in runtime path.
+
+## Adding a Peripheral
+
+- Implement `Peripheral` in `src/peripherals/`.
+- Peripherals expose `tools()` — each tool delegates to the hardware (GPIO, sensors, etc.).
+- Register board type in config schema if needed.
+- See `docs/hardware/hardware-peripherals-design.md` for protocol and firmware notes.
+
+## Security / Runtime / Gateway Changes
+
+- Include threat/risk notes and rollback strategy.
+- Add/update tests or validation evidence for failure modes and boundaries.
+- Keep observability useful but non-sensitive.
+- For `.github/workflows/**` changes, include Actions allowlist impact in PR notes and update `docs/contributing/actions-source-policy.md` when sources change.
+
+## Docs System / README / IA Changes
+
+- Treat docs navigation as product UX: preserve clear pathing from README -> docs hub -> SUMMARY -> category index.
+- Keep top-level nav concise; avoid duplicative links across adjacent nav blocks.
+- When runtime surfaces change, update related references in `docs/reference/`.
+- Keep multilingual entry-point parity for all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when nav or key wording changes.
+- When shared docs wording changes, sync corresponding localized docs in the same PR (or explicitly document deferral and follow-up PR).
+
+## Tool Shared State
+
+- Follow the `Arc<RwLock<T>>` handle pattern for any tool that owns long-lived shared state.
+- Accept handles at construction; do not create global/static mutable state.
+- Use `ClientId` (provided by the daemon) to namespace per-client state — never construct identity keys inside the tool.
+- Isolate security-sensitive state (credentials, quotas) per client; broadcast/display state may be shared with optional namespace prefixing.
+- Cached validation is invalidated on config change — tools must re-validate before the next execution when signaled.
+- See [ADR-004: Tool Shared State Ownership](../architecture/adr-004-tool-shared-state-ownership.md) for the full contract.
+
+## Architecture Boundary Rules
+
+- Extend capabilities by adding trait implementations + factory wiring first; avoid cross-module rewrites for isolated features.
+- Keep dependency direction inward to contracts: concrete integrations depend on trait/config/util layers, not on other concrete integrations.
+- Avoid cross-subsystem coupling (e.g., provider code importing channel internals, tool code mutating gateway policy directly).
+- Keep module responsibilities single-purpose: orchestration in `agent/`, transport in `channels/`, model I/O in `providers/`, policy in `security/`, execution in `tools/`.
+- Introduce new shared abstractions only after repeated use (rule-of-three), with at least one real caller.
+- For config/schema changes, treat keys as public contract: document defaults, compatibility impact, and migration/rollback path.
--- a/third_party/zeroclaw/docs/contributing/ci-map.md
+++ b/third_party/zeroclaw/docs/contributing/ci-map.md
@@ -0,0 +1,136 @@
+# CI Workflow Map
+
+This document explains what each GitHub workflow does, when it runs, and whether it should block merges.
+
+For event-by-event delivery behavior across PR, merge, push, and release, see [`.github/workflows/master-branch-flow.md`](../../.github/workflows/master-branch-flow.md).
+
+## Merge-Blocking vs Optional
+
+Merge-blocking checks should stay small and deterministic. Optional checks are useful for automation and maintenance, but should not block normal development.
+
+### Merge-Blocking
+
+- `.github/workflows/ci-run.yml` (`CI`)
+    - Purpose: Rust validation (`cargo fmt --all -- --check`, `cargo clippy --locked --all-targets -- -D clippy::correctness`, strict delta lint gate on changed Rust lines, `test`, release build smoke) + docs quality checks when docs change (`markdownlint` blocks only issues on changed lines; link check scans only links added on changed lines)
+    - Additional behavior: for Rust-impacting PRs and pushes, `CI Required Gate` requires `lint` + `test` + `build` (no PR build-only bypass)
+    - Additional behavior: PRs that change `.github/workflows/**` require at least one approving review from a login in `WORKFLOW_OWNER_LOGINS` (repository variable fallback: `theonlyhennygod,JordanTheJet,SimianAstronaut7`)
+    - Additional behavior: lint gates run before `test`/`build`; when lint/docs gates fail on PRs, CI posts an actionable feedback comment with failing gate names and local fix commands
+    - Merge gate: `CI Required Gate`
+- `.github/workflows/workflow-sanity.yml` (`Workflow Sanity`)
+    - Purpose: lint GitHub workflow files (`actionlint`, tab checks)
+    - Recommended for workflow-changing PRs
+- `.github/workflows/pr-intake-checks.yml` (`PR Intake Checks`)
+    - Purpose: safe pre-CI PR checks (template completeness, added-line tabs/trailing-whitespace/conflict markers) with immediate sticky feedback comment
+### Non-Blocking but Important
+
+- `.github/workflows/pub-docker-img.yml` (`Docker`)
+    - Purpose: PR Docker smoke check on `master` PRs and publish images on tag pushes (`v*`) only
+- `.github/workflows/sec-audit.yml` (`Security Audit`)
+    - Purpose: dependency advisories (`rustsec/audit-check`, pinned SHA) and policy/license checks (`cargo deny`)
+- `.github/workflows/sec-codeql.yml` (`CodeQL Analysis`)
+    - Purpose: scheduled/manual static analysis for security findings
+- `.github/workflows/sec-vorpal-reviewdog.yml` (`Sec Vorpal Reviewdog`)
+    - Purpose: manual secure-coding feedback scan for supported non-Rust files (`.py`, `.js`, `.jsx`, `.ts`, `.tsx`) using reviewdog annotations
+    - Noise control: excludes common test/fixture paths and test file patterns by default (`include_tests=false`)
+- `.github/workflows/pub-release.yml` (`Release`)
+    - Purpose: build release artifacts in verification mode (manual/scheduled) and publish GitHub releases on tag push or manual publish mode
+- `.github/workflows/pub-homebrew-core.yml` (`Pub Homebrew Core`)
+    - Purpose: manual, bot-owned Homebrew core formula bump PR flow for tagged releases
+    - Guardrail: release tag must match `Cargo.toml` version
+- `.github/workflows/pub-scoop.yml` (`Pub Scoop Manifest`)
+    - Purpose: Scoop bucket manifest update for Windows; auto-called by stable release, also manual dispatch
+    - Guardrail: release tag must be `vX.Y.Z` format; Windows binary hash extracted from `SHA256SUMS`
+- `.github/workflows/pub-aur.yml` (`Pub AUR Package`)
+    - Purpose: AUR PKGBUILD push for Arch Linux; auto-called by stable release, also manual dispatch
+    - Guardrail: release tag must be `vX.Y.Z` format; source tarball SHA256 computed at publish time
+- `.github/workflows/pr-label-policy-check.yml` (`Label Policy Sanity`)
+    - Purpose: validate shared contributor-tier policy in `.github/label-policy.json` and ensure label workflows consume that policy
+- `.github/workflows/test-rust-build.yml` (`Rust Reusable Job`)
+    - Purpose: reusable Rust setup/cache + command runner for workflow-call consumers
+
+### Optional Repository Automation
+
+- `.github/workflows/pr-labeler.yml` (`PR Labeler`)
+    - Purpose: scope/path labels + size/risk labels + fine-grained module labels (`<module>: <component>`)
+    - Additional behavior: label descriptions are auto-managed as hover tooltips to explain each auto-judgment rule
+    - Additional behavior: provider-related keywords in provider/config/onboard/integration changes are promoted to `provider:*` labels (for example `provider:kimi`, `provider:deepseek`)
+    - Additional behavior: hierarchical de-duplication keeps only the most specific scope labels (for example `tool:composio` suppresses `tool:core` and `tool`)
+    - Additional behavior: module namespaces are compacted — one specific module keeps `prefix:component`; multiple specifics collapse to just `prefix`
+    - Additional behavior: applies contributor tiers on PRs by merged PR count (`trusted` >=5, `experienced` >=10, `principal` >=20, `distinguished` >=50)
+    - Additional behavior: final label set is priority-sorted (`risk:*` first, then `size:*`, then contributor tier, then module/path labels)
+    - Additional behavior: managed label colors follow display order to produce a smooth left-to-right gradient when many labels are present
+    - Manual governance: supports `workflow_dispatch` with `mode=audit|repair` to inspect/fix managed label metadata drift across the whole repository
+    - Additional behavior: risk + size labels are auto-corrected on manual PR label edits (`labeled`/`unlabeled` events); apply `risk: manual` when maintainers intentionally override automated risk selection
+    - High-risk heuristic paths: `src/security/**`, `src/runtime/**`, `src/gateway/**`, `src/tools/**`, `.github/workflows/**`
+    - Guardrail: maintainers can apply `risk: manual` to freeze automated risk recalculation
+- `.github/workflows/pr-auto-response.yml` (`PR Auto Responder`)
+    - Purpose: first-time contributor onboarding + label-driven response routing (`r:support`, `r:needs-repro`, etc.)
+    - Additional behavior: applies contributor tiers on issues by merged PR count (`trusted` >=5, `experienced` >=10, `principal` >=20, `distinguished` >=50), matching PR tier thresholds exactly
+    - Additional behavior: contributor-tier labels are treated as automation-managed (manual add/remove on PR/issue is auto-corrected)
+    - Guardrail: label-based close routes are issue-only; PRs are never auto-closed by route labels
+- `.github/workflows/pr-check-stale.yml` (`Stale`)
+    - Purpose: stale issue/PR lifecycle automation
+- `.github/dependabot.yml` (`Dependabot`)
+    - Purpose: grouped, rate-limited dependency update PRs (Cargo + GitHub Actions)
+- `.github/workflows/pr-check-status.yml` (`PR Hygiene`)
+    - Purpose: nudge stale-but-active PRs to rebase/re-run required checks before queue starvation
+
+## Trigger Map
+
+- `CI`: push to `master`, PRs to `master`
+- `Docker`: tag push (`v*`) for publish, matching PRs to `master` for smoke build, manual dispatch for smoke only
+- `Release`: tag push (`v*`), weekly schedule (verification-only), manual dispatch (verification or publish)
+- `Pub Homebrew Core`: manual dispatch only
+- `Pub Scoop Manifest`: auto-called by stable release, also manual dispatch
+- `Pub AUR Package`: auto-called by stable release, also manual dispatch
+- `Security Audit`: push to `master`, PRs to `master`, weekly schedule
+- `Sec Vorpal Reviewdog`: manual dispatch only
+- `Workflow Sanity`: PR/push when `.github/workflows/**`, `.github/*.yml`, or `.github/*.yaml` change
+- `Dependabot`: all update PRs target `master`
+- `PR Intake Checks`: `pull_request_target` on opened/reopened/synchronize/edited/ready_for_review
+- `Label Policy Sanity`: PR/push when `.github/label-policy.json`, `.github/workflows/pr-labeler.yml`, or `.github/workflows/pr-auto-response.yml` changes
+- `PR Labeler`: `pull_request_target` lifecycle events
+- `PR Auto Responder`: issue opened/labeled, `pull_request_target` opened/labeled
+- `Stale PR Check`: daily schedule, manual dispatch
+- `PR Hygiene`: every 12 hours schedule, manual dispatch
+
+## Fast Triage Guide
+
+1. `CI Required Gate` failing: start with `.github/workflows/ci-run.yml`.
+2. Docker failures on PRs: inspect `.github/workflows/pub-docker-img.yml` `pr-smoke` job.
+3. Release failures (tag/manual/scheduled): inspect `.github/workflows/pub-release.yml` and the `prepare` job outputs.
+4. Homebrew formula publish failures: inspect `.github/workflows/pub-homebrew-core.yml` summary output and bot token/fork variables.
+5. Scoop manifest publish failures: inspect `.github/workflows/pub-scoop.yml` summary output and `SCOOP_BUCKET_REPO`/`SCOOP_BUCKET_TOKEN` settings.
+6. AUR package publish failures: inspect `.github/workflows/pub-aur.yml` summary output and `AUR_SSH_KEY` secret.
+7. Security failures: inspect `.github/workflows/sec-audit.yml` and `deny.toml`.
+8. Workflow syntax/lint failures: inspect `.github/workflows/workflow-sanity.yml`.
+9. PR intake failures: inspect `.github/workflows/pr-intake-checks.yml` sticky comment and run logs.
+10. Label policy parity failures: inspect `.github/workflows/pr-label-policy-check.yml`.
+11. Docs failures in CI: inspect `docs-quality` job logs in `.github/workflows/ci-run.yml`.
+12. Strict delta lint failures in CI: inspect `lint-strict-delta` job logs and compare with `BASE_SHA` diff scope.
+
+## Maintenance Rules
+
+- Keep merge-blocking checks deterministic and reproducible (`--locked` where applicable).
+- Follow [`docs/contributing/release-process.md`](./release-process.md) for verify-before-publish release cadence and tag discipline.
+- Keep merge-blocking rust quality policy aligned across `.github/workflows/ci-run.yml`, `dev/ci.sh`, and `.githooks/pre-push` (`./scripts/ci/rust_quality_gate.sh` + `./scripts/ci/rust_strict_delta_gate.sh`).
+- Use `./scripts/ci/rust_strict_delta_gate.sh` (or `./dev/ci.sh lint-delta`) as the incremental strict merge gate for changed Rust lines.
+- Run full strict lint audits regularly via `./scripts/ci/rust_quality_gate.sh --strict` (for example through `./dev/ci.sh lint-strict`) and track cleanup in focused PRs.
+- Keep docs markdown gating incremental via `./scripts/ci/docs_quality_gate.sh` (block changed-line issues, report baseline issues separately).
+- Keep docs link gating incremental via `./scripts/ci/collect_changed_links.py` + lychee (check only links added on changed lines).
+- Prefer explicit workflow permissions (least privilege).
+- Keep Actions source policy restricted to approved allowlist patterns (see [`docs/contributing/actions-source-policy.md`](./actions-source-policy.md)).
+- Use path filters for expensive workflows when practical.
+- Keep docs quality checks low-noise (incremental markdown + incremental added-link checks).
+- Keep dependency update volume controlled (grouping + PR limits).
+- Avoid mixing onboarding/community automation with merge-gating logic.
+- Test levels: `cargo test --test component`, `cargo test --test integration`, `cargo test --test system`.
+- Live tests (manual only): `cargo test --test live -- --ignored`.
+
+## Automation Side-Effect Controls
+
+- Prefer deterministic automation that can be manually overridden (`risk: manual`) when context is nuanced.
+- Keep auto-response comments deduplicated to prevent triage noise.
+- Keep auto-close behavior scoped to issues; maintainers own PR close/merge decisions.
+- If automation is wrong, correct labels first, then continue review with explicit rationale.
+- Use `superseded` / `stale-candidate` labels to prune duplicate or dormant PRs before deep review.
--- a/third_party/zeroclaw/docs/contributing/cla.md
+++ b/third_party/zeroclaw/docs/contributing/cla.md
@@ -0,0 +1,132 @@
+# ZeroClaw Contributor License Agreement (CLA)
+
+**Version 1.0 — February 2026**  
+**ZeroClaw Labs**
+
+---
+
+## Purpose
+
+This Contributor License Agreement ("CLA") clarifies the intellectual
+property rights granted by contributors to ZeroClaw Labs. This agreement
+protects both contributors and users of the ZeroClaw project.
+
+By submitting a contribution (pull request, patch, issue with code, or any
+other form of code submission) to the ZeroClaw repository, you agree to the
+terms of this CLA.
+
+---
+
+## 1. Definitions
+
+- **"Contribution"** means any original work of authorship, including any
+  modifications or additions to existing work, submitted to ZeroClaw Labs
+  for inclusion in the ZeroClaw project.
+
+- **"You"** means the individual or legal entity submitting a Contribution.
+
+- **"ZeroClaw Labs"** means the maintainers and organization responsible
+  for the ZeroClaw project at https://github.com/zeroclaw-labs/zeroclaw.
+
+---
+
+## 2. Grant of Copyright License
+
+You grant ZeroClaw Labs and recipients of software distributed by ZeroClaw
+Labs a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable copyright license to:
+
+- Reproduce, prepare derivative works of, publicly display, publicly
+  perform, sublicense, and distribute your Contributions and derivative
+  works under **both the MIT License and the Apache License 2.0**.
+
+---
+
+## 3. Grant of Patent License
+
+You grant ZeroClaw Labs and recipients of software distributed by ZeroClaw
+Labs a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable patent license to make, have made, use, offer to sell, sell,
+import, and otherwise transfer your Contributions.
+
+This patent license applies only to patent claims licensable by you that
+are necessarily infringed by your Contribution alone or in combination with
+the ZeroClaw project.
+
+**This protects you:** if a third party files a patent claim against
+ZeroClaw that covers your Contribution, your patent license to the project
+is not revoked.
+
+---
+
+## 4. You Retain Your Rights
+
+This CLA does **not** transfer ownership of your Contribution to ZeroClaw
+Labs. You retain full copyright ownership of your Contribution. You are
+free to use your Contribution in any other project under any license.
+
+---
+
+## 5. Original Work
+
+You represent that:
+
+1. Each Contribution is your original creation, or you have sufficient
+   rights to submit it under this CLA.
+2. Your Contribution does not knowingly infringe any third-party patent,
+   copyright, trademark, or other intellectual property right.
+3. If your employer has rights to intellectual property you create, you
+   have received permission to submit the Contribution, or your employer
+   has signed a corporate CLA with ZeroClaw Labs.
+
+---
+
+## 6. No Trademark Rights
+
+This CLA does not grant you any rights to use the ZeroClaw name,
+trademarks, service marks, or logos. See [trademark.md](../maintainers/trademark.md) for trademark policy.
+
+---
+
+## 7. Attribution
+
+ZeroClaw Labs will maintain attribution to contributors in the repository
+commit history and NOTICE file. Your contributions are permanently and
+publicly recorded.
+
+---
+
+## 8. Dual-License Commitment
+
+All Contributions accepted into the ZeroClaw project are licensed under
+both:
+
+- **MIT License** — permissive open-source use
+- **Apache License 2.0** — patent protection and stronger IP guarantees
+
+This dual-license model ensures maximum compatibility and protection for
+the entire contributor community.
+
+---
+
+## 9. How to Agree
+
+By opening a pull request or submitting a patch to the ZeroClaw repository,
+you indicate your agreement to this CLA. No separate signature is required
+for individual contributors.
+
+For **corporate contributors** (submitting on behalf of a company or
+organization), please open an issue titled "Corporate CLA — [Company Name]"
+and a maintainer will follow up.
+
+---
+
+## 10. Questions
+
+If you have questions about this CLA, open an issue at:
+https://github.com/zeroclaw-labs/zeroclaw/issues
+
+---
+
+*This CLA is based on the Apache Individual Contributor License Agreement
+v2.0, adapted for the ZeroClaw dual-license model.*
--- a/third_party/zeroclaw/docs/contributing/custom-providers.md
+++ b/third_party/zeroclaw/docs/contributing/custom-providers.md
@@ -0,0 +1,206 @@
+# Custom Provider Configuration
+
+ZeroClaw supports custom API endpoints for both OpenAI-compatible and Anthropic-compatible providers.
+
+## Provider Types
+
+### OpenAI-Compatible Endpoints (`custom:`)
+
+For services that implement the OpenAI API format:
+
+```toml
+default_provider = "custom:https://your-api.com"
+api_key = "your-api-key"
+default_model = "your-model-name"
+```
+
+### Anthropic-Compatible Endpoints (`anthropic-custom:`)
+
+For services that implement the Anthropic API format:
+
+```toml
+default_provider = "anthropic-custom:https://your-api.com"
+api_key = "your-api-key"
+default_model = "your-model-name"
+```
+
+## Configuration Methods
+
+### Config File
+
+Edit `~/.zeroclaw/config.toml`:
+
+```toml
+api_key = "your-api-key"
+default_provider = "anthropic-custom:https://api.example.com"
+default_model = "claude-sonnet-4-6"
+```
+
+### Environment Variables
+
+For `custom:` and `anthropic-custom:` providers, use the generic key env vars:
+
+```bash
+export API_KEY="your-api-key"
+# or: export ZEROCLAW_API_KEY="your-api-key"
+zeroclaw agent
+```
+
+## llama.cpp Server (Recommended Local Setup)
+
+ZeroClaw includes a first-class local provider for `llama-server`:
+
+- Provider ID: `llamacpp` (alias: `llama.cpp`)
+- Default endpoint: `http://localhost:8080/v1`
+- API key is optional unless `llama-server` is started with `--api-key`
+
+Start a local server (example):
+
+```bash
+llama-server -hf ggml-org/gpt-oss-20b-GGUF --jinja -c 133000 --host 127.0.0.1 --port 8033
+```
+
+Then configure ZeroClaw:
+
+```toml
+default_provider = "llamacpp"
+api_url = "http://127.0.0.1:8033/v1"
+default_model = "ggml-org/gpt-oss-20b-GGUF"
+default_temperature = 0.7
+```
+
+Quick validation:
+
+```bash
+zeroclaw models refresh --provider llamacpp
+zeroclaw agent -m "hello"
+```
+
+You do not need to export `ZEROCLAW_API_KEY=dummy` for this flow.
+
+## SGLang Server
+
+ZeroClaw includes a first-class local provider for [SGLang](https://github.com/sgl-project/sglang):
+
+- Provider ID: `sglang`
+- Default endpoint: `http://localhost:30000/v1`
+- API key is optional unless the server requires authentication
+
+Start a local server (example):
+
+```bash
+python -m sglang.launch_server --model meta-llama/Llama-3.1-8B-Instruct --port 30000
+```
+
+Then configure ZeroClaw:
+
+```toml
+default_provider = "sglang"
+default_model = "meta-llama/Llama-3.1-8B-Instruct"
+default_temperature = 0.7
+```
+
+Quick validation:
+
+```bash
+zeroclaw models refresh --provider sglang
+zeroclaw agent -m "hello"
+```
+
+You do not need to export `ZEROCLAW_API_KEY=dummy` for this flow.
+
+## vLLM Server
+
+ZeroClaw includes a first-class local provider for [vLLM](https://docs.vllm.ai/):
+
+- Provider ID: `vllm`
+- Default endpoint: `http://localhost:8000/v1`
+- API key is optional unless the server requires authentication
+
+Start a local server (example):
+
+```bash
+vllm serve meta-llama/Llama-3.1-8B-Instruct
+```
+
+Then configure ZeroClaw:
+
+```toml
+default_provider = "vllm"
+default_model = "meta-llama/Llama-3.1-8B-Instruct"
+default_temperature = 0.7
+```
+
+Quick validation:
+
+```bash
+zeroclaw models refresh --provider vllm
+zeroclaw agent -m "hello"
+```
+
+You do not need to export `ZEROCLAW_API_KEY=dummy` for this flow.
+
+## Testing Configuration
+
+Verify your custom endpoint:
+
+```bash
+# Interactive mode
+zeroclaw agent
+
+# Single message test
+zeroclaw agent -m "test message"
+```
+
+## Troubleshooting
+
+### Authentication Errors
+
+- Verify API key is correct
+- Check endpoint URL format (must include `http://` or `https://`)
+- Ensure endpoint is accessible from your network
+
+### Model Not Found
+
+- Confirm model name matches provider's available models
+- Check provider documentation for exact model identifiers
+- Ensure endpoint and model family match. Some custom gateways only expose a subset of models.
+- Verify available models from the same endpoint and key you configured:
+
+```bash
+curl -sS https://your-api.com/models \
+  -H "Authorization: Bearer $API_KEY"
+```
+
+- If the gateway does not implement `/models`, send a minimal chat request and inspect the provider's returned model error text.
+
+### Connection Issues
+
+- Test endpoint accessibility: `curl -I https://your-api.com`
+- Verify firewall/proxy settings
+- Check provider status page
+
+## Examples
+
+### Local LLM Server (Generic Custom Endpoint)
+
+```toml
+default_provider = "custom:http://localhost:8080/v1"
+api_key = "your-api-key-if-required"
+default_model = "local-model"
+```
+
+### Corporate Proxy
+
+```toml
+default_provider = "anthropic-custom:https://llm-proxy.corp.example.com"
+api_key = "internal-token"
+```
+
+### Cloud Provider Gateway
+
+```toml
+default_provider = "custom:https://gateway.cloud-provider.com/v1"
+api_key = "gateway-api-key"
+default_model = "gpt-4"
+```
--- a/third_party/zeroclaw/docs/contributing/doc-template.md
+++ b/third_party/zeroclaw/docs/contributing/doc-template.md
@@ -0,0 +1,63 @@
+# Documentation Template (Operational)
+
+Use this template when adding a new operational or engineering document under `docs/`.
+
+Keep sections that apply; remove non-applicable placeholders before merging.
+
+---
+
+## 1. Summary
+
+- **Purpose:** <one sentence about why this document exists>
+- **Audience:** <operators | reviewers | contributors | maintainers>
+- **Scope:** <what this doc covers>
+- **Non-goals:** <what this doc intentionally does not cover>
+
+## 2. Prerequisites
+
+- <required environment>
+- <required permissions>
+- <required tools/config>
+
+## 3. Procedure
+
+### 3.1 Baseline Check
+
+1. <step>
+2. <step>
+
+### 3.2 Main Workflow
+
+1. <step>
+2. <step>
+3. <step>
+
+### 3.3 Verification
+
+- <expected output or success signal>
+- <validation command/log/checkpoint>
+
+## 4. Safety, Risk, and Rollback
+
+- **Risk surface:** <which components may be impacted>
+- **Failure modes:** <what can go wrong>
+- **Rollback plan:** <concrete rollback command/steps>
+
+## 5. Troubleshooting
+
+- **Symptom:** <error/signal>
+  - **Cause:** <likely cause>
+  - **Fix:** <action>
+
+## 6. Related Docs
+
+- [README.md](./README.md) — documentation taxonomy and navigation.
+- <related-doc-1.md>
+- <related-doc-2.md>
+
+## 7. Maintenance Notes
+
+- **Owner:** <team/persona/area>
+- **Update trigger:** <what changes should force this doc update>
+- **Last reviewed:** <YYYY-MM-DD>
+
--- a/third_party/zeroclaw/docs/contributing/docs-contract.md
+++ b/third_party/zeroclaw/docs/contributing/docs-contract.md
@@ -0,0 +1,34 @@
+# Documentation System Contract
+
+Treat documentation as a first-class product surface, not a post-merge artifact.
+
+## Canonical Entry Points
+
+- root READMEs: `README.md`, `README.zh-CN.md`, `README.ja.md`, `README.ru.md`, `README.fr.md`, `README.vi.md`
+- docs hubs: `docs/README.md`, `docs/README.zh-CN.md`, `docs/README.ja.md`, `docs/README.ru.md`, `docs/README.fr.md`, `docs/README.vi.md`
+- unified TOC: `docs/SUMMARY.md`
+
+## Supported Locales
+
+`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`
+
+## Collection Indexes
+
+- `docs/setup-guides/README.md`
+- `docs/reference/README.md`
+- `docs/ops/README.md`
+- `docs/security/README.md`
+- `docs/hardware/README.md`
+- `docs/contributing/README.md`
+- `docs/maintainers/README.md`
+
+## Governance Rules
+
+- Keep README/hub top navigation and quick routes intuitive and non-duplicative.
+- Keep entry-point parity across all supported locales when changing navigation architecture.
+- If a change touches docs IA, runtime-contract references, or user-facing wording in shared docs, perform i18n follow-through for supported locales in the same PR:
+  - Update locale navigation links (`README*`, `docs/README*`, `docs/SUMMARY.md`).
+  - Update localized runtime-contract docs where equivalents exist.
+  - For Vietnamese, treat `docs/vi/**` as canonical.
+- Keep proposal/roadmap docs explicitly labeled; avoid mixing proposal text into runtime-contract docs.
+- Keep project snapshots date-stamped and immutable once superseded by a newer date.
--- a/third_party/zeroclaw/docs/contributing/extension-examples.md
+++ b/third_party/zeroclaw/docs/contributing/extension-examples.md
@@ -0,0 +1,407 @@
+# Extension Examples
+
+ZeroClaw's architecture is trait-driven and modular.
+To add a new provider, channel, tool, or memory backend, implement the corresponding trait and register it in the factory module.
+
+This page contains minimal, working examples for each core extension point.
+For step-by-step integration checklists, see [change-playbooks.md](./change-playbooks.md).
+
+> **Source of truth**: the trait definitions live in `src/*/traits.rs`.
+> If an example here conflicts with the trait file, the trait file wins.
+
+---
+
+## Tool (`src/tools/traits.rs`)
+
+Tools are the agent's hands — they let it interact with the world.
+
+**Required methods**: `name()`, `description()`, `parameters_schema()`, `execute()`.
+The `spec()` method has a default implementation that composes the others.
+
+Register your tool in `src/tools/mod.rs` via `default_tools()`.
+
+```rust
+// In your crate: use zeroclaw::tools::traits::{Tool, ToolResult};
+
+use anyhow::Result;
+use async_trait::async_trait;
+use serde_json::{json, Value};
+
+/// A tool that fetches a URL and returns the status code.
+pub struct HttpGetTool;
+
+#[async_trait]
+impl Tool for HttpGetTool {
+    fn name(&self) -> &str {
+        "http_get"
+    }
+
+    fn description(&self) -> &str {
+        "Fetch a URL and return the HTTP status code and content length"
+    }
+
+    fn parameters_schema(&self) -> Value {
+        json!({
+            "type": "object",
+            "properties": {
+                "url": { "type": "string", "description": "URL to fetch" }
+            },
+            "required": ["url"]
+        })
+    }
+
+    async fn execute(&self, args: Value) -> Result<ToolResult> {
+        let url = args["url"]
+            .as_str()
+            .ok_or_else(|| anyhow::anyhow!("Missing 'url' parameter"))?;
+
+        match reqwest::get(url).await {
+            Ok(resp) => {
+                let status = resp.status().as_u16();
+                let len = resp.content_length().unwrap_or(0);
+                Ok(ToolResult {
+                    success: status < 400,
+                    output: format!("HTTP {status} — {len} bytes"),
+                    error: None,
+                })
+            }
+            Err(e) => Ok(ToolResult {
+                success: false,
+                output: String::new(),
+                error: Some(format!("Request failed: {e}")),
+            }),
+        }
+    }
+}
+```
+
+---
+
+## Channel (`src/channels/traits.rs`)
+
+Channels let ZeroClaw communicate through any messaging platform.
+
+**Required methods**: `name()`, `send(&SendMessage)`, `listen()`.
+Default implementations exist for `health_check()`, `start_typing()`, `stop_typing()`,
+draft methods (`send_draft`, `update_draft`, `finalize_draft`, `cancel_draft`),
+and reaction methods (`add_reaction`, `remove_reaction`).
+
+Register your channel in `src/channels/mod.rs` and add config to `ChannelsConfig` in `src/config/schema.rs`.
+
+```rust
+// In your crate: use zeroclaw::channels::traits::{Channel, ChannelMessage, SendMessage};
+
+use anyhow::Result;
+use async_trait::async_trait;
+use tokio::sync::mpsc;
+
+/// Telegram channel via Bot API.
+pub struct TelegramChannel {
+    bot_token: String,
+    allowed_users: Vec<String>,
+    client: reqwest::Client,
+}
+
+impl TelegramChannel {
+    pub fn new(bot_token: &str, allowed_users: Vec<String>) -> Self {
+        Self {
+            bot_token: bot_token.to_string(),
+            allowed_users,
+            client: reqwest::Client::new(),
+        }
+    }
+
+    fn api_url(&self, method: &str) -> String {
+        format!("https://api.telegram.org/bot{}/{method}", self.bot_token)
+    }
+}
+
+#[async_trait]
+impl Channel for TelegramChannel {
+    fn name(&self) -> &str {
+        "telegram"
+    }
+
+    async fn send(&self, message: &SendMessage) -> Result<()> {
+        self.client
+            .post(self.api_url("sendMessage"))
+            .json(&serde_json::json!({
+                "chat_id": message.recipient,
+                "text": message.content,
+                "parse_mode": "Markdown",
+            }))
+            .send()
+            .await?;
+        Ok(())
+    }
+
+    async fn listen(&self, tx: mpsc::Sender<ChannelMessage>) -> Result<()> {
+        let mut offset: i64 = 0;
+
+        loop {
+            let resp = self
+                .client
+                .get(self.api_url("getUpdates"))
+                .query(&[("offset", offset.to_string()), ("timeout", "30".into())])
+                .send()
+                .await?
+                .json::<serde_json::Value>()
+                .await?;
+
+            if let Some(updates) = resp["result"].as_array() {
+                for update in updates {
+                    if let Some(msg) = update.get("message") {
+                        let sender = msg["from"]["username"]
+                            .as_str()
+                            .unwrap_or("unknown")
+                            .to_string();
+
+                        if !self.allowed_users.is_empty()
+                            && !self.allowed_users.contains(&sender)
+                        {
+                            continue;
+                        }
+
+                        let chat_id = msg["chat"]["id"].to_string();
+
+                        let channel_msg = ChannelMessage {
+                            id: msg["message_id"].to_string(),
+                            sender,
+                            reply_target: chat_id,
+                            content: msg["text"].as_str().unwrap_or("").to_string(),
+                            channel: "telegram".into(),
+                            timestamp: msg["date"].as_u64().unwrap_or(0),
+                            thread_ts: None,
+                        };
+
+                        if tx.send(channel_msg).await.is_err() {
+                            return Ok(());
+                        }
+                    }
+                    offset = update["update_id"].as_i64().unwrap_or(offset) + 1;
+                }
+            }
+        }
+    }
+
+    async fn health_check(&self) -> bool {
+        self.client
+            .get(self.api_url("getMe"))
+            .send()
+            .await
+            .map(|r| r.status().is_success())
+            .unwrap_or(false)
+    }
+}
+```
+
+---
+
+## Provider (`src/providers/traits.rs`)
+
+Providers are LLM backend adapters. Each provider connects ZeroClaw to a different model API.
+
+**Required method**: `chat_with_system(system_prompt: Option<&str>, message: &str, model: &str, temperature: f64) -> Result<String>`.
+Everything else has default implementations:
+`simple_chat()` and `chat_with_history()` delegate to `chat_with_system()`;
+`capabilities()` returns no native tool calling by default;
+streaming methods return empty/error streams by default.
+
+Register your provider in `src/providers/mod.rs`.
+
+```rust
+// In your crate: use zeroclaw::providers::traits::Provider;
+
+use anyhow::Result;
+use async_trait::async_trait;
+
+/// Ollama local provider.
+pub struct OllamaProvider {
+    base_url: String,
+    client: reqwest::Client,
+}
+
+impl OllamaProvider {
+    pub fn new(base_url: Option<&str>) -> Self {
+        Self {
+            base_url: base_url.unwrap_or("http://localhost:11434").to_string(),
+            client: reqwest::Client::new(),
+        }
+    }
+}
+
+#[async_trait]
+impl Provider for OllamaProvider {
+    async fn chat_with_system(
+        &self,
+        system_prompt: Option<&str>,
+        message: &str,
+        model: &str,
+        temperature: f64,
+    ) -> Result<String> {
+        let url = format!("{}/api/generate", self.base_url);
+
+        let mut body = serde_json::json!({
+            "model": model,
+            "prompt": message,
+            "temperature": temperature,
+            "stream": false,
+        });
+
+        if let Some(system) = system_prompt {
+            body["system"] = serde_json::Value::String(system.to_string());
+        }
+
+        let resp = self
+            .client
+            .post(&url)
+            .json(&body)
+            .send()
+            .await?
+            .json::<serde_json::Value>()
+            .await?;
+
+        resp["response"]
+            .as_str()
+            .map(|s| s.to_string())
+            .ok_or_else(|| anyhow::anyhow!("No response field in Ollama reply"))
+    }
+}
+```
+
+---
+
+## Memory (`src/memory/traits.rs`)
+
+Memory backends provide pluggable persistence for the agent's knowledge.
+
+**Required methods**: `name()`, `store()`, `recall()`, `get()`, `list()`, `forget()`, `count()`, `health_check()`.
+Both `store()` and `recall()` accept an optional `session_id` for scoping.
+
+Register your backend in `src/memory/mod.rs`.
+
+```rust
+// In your crate: use zeroclaw::memory::traits::{Memory, MemoryEntry, MemoryCategory};
+
+use async_trait::async_trait;
+use std::collections::HashMap;
+use std::sync::Mutex;
+
+/// In-memory HashMap backend (useful for testing or ephemeral sessions).
+pub struct InMemoryBackend {
+    store: Mutex<HashMap<String, MemoryEntry>>,
+}
+
+impl InMemoryBackend {
+    pub fn new() -> Self {
+        Self {
+            store: Mutex::new(HashMap::new()),
+        }
+    }
+}
+
+#[async_trait]
+impl Memory for InMemoryBackend {
+    fn name(&self) -> &str {
+        "in-memory"
+    }
+
+    async fn store(
+        &self,
+        key: &str,
+        content: &str,
+        category: MemoryCategory,
+        session_id: Option<&str>,
+    ) -> anyhow::Result<()> {
+        let entry = MemoryEntry {
+            id: uuid::Uuid::new_v4().to_string(),
+            key: key.to_string(),
+            content: content.to_string(),
+            category,
+            timestamp: chrono::Local::now().to_rfc3339(),
+            session_id: session_id.map(|s| s.to_string()),
+            score: None,
+        };
+        self.store
+            .lock()
+            .map_err(|e| anyhow::anyhow!("{e}"))?
+            .insert(key.to_string(), entry);
+        Ok(())
+    }
+
+    async fn recall(
+        &self,
+        query: &str,
+        limit: usize,
+        session_id: Option<&str>,
+    ) -> anyhow::Result<Vec<MemoryEntry>> {
+        let store = self.store.lock().map_err(|e| anyhow::anyhow!("{e}"))?;
+        let query_lower = query.to_lowercase();
+
+        let mut results: Vec<MemoryEntry> = store
+            .values()
+            .filter(|e| e.content.to_lowercase().contains(&query_lower))
+            .filter(|e| match session_id {
+                Some(sid) => e.session_id.as_deref() == Some(sid),
+                None => true,
+            })
+            .cloned()
+            .collect();
+
+        results.truncate(limit);
+        Ok(results)
+    }
+
+    async fn get(&self, key: &str) -> anyhow::Result<Option<MemoryEntry>> {
+        let store = self.store.lock().map_err(|e| anyhow::anyhow!("{e}"))?;
+        Ok(store.get(key).cloned())
+    }
+
+    async fn list(
+        &self,
+        category: Option<&MemoryCategory>,
+        session_id: Option<&str>,
+    ) -> anyhow::Result<Vec<MemoryEntry>> {
+        let store = self.store.lock().map_err(|e| anyhow::anyhow!("{e}"))?;
+        Ok(store
+            .values()
+            .filter(|e| match category {
+                Some(cat) => &e.category == cat,
+                None => true,
+            })
+            .filter(|e| match session_id {
+                Some(sid) => e.session_id.as_deref() == Some(sid),
+                None => true,
+            })
+            .cloned()
+            .collect())
+    }
+
+    async fn forget(&self, key: &str) -> anyhow::Result<bool> {
+        let mut store = self.store.lock().map_err(|e| anyhow::anyhow!("{e}"))?;
+        Ok(store.remove(key).is_some())
+    }
+
+    async fn count(&self) -> anyhow::Result<usize> {
+        let store = self.store.lock().map_err(|e| anyhow::anyhow!("{e}"))?;
+        Ok(store.len())
+    }
+
+    async fn health_check(&self) -> bool {
+        true
+    }
+}
+```
+
+---
+
+## Registration Pattern
+
+All extension traits follow the same wiring pattern:
+
+1. Create your implementation file in the relevant `src/*/` directory.
+2. Register it in the module's factory function (e.g., `default_tools()`, provider match arm).
+3. Add any needed config keys to `src/config/schema.rs`.
+4. Write focused tests for factory wiring and error paths.
+
+See [change-playbooks.md](./change-playbooks.md) for full checklists per extension type.
--- a/third_party/zeroclaw/docs/contributing/label-registry.md
+++ b/third_party/zeroclaw/docs/contributing/label-registry.md
@@ -0,0 +1,213 @@
+# Label Registry
+
+Single reference for every label used on PRs and issues. Labels are grouped by category. Each entry lists the label name, definition, and how it is applied.
+
+Sources consolidated here:
+
+- `.github/labeler.yml` (path-label config for `actions/labeler`)
+- `.github/label-policy.json` (contributor tier thresholds)
+- `docs/contributing/pr-workflow.md` (size, risk, and triage label definitions)
+- `docs/contributing/ci-map.md` (automation behavior and high-risk path heuristics)
+
+Note: The CI was simplified to 4 workflows (`ci.yml`, `release.yml`, `ci-full.yml`, `promote-release.yml`). Workflows that previously automated size, risk, contributor tier, and triage labels (`pr-labeler.yml`, `pr-auto-response.yml`, `pr-check-stale.yml`, and supporting scripts) were removed. Only path labels via `pr-path-labeler.yml` are currently automated.
+
+---
+
+## Path labels
+
+Applied automatically by `pr-path-labeler.yml` using `actions/labeler`. Matches changed files against glob patterns in `.github/labeler.yml`.
+
+### Base scope labels
+
+| Label | Matches |
+|---|---|
+| `docs` | `docs/**`, `**/*.md`, `**/*.mdx`, `LICENSE`, `.markdownlint-cli2.yaml` |
+| `dependencies` | `Cargo.toml`, `Cargo.lock`, `deny.toml`, `.github/dependabot.yml` |
+| `ci` | `.github/**`, `.githooks/**` |
+| `core` | `src/*.rs` |
+| `agent` | `src/agent/**` |
+| `channel` | `src/channels/**` |
+| `gateway` | `src/gateway/**` |
+| `config` | `src/config/**` |
+| `cron` | `src/cron/**` |
+| `daemon` | `src/daemon/**` |
+| `doctor` | `src/doctor/**` |
+| `health` | `src/health/**` |
+| `heartbeat` | `src/heartbeat/**` |
+| `integration` | `src/integrations/**` |
+| `memory` | `src/memory/**` |
+| `security` | `src/security/**` |
+| `runtime` | `src/runtime/**` |
+| `onboard` | `src/onboard/**` |
+| `provider` | `src/providers/**` |
+| `service` | `src/service/**` |
+| `skillforge` | `src/skillforge/**` |
+| `skills` | `src/skills/**` |
+| `tool` | `src/tools/**` |
+| `tunnel` | `src/tunnel/**` |
+| `observability` | `src/observability/**` |
+| `tests` | `tests/**` |
+| `scripts` | `scripts/**` |
+| `dev` | `dev/**` |
+
+### Per-component channel labels
+
+Each channel gets a specific label in addition to the base `channel` label.
+
+| Label | Matches |
+|---|---|
+| `channel:bluesky` | `bluesky.rs` |
+| `channel:clawdtalk` | `clawdtalk.rs` |
+| `channel:cli` | `cli.rs` |
+| `channel:dingtalk` | `dingtalk.rs` |
+| `channel:discord` | `discord.rs`, `discord_history.rs` |
+| `channel:email` | `email_channel.rs`, `gmail_push.rs` |
+| `channel:imessage` | `imessage.rs` |
+| `channel:irc` | `irc.rs` |
+| `channel:lark` | `lark.rs` |
+| `channel:linq` | `linq.rs` |
+| `channel:matrix` | `matrix.rs` |
+| `channel:mattermost` | `mattermost.rs` |
+| `channel:mochat` | `mochat.rs` |
+| `channel:mqtt` | `mqtt.rs` |
+| `channel:nextcloud-talk` | `nextcloud_talk.rs` |
+| `channel:nostr` | `nostr.rs` |
+| `channel:notion` | `notion.rs` |
+| `channel:qq` | `qq.rs` |
+| `channel:reddit` | `reddit.rs` |
+| `channel:signal` | `signal.rs` |
+| `channel:slack` | `slack.rs` |
+| `channel:telegram` | `telegram.rs` |
+| `channel:twitter` | `twitter.rs` |
+| `channel:wati` | `wati.rs` |
+| `channel:webhook` | `webhook.rs` |
+| `channel:wecom` | `wecom.rs` |
+| `channel:whatsapp` | `whatsapp.rs`, `whatsapp_storage.rs`, `whatsapp_web.rs` |
+
+### Per-component provider labels
+
+| Label | Matches |
+|---|---|
+| `provider:anthropic` | `anthropic.rs` |
+| `provider:azure-openai` | `azure_openai.rs` |
+| `provider:bedrock` | `bedrock.rs` |
+| `provider:claude-code` | `claude_code.rs` |
+| `provider:compatible` | `compatible.rs` |
+| `provider:copilot` | `copilot.rs` |
+| `provider:gemini` | `gemini.rs`, `gemini_cli.rs` |
+| `provider:glm` | `glm.rs` |
+| `provider:kilocli` | `kilocli.rs` |
+| `provider:ollama` | `ollama.rs` |
+| `provider:openai` | `openai.rs`, `openai_codex.rs` |
+| `provider:openrouter` | `openrouter.rs` |
+| `provider:telnyx` | `telnyx.rs` |
+
+### Per-group tool labels
+
+Tools are grouped by logical function rather than one label per file.
+
+| Label | Matches |
+|---|---|
+| `tool:browser` | `browser.rs`, `browser_delegate.rs`, `browser_open.rs`, `text_browser.rs`, `screenshot.rs` |
+| `tool:cloud` | `cloud_ops.rs`, `cloud_patterns.rs` |
+| `tool:composio` | `composio.rs` |
+| `tool:cron` | `cron_add.rs`, `cron_list.rs`, `cron_remove.rs`, `cron_run.rs`, `cron_runs.rs`, `cron_update.rs` |
+| `tool:file` | `file_edit.rs`, `file_read.rs`, `file_write.rs`, `glob_search.rs`, `content_search.rs` |
+| `tool:google-workspace` | `google_workspace.rs` |
+| `tool:mcp` | `mcp_client.rs`, `mcp_deferred.rs`, `mcp_protocol.rs`, `mcp_tool.rs`, `mcp_transport.rs` |
+| `tool:memory` | `memory_forget.rs`, `memory_recall.rs`, `memory_store.rs` |
+| `tool:microsoft365` | `microsoft365/**` |
+| `tool:security` | `security_ops.rs`, `verifiable_intent.rs` |
+| `tool:shell` | `shell.rs`, `node_tool.rs`, `cli_discovery.rs` |
+| `tool:sop` | `sop_advance.rs`, `sop_approve.rs`, `sop_execute.rs`, `sop_list.rs`, `sop_status.rs` |
+| `tool:web` | `web_fetch.rs`, `web_search_tool.rs`, `web_search_provider_routing.rs`, `http_request.rs` |
+
+---
+
+## Size labels
+
+Defined in `pr-workflow.md` §6.1. Based on effective changed line count, normalized for docs-only and lockfile-heavy PRs.
+
+| Label | Threshold |
+|---|---|
+| `size: XS` | <= 80 lines |
+| `size: S` | <= 250 lines |
+| `size: M` | <= 500 lines |
+| `size: L` | <= 1000 lines |
+| `size: XL` | > 1000 lines |
+
+**Applied by:** manual. The workflows that previously computed size labels (`pr-labeler.yml` and supporting scripts) were removed during CI simplification.
+
+---
+
+## Risk labels
+
+Defined in `pr-workflow.md` §13.2 and `ci-map.md`. Based on a heuristic combining touched paths and change size.
+
+| Label | Meaning |
+|---|---|
+| `risk: low` | No high-risk paths touched, small change |
+| `risk: medium` | Behavioral `src/**` changes without boundary/security impact |
+| `risk: high` | Touches high-risk paths (see below) or large security-adjacent change |
+| `risk: manual` | Maintainer override that freezes automated risk recalculation |
+
+High-risk paths: `src/security/**`, `src/runtime/**`, `src/gateway/**`, `src/tools/**`, `.github/workflows/**`.
+
+The boundary between low and medium is not formally defined beyond "no high-risk paths."
+
+**Applied by:** manual. Previously automated via `pr-labeler.yml`; removed during CI simplification.
+
+---
+
+## Contributor tier labels
+
+Defined in `.github/label-policy.json`. Based on the author's merged PR count queried from the GitHub API.
+
+| Label | Minimum merged PRs |
+|---|---|
+| `trusted contributor` | 5 |
+| `experienced contributor` | 10 |
+| `principal contributor` | 20 |
+| `distinguished contributor` | 50 |
+
+**Applied by:** manual. Previously automated via `pr-labeler.yml` and `pr-auto-response.yml`; removed during CI simplification.
+
+---
+
+## Response and triage labels
+
+Defined in `pr-workflow.md` §8. Applied manually.
+
+| Label | Purpose | Applied by |
+|---|---|---|
+| `r:needs-repro` | Incomplete bug report; request deterministic repro | Manual |
+| `r:support` | Usage/help item better handled outside bug backlog | Manual |
+| `invalid` | Not a valid bug/feature request | Manual |
+| `duplicate` | Duplicate of existing issue | Manual |
+| `stale-candidate` | Dormant PR/issue; candidate for closing | Manual |
+| `superseded` | Replaced by a newer PR | Manual |
+| `no-stale` | Exempt from stale automation; accepted but blocked work | Manual |
+
+**Automation:** none currently. The workflows that handled label-driven issue closing (`pr-auto-response.yml`) and stale detection (`pr-check-stale.yml`) were removed during CI simplification.
+
+---
+
+## Implementation status
+
+| Category | Count | Automated | Workflow |
+|---|---|---|---|
+| Path (base scope) | 27 | Yes | `pr-path-labeler.yml` |
+| Path (per-component) | 52 | Yes | `pr-path-labeler.yml` |
+| Size | 5 | No | Manual |
+| Risk | 4 | No | Manual |
+| Contributor tier | 4 | No | Manual |
+| Response/triage | 7 | No | Manual |
+| **Total** | **99** | | |
+
+---
+
+## Maintenance
+
+- **Owner:** maintainers responsible for label policy and PR triage automation.
+- **Update trigger:** new channels, providers, or tools added to the source tree; label policy changes; triage workflow changes.
+- **Source of truth:** this document consolidates definitions from the four source files listed at the top. When definitions conflict, update the source file first, then sync this registry.
--- a/third_party/zeroclaw/docs/contributing/langgraph-integration.md
+++ b/third_party/zeroclaw/docs/contributing/langgraph-integration.md
@@ -0,0 +1,239 @@
+# LangGraph Integration Guide
+
+This guide explains how to use the `zeroclaw-tools` Python package for consistent tool calling with any OpenAI-compatible LLM provider.
+
+## Background
+
+Some LLM providers, particularly Chinese models like GLM-5 (Zhipu AI), have inconsistent tool calling behavior when using text-based tool invocation. ZeroClaw's Rust core uses structured tool calling via the OpenAI API format, but some models respond better to a different approach.
+
+LangGraph provides a stateful graph execution engine that guarantees consistent tool calling behavior regardless of the underlying model's native capabilities.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      Your Application                        │
+├─────────────────────────────────────────────────────────────┤
+│                   zeroclaw-tools Agent                       │
+│                                                              │
+│   ┌─────────────────────────────────────────────────────┐   │
+│   │              LangGraph StateGraph                    │   │
+│   │                                                      │   │
+│   │    ┌────────────┐         ┌────────────┐            │   │
+│   │    │   Agent    │ ──────▶ │   Tools    │            │   │
+│   │    │   Node     │ ◀────── │   Node     │            │   │
+│   │    └────────────┘         └────────────┘            │   │
+│   │         │                       │                    │   │
+│   │         ▼                       ▼                    │   │
+│   │    [Continue?]            [Execute Tool]             │   │
+│   │         │                       │                    │   │
+│   │    Yes │ No                Result│                    │   │
+│   │         ▼                       ▼                    │   │
+│   │      [END]              [Back to Agent]              │   │
+│   │                                                      │   │
+│   └─────────────────────────────────────────────────────┘   │
+│                                                              │
+├─────────────────────────────────────────────────────────────┤
+│            OpenAI-Compatible LLM Provider                    │
+│   (Z.AI, OpenRouter, Groq, DeepSeek, Ollama, etc.)          │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install zeroclaw-tools
+```
+
+### Basic Usage
+
+```python
+import asyncio
+from zeroclaw_tools import create_agent, shell, file_read, file_write
+from langchain_core.messages import HumanMessage
+
+async def main():
+    agent = create_agent(
+        tools=[shell, file_read, file_write],
+        model="glm-5",
+        api_key="your-api-key",
+        base_url="https://api.z.ai/api/coding/paas/v4"
+    )
+    
+    result = await agent.ainvoke({
+        "messages": [HumanMessage(content="Read /etc/hostname and tell me the machine name")]
+    })
+    
+    print(result["messages"][-1].content)
+
+asyncio.run(main())
+```
+
+## Available Tools
+
+### Core Tools
+
+| Tool | Description |
+|------|-------------|
+| `shell` | Execute shell commands |
+| `file_read` | Read file contents |
+| `file_write` | Write content to files |
+
+### Extended Tools
+
+| Tool | Description |
+|------|-------------|
+| `web_search` | Search the web (requires `BRAVE_API_KEY`) |
+| `http_request` | Make HTTP requests |
+| `memory_store` | Store data in persistent memory |
+| `memory_recall` | Recall stored data |
+
+## Custom Tools
+
+Create your own tools with the `@tool` decorator:
+
+```python
+from zeroclaw_tools import tool, create_agent
+
+@tool
+def get_weather(city: str) -> str:
+    """Get the current weather for a city."""
+    # Your implementation
+    return f"Weather in {city}: Sunny, 25°C"
+
+@tool
+def query_database(sql: str) -> str:
+    """Execute a SQL query and return results."""
+    # Your implementation
+    return "Query returned 5 rows"
+
+agent = create_agent(
+    tools=[get_weather, query_database],
+    model="glm-5",
+    api_key="your-key"
+)
+```
+
+## Provider Configuration
+
+### Z.AI / GLM-5
+
+```python
+agent = create_agent(
+    model="glm-5",
+    api_key="your-zhipu-key",
+    base_url="https://api.z.ai/api/coding/paas/v4"
+)
+```
+
+### OpenRouter
+
+```python
+agent = create_agent(
+    model="anthropic/claude-sonnet-4-6",
+    api_key="your-openrouter-key",
+    base_url="https://openrouter.ai/api/v1"
+)
+```
+
+### Groq
+
+```python
+agent = create_agent(
+    model="llama-3.3-70b-versatile",
+    api_key="your-groq-key",
+    base_url="https://api.groq.com/openai/v1"
+)
+```
+
+### Ollama (Local)
+
+```python
+agent = create_agent(
+    model="llama3.2",
+    base_url="http://localhost:11434/v1"
+)
+```
+
+## Discord Bot Integration
+
+```python
+import os
+from zeroclaw_tools.integrations import DiscordBot
+
+bot = DiscordBot(
+    token=os.environ["DISCORD_TOKEN"],
+    guild_id=123456789,  # Your Discord server ID
+    allowed_users=["123456789"],  # User IDs that can use the bot
+    api_key=os.environ["API_KEY"],
+    model="glm-5"
+)
+
+bot.run()
+```
+
+## CLI Usage
+
+```bash
+# Set environment variables
+export API_KEY="your-key"
+export BRAVE_API_KEY="your-brave-key"  # Optional, for web search
+
+# Single message
+zeroclaw-tools "What is the current date?"
+
+# Interactive mode
+zeroclaw-tools -i
+```
+
+## Comparison with Rust ZeroClaw
+
+| Aspect | Rust ZeroClaw | zeroclaw-tools |
+|--------|---------------|-----------------|
+| **Performance** | Ultra-fast (~10ms startup) | Python startup (~500ms) |
+| **Memory** | <5 MB | ~50 MB |
+| **Binary size** | ~3.4 MB | pip package |
+| **Tool consistency** | Model-dependent | LangGraph guarantees |
+| **Extensibility** | Rust traits | Python decorators |
+| **Ecosystem** | Rust crates | PyPI packages |
+
+**When to use Rust ZeroClaw:**
+- Production edge deployments
+- Resource-constrained environments (Raspberry Pi, etc.)
+- Maximum performance requirements
+
+**When to use zeroclaw-tools:**
+- Models with inconsistent native tool calling
+- Python-centric development
+- Rapid prototyping
+- Integration with Python ML ecosystem
+
+## Troubleshooting
+
+### "API key required" error
+
+Set the `API_KEY` environment variable or pass `api_key` to `create_agent()`.
+
+### Tool calls not executing
+
+Ensure your model supports function calling. Some older models may not support tools.
+
+### Rate limiting
+
+Add delays between calls or implement your own rate limiting:
+
+```python
+import asyncio
+
+for message in messages:
+    result = await agent.ainvoke({"messages": [message]})
+    await asyncio.sleep(1)  # Rate limit
+```
+
+## Related Projects
+
+- [rs-graph-llm](https://github.com/a-agmon/rs-graph-llm) - Rust LangGraph alternative
+- [langchain-rust](https://github.com/Abraxas-365/langchain-rust) - LangChain for Rust
+- [llm-chain](https://github.com/sobelio/llm-chain) - LLM chains in Rust
--- a/third_party/zeroclaw/docs/contributing/pr-discipline.md
+++ b/third_party/zeroclaw/docs/contributing/pr-discipline.md
@@ -0,0 +1,86 @@
+# PR Discipline
+
+Rules for pull request quality, attribution, privacy, and handoff in ZeroClaw.
+
+## Privacy / Sensitive Data (Required)
+
+Treat privacy and neutrality as merge gates, not best-effort guidelines.
+
+- Never commit personal or sensitive data in code, docs, tests, fixtures, snapshots, logs, examples, or commit messages.
+- Prohibited data includes (non-exhaustive): real names, personal emails, phone numbers, addresses, access tokens, API keys, credentials, IDs, and private URLs.
+- Use neutral project-scoped placeholders (e.g., `user_a`, `test_user`, `project_bot`, `example.com`) instead of real identity data.
+- Test names/messages/fixtures must be impersonal and system-focused; avoid first-person or identity-specific language.
+- If identity-like context is unavoidable, use ZeroClaw-scoped roles/labels only (e.g., `ZeroClawAgent`, `ZeroClawOperator`, `zeroclaw_user`).
+- Recommended identity-safe naming palette:
+    - actor labels: `ZeroClawAgent`, `ZeroClawOperator`, `ZeroClawMaintainer`, `zeroclaw_user`
+    - service/runtime labels: `zeroclaw_bot`, `zeroclaw_service`, `zeroclaw_runtime`, `zeroclaw_node`
+    - environment labels: `zeroclaw_project`, `zeroclaw_workspace`, `zeroclaw_channel`
+- If reproducing external incidents, redact and anonymize all payloads before committing.
+- Before push, review `git diff --cached` specifically for accidental sensitive strings and identity leakage.
+
+## Superseded-PR Attribution (Required)
+
+When a PR supersedes another contributor's PR and carries forward substantive code or design decisions, preserve authorship explicitly.
+
+- In the integrating commit message, add one `Co-authored-by: Name <email>` trailer per superseded contributor whose work is materially incorporated.
+- Use a GitHub-recognized email (`<login@users.noreply.github.com>` or the contributor's verified commit email).
+- Keep trailers on their own lines after a blank line at commit-message end; never encode them as escaped `\\n` text.
+- In the PR body, list superseded PR links and briefly state what was incorporated from each.
+- If no actual code/design was incorporated (only inspiration), do not use `Co-authored-by`; give credit in PR notes instead.
+
+## Superseded-PR Templates
+
+### PR Title/Body Template
+
+- Recommended title format: `feat(<scope>): unify and supersede #<pr_a>, #<pr_b> [and #<pr_n>]`
+- In the PR body, include:
+
+```md
+## Supersedes
+- #<pr_a> by @<author_a>
+- #<pr_b> by @<author_b>
+
+## Integrated Scope
+- From #<pr_a>: <what was materially incorporated>
+- From #<pr_b>: <what was materially incorporated>
+
+## Attribution
+- Co-authored-by trailers added for materially incorporated contributors: Yes/No
+- If No, explain why
+
+## Non-goals
+- <explicitly list what was not carried over>
+
+## Risk and Rollback
+- Risk: <summary>
+- Rollback: <revert commit/PR strategy>
+```
+
+### Commit Message Template
+
+```text
+feat(<scope>): unify and supersede #<pr_a>, #<pr_b> [and #<pr_n>]
+
+<one-paragraph summary of integrated outcome>
+
+Supersedes:
+- #<pr_a> by @<author_a>
+- #<pr_b> by @<author_b>
+
+Integrated scope:
+- <subsystem_or_feature_a>: from #<pr_x>
+- <subsystem_or_feature_b>: from #<pr_y>
+
+Co-authored-by: <Name A> <login_a@users.noreply.github.com>
+Co-authored-by: <Name B> <login_b@users.noreply.github.com>
+```
+
+## Handoff Template (Agent -> Agent / Maintainer)
+
+When handing off work, include:
+
+1. What changed
+2. What did not change
+3. Validation run and results
+4. Remaining risks / unknowns
+5. Next recommended action
--- a/third_party/zeroclaw/docs/contributing/pr-workflow.md
+++ b/third_party/zeroclaw/docs/contributing/pr-workflow.md
@@ -0,0 +1,366 @@
+# ZeroClaw PR Workflow (High-Volume Collaboration)
+
+This document defines how ZeroClaw handles high PR volume while maintaining:
+
+- High performance
+- High efficiency
+- High stability
+- High extensibility
+- High sustainability
+- High security
+
+Related references:
+
+- [`docs/README.md`](../README.md) for documentation taxonomy and navigation.
+- [`ci-map.md`](./ci-map.md) for per-workflow ownership, triggers, and triage flow.
+- [`reviewer-playbook.md`](./reviewer-playbook.md) for day-to-day reviewer execution.
+
+## 0. Summary
+
+- **Purpose:** provide a deterministic, risk-based PR operating model for high-throughput collaboration.
+- **Audience:** contributors, maintainers, and agent-assisted reviewers.
+- **Scope:** repository settings, PR lifecycle, readiness contracts, risk routing, queue discipline, and recovery protocol.
+- **Non-goals:** replacing branch protection configuration or CI workflow source files as implementation authority.
+
+---
+
+## 1. Fast Path by PR Situation
+
+Use this section to route quickly before full deep review.
+
+### 1.1 Intake is incomplete
+
+1. Request template completion and missing evidence in one checklist comment.
+2. Stop deep review until intake blockers are resolved.
+
+Go to:
+
+- [Section 5.1](#51-definition-of-ready-dor-before-requesting-review)
+
+### 1.2 `CI Required Gate` failing
+
+1. Route failure through CI map and fix deterministic gates first.
+2. Re-evaluate risk only after CI returns coherent signal.
+
+Go to:
+
+- [ci-map.md](./ci-map.md)
+- [Section 4.2](#42-step-b-validation)
+
+### 1.3 High-risk path touched
+
+1. Escalate to deep review lane.
+2. Require explicit rollback, failure-mode evidence, and security boundary checks.
+
+Go to:
+
+- [Section 9](#9-security-and-stability-rules)
+- [reviewer-playbook.md](./reviewer-playbook.md)
+
+### 1.4 PR is superseded or duplicate
+
+1. Require explicit supersede linkage and queue cleanup.
+2. Close superseded PR after maintainer confirmation.
+
+Go to:
+
+- [Section 8.2](#82-backlog-pressure-controls)
+
+---
+
+## 2. Governance Goals and Control Loop
+
+### 2.1 Governance goals
+
+1. Keep merge throughput predictable under heavy PR load.
+2. Keep CI signal quality high (fast feedback, low false positives).
+3. Keep security review explicit for risky surfaces.
+4. Keep changes easy to reason about and easy to revert.
+5. Keep repository artifacts free of personal/sensitive data leakage.
+
+### 2.2 Governance design logic (control loop)
+
+This workflow is intentionally layered to reduce reviewer load while keeping accountability clear:
+
+1. **Intake classification:** path/size/risk/module labels route the PR to the right review depth.
+2. **Deterministic validation:** merge gate depends on reproducible checks, not subjective comments.
+3. **Risk-based review depth:** high-risk paths trigger deep review; low-risk paths stay fast.
+4. **Rollback-first merge contract:** every merge path includes concrete recovery steps.
+
+Automation assists with triage and guardrails, but final merge accountability remains with human maintainers and PR authors.
+
+---
+
+## 3. Required Repository Settings
+
+Maintain these branch protection rules on `master`:
+
+- Require status checks before merge.
+- Require check `CI Required Gate`.
+- Require pull request reviews before merge.
+- Require CODEOWNERS review for protected paths.
+- For `.github/workflows/**`, require owner approval via `CI Required Gate` (`WORKFLOW_OWNER_LOGINS`) and keep branch/ruleset bypass limited to org owners.
+- Default workflow-owner allowlist is configured via the `WORKFLOW_OWNER_LOGINS` repository variable (see CODEOWNERS for current maintainers).
+- Dismiss stale approvals when new commits are pushed.
+- Restrict force-push on protected branches.
+- All contributor PRs target `master` directly.
+
+---
+
+## 4. PR Lifecycle Runbook
+
+### 4.1 Step A: Intake
+
+- Contributor opens PR with full `.github/pull_request_template.md`.
+- `PR Labeler` applies scope/path labels + size labels + risk labels + module labels (for example `channel:telegram`, `provider:kimi`, `tool:shell`) and contributor tiers by merged PR count (`trusted` >=5, `experienced` >=10, `principal` >=20, `distinguished` >=50), while de-duplicating less-specific scope labels when a more specific module label is present.
+- For all module prefixes, module labels are compacted to reduce noise: one specific module keeps `prefix:component`, but multiple specifics collapse to the base scope label `prefix`.
+- Label ordering is priority-first: `risk:*` -> `size:*` -> contributor tier -> module/path labels.
+- Maintainers can run `PR Labeler` manually (`workflow_dispatch`) in `audit` mode for drift visibility or `repair` mode to normalize managed label metadata repository-wide.
+- Hovering a label in GitHub shows its auto-managed description (rule/threshold summary).
+- Managed label colors are arranged by display order to create a smooth gradient across long label rows.
+- `PR Auto Responder` posts first-time guidance, handles label-driven routing for low-signal items, and auto-applies issue contributor tiers using the same thresholds as `PR Labeler` (`trusted` >=5, `experienced` >=10, `principal` >=20, `distinguished` >=50).
+
+### 4.2 Step B: Validation
+
+- `CI Required Gate` is the merge gate.
+- Docs-only PRs use fast-path and skip heavy Rust jobs.
+- Non-doc PRs must pass lint, tests, and release build smoke check.
+- Rust-impacting PRs use the same required gate set as `master` pushes (no PR build-only shortcut).
+
+### 4.3 Step C: Review
+
+- Reviewers prioritize by risk and size labels.
+- Security-sensitive paths (`src/security`, `src/runtime`, `src/gateway`, and CI workflows) require maintainer attention.
+- Large PRs (`size: L`/`size: XL`) should be split unless strongly justified.
+
+### 4.4 Step D: Merge
+
+- Prefer **squash merge** to keep history compact.
+- PR title should follow Conventional Commit style.
+- Merge only when rollback path is documented.
+
+---
+
+## 5. PR Readiness Contracts (DoR / DoD)
+
+### 5.1 Definition of Ready (DoR) before requesting review
+
+- PR template fully completed.
+- Scope boundary is explicit (what changed / what did not).
+- Validation evidence attached (not just "CI will check").
+- Security and rollback fields completed for risky paths.
+- Privacy/data-hygiene checks are completed and test language is neutral/project-scoped.
+- If identity-like wording appears in tests/examples, it is normalized to ZeroClaw/project-native labels.
+
+### 5.2 Definition of Done (DoD) merge-ready
+
+- `CI Required Gate` is green.
+- Required reviewers approved (including CODEOWNERS paths).
+- Risk class labels match touched paths.
+- Migration/compatibility impact is documented.
+- Rollback path is concrete and fast.
+
+---
+
+## 6. PR Size and Batching Policy
+
+### 6.1 Size tiers
+
+- `size: XS` <= 80 changed lines
+- `size: S` <= 250 changed lines
+- `size: M` <= 500 changed lines
+- `size: L` <= 1000 changed lines
+- `size: XL` > 1000 changed lines
+
+### 6.2 Policy
+
+- Target `XS/S/M` by default.
+- `L/XL` PRs need explicit justification and tighter test evidence.
+- If a large feature is unavoidable, split into stacked PRs.
+
+### 6.3 Automation behavior
+
+- `PR Labeler` applies `size:*` labels from effective changed lines.
+- Docs-only/lockfile-heavy PRs are normalized to avoid size inflation.
+
+---
+
+## 7. AI/Agent Contribution Policy
+
+AI-assisted PRs are welcome, and review can also be agent-assisted.
+
+### 7.1 Required
+
+1. Clear PR summary with scope boundary.
+2. Explicit test/validation evidence.
+3. Security impact and rollback notes for risky changes.
+
+### 7.2 Recommended
+
+1. Brief tool/workflow notes when automation materially influenced the change.
+2. Optional prompt/plan snippets for reproducibility.
+
+We do **not** require contributors to quantify AI-vs-human line ownership.
+
+### 7.3 Review emphasis for AI-heavy PRs
+
+- Contract compatibility.
+- Security boundaries.
+- Error handling and fallback behavior.
+- Performance and memory regressions.
+
+---
+
+## 8. Review SLA and Queue Discipline
+
+- First maintainer triage target: within 48 hours.
+- If PR is blocked, maintainer leaves one actionable checklist.
+- `stale` automation is used to keep queue healthy; maintainers can apply `no-stale` when needed.
+- `pr-hygiene` automation checks open PRs every 12 hours and posts a nudge when a PR has no new commits for 48+ hours and is either behind `master` or missing/failing `CI Required Gate` on the head commit.
+
+### 8.1 Queue budget controls
+
+- Use a review queue budget: limit concurrent deep-review PRs per maintainer and keep the rest in triage state.
+- For stacked work, require explicit `Depends on #...` so review order is deterministic.
+
+### 8.2 Backlog pressure controls
+
+- If a new PR replaces an older open PR, require `Supersedes #...` and close the older one after maintainer confirmation.
+- Mark dormant/redundant PRs with `stale-candidate` or `superseded` to reduce duplicate review effort.
+
+### 8.3 Issue triage discipline
+
+- `r:needs-repro` for incomplete bug reports (request deterministic repro before deep triage).
+- `r:support` for usage/help items better handled outside bug backlog.
+- `invalid` / `duplicate` labels trigger **issue-only** closing automation with guidance.
+
+### 8.4 Automation side-effect guards
+
+- `PR Auto Responder` deduplicates label-based comments to avoid spam.
+- Automated close routes are limited to issues, not PRs.
+- Maintainers can freeze automated risk recalculation with `risk: manual` when context demands human override.
+
+---
+
+## 9. Security and Stability Rules
+
+Changes in these areas require stricter review and stronger test evidence:
+
+- `src/security/**`
+- Runtime process management.
+- Gateway ingress/authentication behavior (`src/gateway/**`).
+- Filesystem access boundaries.
+- Network/authentication behavior.
+- GitHub workflows and release pipeline.
+- Tools with execution capability (`src/tools/**`).
+
+### 9.1 Minimum for risky PRs
+
+- Threat/risk statement.
+- Mitigation notes.
+- Rollback steps.
+
+### 9.2 Recommended for high-risk PRs
+
+- Include a focused test proving boundary behavior.
+- Include one explicit failure-mode scenario and expected degradation.
+
+For agent-assisted contributions, reviewers should also verify the author demonstrates understanding of runtime behavior and blast radius.
+
+---
+
+## 10. Failure Recovery Protocol
+
+If a merged PR causes regressions:
+
+1. Revert PR immediately on `master`.
+2. Open a follow-up issue with root-cause analysis.
+3. Re-introduce fix only with regression tests.
+
+Prefer fast restore of service quality over delayed perfect fixes.
+
+---
+
+## 11. Maintainer Merge Checklist
+
+- Scope is focused and understandable.
+- CI gate is green.
+- Docs-quality checks are green when docs changed.
+- Security impact fields are complete.
+- Privacy/data-hygiene fields are complete and evidence is redacted/anonymized.
+- Agent workflow notes are sufficient for reproducibility (if automation was used).
+- Rollback plan is explicit.
+- Commit title follows Conventional Commits.
+
+---
+
+## 12. Agent Review Operating Model
+
+To keep review quality stable under high PR volume, use a two-lane review model.
+
+### 12.1 Lane A: fast triage (agent-friendly)
+
+- Confirm PR template completeness.
+- Confirm CI gate signal (`CI Required Gate`).
+- Confirm risk class via labels and touched paths.
+- Confirm rollback statement exists.
+- Confirm privacy/data-hygiene section and neutral wording requirements are satisfied.
+- Confirm any required identity-like wording uses ZeroClaw/project-native terminology.
+
+### 12.2 Lane B: deep review (risk-based)
+
+Required for high-risk changes (security/runtime/gateway/CI):
+
+- Validate threat model assumptions.
+- Validate failure mode and degradation behavior.
+- Validate backward compatibility and migration impact.
+- Validate observability/logging impact.
+
+---
+
+## 13. Queue Priority and Label Discipline
+
+### 13.1 Triage order recommendation
+
+1. `size: XS`/`size: S` + bug/security fixes.
+2. `size: M` focused changes.
+3. `size: L`/`size: XL` split requests or staged review.
+
+### 13.2 Label discipline
+
+- Path labels identify subsystem ownership quickly.
+- Size labels drive batching strategy.
+- Risk labels drive review depth (`risk: low/medium/high`).
+- Module labels (`<module>: <component>`) improve reviewer routing for integration-specific changes and future newly-added modules.
+- `risk: manual` allows maintainers to preserve a human risk judgment when automation lacks context.
+- `no-stale` is reserved for accepted-but-blocked work.
+
+---
+
+## 14. Agent Handoff Contract
+
+When one agent hands off to another (or to a maintainer), include:
+
+1. Scope boundary (what changed / what did not).
+2. Validation evidence.
+3. Open risks and unknowns.
+4. Suggested next action.
+
+This keeps context loss low and avoids repeated deep dives.
+
+---
+
+## 15. Related Docs
+
+- [README.md](../README.md) — documentation taxonomy and navigation.
+- [ci-map.md](./ci-map.md) — CI workflow ownership and triage map.
+- [reviewer-playbook.md](./reviewer-playbook.md) — reviewer execution model.
+- [actions-source-policy.md](./actions-source-policy.md) — action source allowlist policy.
+
+---
+
+## 16. Maintenance Notes
+
+- **Owner:** maintainers responsible for collaboration governance and merge quality.
+- **Update trigger:** branch protection changes, label/risk policy changes, queue governance updates, or agent review process changes.
+- **Last reviewed:** 2026-02-18.
--- a/third_party/zeroclaw/docs/contributing/release-process.md
+++ b/third_party/zeroclaw/docs/contributing/release-process.md
@@ -0,0 +1,170 @@
+# ZeroClaw Release Process
+
+This runbook defines the maintainers' standard release flow.
+
+Last verified: **February 21, 2026**.
+
+## Release Goals
+
+- Keep releases predictable and repeatable.
+- Publish only from code already in `master`.
+- Verify multi-target artifacts before publish.
+- Keep release cadence regular even with high PR volume.
+
+## Standard Cadence
+
+- Patch/minor releases: weekly or bi-weekly.
+- Emergency security fixes: out-of-band.
+- Never wait for very large commit batches to accumulate.
+
+## Workflow Contract
+
+Release automation lives in:
+
+- `.github/workflows/pub-release.yml`
+- `.github/workflows/pub-homebrew-core.yml` (manual Homebrew formula PR, bot-owned)
+- `.github/workflows/pub-scoop.yml` (manual Scoop bucket manifest update)
+- `.github/workflows/pub-aur.yml` (manual AUR PKGBUILD push)
+
+Modes:
+
+- Tag push `v*`: publish mode.
+- Manual dispatch: verification-only or publish mode.
+- Weekly schedule: verification-only mode.
+
+Publish-mode guardrails:
+
+- Tag must match semver-like format `vX.Y.Z[-suffix]`.
+- Tag must already exist on origin.
+- Tag commit must be reachable from `origin/master`.
+- Matching GHCR image tag (`ghcr.io/<owner>/<repo>:<tag>`) must be available before GitHub Release publish completes.
+- Artifacts are verified before publish.
+
+## Maintainer Procedure
+
+### 1) Preflight on `master`
+
+1. Ensure required checks are green on latest `master`.
+2. Confirm no high-priority incidents or known regressions are open.
+3. Confirm installer and Docker workflows are healthy on recent `master` commits.
+
+### 2) Run verification build (no publish)
+
+Run `Pub Release` manually:
+
+- `publish_release`: `false`
+- `release_ref`: `master`
+
+Expected outcome:
+
+- Full target matrix builds successfully.
+- `verify-artifacts` confirms all expected archives exist.
+- No GitHub Release is published.
+
+### 3) Cut release tag
+
+From a clean local checkout synced to `origin/master`:
+
+```bash
+scripts/release/cut_release_tag.sh vX.Y.Z --push
+```
+
+This script enforces:
+
+- clean working tree
+- `HEAD == origin/master`
+- non-duplicate tag
+- semver-like tag format
+
+### 4) Monitor publish run
+
+After tag push, monitor:
+
+1. `Pub Release` publish mode
+2. `Pub Docker Img` publish job
+
+Expected publish outputs:
+
+- release archives
+- `SHA256SUMS`
+- `CycloneDX` and `SPDX` SBOMs
+- cosign signatures/certificates
+- GitHub Release notes + assets
+
+### 5) Post-release validation
+
+1. Verify GitHub Release assets are downloadable.
+2. Verify GHCR tags for the released version (`vX.Y.Z`) and release commit SHA tag (`sha-<12>`).
+3. Verify install paths that rely on release assets (for example bootstrap binary download).
+
+### 6) Publish Homebrew Core formula (bot-owned)
+
+Run `Pub Homebrew Core` manually:
+
+- `release_tag`: `vX.Y.Z`
+- `dry_run`: `true` first, then `false`
+
+Required repository settings for non-dry-run:
+
+- secret: `HOMEBREW_CORE_BOT_TOKEN` (token from a dedicated bot account, not a personal maintainer account)
+- variable: `HOMEBREW_CORE_BOT_FORK_REPO` (for example `zeroclaw-release-bot/homebrew-core`)
+- optional variable: `HOMEBREW_CORE_BOT_EMAIL`
+
+Workflow guardrails:
+
+- release tag must match `Cargo.toml` version
+- formula source URL and SHA256 are updated from the tagged tarball
+- formula license is normalized to `Apache-2.0 OR MIT`
+- PR is opened from the bot fork into `Homebrew/homebrew-core:master`
+
+### 7) Publish Scoop manifest (Windows)
+
+Run `Pub Scoop Manifest` manually:
+
+- `release_tag`: `vX.Y.Z`
+- `dry_run`: `true` first, then `false`
+
+Required repository settings for non-dry-run:
+
+- secret: `SCOOP_BUCKET_TOKEN` (PAT with push access to the bucket repo)
+- variable: `SCOOP_BUCKET_REPO` (for example `zeroclaw-labs/scoop-zeroclaw`)
+
+Workflow guardrails:
+
+- release tag must be `vX.Y.Z` format
+- Windows binary SHA256 extracted from `SHA256SUMS` release asset
+- manifest pushed to `bucket/zeroclaw.json` in the Scoop bucket repo
+
+### 8) Publish AUR package (Arch Linux)
+
+Run `Pub AUR Package` manually:
+
+- `release_tag`: `vX.Y.Z`
+- `dry_run`: `true` first, then `false`
+
+Required repository settings for non-dry-run:
+
+- secret: `AUR_SSH_KEY` (SSH private key registered with AUR)
+
+Workflow guardrails:
+
+- release tag must be `vX.Y.Z` format
+- source tarball SHA256 computed from the tagged release
+- PKGBUILD and .SRCINFO pushed to AUR `zeroclaw` package
+
+## Emergency / Recovery Path
+
+If tag-push release fails after artifacts are validated:
+
+1. Fix workflow or packaging issue on `master`.
+2. Re-run manual `Pub Release` in publish mode with:
+   - `publish_release=true`
+   - `release_tag=<existing tag>`
+   - `release_ref` is automatically pinned to `release_tag` in publish mode
+3. Re-validate released assets.
+
+## Operational Notes
+
+- Keep release changes small and reversible.
+- Prefer one release issue/checklist per version so handoff is clear.
+- Avoid publishing from ad-hoc feature branches.
--- a/third_party/zeroclaw/docs/contributing/reviewer-playbook.md
+++ b/third_party/zeroclaw/docs/contributing/reviewer-playbook.md
@@ -0,0 +1,191 @@
+# Reviewer Playbook
+
+This playbook is the operational companion to [`pr-workflow.md`](./pr-workflow.md).
+For broader documentation navigation, use [`docs/README.md`](../README.md).
+
+## 0. Summary
+
+- **Purpose:** define a deterministic reviewer operating model that keeps review quality high under heavy PR volume.
+- **Audience:** maintainers, reviewers, and agent-assisted reviewers.
+- **Scope:** intake triage, risk-to-depth routing, deep-review checks, automation overrides, and handoff protocol.
+- **Non-goals:** replacing PR policy authority in `CONTRIBUTING.md` or workflow authority in CI files.
+
+---
+
+## 1. Fast Path by Review Situation
+
+Use this section to route quickly before reading full detail.
+
+### 1.1 Intake fails in first 5 minutes
+
+1. Leave one actionable checklist comment.
+2. Stop deep review until intake blockers are fixed.
+
+Go to:
+
+- [Section 3.1](#31-five-minute-intake-triage)
+
+### 1.2 Risk is high or unclear
+
+1. Treat as `risk: high` by default.
+2. Require deep review and explicit rollback evidence.
+
+Go to:
+
+- [Section 2](#2-review-depth-decision-matrix)
+- [Section 3.3](#33-deep-review-checklist-high-risk)
+
+### 1.3 Automation output is wrong/noisy
+
+1. Apply override protocol (`risk: manual`, dedupe comments/labels).
+2. Continue review with explicit rationale.
+
+Go to:
+
+- [Section 5](#5-automation-override-protocol)
+
+### 1.4 Need review handoff
+
+1. Handoff with scope/risk/validation/blockers.
+2. Assign concrete next action.
+
+Go to:
+
+- [Section 6](#6-handoff-protocol)
+
+---
+
+## 2. Review Depth Decision Matrix
+
+| Risk label | Typical touched paths | Minimum review depth | Required evidence |
+|---|---|---|---|
+| `risk: low` | docs/tests/chore, isolated non-runtime changes | 1 reviewer + CI gate | coherent local validation + no behavior ambiguity |
+| `risk: medium` | `src/providers/**`, `src/channels/**`, `src/memory/**`, `src/config/**` | 1 subsystem-aware reviewer + behavior verification | focused scenario proof + explicit side effects |
+| `risk: high` | `src/security/**`, `src/runtime/**`, `src/gateway/**`, `src/tools/**`, `.github/workflows/**` | fast triage + deep review + rollback readiness | security/failure-mode checks + rollback clarity |
+
+When uncertain, treat as `risk: high`.
+
+If automated risk labeling is contextually wrong, maintainers can apply `risk: manual` and set the final `risk:*` label explicitly.
+
+---
+
+## 3. Standard Review Workflow
+
+### 3.1 Five-minute intake triage
+
+For every new PR:
+
+1. Confirm template completeness (`summary`, `validation`, `security`, `rollback`).
+2. Confirm labels are present and plausible:
+   - `size:*`, `risk:*`
+   - scope labels (for example `provider`, `channel`, `security`)
+   - module-scoped labels (`channel:*`, `provider:*`, `tool:*`)
+   - contributor tier labels when applicable
+3. Confirm CI signal status (`CI Required Gate`).
+4. Confirm scope is one concern (reject mixed mega-PRs unless justified).
+5. Confirm privacy/data-hygiene and neutral test wording requirements are satisfied.
+
+If any intake requirement fails, leave one actionable checklist comment instead of deep review.
+
+### 3.2 Fast-lane checklist (all PRs)
+
+- Scope boundary is explicit and believable.
+- Validation commands are present and results are coherent.
+- User-facing behavior changes are documented.
+- Author demonstrates understanding of behavior and blast radius (especially for agent-assisted PRs).
+- Rollback path is concrete (not just “revert”).
+- Compatibility/migration impacts are clear.
+- No personal/sensitive data leakage in diff artifacts; examples/tests remain neutral and project-scoped.
+- If identity-like wording exists, it uses ZeroClaw/project-native roles (not personal or real-world identities).
+- Naming and architecture boundaries follow project contracts (`AGENTS.md`, `CONTRIBUTING.md`).
+
+### 3.3 Deep review checklist (high risk)
+
+For high-risk PRs, verify at least one concrete example in each category:
+
+- **Security boundaries:** deny-by-default behavior preserved, no accidental scope broadening.
+- **Failure modes:** error handling is explicit and degrades safely.
+- **Contract stability:** CLI/config/API compatibility preserved or migration documented.
+- **Observability:** failures are diagnosable without leaking secrets.
+- **Rollback safety:** revert path and blast radius are clear.
+
+### 3.4 Review comment outcome style
+
+Prefer checklist-style comments with one explicit outcome:
+
+- **Ready to merge** (say why).
+- **Needs author action** (ordered blocker list).
+- **Needs deeper security/runtime review** (state exact risk and requested evidence).
+
+Avoid vague comments that create avoidable back-and-forth latency.
+
+---
+
+## 4. Issue Triage and Backlog Governance
+
+### 4.1 Issue triage label playbook
+
+Use labels to keep backlog actionable:
+
+- `r:needs-repro` for incomplete bug reports.
+- `r:support` for usage/support questions better routed outside bug backlog.
+- `duplicate` / `invalid` for non-actionable duplicates/noise.
+- `no-stale` for accepted work waiting on external blockers.
+- Request redaction when logs/payloads include personal identifiers or sensitive data.
+
+### 4.2 PR backlog pruning protocol
+
+When review demand exceeds capacity, apply this order:
+
+1. Keep active bug/security PRs (`size: XS/S`) at the top of queue.
+2. Ask overlapping PRs to consolidate; close older ones as `superseded` after acknowledgement.
+3. Mark dormant PRs as `stale-candidate` before stale closure window starts.
+4. Require rebase + fresh validation before reopening stale/superseded technical work.
+
+---
+
+## 5. Automation Override Protocol
+
+Use this when automation output creates review side effects:
+
+1. **Incorrect risk label:** add `risk: manual`, then set intended `risk:*` label.
+2. **Incorrect auto-close on issue triage:** reopen issue, remove route label, leave one clarifying comment.
+3. **Label spam/noise:** keep one canonical maintainer comment and remove redundant route labels.
+4. **Ambiguous PR scope:** request split before deep review.
+
+---
+
+## 6. Handoff Protocol
+
+If handing off review to another maintainer/agent, include:
+
+1. Scope summary.
+2. Current risk class and rationale.
+3. What has been validated already.
+4. Open blockers.
+5. Suggested next action.
+
+---
+
+## 7. Weekly Queue Hygiene
+
+- Review stale queue and apply `no-stale` only to accepted-but-blocked work.
+- Prioritize `size: XS/S` bug/security PRs first.
+- Convert recurring support issues into docs updates and auto-response guidance.
+
+---
+
+## 8. Related Docs
+
+- [README.md](../README.md) — documentation taxonomy and navigation.
+- [pr-workflow.md](./pr-workflow.md) — governance workflow and merge contract.
+- [ci-map.md](./ci-map.md) — CI ownership and triage map.
+- [actions-source-policy.md](./actions-source-policy.md) — action source allowlist policy.
+
+---
+
+## 9. Maintenance Notes
+
+- **Owner:** maintainers responsible for review quality and queue throughput.
+- **Update trigger:** PR policy changes, risk-routing model changes, or automation override behavior changes.
+- **Last reviewed:** 2026-02-18.
--- a/third_party/zeroclaw/docs/contributing/testing-telegram.md
+++ b/third_party/zeroclaw/docs/contributing/testing-telegram.md
@@ -0,0 +1,303 @@
+# 🧪 Test Execution Guide
+
+## Quick Reference
+
+```bash
+# Full automated test suite (~2 min)
+./tests/telegram/test_telegram_integration.sh
+
+# Quick smoke test (~10 sec)
+./tests/telegram/quick_test.sh
+
+# Just compile and unit test (~30 sec)
+cargo test telegram --lib
+```
+
+## 📝 What Was Created For You
+
+### 1. **test_telegram_integration.sh** (Main Test Suite)
+   - **20+ automated tests** covering all fixes
+   - **6 test phases**: Code quality, build, config, health, features, manual
+   - **Colored output** with pass/fail indicators
+   - **Detailed summary** at the end
+
+   ```bash
+   ./tests/telegram/test_telegram_integration.sh
+   ```
+
+### 2. **quick_test.sh** (Fast Validation)
+   - **4 essential tests** for quick feedback
+   - **<10 second** execution time
+   - Perfect for **pre-commit** checks
+
+   ```bash
+   ./tests/telegram/quick_test.sh
+   ```
+
+### 3. **generate_test_messages.py** (Test Helper)
+   - Generates test messages of various lengths
+   - Tests message splitting functionality
+   - 8 different message types
+
+   ```bash
+   # Generate a long message (>4096 chars)
+   python3 tests/telegram/generate_test_messages.py long
+
+   # Show all message types
+   python3 tests/telegram/generate_test_messages.py all
+   ```
+
+### 4. **TESTING_TELEGRAM.md** (Complete Guide)
+   - Comprehensive testing documentation
+   - Troubleshooting guide
+   - Performance benchmarks
+   - CI/CD integration examples
+
+## 🚀 Step-by-Step: First Run
+
+### Step 1: Run Automated Tests
+
+```bash
+cd /Users/abdzsam/zeroclaw
+
+# Make scripts executable (already done)
+chmod +x tests/telegram/test_telegram_integration.sh tests/telegram/quick_test.sh
+
+# Run the full test suite
+./tests/telegram/test_telegram_integration.sh
+```
+
+**Expected output:**
+```
+⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡
+
+███████╗███████╗██████╗  ██████╗  ██████╗██╗      █████╗ ██╗    ██╗
+...
+
+🧪 TELEGRAM INTEGRATION TEST SUITE 🧪
+
+Phase 1: Code Quality Tests
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Test 1: Compiling test suite
+✓ PASS: Test suite compiles successfully
+
+Test 2: Running Telegram unit tests
+✓ PASS: All Telegram unit tests passed (24 tests)
+...
+
+Test Summary
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Total Tests:   20
+Passed:        20
+Failed:        0
+Warnings:      0
+
+Pass Rate:     100%
+
+✓ ALL AUTOMATED TESTS PASSED! 🎉
+```
+
+### Step 2: Configure Telegram (if not done)
+
+```bash
+# Guided setup
+zeroclaw onboard
+
+# Or channels-only setup
+zeroclaw onboard --channels-only
+```
+
+When prompted:
+1. Select **Telegram** channel
+2. Enter your **bot token** from @BotFather
+3. Enter your **Telegram user ID** or username
+
+### Step 3: Verify Health
+
+```bash
+zeroclaw channel doctor
+```
+
+**Expected output:**
+```
+🩺 ZeroClaw Channel Doctor
+
+  ✅ Telegram  healthy
+
+Summary: 1 healthy, 0 unhealthy, 0 timed out
+```
+
+### Step 4: Manual Testing
+
+#### Test 1: Basic Message
+
+```bash
+# Terminal 1: Start the channel
+zeroclaw channel start
+```
+
+**In Telegram:**
+- Find your bot
+- Send: `Hello bot!`
+- **Verify**: Bot responds within 3 seconds
+
+#### Test 2: Long Message (Split Test)
+
+```bash
+# Generate a long message
+python3 tests/telegram/generate_test_messages.py long
+```
+
+- **Copy the output**
+- **Paste into Telegram** to your bot
+- **Verify**:
+  - Message is split into 2+ chunks
+  - First chunk ends with `(continues...)`
+  - Middle chunks have `(continued)` and `(continues...)`
+  - Last chunk starts with `(continued)`
+  - All chunks arrive in order
+
+#### Test 3: Word Boundary Splitting
+
+```bash
+python3 tests/telegram/generate_test_messages.py word
+```
+
+- Send to bot
+- **Verify**: Splits at word boundaries (not mid-word)
+
+## 🎯 Test Results Checklist
+
+After running all tests, verify:
+
+### Automated Tests
+- [ ] ✅ All 20 automated tests passed
+- [ ] ✅ Build completed successfully
+- [ ] ✅ Binary size <10MB
+- [ ] ✅ Health check completes in <5s
+- [ ] ✅ No clippy warnings
+
+### Manual Tests
+- [ ] ✅ Bot responds to basic messages
+- [ ] ✅ Long messages split correctly
+- [ ] ✅ Continuation markers appear
+- [ ] ✅ Word boundaries respected
+- [ ] ✅ Allowlist blocks unauthorized users
+- [ ] ✅ No errors in logs
+
+### Performance
+- [ ] ✅ Response time <3 seconds
+- [ ] ✅ Memory usage <10MB
+- [ ] ✅ No message loss
+- [ ] ✅ Rate limiting works (100ms delays)
+
+## 🐛 Troubleshooting
+
+### Issue: Tests fail to compile
+
+```bash
+# Clean build
+cargo clean
+cargo build --release
+
+# Update dependencies
+cargo update
+```
+
+### Issue: "Bot token not configured"
+
+```bash
+# Check config
+cat ~/.zeroclaw/config.toml | grep -A 5 telegram
+
+# Reconfigure
+zeroclaw onboard --channels-only
+```
+
+### Issue: Health check fails
+
+```bash
+# Test bot token directly
+curl "https://api.telegram.org/bot<YOUR_TOKEN>/getMe"
+
+# Should return: {"ok":true,"result":{...}}
+```
+
+### Issue: Bot doesn't respond
+
+```bash
+# Enable debug logging
+RUST_LOG=debug zeroclaw channel start
+
+# Look for:
+# - "Telegram channel listening for messages..."
+# - "ignoring message from unauthorized user" (if allowlist issue)
+# - Any error messages
+```
+
+## 📊 Performance Benchmarks
+
+After all fixes, you should see:
+
+| Metric | Target | Command |
+|--------|--------|---------|
+| Unit test pass | 24/24 | `cargo test telegram --lib` |
+| Build time | <30s | `time cargo build --release` |
+| Binary size | ~3-4MB | `ls -lh target/release/zeroclaw` |
+| Health check | <5s | `time zeroclaw channel doctor` |
+| First response | <3s | Manual test in Telegram |
+| Message split | <50ms | Check debug logs |
+| Memory usage | <10MB | `ps aux \| grep zeroclaw` |
+
+## 🔄 CI/CD Integration
+
+Add to your workflow:
+
+```bash
+# Pre-commit hook
+#!/bin/bash
+./tests/telegram/quick_test.sh
+
+# CI pipeline
+./tests/telegram/test_telegram_integration.sh
+```
+
+## 📚 Next Steps
+
+1. **Run the tests:**
+   ```bash
+   ./tests/telegram/test_telegram_integration.sh
+   ```
+
+2. **Fix any failures** using the troubleshooting guide
+
+3. **Complete manual tests** using the checklist
+
+4. **Deploy to production** when all tests pass
+
+5. **Monitor logs** for any issues:
+   ```bash
+   zeroclaw daemon
+   # or
+   RUST_LOG=info zeroclaw channel start
+   ```
+
+## 🎉 Success!
+
+If all tests pass:
+- ✅ Message splitting works (4096 char limit)
+- ✅ Health check has 5s timeout
+- ✅ Empty chat_id is handled safely
+- ✅ All 24 unit tests pass
+- ✅ Code is production-ready
+
+**Your Telegram integration is ready to go!** 🚀
+
+---
+
+## 📞 Support
+
+- Issues: https://github.com/zeroclaw-labs/zeroclaw/issues
+- Docs: [testing-telegram.md](../../tests/telegram/testing-telegram.md)
+- Help: `zeroclaw --help`
--- a/third_party/zeroclaw/docs/contributing/testing.md
+++ b/third_party/zeroclaw/docs/contributing/testing.md
@@ -0,0 +1,149 @@
+# Testing Guide
+
+ZeroClaw uses a five-level testing taxonomy with filesystem-based organization.
+
+## Testing Taxonomy
+
+| Level | What it tests | External boundaries | Directory |
+|-------|--------------|-------------------|-----------|
+| **Unit** | Single function/struct | Everything mocked | `#[cfg(test)]` blocks in `src/**/*.rs` or separate `src/**/tests.rs` files |
+| **Component** | One subsystem within its own boundary | Subsystem real, everything else mocked | `tests/component/` |
+| **Integration** | Multiple internal components wired together | Real internals, external APIs mocked | `tests/integration/` |
+| **System** | Full request→response across ALL internal boundaries | Only external APIs mocked | `tests/system/` |
+| **Live** | Full stack with real external services | Nothing mocked, `#[ignore]` | `tests/live/` |
+
+## Directory Structure
+
+| Directory | Level | Description | Run command |
+|-----------|-------|-------------|-------------|
+| `src/**/*.rs` | Unit | Co-located `#[cfg(test)]` blocks or separate `tests.rs` files alongside source | `cargo test --lib` |
+| `tests/component/` | Component | One subsystem, real impl, mocked boundaries | `cargo test --test component` |
+| `tests/integration/` | Integration | Multiple components wired together | `cargo test --test integration` |
+| `tests/system/` | System | Full channel→agent→channel flow | `cargo test --test system` |
+| `tests/live/` | Live | Real external services, `#[ignore]` | `cargo test --test live -- --ignored` |
+| `tests/manual/` | — | Human-driven test scripts (shell, Python) | Run directly |
+| `tests/support/` | — | Shared mock infrastructure (not a test binary) | — |
+| `tests/fixtures/` | — | Test data files (JSON traces, media) | — |
+
+## How to Run Tests
+
+```bash
+# Run all tests (unit + component + integration + system)
+cargo test
+
+# Run only unit tests
+cargo test --lib
+
+# Run component tests
+cargo test --test component
+
+# Run integration tests
+cargo test --test integration
+
+# Run system tests
+cargo test --test system
+
+# Run live tests (requires API credentials)
+cargo test --test live -- --ignored
+
+# Filter within a level
+cargo test --test integration agent
+
+# Full CI validation
+./dev/ci.sh all
+
+# Level-specific CI commands
+./dev/ci.sh test-component
+./dev/ci.sh test-integration
+./dev/ci.sh test-system
+```
+
+## How to Add a New Test
+
+1. **Testing one subsystem in isolation?** → `tests/component/`
+2. **Testing multiple components together?** → `tests/integration/`
+3. **Testing full message flow?** → `tests/system/`
+4. **Requires real API keys?** → `tests/live/` with `#[ignore]`
+
+After creating a test file, add it to the appropriate `mod.rs` and use shared infrastructure from `tests/support/`.
+
+## Shared Infrastructure (`tests/support/`)
+
+All test binaries include `mod support;` making shared mocks available via `crate::support::*`.
+
+| Module | Contents |
+|--------|----------|
+| `mock_provider.rs` | `MockProvider` (FIFO scripted), `RecordingProvider` (captures requests), `TraceLlmProvider` (JSON fixture replay) |
+| `mock_tools.rs` | `EchoTool`, `CountingTool`, `FailingTool`, `RecordingTool` |
+| `mock_channel.rs` | `TestChannel` (captures sends, records typing events) |
+| `helpers.rs` | `make_memory()`, `make_observer()`, `build_agent()`, `text_response()`, `tool_response()`, `StaticMemoryLoader` |
+| `trace.rs` | `LlmTrace`, `TraceTurn`, `TraceStep` types + `LlmTrace::from_file()` |
+| `assertions.rs` | `verify_expects()` for declarative trace assertion |
+
+### Usage
+
+```rust
+use crate::support::{MockProvider, EchoTool, CountingTool};
+use crate::support::helpers::{build_agent, text_response, tool_response};
+```
+
+## JSON Trace Fixtures
+
+Trace fixtures are canned LLM response scripts stored as JSON files in `tests/fixtures/traces/`. They replace inline mock setup with declarative conversation scripts.
+
+### How it works
+
+1. `TraceLlmProvider` loads a fixture and implements the `Provider` trait
+2. Each `provider.chat()` call returns the next step from the fixture in FIFO order
+3. Real tools execute normally (e.g., `EchoTool` processes arguments)
+4. After all turns, `verify_expects()` checks declarative assertions
+5. If the agent calls the provider more times than there are steps, the test fails
+
+### Fixture format
+
+```json
+{
+  "model_name": "test-name",
+  "turns": [
+    {
+      "user_input": "User message",
+      "steps": [
+        {
+          "response": {
+            "type": "text",
+            "content": "LLM response",
+            "input_tokens": 20,
+            "output_tokens": 10
+          }
+        }
+      ]
+    }
+  ],
+  "expects": {
+    "response_contains": ["expected text"],
+    "tools_used": ["echo"],
+    "max_tool_calls": 1
+  }
+}
+```
+
+**Response types**: `"text"` (plain text) or `"tool_calls"` (LLM requests tool execution).
+
+**Expects fields**: `response_contains`, `response_not_contains`, `tools_used`, `tools_not_used`, `max_tool_calls`, `all_tools_succeeded`, `response_matches` (regex).
+
+## Live Test Conventions
+
+- All live tests must be `#[ignore]`
+- Use `env::var("ZEROCLAW_TEST_*")` for credentials
+- Run with `cargo test --test live -- --ignored --nocapture`
+
+## Manual Tests (`tests/manual/`)
+
+Scripts for human-driven testing that can't be automated via `cargo test`:
+
+| Directory/File | What it does |
+|---|---|
+| `manual/telegram/` | Telegram integration test suite, smoke tests, message generator |
+| `manual/test_dockerignore.sh` | Validates `.dockerignore` excludes sensitive paths |
+
+For Telegram-specific testing details, see [testing-telegram.md](./testing-telegram.md).
--- a/third_party/zeroclaw/docs/hardware/README.md
+++ b/third_party/zeroclaw/docs/hardware/README.md
@@ -0,0 +1,19 @@
+# Hardware & Peripherals Docs
+
+For board integration, firmware flow, and peripheral architecture.
+
+ZeroClaw's hardware subsystem enables direct control of microcontrollers and peripherals via the `Peripheral` trait. Each board exposes tools for GPIO, ADC, and sensor operations, allowing agent-driven hardware interaction on boards like STM32 Nucleo, Raspberry Pi, and ESP32. See [hardware-peripherals-design.md](hardware-peripherals-design.md) for the full architecture.
+
+## Entry Points
+
+- Architecture and peripheral model: [hardware-peripherals-design.md](hardware-peripherals-design.md)
+- Add a new board/tool: [../contributing/adding-boards-and-tools.md](../contributing/adding-boards-and-tools.md)
+- Nucleo setup: [nucleo-setup.md](nucleo-setup.md)
+- Arduino Uno R4 WiFi setup: [arduino-uno-q-setup.md](arduino-uno-q-setup.md)
+
+## Datasheets
+
+- Datasheet index: [datasheets](datasheets)
+- STM32 Nucleo-F401RE: [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md)
+- Arduino Uno: [datasheets/arduino-uno.md](datasheets/arduino-uno.md)
+- ESP32: [datasheets/esp32.md](datasheets/esp32.md)
--- a/third_party/zeroclaw/docs/hardware/android-setup.md
+++ b/third_party/zeroclaw/docs/hardware/android-setup.md
@@ -0,0 +1,100 @@
+# Android Setup
+
+ZeroClaw provides prebuilt binaries for Android devices.
+
+## Supported Architectures
+
+| Target | Android Version | Devices |
+|--------|-----------------|---------|
+| `armv7-linux-androideabi` | Android 4.1+ (API 16+) | Older 32-bit phones (Galaxy S3, etc.) |
+| `aarch64-linux-android` | Android 5.0+ (API 21+) | Modern 64-bit phones |
+
+## Installation via Termux
+
+The easiest way to run ZeroClaw on Android is via [Termux](https://termux.dev/).
+
+### 1. Install Termux
+
+Download from [F-Droid](https://f-droid.org/packages/com.termux/) (recommended) or GitHub releases.
+
+> ⚠️ **Note:** The Play Store version is outdated and unsupported.
+
+### 2. Download ZeroClaw
+
+```bash
+# Check your architecture
+uname -m
+# aarch64 = 64-bit, armv7l/armv8l = 32-bit
+
+# Download the appropriate binary
+# For 64-bit (aarch64):
+curl -LO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-aarch64-linux-android.tar.gz
+tar xzf zeroclaw-aarch64-linux-android.tar.gz
+
+# For 32-bit (armv7):
+curl -LO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-armv7-linux-androideabi.tar.gz
+tar xzf zeroclaw-armv7-linux-androideabi.tar.gz
+```
+
+### 3. Install and Run
+
+```bash
+chmod +x zeroclaw
+mv zeroclaw $PREFIX/bin/
+
+# Verify installation
+zeroclaw --version
+
+# Run setup
+zeroclaw onboard
+```
+
+## Direct Installation via ADB
+
+For advanced users who want to run ZeroClaw outside Termux:
+
+```bash
+# From your computer with ADB
+adb push zeroclaw /data/local/tmp/
+adb shell chmod +x /data/local/tmp/zeroclaw
+adb shell /data/local/tmp/zeroclaw --version
+```
+
+> ⚠️ Running outside Termux requires a rooted device or specific permissions for full functionality.
+
+## Limitations on Android
+
+- **No systemd:** Use Termux's `termux-services` for daemon mode
+- **Storage access:** Requires Termux storage permissions (`termux-setup-storage`)
+- **Network:** Some features may require Android VPN permission for local binding
+
+## Building from Source
+
+To build for Android yourself:
+
+```bash
+# Install Android NDK
+# Add targets
+rustup target add armv7-linux-androideabi aarch64-linux-android
+
+# Set NDK path
+export ANDROID_NDK_HOME=/path/to/ndk
+export PATH=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH
+
+# Build
+cargo build --release --target armv7-linux-androideabi
+cargo build --release --target aarch64-linux-android
+```
+
+## Troubleshooting
+
+### "Permission denied"
+```bash
+chmod +x zeroclaw
+```
+
+### "not found" or linker errors
+Make sure you downloaded the correct architecture for your device.
+
+### Old Android (4.x)
+Use the `armv7-linux-androideabi` build with API level 16+.
--- a/third_party/zeroclaw/docs/hardware/arduino-uno-q-setup.md
+++ b/third_party/zeroclaw/docs/hardware/arduino-uno-q-setup.md
@@ -0,0 +1,217 @@
+# ZeroClaw on Arduino Uno Q — Step-by-Step Guide
+
+Run ZeroClaw on the Arduino Uno Q's Linux side. Telegram works over WiFi; GPIO control uses the Bridge (requires a minimal App Lab app).
+
+---
+
+## What's Included (No Code Changes Needed)
+
+ZeroClaw includes everything needed for Arduino Uno Q. **Clone the repo and follow this guide — no patches or custom code required.**
+
+| Component | Location | Purpose |
+|-----------|----------|---------|
+| Bridge app | `firmware/uno-q-bridge/` | MCU sketch + Python socket server (port 9999) for GPIO |
+| Bridge tools | `src/peripherals/uno_q_bridge.rs` | `gpio_read` / `gpio_write` tools that talk to the Bridge over TCP |
+| Setup command | `src/peripherals/uno_q_setup.rs` | `zeroclaw peripheral setup-uno-q` deploys the Bridge via scp + arduino-app-cli |
+| Config schema | `board = "arduino-uno-q"`, `transport = "bridge"` | Supported in `config.toml` |
+
+Build with `--features hardware` to include Uno Q support.
+
+---
+
+## Prerequisites
+
+- Arduino Uno Q with WiFi configured
+- Arduino App Lab installed on your Mac (for initial setup and deployment)
+- API key for LLM (OpenRouter, etc.)
+
+---
+
+## Phase 1: Initial Uno Q Setup (One-Time)
+
+### 1.1 Configure Uno Q via App Lab
+
+1. Download [Arduino App Lab](https://docs.arduino.cc/software/app-lab/) (tar.gz on Linux).
+2. Connect Uno Q via USB, power it on.
+3. Open App Lab, connect to the board.
+4. Follow the setup wizard:
+   - Set username and password (for SSH)
+   - Configure WiFi (SSID, password)
+   - Apply any firmware updates
+5. Note the IP address shown (e.g. `arduino@192.168.1.42`) or find it later via `ip addr show` in App Lab's terminal.
+
+### 1.2 Verify SSH Access
+
+```bash
+ssh arduino@<UNO_Q_IP>
+# Enter the password you set
+```
+
+---
+
+## Phase 2: Install ZeroClaw on Uno Q
+
+### Option A: Build on the Device (Simpler, ~20–40 min)
+
+```bash
+# SSH into Uno Q
+ssh arduino@<UNO_Q_IP>
+
+# Install Rust
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+source ~/.cargo/env
+
+# Install build deps (Debian)
+sudo apt-get update
+sudo apt-get install -y pkg-config libssl-dev
+
+# Clone zeroclaw (or scp your project)
+git clone https://github.com/zeroclaw-labs/zeroclaw.git
+cd zeroclaw
+
+# Build (takes ~15–30 min on Uno Q)
+cargo build --release --features hardware
+
+# Install
+sudo cp target/release/zeroclaw /usr/local/bin/
+```
+
+### Option B: Cross-Compile on Mac (Faster)
+
+```bash
+# On your Mac — add aarch64 target
+rustup target add aarch64-unknown-linux-gnu
+
+# Install cross-compiler (macOS; required for linking)
+brew tap messense/macos-cross-toolchains
+brew install aarch64-unknown-linux-gnu
+
+# Build
+CC_aarch64_unknown_linux_gnu=aarch64-unknown-linux-gnu-gcc cargo build --release --target aarch64-unknown-linux-gnu --features hardware
+
+# Copy to Uno Q
+scp target/aarch64-unknown-linux-gnu/release/zeroclaw arduino@<UNO_Q_IP>:~/
+ssh arduino@<UNO_Q_IP> "sudo mv ~/zeroclaw /usr/local/bin/"
+```
+
+If cross-compile fails, use Option A and build on the device.
+
+---
+
+## Phase 3: Configure ZeroClaw
+
+### 3.1 Run Onboard (or Create Config Manually)
+
+```bash
+ssh arduino@<UNO_Q_IP>
+
+# Quick config
+zeroclaw onboard --api-key YOUR_OPENROUTER_KEY --provider openrouter
+
+# Or create config manually
+mkdir -p ~/.zeroclaw/workspace
+nano ~/.zeroclaw/config.toml
+```
+
+### 3.2 Minimal config.toml
+
+```toml
+api_key = "YOUR_OPENROUTER_API_KEY"
+default_provider = "openrouter"
+default_model = "anthropic/claude-sonnet-4-6"
+
+[peripherals]
+enabled = false
+# GPIO via Bridge requires Phase 4
+
+[channels_config.telegram]
+bot_token = "YOUR_TELEGRAM_BOT_TOKEN"
+allowed_users = ["*"]
+
+[gateway]
+host = "127.0.0.1"
+port = 42617
+allow_public_bind = false
+
+[agent]
+compact_context = true
+```
+
+---
+
+## Phase 4: Run ZeroClaw Daemon
+
+```bash
+ssh arduino@<UNO_Q_IP>
+
+# Run daemon (Telegram polling works over WiFi)
+zeroclaw daemon --host 127.0.0.1 --port 42617
+```
+
+**At this point:** Telegram chat works. Send messages to your bot — ZeroClaw responds. No GPIO yet.
+
+---
+
+## Phase 5: GPIO via Bridge (ZeroClaw Handles It)
+
+ZeroClaw includes the Bridge app and setup command.
+
+### 5.1 Deploy Bridge App
+
+**From your Mac** (with zeroclaw repo):
+```bash
+zeroclaw peripheral setup-uno-q --host 192.168.0.48
+```
+
+**From the Uno Q** (SSH'd in):
+```bash
+zeroclaw peripheral setup-uno-q
+```
+
+This copies the Bridge app to `~/ArduinoApps/uno-q-bridge` and starts it.
+
+### 5.2 Add to config.toml
+
+```toml
+[peripherals]
+enabled = true
+
+[[peripherals.boards]]
+board = "arduino-uno-q"
+transport = "bridge"
+```
+
+### 5.3 Run ZeroClaw
+
+```bash
+zeroclaw daemon --host 127.0.0.1 --port 42617
+```
+
+Now when you message your Telegram bot *"Turn on the LED"* or *"Set pin 13 high"*, ZeroClaw uses `gpio_write` via the Bridge.
+
+---
+
+## Summary: Commands Start to End
+
+| Step | Command |
+|------|---------|
+| 1 | Configure Uno Q in App Lab (WiFi, SSH) |
+| 2 | `ssh arduino@<IP>` |
+| 3 | `curl -sSf https://sh.rustup.rs \| sh -s -- -y && source ~/.cargo/env` |
+| 4 | `sudo apt-get install -y pkg-config libssl-dev` |
+| 5 | `git clone https://github.com/zeroclaw-labs/zeroclaw.git && cd zeroclaw` |
+| 6 | `cargo build --release --features hardware` |
+| 7 | `zeroclaw onboard --api-key KEY --provider openrouter` |
+| 8 | Edit `~/.zeroclaw/config.toml` (add Telegram bot_token) |
+| 9 | `zeroclaw daemon --host 127.0.0.1 --port 42617` |
+| 10 | Message your Telegram bot — it responds |
+
+---
+
+## Troubleshooting
+
+- **"command not found: zeroclaw"** — Use full path: `/usr/local/bin/zeroclaw` or ensure `~/.cargo/bin` is in PATH.
+- **Telegram not responding** — Check bot_token, allowed_users, and that the Uno Q has internet (WiFi).
+- **Out of memory** — Keep features minimal (`--features hardware` for Uno Q); consider `compact_context = true`.
+- **GPIO commands ignored** — Ensure Bridge app is running (`zeroclaw peripheral setup-uno-q` deploys and starts it). Config must have `board = "arduino-uno-q"` and `transport = "bridge"`.
+- **LLM provider (GLM/Zhipu)** — Use `default_provider = "glm"` or `"zhipu"` with `GLM_API_KEY` in env or config. ZeroClaw uses the correct v4 endpoint.
--- a/third_party/zeroclaw/docs/hardware/datasheets/arduino-uno.md
+++ b/third_party/zeroclaw/docs/hardware/datasheets/arduino-uno.md
@@ -0,0 +1,37 @@
+# Arduino Uno
+
+## Pin Aliases
+
+| alias       | pin |
+|-------------|-----|
+| red_led     | 13  |
+| builtin_led | 13  |
+| user_led    | 13  |
+
+## Overview
+
+Arduino Uno is a microcontroller board based on the ATmega328P. It has 14 digital I/O pins (0–13) and 6 analog inputs (A0–A5).
+
+## Digital Pins
+
+- **Pins 0–13:** Digital I/O. Can be INPUT or OUTPUT.
+- **Pin 13:** Built-in LED (onboard). Connect LED to GND or use for output.
+- **Pins 0–1:** Also used for Serial (RX/TX). Avoid if using Serial.
+
+## GPIO
+
+- `digitalWrite(pin, HIGH)` or `digitalWrite(pin, LOW)` for output.
+- `digitalRead(pin)` for input (returns 0 or 1).
+- Pin numbers in ZeroClaw protocol: 0–13.
+
+## Serial
+
+- UART on pins 0 (RX) and 1 (TX).
+- USB via ATmega16U2 or CH340 (clones).
+- Baud rate: 115200 for ZeroClaw firmware.
+
+## ZeroClaw Tools
+
+- `gpio_read`: Read pin value (0 or 1).
+- `gpio_write`: Set pin high (1) or low (0).
+- `arduino_upload`: Agent generates full Arduino sketch code; ZeroClaw compiles and uploads it via arduino-cli. Use for "make a heart", custom patterns — agent writes the code, no manual editing. Pin 13 = built-in LED.
--- a/third_party/zeroclaw/docs/hardware/datasheets/esp32.md
+++ b/third_party/zeroclaw/docs/hardware/datasheets/esp32.md
@@ -0,0 +1,22 @@
+# ESP32 GPIO Reference
+
+## Pin Aliases
+
+| alias       | pin |
+|-------------|-----|
+| builtin_led | 2   |
+| red_led     | 2   |
+
+## Common pins (ESP32 / ESP32-C3)
+
+- **GPIO 2**: Built-in LED on many dev boards (output)
+- **GPIO 13**: General-purpose output
+- **GPIO 21/20**: Often used for UART0 TX/RX (avoid if using serial)
+
+## Protocol
+
+ZeroClaw host sends JSON over serial (115200 baud):
+- `gpio_read`: `{"id":"1","cmd":"gpio_read","args":{"pin":13}}`
+- `gpio_write`: `{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}`
+
+Response: `{"id":"1","ok":true,"result":"0"}` or `{"id":"1","ok":true,"result":"done"}`
--- a/third_party/zeroclaw/docs/hardware/datasheets/nucleo-f401re.md
+++ b/third_party/zeroclaw/docs/hardware/datasheets/nucleo-f401re.md
@@ -0,0 +1,16 @@
+# Nucleo-F401RE GPIO
+
+## Pin Aliases
+
+| alias       | pin |
+|-------------|-----|
+| red_led     | 13  |
+| user_led    | 13  |
+| ld2         | 13  |
+| builtin_led | 13  |
+
+## GPIO
+
+Pin 13: User LED (LD2)
+- Output, active high
+- PA5 on STM32F401
--- a/third_party/zeroclaw/docs/hardware/hardware-peripherals-design.md
+++ b/third_party/zeroclaw/docs/hardware/hardware-peripherals-design.md
@@ -0,0 +1,324 @@
+# Hardware Peripherals Design — ZeroClaw
+
+ZeroClaw enables microcontrollers (MCUs) and Single Board Computers (SBCs) to **dynamically interpret natural language commands**, generate hardware-specific code, and execute peripheral interactions in real-time.
+
+## 1. Vision
+
+**Goal:** ZeroClaw acts as a hardware-aware AI agent that:
+- Receives natural language triggers (e.g. "Move X arm", "Turn on LED") via channels (WhatsApp, Telegram)
+- Fetches accurate hardware documentation (datasheets, register maps)
+- Synthesizes Rust code/logic using an LLM (Gemini, local open-source models)
+- Executes the logic to manipulate peripherals (GPIO, I2C, SPI)
+- Persists optimized code for future reuse
+
+**Mental model:** ZeroClaw = brain that understands hardware. Peripherals = arms and legs it controls.
+
+## 2. Two Modes of Operation
+
+### Mode 1: Edge-Native (Standalone)
+
+**Target:** Wi-Fi-enabled boards (ESP32, Raspberry Pi).
+
+ZeroClaw runs **directly on the device**. The board spins up a gRPC/nanoRPC server and communicates with peripherals locally.
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  ZeroClaw on ESP32 / Raspberry Pi (Edge-Native)                             │
+│                                                                             │
+│  ┌─────────────┐    ┌──────────────┐    ┌─────────────────────────────────┐ │
+│  │ Channels    │───►│ Agent Loop   │───►│ RAG: datasheets, register maps  │ │
+│  │ WhatsApp    │    │ (LLM calls)  │    │ → LLM context                    │ │
+│  │ Telegram    │    └──────┬───────┘    └─────────────────────────────────┘ │
+│  └─────────────┘           │                                                 │
+│                            ▼                                                 │
+│  ┌─────────────────────────────────────────────────────────────────────────┐│
+│  │ Code synthesis → Wasm / dynamic exec → GPIO / I2C / SPI → persist       ││
+│  └─────────────────────────────────────────────────────────────────────────┘│
+│                                                                             │
+│  gRPC/nanoRPC server ◄──► Peripherals (GPIO, I2C, SPI, sensors, actuators)  │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+**Workflow:**
+1. User sends WhatsApp: *"Turn on LED on pin 13"*
+2. ZeroClaw fetches board-specific docs (e.g. ESP32 GPIO mapping)
+3. LLM synthesizes Rust code
+4. Code runs in a sandbox (Wasm or dynamic linking)
+5. GPIO is toggled; result returned to user
+6. Optimized code is persisted for future "Turn on LED" requests
+
+**All happens on-device.** No host required.
+
+### Mode 2: Host-Mediated (Development / Debugging)
+
+**Target:** Hardware connected via USB / J-Link / Aardvark to a host (macOS, Linux).
+
+ZeroClaw runs on the **host** and maintains a hardware-aware link to the target. Used for development, introspection, and flashing.
+
+```
+┌─────────────────────┐                    ┌──────────────────────────────────┐
+│  ZeroClaw on Mac    │   USB / J-Link /   │  STM32 Nucleo-F401RE              │
+│                     │   Aardvark         │  (or other MCU)                    │
+│  - Channels         │ ◄────────────────► │  - Memory map                     │
+│  - LLM              │                    │  - Peripherals (GPIO, ADC, I2C)    │
+│  - Hardware probe   │   VID/PID          │  - Flash / RAM                     │
+│  - Flash / debug    │   discovery        │                                    │
+└─────────────────────┘                    └──────────────────────────────────┘
+```
+
+**Workflow:**
+1. User sends Telegram: *"What are the readable memory addresses on this USB device?"*
+2. ZeroClaw identifies connected hardware (VID/PID, architecture)
+3. Performs memory mapping; suggests available address spaces
+4. Returns result to user
+
+**Or:**
+1. User: *"Flash this firmware to the Nucleo"*
+2. ZeroClaw writes/flashes via OpenOCD or probe-rs
+3. Confirms success
+
+**Or:**
+1. ZeroClaw auto-discovers: *"STM32 Nucleo on /dev/ttyACM0, ARM Cortex-M4"*
+2. Suggests: *"I can read/write GPIO, ADC, flash. What would you like to do?"*
+
+---
+
+### Mode Comparison
+
+| Aspect           | Edge-Native                    | Host-Mediated                    |
+|------------------|--------------------------------|----------------------------------|
+| ZeroClaw runs on | Device (ESP32, RPi)           | Host (Mac, Linux)                |
+| Hardware link    | Local (GPIO, I2C, SPI)        | USB, J-Link, Aardvark            |
+| LLM              | On-device or cloud (Gemini)   | Host (cloud or local)            |
+| Use case         | Production, standalone         | Dev, debug, introspection       |
+| Channels         | WhatsApp, etc. (via WiFi)      | Telegram, CLI, etc.              |
+
+## 3. Legacy / Simpler Modes (Pre-LLM-on-Edge)
+
+For boards without WiFi or before full Edge-Native is ready:
+
+### Mode A: Host + Remote Peripheral (STM32 via serial)
+
+Host runs ZeroClaw; peripheral runs minimal firmware. Simple JSON over serial.
+
+### Mode B: RPi as Host (Native GPIO)
+
+ZeroClaw on Pi; GPIO via rppal or sysfs. No separate firmware.
+
+## 4. Technical Requirements
+
+| Requirement | Description |
+|-------------|-------------|
+| **Language** | Pure Rust. `no_std` where applicable for embedded targets (STM32, ESP32). |
+| **Communication** | Lightweight gRPC or nanoRPC stack for low-latency command processing. |
+| **Dynamic execution** | Safely run LLM-generated logic on-the-fly: Wasm runtime for isolation, or dynamic linking where supported. |
+| **Documentation retrieval** | RAG (Retrieval-Augmented Generation) pipeline to feed datasheet snippets, register maps, and pinouts into LLM context. |
+| **Hardware discovery** | VID/PID-based identification for USB devices; architecture detection (ARM Cortex-M, RISC-V, etc.). |
+
+### RAG Pipeline (Datasheet Retrieval)
+
+- **Index:** Datasheets, reference manuals, register maps (PDF → chunks, embeddings).
+- **Retrieve:** On user query ("turn on LED"), fetch relevant snippets (e.g. GPIO section for target board).
+- **Inject:** Add to LLM system prompt or context.
+- **Result:** LLM generates accurate, board-specific code.
+
+### Dynamic Execution Options
+
+| Option | Pros | Cons |
+|-------|------|------|
+| **Wasm** | Sandboxed, portable, no FFI | Overhead; limited HW access from Wasm |
+| **Dynamic linking** | Native speed, full HW access | Platform-specific; security concerns |
+| **Interpreted DSL** | Safe, auditable | Slower; limited expressiveness |
+| **Pre-compiled templates** | Fast, secure | Less flexible; requires template library |
+
+**Recommendation:** Start with pre-compiled templates + parameterization; evolve to Wasm for user-defined logic once stable.
+
+## 5. CLI and Config
+
+### CLI Flags
+
+```bash
+# Edge-Native: run on device (ESP32, RPi)
+zeroclaw agent --mode edge
+
+# Host-Mediated: connect to USB/J-Link target
+zeroclaw agent --peripheral nucleo-f401re:/dev/ttyACM0
+zeroclaw agent --probe jlink
+
+# Hardware introspection
+zeroclaw hardware discover
+zeroclaw hardware introspect /dev/ttyACM0
+```
+
+### Config (config.toml)
+
+```toml
+[peripherals]
+enabled = true
+mode = "host"  # "edge" | "host"
+datasheet_dir = "docs/datasheets"  # RAG: board-specific docs for LLM context
+
+[[peripherals.boards]]
+board = "nucleo-f401re"
+transport = "serial"
+path = "/dev/ttyACM0"
+baud = 115200
+
+[[peripherals.boards]]
+board = "rpi-gpio"
+transport = "native"
+
+[[peripherals.boards]]
+board = "esp32"
+transport = "wifi"
+# Edge-Native: ZeroClaw runs on ESP32
+```
+
+## 6. Architecture: Peripheral as Extension Point
+
+### New Trait: `Peripheral`
+
+```rust
+/// A hardware peripheral that exposes capabilities as tools.
+#[async_trait]
+pub trait Peripheral: Send + Sync {
+    fn name(&self) -> &str;
+    fn board_type(&self) -> &str;  // e.g. "nucleo-f401re", "rpi-gpio"
+    async fn connect(&mut self) -> anyhow::Result<()>;
+    async fn disconnect(&mut self) -> anyhow::Result<()>;
+    async fn health_check(&self) -> bool;
+    /// Tools this peripheral provides (gpio_read, gpio_write, sensor_read, etc.)
+    fn tools(&self) -> Vec<Box<dyn Tool>>;
+}
+```
+
+### Flow
+
+1. **Startup:** ZeroClaw loads config, sees `peripherals.boards`.
+2. **Connect:** For each board, create a `Peripheral` impl, call `connect()`.
+3. **Tools:** Collect tools from all connected peripherals; merge with default tools.
+4. **Agent loop:** Agent can call `gpio_write`, `sensor_read`, etc. — these delegate to the peripheral.
+5. **Shutdown:** Call `disconnect()` on each peripheral.
+
+### Board Support
+
+| Board              | Transport | Firmware / Driver      | Tools                    |
+|--------------------|-----------|------------------------|--------------------------|
+| nucleo-f401re      | serial    | Zephyr / Embassy       | gpio_read, gpio_write, adc_read |
+| rpi-gpio           | native    | rppal or sysfs         | gpio_read, gpio_write    |
+| esp32              | serial/ws | ESP-IDF / Embassy      | gpio, wifi, mqtt         |
+
+## 7. Communication Protocols
+
+### gRPC / nanoRPC (Edge-Native, Host-Mediated)
+
+For low-latency, typed RPC between ZeroClaw and peripherals:
+
+- **nanoRPC** or **tonic** (gRPC): Protobuf-defined services.
+- Methods: `GpioWrite`, `GpioRead`, `I2cTransfer`, `SpiTransfer`, `MemoryRead`, `FlashWrite`, etc.
+- Enables streaming, bidirectional calls, and code generation from `.proto` files.
+
+### Serial Fallback (Host-Mediated, legacy)
+
+Simple JSON over serial for boards without gRPC support:
+
+**Request (host → peripheral):**
+```json
+{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}
+```
+
+**Response (peripheral → host):**
+```json
+{"id":"1","ok":true,"result":"done"}
+```
+
+## 8. Firmware (Separate Repo or Crate)
+
+- **zeroclaw-firmware** or **zeroclaw-peripheral** — a separate crate/workspace.
+- Targets: `thumbv7em-none-eabihf` (STM32), `armv7-unknown-linux-gnueabihf` (RPi), etc.
+- Uses `embassy` or Zephyr for STM32.
+- Implements the protocol above.
+- User flashes this to the board; ZeroClaw connects and discovers capabilities.
+
+## 9. Implementation Phases
+
+### Phase 1: Skeleton ✅ (Done)
+
+- [x] Add `Peripheral` trait, config schema, CLI (`zeroclaw peripheral list/add`)
+- [x] Add `--peripheral` flag to agent
+- [x] Document in AGENTS.md
+
+### Phase 2: Host-Mediated — Hardware Discovery ✅ (Done)
+
+- [x] `zeroclaw hardware discover`: enumerate USB devices (VID/PID)
+- [x] Board registry: map VID/PID → architecture, name (e.g. Nucleo-F401RE)
+- [x] `zeroclaw hardware introspect <path>`: memory map, peripheral list
+
+### Phase 3: Host-Mediated — Serial / J-Link
+
+- [x] `SerialPeripheral` for STM32 over USB CDC
+- [ ] probe-rs or OpenOCD integration for flash/debug
+- [x] Tools: `gpio_read`, `gpio_write` (memory_read, flash_write in future)
+
+### Phase 4: RAG Pipeline ✅ (Done)
+
+- [x] Datasheet index (markdown/text → chunks)
+- [x] Retrieve-and-inject into LLM context on hardware-related queries
+- [x] Board-specific prompt augmentation
+
+**Usage:** Add `datasheet_dir = "docs/datasheets"` to `[peripherals]` in config.toml. Place `.md` or `.txt` files named by board (e.g. `nucleo-f401re.md`, `rpi-gpio.md`). Files in `_generic/` or named `generic.md` apply to all boards. Chunks are retrieved by keyword match and injected into the user message context.
+
+### Phase 5: Edge-Native — RPi ✅ (Done)
+
+- [x] ZeroClaw on Raspberry Pi (native GPIO via rppal)
+- [ ] gRPC/nanoRPC server for local peripheral access
+- [ ] Code persistence (store synthesized snippets)
+
+### Phase 6: Edge-Native — ESP32
+
+- [x] Host-mediated ESP32 (serial transport) — same JSON protocol as STM32
+- [x] `esp32` firmware crate (`firmware/esp32`) — GPIO over UART
+- [x] ESP32 in hardware registry (CH340 VID/PID)
+- [ ] ZeroClaw *on* ESP32 (WiFi + LLM, edge-native) — future
+- [ ] Wasm or template-based execution for LLM-generated logic
+
+**Usage:** Flash `firmware/esp32` to ESP32, add `board = "esp32"`, `transport = "serial"`, `path = "/dev/ttyUSB0"` to config.
+
+### Phase 7: Dynamic Execution (LLM-Generated Code)
+
+- [ ] Template library: parameterized GPIO/I2C/SPI snippets
+- [ ] Optional: Wasm runtime for user-defined logic (sandboxed)
+- [ ] Persist and reuse optimized code paths
+
+## 10. Security Considerations
+
+- **Serial path:** Validate `path` is in allowlist (e.g. `/dev/ttyACM*`, `/dev/ttyUSB*`); never arbitrary paths.
+- **GPIO:** Restrict which pins are exposed; avoid power/reset pins.
+- **No secrets on peripheral:** Firmware should not store API keys; host handles auth.
+
+## 11. Non-Goals (For Now)
+
+- Running full ZeroClaw *on* bare STM32 (no WiFi, limited RAM) — use Host-Mediated instead
+- Real-time guarantees — peripherals are best-effort
+- Arbitrary native code execution from LLM — prefer Wasm or templates
+
+## 12. Related Documents
+
+- [adding-boards-and-tools.md](../contributing/adding-boards-and-tools.md) — How to add boards and datasheets
+- [network-deployment.md](../ops/network-deployment.md) — RPi and network deployment
+
+## 13. References
+
+- [Zephyr RTOS Rust support](https://docs.zephyrproject.org/latest/develop/languages/rust/index.html)
+- [Embassy](https://embassy.dev/) — async embedded framework
+- [rppal](https://github.com/golemparts/rppal) — Raspberry Pi GPIO in Rust
+- [STM32 Nucleo-F401RE](https://www.st.com/en/evaluation-tools/nucleo-f401re.html)
+- [tonic](https://github.com/hyperium/tonic) — gRPC for Rust
+- [probe-rs](https://probe.rs/) — ARM debug probe, flash, memory access
+- [nusb](https://github.com/nic-hartley/nusb) — USB device enumeration (VID/PID)
+
+## 14. Raw Prompt Summary
+
+> *"Boards like ESP, Raspberry Pi, or boards with WiFi can connect to an LLM (Gemini or open-source). ZeroClaw runs on the device, creates its own gRPC, spins it up, and communicates with peripherals. User asks via WhatsApp: 'move X arm' or 'turn on LED'. ZeroClaw gets accurate documentation, writes code, executes it, stores it optimally, runs it, and turns on the LED — all on the development board.*
+>
+> *For STM Nucleo connected via USB/J-Link/Aardvark to my Mac: ZeroClaw from my Mac accesses the hardware, installs or writes what it wants on the device, and returns the result. Example: 'Hey ZeroClaw, what are the available/readable addresses on this USB device?' It can figure out what's connected where and suggest."*
--- a/third_party/zeroclaw/docs/hardware/nucleo-setup.md
+++ b/third_party/zeroclaw/docs/hardware/nucleo-setup.md
@@ -0,0 +1,147 @@
+# ZeroClaw on Nucleo-F401RE — Step-by-Step Guide
+
+Run ZeroClaw on your Mac or Linux host. Connect a Nucleo-F401RE via USB. Control GPIO (LED, pins) via Telegram or CLI.
+
+---
+
+## Get Board Info via Telegram (No Firmware Needed)
+
+ZeroClaw can read chip info from the Nucleo over USB **without flashing any firmware**. Message your Telegram bot:
+
+- *"What board info do I have?"*
+- *"Board info"*
+- *"What hardware is connected?"*
+- *"Chip info"*
+
+The agent uses the `hardware_board_info` tool to return chip name, architecture, and memory map. With the `probe` feature, it reads live data via USB/SWD; otherwise it returns static datasheet info.
+
+**Config:** Add Nucleo to `config.toml` first (so the agent knows which board to query):
+
+```toml
+[[peripherals.boards]]
+board = "nucleo-f401re"
+transport = "serial"
+path = "/dev/ttyACM0"
+baud = 115200
+```
+
+**CLI alternative:**
+
+```bash
+cargo build --features hardware,probe
+zeroclaw hardware info
+zeroclaw hardware discover
+```
+
+---
+
+## What's Included (No Code Changes Needed)
+
+ZeroClaw includes everything for Nucleo-F401RE:
+
+| Component | Location | Purpose |
+|-----------|----------|---------|
+| Firmware | `firmware/nucleo/` | Embassy Rust — USART2 (115200), gpio_read, gpio_write |
+| Serial peripheral | `src/peripherals/serial.rs` | JSON-over-serial protocol (same as Arduino/ESP32) |
+| Flash command | `zeroclaw peripheral flash-nucleo` | Builds firmware, flashes via probe-rs |
+
+Protocol: newline-delimited JSON. Request: `{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}`. Response: `{"id":"1","ok":true,"result":"done"}`.
+
+---
+
+## Prerequisites
+
+- Nucleo-F401RE board
+- USB cable (USB-A to Mini-USB; Nucleo has built-in ST-Link)
+- For flashing: `cargo install probe-rs-tools --locked` (or use the [install script](https://probe.rs/docs/getting-started/installation/))
+
+---
+
+## Phase 1: Flash Firmware
+
+### 1.1 Connect Nucleo
+
+1. Connect Nucleo to your Mac/Linux via USB.
+2. The board appears as a USB device (ST-Link). No separate driver needed on modern systems.
+
+### 1.2 Flash via ZeroClaw
+
+From the zeroclaw repo root:
+
+```bash
+zeroclaw peripheral flash-nucleo
+```
+
+This builds `firmware/nucleo` and runs `probe-rs run --chip STM32F401RETx`. The firmware runs immediately after flashing.
+
+### 1.3 Manual Flash (Alternative)
+
+```bash
+cd firmware/nucleo
+cargo build --release --target thumbv7em-none-eabihf
+probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/nucleo
+```
+
+---
+
+## Phase 2: Find Serial Port
+
+- **macOS:** `/dev/cu.usbmodem*` or `/dev/tty.usbmodem*` (e.g. `/dev/cu.usbmodem101`)
+- **Linux:** `/dev/ttyACM0` (or check `dmesg` after plugging in)
+
+USART2 (PA2/PA3) is bridged to the ST-Link's virtual COM port, so the host sees one serial device.
+
+---
+
+## Phase 3: Configure ZeroClaw
+
+Add to `~/.zeroclaw/config.toml`:
+
+```toml
+[peripherals]
+enabled = true
+
+[[peripherals.boards]]
+board = "nucleo-f401re"
+transport = "serial"
+path = "/dev/cu.usbmodem101"   # adjust to your port
+baud = 115200
+```
+
+---
+
+## Phase 4: Run and Test
+
+```bash
+zeroclaw daemon --host 127.0.0.1 --port 42617
+```
+
+Or use the agent directly:
+
+```bash
+zeroclaw agent --message "Turn on the LED on pin 13"
+```
+
+Pin 13 = PA5 = User LED (LD2) on Nucleo-F401RE.
+
+---
+
+## Summary: Commands
+
+| Step | Command |
+|------|---------|
+| 1 | Connect Nucleo via USB |
+| 2 | `cargo install probe-rs-tools --locked` |
+| 3 | `zeroclaw peripheral flash-nucleo` |
+| 4 | Add Nucleo to config.toml (path = your serial port) |
+| 5 | `zeroclaw daemon` or `zeroclaw agent -m "Turn on LED"` |
+
+---
+
+## Troubleshooting
+
+- **flash-nucleo unrecognized** — Build from repo: `cargo run --features hardware -- peripheral flash-nucleo`. The subcommand is only in the repo build, not in crates.io installs.
+- **probe-rs not found** — `cargo install probe-rs-tools --locked` (the `probe-rs` crate is a library; the CLI is in `probe-rs-tools`)
+- **No probe detected** — Ensure Nucleo is connected. Try another USB cable/port.
+- **Serial port not found** — On Linux, add user to `dialout`: `sudo usermod -a -G dialout $USER`, then log out/in.
+- **GPIO commands ignored** — Check `path` in config matches your serial port. Run `zeroclaw peripheral list` to verify.
--- a/third_party/zeroclaw/docs/i18n/README.md
+++ b/third_party/zeroclaw/docs/i18n/README.md
@@ -0,0 +1,28 @@
+# ZeroClaw i18n Docs Index
+
+Localized documentation trees live here and under `docs/`.
+
+## Locales
+
+- العربية (Arabic): [ar/README.md](ar/README.md)
+- বাংলা (Bengali): [bn/README.md](bn/README.md)
+- Deutsch (German): [de/README.md](de/README.md)
+- Ελληνικά (Greek): [el/README.md](el/README.md)
+- Español (Spanish): [es/README.md](es/README.md)
+- Français (French): [fr/README.md](fr/README.md)
+- हिन्दी (Hindi): [hi/README.md](hi/README.md)
+- Italiano (Italian): [it/README.md](it/README.md)
+- 日本語 (Japanese): [ja/README.md](ja/README.md)
+- 한국어 (Korean): [ko/README.md](ko/README.md)
+- Português (Portuguese): [pt/README.md](pt/README.md)
+- Русский (Russian): [ru/README.md](ru/README.md)
+- Tagalog: [tl/README.md](tl/README.md)
+- Tiếng Việt (Vietnamese): [vi/README.md](vi/README.md)
+- Vietnamese (canonical): [`docs/vi/`](../vi/)
+- 简体中文 (Chinese): [zh-CN/README.md](zh-CN/README.md)
+
+## Structure
+
+- Docs structure map (language/part/function): [../maintainers/structure-README.md](../maintainers/structure-README.md)
+
+See overall coverage and conventions in [../maintainers/i18n-coverage.md](../maintainers/i18n-coverage.md).
--- a/Show More
+++ b/Show More