docs(readme): add v0.1.9a release highlights and contributor credits (#3453)

* docs(readme): add v0.1.9a release highlights and contributor credits

Add "What's New in v0.1.9a" section covering web dashboard restyle,
new providers/channels, MCP tools, infrastructure updates, and fixes.
Add "Recent Contributors" table crediting key contributors with their
specific highlights for this release cycle.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(docs): use table format for release highlights to pass MD036 lint

Replace bold-text subsections with a table to satisfy the markdown
linter's no-emphasis-as-heading rule (MD036).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

.github/workflows/checks-on-pr.yml

@@ -77,6 +77,8 @@ jobs:
             target: x86_64-unknown-linux-gnu
           - os: macos-14
             target: aarch64-apple-darwin
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
       - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable
@@ -84,6 +86,7 @@ jobs:
           toolchain: 1.92.0
           targets: ${{ matrix.target }}
       - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2
+        if: runner.os != 'Windows'
 
       - name: Install mold linker
         if: runner.os == 'Linux'
@@ -92,11 +95,12 @@ jobs:
           sudo apt-get install -y mold
 
       - name: Ensure web/dist placeholder exists
+        shell: bash
         run: mkdir -p web/dist && touch web/dist/.gitkeep
 
       - name: Build release
         shell: bash
-        run: cargo build --release --locked --target ${{ matrix.target }}
+        run: cargo build --profile ci --locked --target ${{ matrix.target }}
         env:
           CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_LINKER: clang
           CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_RUSTFLAGS: "-C link-arg=-fuse-ld=mold"

.github/workflows/ci-run.yml

@@ -105,6 +105,8 @@ jobs:
             target: x86_64-unknown-linux-gnu
           - os: macos-14
             target: aarch64-apple-darwin
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
       - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable
@@ -112,6 +114,7 @@ jobs:
           toolchain: 1.92.0
           targets: ${{ matrix.target }}
       - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2
+        if: runner.os != 'Windows'
 
       - name: Install mold linker
         if: runner.os == 'Linux'
@@ -120,11 +123,12 @@ jobs:
           sudo apt-get install -y mold
 
       - name: Ensure web/dist placeholder exists
+        shell: bash
         run: mkdir -p web/dist && touch web/dist/.gitkeep
 
       - name: Build release
         shell: bash
-        run: cargo build --release --locked --target ${{ matrix.target }}
+        run: cargo build --profile ci --locked --target ${{ matrix.target }}
         env:
           CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_LINKER: clang
           CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_RUSTFLAGS: "-C link-arg=-fuse-ld=mold"

.github/workflows/master-branch-flow.md

@@ -81,7 +81,7 @@ Current maintainers with PR approval authority: `theonlyhennygod`, `JordanTheJet
 | `aarch64-unknown-linux-gnu` | | ✓ | ✓ | ✓ |
 | `aarch64-apple-darwin` | ✓ | | ✓ | ✓ |
 | `x86_64-apple-darwin` | | ✓ | | |
-| `x86_64-pc-windows-msvc` | | ✓ | ✓ | ✓ |
+| `x86_64-pc-windows-msvc` | ✓ | ✓ | ✓ | ✓ |
 
 ## Mermaid Diagrams
 

.github/workflows/release-beta-on-push.yml

@@ -65,11 +65,11 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - os: ubuntu-22.04
+          - os: ubuntu-latest
             target: x86_64-unknown-linux-gnu
             artifact: zeroclaw
             ext: tar.gz
-          - os: ubuntu-22.04
+          - os: ubuntu-latest
             target: aarch64-unknown-linux-gnu
             artifact: zeroclaw
             ext: tar.gz
@@ -158,7 +158,7 @@ jobs:
           files: |
             artifacts/**/*
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.RELEASE_TOKEN }}
 
   docker:
     name: Push Docker Image

.github/workflows/release-stable-manual.yml

@@ -83,11 +83,11 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - os: ubuntu-22.04
+          - os: ubuntu-latest
             target: x86_64-unknown-linux-gnu
             artifact: zeroclaw
             ext: tar.gz
-          - os: ubuntu-22.04
+          - os: ubuntu-latest
             target: aarch64-unknown-linux-gnu
             artifact: zeroclaw
             ext: tar.gz

.gitignore

@@ -41,3 +41,6 @@ credentials.json
 
 # Coverage artifacts
 lcov.info
+
+# IDE's stuff
+.idea

CONTRIBUTING.md

@@ -2,20 +2,41 @@
 
 Thanks for your interest in contributing to ZeroClaw! This guide will help you get started.
 
+---
+
+## ⚠️ Branch Migration Notice (March 2026)
+
+**`master` is the ONLY default branch. The `main` branch no longer exists.**
+
+If you have an existing fork or local clone that tracks `main`, you **must** update it:
+
+```bash
+# Update your local clone to track master
+git checkout master
+git branch -D main 2>/dev/null          # delete local main if it exists
+git remote set-head origin master
+git fetch origin --prune                 # remove stale remote refs
+
+# If your fork still has a main branch, delete it
+git push origin --delete main 2>/dev/null
+```
+
+All PRs must target **`master`**. PRs targeting `main` will be rejected.
+
+**Background:** ZeroClaw previously used `main` in some documentation and scripts, which caused 404 errors, broken CI refs, and contributor confusion (see [#2929](https://github.com/zeroclaw-labs/zeroclaw/issues/2929), [#3061](https://github.com/zeroclaw-labs/zeroclaw/issues/3061), [#3194](https://github.com/zeroclaw-labs/zeroclaw/pull/3194)). As of March 2026, all references have been corrected, stale branches cleaned up, and the `main` branch permanently deleted.
+
+---
+
 ## Branching Model
 
-> **Important — `master` is the default branch.**
->
-> ZeroClaw uses **`master`** as its single source-of-truth branch. The `main` branch has been removed.
->
-> Previously, some documentation and scripts referenced a `main` branch, which caused 404 errors and contributor confusion (see [#2929](https://github.com/zeroclaw-labs/zeroclaw/issues/2929), [#3061](https://github.com/zeroclaw-labs/zeroclaw/issues/3061), [#3194](https://github.com/zeroclaw-labs/zeroclaw/pull/3194)). As of March 2026, all references have been corrected and the `main` branch deleted.
+> **`master`** is the single source-of-truth branch.
 >
 > **How contributors should work:**
 > 1. Fork the repository
 > 2. Create a `feat/*` or `fix/*` branch from `master`
 > 3. Open a PR targeting `master`
 >
-> Do **not** create or push to a `main` branch.
+> Do **not** create or push to a `main` branch. There is no `main` branch — it will not work.
 
 ## First-Time Contributors
 
@@ -559,4 +580,3 @@ Recommended scope keys in commit titles:
 ## License
 
 By contributing, you agree that your contributions will be licensed under the MIT License.
-# Contributing Guide Update

Cargo.lock

@@ -8021,6 +8021,7 @@ dependencies = [
  "base64",
  "chrono",
  "directories",
+ "portable-atomic",
  "reqwest",
  "rppal",
  "serde",

Cargo.toml

@@ -48,8 +48,8 @@ schemars = "1.2"
 tracing = { version = "0.1", default-features = false }
 tracing-subscriber = { version = "0.3", default-features = false, features = ["fmt", "ansi", "env-filter"] }
 
-# Observability - Prometheus metrics
-prometheus = { version = "0.14", default-features = false }
+# Observability - Prometheus metrics (optional; requires AtomicU64, unavailable on 32-bit)
+prometheus = { version = "0.14", default-features = false, optional = true }
 
 # Base64 encoding (screenshots, image data)
 base64 = "0.22"
@@ -82,12 +82,12 @@ hex = "0.4"
 # CSPRNG for secure token generation
 rand = "0.10"
 
+# Portable atomic fallbacks for targets without native 64-bit atomics
+portable-atomic = "1"
+
 # serde-big-array for wa-rs storage (large array serialization)
 serde-big-array = { version = "0.5", optional = true }
 
-# Portable atomic fallbacks for 32-bit targets (no native 64-bit atomics)
-portable-atomic = { version = "1", optional = true }
-
 # Fast mutexes that don't poison on panic
 parking_lot = "0.12"
 
@@ -187,13 +187,14 @@ landlock = { version = "0.4", optional = true }
 libc = "0.2"
 
 [features]
-default = ["channel-nostr"]
+default = ["observability-prometheus", "channel-nostr"]
 channel-nostr = ["dep:nostr-sdk"]
 hardware = ["nusb", "tokio-serial"]
 channel-matrix = ["dep:matrix-sdk"]
 channel-lark = ["dep:prost"]
 channel-feishu = ["channel-lark"]  # Alias for Feishu users (Lark and Feishu are the same platform)
 memory-postgres = ["dep:postgres"]
+observability-prometheus = ["dep:prometheus"]
 observability-otel = ["dep:opentelemetry", "dep:opentelemetry_sdk", "dep:opentelemetry-otlp"]
 peripheral-rpi = ["rppal"]
 # Browser backend feature alias used by cfg(feature = "browser-native")
@@ -205,6 +206,8 @@ sandbox-landlock = ["dep:landlock"]
 sandbox-bubblewrap = []
 # Backward-compatible alias for older invocations
 landlock = ["sandbox-landlock"]
+# Prometheus metrics observer (requires 64-bit atomics; disable on 32-bit targets)
+metrics = ["observability-prometheus"]
 # probe = probe-rs for Nucleo memory read (adds ~50 deps; optional)
 probe = ["dep:probe-rs"]
 # rag-pdf = PDF ingestion for datasheet RAG
@@ -225,6 +228,11 @@ inherits = "release"
 codegen-units = 8    # Parallel codegen for faster builds on powerful machines (16GB+ RAM recommended)
                      # Use: cargo build --profile release-fast
 
+[profile.ci]
+inherits = "release"
+lto = "thin"         # Much faster than fat LTO; still catches release-mode issues
+codegen-units = 16   # Full parallelism for CI runners
+
 [profile.dist]
 inherits = "release"
 opt-level = "z"

Dockerfile

@@ -90,6 +90,8 @@ COPY dev/config.template.toml /zeroclaw-data/.zeroclaw/config.toml
 RUN chown 65534:65534 /zeroclaw-data/.zeroclaw/config.toml
 
 # Environment setup
+# Ensure UTF-8 locale so CJK / multibyte input is handled correctly
+ENV LANG=C.UTF-8
 # Use consistent workspace path
 ENV ZEROCLAW_WORKSPACE=/zeroclaw-data/workspace
 ENV HOME=/zeroclaw-data
@@ -114,6 +116,8 @@ COPY --from=builder /app/zeroclaw /usr/local/bin/zeroclaw
 COPY --from=builder /zeroclaw-data /zeroclaw-data
 
 # Environment setup
+# Ensure UTF-8 locale so CJK / multibyte input is handled correctly
+ENV LANG=C.UTF-8
 ENV ZEROCLAW_WORKSPACE=/zeroclaw-data/workspace
 ENV HOME=/zeroclaw-data
 # Default provider and model are set in config.toml, not here,

Dockerfile.debian

@@ -0,0 +1,120 @@
+# syntax=docker/dockerfile:1.7
+
+# Dockerfile.debian — Shell-equipped variant of the ZeroClaw container.
+#
+# The default Dockerfile produces a distroless "release" image with no shell,
+# which is ideal for minimal attack surface but prevents the agent from using
+# shell-based tools (pwd, ls, git, curl, etc.).
+#
+# This variant uses debian:bookworm-slim as the runtime base and ships
+# essential CLI tools so the agent can operate as a full coding assistant.
+#
+# Build:
+#   docker build -f Dockerfile.debian -t zeroclaw:debian .
+#
+# Or with docker compose:
+#   docker compose -f docker-compose.yml -f docker-compose.debian.yml up
+
+# ── Stage 1: Build (identical to main Dockerfile) ───────────
+FROM rust:1.93-slim@sha256:9663b80a1621253d30b146454f903de48f0af925c967be48c84745537cd35d8b AS builder
+
+WORKDIR /app
+
+# Install build dependencies
+RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
+    --mount=type=cache,target=/var/lib/apt,sharing=locked \
+    apt-get update && apt-get install -y \
+        pkg-config \
+    && rm -rf /var/lib/apt/lists/*
+
+# 1. Copy manifests to cache dependencies
+COPY Cargo.toml Cargo.lock ./
+COPY crates/robot-kit/Cargo.toml crates/robot-kit/Cargo.toml
+# Create dummy targets declared in Cargo.toml so manifest parsing succeeds.
+RUN mkdir -p src benches crates/robot-kit/src \
+    && echo "fn main() {}" > src/main.rs \
+    && echo "fn main() {}" > benches/agent_benchmarks.rs \
+    && echo "pub fn placeholder() {}" > crates/robot-kit/src/lib.rs
+RUN --mount=type=cache,id=zeroclaw-cargo-registry,target=/usr/local/cargo/registry,sharing=locked \
+    --mount=type=cache,id=zeroclaw-cargo-git,target=/usr/local/cargo/git,sharing=locked \
+    --mount=type=cache,id=zeroclaw-target,target=/app/target,sharing=locked \
+    cargo build --release --locked
+RUN rm -rf src benches crates/robot-kit/src
+
+# 2. Copy only build-relevant source paths (avoid cache-busting on docs/tests/scripts)
+COPY src/ src/
+COPY benches/ benches/
+COPY crates/ crates/
+COPY firmware/ firmware/
+COPY web/ web/
+# Keep release builds resilient when frontend dist assets are not prebuilt in Git.
+RUN mkdir -p web/dist && \
+    if [ ! -f web/dist/index.html ]; then \
+      printf '%s\n' \
+        '<!doctype html>' \
+        '<html lang="en">' \
+        '  <head>' \
+        '    <meta charset="utf-8" />' \
+        '    <meta name="viewport" content="width=device-width,initial-scale=1" />' \
+        '    <title>ZeroClaw Dashboard</title>' \
+        '  </head>' \
+        '  <body>' \
+        '    <h1>ZeroClaw Dashboard Unavailable</h1>' \
+        '    <p>Frontend assets are not bundled in this build. Build the web UI to populate <code>web/dist</code>.</p>' \
+        '  </body>' \
+        '</html>' > web/dist/index.html; \
+    fi
+RUN --mount=type=cache,id=zeroclaw-cargo-registry,target=/usr/local/cargo/registry,sharing=locked \
+    --mount=type=cache,id=zeroclaw-cargo-git,target=/usr/local/cargo/git,sharing=locked \
+    --mount=type=cache,id=zeroclaw-target,target=/app/target,sharing=locked \
+    cargo build --release --locked && \
+    cp target/release/zeroclaw /app/zeroclaw && \
+    strip /app/zeroclaw
+
+# Prepare runtime directory structure and default config inline (no extra stage)
+RUN mkdir -p /zeroclaw-data/.zeroclaw /zeroclaw-data/workspace && \
+    printf '%s\n' \
+        'workspace_dir = "/zeroclaw-data/workspace"' \
+        'config_path = "/zeroclaw-data/.zeroclaw/config.toml"' \
+        'api_key = ""' \
+        'default_provider = "openrouter"' \
+        'default_model = "anthropic/claude-sonnet-4-20250514"' \
+        'default_temperature = 0.7' \
+        '' \
+        '[gateway]' \
+        'port = 42617' \
+        'host = "[::]"' \
+        'allow_public_bind = true' \
+        > /zeroclaw-data/.zeroclaw/config.toml && \
+    chown -R 65534:65534 /zeroclaw-data
+
+# ── Stage 2: Runtime (Debian with shell) ─────────────────────
+FROM debian:bookworm-slim AS runtime
+
+# Install essential tools for agent shell operations
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        bash \
+        ca-certificates \
+        curl \
+        git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /app/zeroclaw /usr/local/bin/zeroclaw
+COPY --from=builder /zeroclaw-data /zeroclaw-data
+
+# Environment setup
+# Ensure UTF-8 locale so CJK / multibyte input is handled correctly
+ENV LANG=C.UTF-8
+ENV ZEROCLAW_WORKSPACE=/zeroclaw-data/workspace
+ENV HOME=/zeroclaw-data
+# Default provider and model are set in config.toml, not here,
+# so config file edits are not silently overridden
+ENV ZEROCLAW_GATEWAY_PORT=42617
+
+# API_KEY must be provided at runtime!
+
+WORKDIR /zeroclaw-data
+USER 65534:65534
+EXPOSE 42617
+ENTRYPOINT ["zeroclaw"]
+CMD ["gateway"]

README.md

@@ -84,6 +84,16 @@ Built by students and members of the Harvard, MIT, and Sundai.Club communities.
 
 <p align="center"><code>Trait-driven architecture · secure-by-default runtime · provider/channel/tool swappable · pluggable everything</code></p>
 
+### 🚀 What's New in v0.1.9a (March 2026)
+
+| Area | Highlights |
+|---|---|
+| Web Dashboard | Electric blue restyle with glassmorphism and animations, ZeroClaw logo, cron run history panel, message draft persistence, auto-expanding chat composer |
+| Providers & Channels | Azure OpenAI support, WeCom webhook channel, Matrix read markers/typing/file uploads/voice/multi-room, custom HTTP headers, `ZEROCLAW_PROVIDER_URL` override, configurable `ack_reactions` |
+| Tools & MCP | On-demand MCP tool loading via `tool_search`, multi-transport MCP client, `tool_filter_groups` for per-turn schema filtering, Windows shell `tool_call` support, dynamic node discovery |
+| Infrastructure | 32-bit system support via feature gates, Debian Docker variant with shell tools, session state persistence/recovery, docs hub translations for all 30 languages |
+| Fixes | Slack thread events in polling mode, Discord WebSocket Ping handling, Ollama Qwen think-tag stripping, security hardening (filesystem scoping, credential scrubbing, cron validation), 32-bit atomic fallbacks |
+
 ### 📢 Announcements
 
 Use this board for important notices (breaking changes, security advisories, maintenance windows, and release blockers).
@@ -1132,6 +1142,27 @@ A heartfelt thank you to the communities and institutions that inspire and fuel
 
 We're building in the open because the best ideas come from everywhere. If you're reading this, you're part of it. Welcome. 🦀❤️
 
+### 🌟 Recent Contributors (v0.1.9a)
+
+Special recognition to the contributors who shipped features, fixes, and improvements in this release cycle:
+
+| Contributor | Highlights |
+|---|---|
+| **@SimianAstronaut7** | Security hardening (credential scrubbing, filesystem scoping), Discord WebSocket fixes, Lark/Feishu channel restoration, WhatsApp Web concurrency fix |
+| **@Alix-007** | CI/CD master branch migration, release runner fixes, install script Bash 3.2 compatibility |
+| **@darrenzeng2025** | Anthropic vision support, email subject config, auto-expanding chat composer, config fixes, SIGTERM graceful shutdown |
+| **@imadnyc** | Live tool call notifications, Matrix reactions/threading, datetime refresh in cached prompts |
+| **@jameslcowan** | Channel secrets encryption roundtrip fix |
+| **@ImanHashemi** | Webhook-audit builtin hook |
+| **@alanpjohn** | Opencode-go provider integration |
+| **@parziva-1** | WhatsApp Web session reconnect and QR flow |
+| **@ttuffin** | Docker dependency management |
+| **@zverozabr** | Embedding API key resolution fix |
+| **@Jacobinwwey** | MCP tools and subsystem integration |
+| **@vernonstinebaker** | MCP tool filter groups and schema filtering |
+
+Thank you to everyone who opened issues, reviewed PRs, translated docs, and helped test. Every contribution matters. 🦀
+
 ## ⚠️ Official Repository & Impersonation Warning
 
 **This is the only official ZeroClaw repository:**

README.zh-CN.md

@@ -54,26 +54,26 @@
 
 <p align="center">
   <a href="install.sh">一键部署</a> |
-  <a href="docs/setup-guides/README.md">安装入门</a> |
+  <a href="docs/i18n/zh-CN/setup-guides/README.zh-CN.md">安装入门</a> |
   <a href="docs/README.zh-CN.md">文档总览</a> |
-  <a href="docs/SUMMARY.md">文档目录</a>
+  <a href="docs/SUMMARY.zh-CN.md">文档目录</a>
 </p>
 
 <p align="center">
   <strong>场景分流：</strong>
-  <a href="docs/reference/README.md">参考手册</a> ·
-  <a href="docs/ops/README.md">运维部署</a> ·
-  <a href="docs/ops/troubleshooting.md">故障排查</a> ·
-  <a href="docs/security/README.md">安全专题</a> ·
-  <a href="docs/hardware/README.md">硬件外设</a> ·
-  <a href="docs/contributing/README.md">贡献与 CI</a>
+  <a href="docs/i18n/zh-CN/reference/README.zh-CN.md">参考手册</a> ·
+  <a href="docs/i18n/zh-CN/ops/README.zh-CN.md">运维部署</a> ·
+  <a href="docs/i18n/zh-CN/ops/troubleshooting.zh-CN.md">故障排查</a> ·
+  <a href="docs/i18n/zh-CN/security/README.zh-CN.md">安全专题</a> ·
+  <a href="docs/i18n/zh-CN/hardware/README.zh-CN.md">硬件外设</a> ·
+  <a href="docs/i18n/zh-CN/contributing/README.zh-CN.md">贡献与 CI</a>
 </p>
 
 > 本文是对 `README.md` 的人工对齐翻译（强调可读性与准确性，不做逐字直译）。
-> 
+>
 > 技术标识（命令、配置键、API 路径、Trait 名称）保持英文，避免语义漂移。
-> 
-> 最后对齐时间：**2026-02-22**。
+>
+> 最后对齐时间：**2026-03-14**。
 
 ## 📢 公告板
 
@@ -146,7 +146,7 @@ cd zeroclaw
 
 可选环境初始化：`./install.sh --install-system-deps --install-rust`（可能需要 `sudo`）。
 
-详细说明见：[`docs/setup-guides/one-click-bootstrap.md`](docs/setup-guides/one-click-bootstrap.md)。
+详细说明见：[`docs/setup-guides/one-click-bootstrap.md`](docs/i18n/zh-CN/setup-guides/one-click-bootstrap.zh-CN.md)。
 
 ## 快速开始
 
@@ -312,20 +312,20 @@ allow_public_bind = false
 - 文档总览（英文）：[`docs/README.md`](docs/README.md)
 - 统一目录（TOC）：[`docs/SUMMARY.md`](docs/SUMMARY.md)
 - 文档总览（简体中文）：[`docs/README.zh-CN.md`](docs/README.zh-CN.md)
-- 命令参考：[`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md)
-- 配置参考：[`docs/reference/api/config-reference.md`](docs/reference/api/config-reference.md)
-- Provider 参考：[`docs/reference/api/providers-reference.md`](docs/reference/api/providers-reference.md)
-- Channel 参考：[`docs/reference/api/channels-reference.md`](docs/reference/api/channels-reference.md)
-- 运维手册：[`docs/ops/operations-runbook.md`](docs/ops/operations-runbook.md)
-- 故障排查：[`docs/ops/troubleshooting.md`](docs/ops/troubleshooting.md)
-- 文档清单与分类：[`docs/maintainers/docs-inventory.md`](docs/maintainers/docs-inventory.md)
-- 项目 triage 快照（2026-02-18）：[`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/maintainers/project-triage-snapshot-2026-02-18.md)
+- 命令参考：[`docs/reference/cli/commands-reference.md`](docs/i18n/zh-CN/reference/cli/commands-reference.zh-CN.md)
+- 配置参考：[`docs/reference/api/config-reference.md`](docs/i18n/zh-CN/reference/api/config-reference.zh-CN.md)
+- Provider 参考：[`docs/reference/api/providers-reference.md`](docs/i18n/zh-CN/reference/api/providers-reference.zh-CN.md)
+- Channel 参考：[`docs/reference/api/channels-reference.md`](docs/i18n/zh-CN/reference/api/channels-reference.zh-CN.md)
+- 运维手册：[`docs/ops/operations-runbook.md`](docs/i18n/zh-CN/ops/operations-runbook.zh-CN.md)
+- 故障排查：[`docs/ops/troubleshooting.md`](docs/i18n/zh-CN/ops/troubleshooting.zh-CN.md)
+- 文档清单与分类：[`docs/maintainers/docs-inventory.md`](docs/i18n/zh-CN/maintainers/docs-inventory.zh-CN.md)
+- 项目 triage 快照（2026-02-18）：[`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/i18n/zh-CN/maintainers/project-triage-snapshot-2026-02-18.zh-CN.md)
 
 ## 贡献与许可证
 
 - 贡献指南：[`CONTRIBUTING.md`](CONTRIBUTING.md)
-- PR 工作流：[`docs/contributing/pr-workflow.md`](docs/contributing/pr-workflow.md)
-- Reviewer 指南：[`docs/contributing/reviewer-playbook.md`](docs/contributing/reviewer-playbook.md)
+- PR 工作流：[`docs/contributing/pr-workflow.md`](docs/i18n/zh-CN/contributing/pr-workflow.zh-CN.md)
+- Reviewer 指南：[`docs/contributing/reviewer-playbook.md`](docs/i18n/zh-CN/contributing/reviewer-playbook.zh-CN.md)
 - 许可证：MIT 或 Apache 2.0（见 [`LICENSE-MIT`](LICENSE-MIT)、[`LICENSE-APACHE`](LICENSE-APACHE) 与 [`NOTICE`](NOTICE)）
 
 ---

build.rs

@@ -1,6 +1,110 @@
+use std::path::Path;
+use std::process::Command;
+
 fn main() {
-    let dir = std::path::Path::new("web/dist");
-    if !dir.exists() {
-        std::fs::create_dir_all(dir).expect("failed to create web/dist/");
+    let dist_dir = Path::new("web/dist");
+    let web_dir = Path::new("web");
+
+    // Tell Cargo to re-run this script when web source files change.
+    println!("cargo:rerun-if-changed=web/src");
+    println!("cargo:rerun-if-changed=web/index.html");
+    println!("cargo:rerun-if-changed=web/package.json");
+    println!("cargo:rerun-if-changed=web/vite.config.ts");
+
+    // Attempt to build the web frontend if npm is available and web/dist is
+    // missing or stale.  The build is best-effort: when Node.js is not
+    // installed (e.g. CI containers, cross-compilation, minimal dev setups)
+    // we fall back to the existing stub/empty dist directory so the Rust
+    // build still succeeds.
+    let needs_build = !dist_dir.join("index.html").exists();
+
+    if needs_build && web_dir.join("package.json").exists() {
+        if let Ok(npm) = which_npm() {
+            eprintln!("cargo:warning=Building web frontend (web/dist is missing or stale)...");
+
+            // npm ci / npm install
+            let install_status = Command::new(&npm)
+                .args(["ci", "--ignore-scripts"])
+                .current_dir(web_dir)
+                .status();
+
+            match install_status {
+                Ok(s) if s.success() => {}
+                Ok(s) => {
+                    // Fall back to `npm install` if `npm ci` fails (no lockfile, etc.)
+                    eprintln!("cargo:warning=npm ci exited with {s}, trying npm install...");
+                    let fallback = Command::new(&npm)
+                        .args(["install"])
+                        .current_dir(web_dir)
+                        .status();
+                    if !matches!(fallback, Ok(s) if s.success()) {
+                        eprintln!("cargo:warning=npm install failed — skipping web build");
+                        ensure_dist_dir(dist_dir);
+                        return;
+                    }
+                }
+                Err(e) => {
+                    eprintln!("cargo:warning=Could not run npm: {e} — skipping web build");
+                    ensure_dist_dir(dist_dir);
+                    return;
+                }
+            }
+
+            // npm run build
+            let build_status = Command::new(&npm)
+                .args(["run", "build"])
+                .current_dir(web_dir)
+                .status();
+
+            match build_status {
+                Ok(s) if s.success() => {
+                    eprintln!("cargo:warning=Web frontend built successfully.");
+                }
+                Ok(s) => {
+                    eprintln!(
+                        "cargo:warning=npm run build exited with {s} — web dashboard may be unavailable"
+                    );
+                }
+                Err(e) => {
+                    eprintln!(
+                        "cargo:warning=Could not run npm build: {e} — web dashboard may be unavailable"
+                    );
+                }
+            }
+        }
+    }
+
+    ensure_dist_dir(dist_dir);
+}
+
+/// Ensure the dist directory exists so `rust-embed` does not fail at compile
+/// time even when the web frontend is not built.
+fn ensure_dist_dir(dist_dir: &Path) {
+    if !dist_dir.exists() {
+        std::fs::create_dir_all(dist_dir).expect("failed to create web/dist/");
     }
 }
+
+/// Locate the `npm` binary on the system PATH.
+fn which_npm() -> Result<String, ()> {
+    let cmd = if cfg!(target_os = "windows") {
+        "where"
+    } else {
+        "which"
+    };
+
+    Command::new(cmd)
+        .arg("npm")
+        .output()
+        .ok()
+        .and_then(|output| {
+            if output.status.success() {
+                String::from_utf8(output.stdout)
+                    .ok()
+                    .map(|s| s.lines().next().unwrap_or("npm").trim().to_string())
+            } else {
+                None
+            }
+        })
+        .ok_or(())
+}

crates/robot-kit/Cargo.toml

@@ -51,6 +51,9 @@ tracing = "0.1"
 # Time handling
 chrono = { version = "0.4", features = ["clock", "std"] }
 
+# Portable atomics for 32-bit targets
+portable-atomic = "1"
+
 # User directories
 directories = "6.0"
 

crates/robot-kit/src/safety.rs

@@ -19,7 +19,8 @@
 use crate::config::{RobotConfig, SafetyConfig};
 use crate::traits::ToolResult;
 use anyhow::Result;
-use std::sync::atomic::{AtomicBool, AtomicU64, Ordering};
+use portable_atomic::{AtomicU64, Ordering};
+use std::sync::atomic::AtomicBool;
 use std::sync::Arc;
 use std::time::{Duration, Instant};
 use tokio::sync::{broadcast, RwLock};

docker-compose.yml

@@ -10,8 +10,12 @@
 services:
   zeroclaw:
     image: ghcr.io/zeroclaw-labs/zeroclaw:latest
-    # Or build locally:
+    # Or build locally (distroless, no shell):
     # build: .
+    # Or build the Debian variant (includes bash, git, curl):
+    # build:
+    #   context: .
+    #   dockerfile: Dockerfile.debian
     container_name: zeroclaw
     restart: unless-stopped
     

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

docs/README.md

@@ -4,7 +4,8 @@ This page is the primary entry point for the documentation system.
 
 Last refreshed: **February 21, 2026**.
 
-Localized hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md).
+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
 

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

docs/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 这是文档系统的中文入口页。
 
-最后对齐：**2026-02-18**。
+最后对齐：**2026-03-14**。
 
 > 说明：命令、配置键、API 路径保持英文；实现细节以英文文档为准。
 
@@ -11,77 +11,83 @@
 | 我想要… | 建议阅读 |
 |---|---|
 | 快速安装并运行 | [../README.zh-CN.md](../README.zh-CN.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) |
+| 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](maintainers/project-triage-snapshot-2026-02-18.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](setup-guides/README.md)
-- 需要精确命令或配置键 → [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)
+- 首次安装或快速启动 → [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](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)
+- 入门文档： [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](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)
+- [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](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)
+- [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](reference/api/config-reference.md)、[operations-runbook.md](ops/operations-runbook.md)、[troubleshooting.md](ops/troubleshooting.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](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)
+- [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](maintainers/structure-README.md)
-- 文档清单与分类：[docs-inventory.md](maintainers/docs-inventory.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)
 
 ## 其他语言
 

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

docs/SUMMARY.md

@@ -8,17 +8,67 @@ Last refreshed: **February 18, 2026**.
 
 - Docs Structure Map (language/part/function): [structure/README.md](maintainers/structure-README.md)
 - English README: [../README.md](../README.md)
-- Chinese README: [../README.zh-CN.md](../README.zh-CN.md)
-- Japanese README: [../README.ja.md](../README.ja.md)
-- Russian README: [../README.ru.md](../README.ru.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)
-- Chinese Docs Hub: [README.zh-CN.md](README.zh-CN.md)
-- Japanese Docs Hub: [README.ja.md](README.ja.md)
-- Russian Docs Hub: [README.ru.md](README.ru.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)
-- Vietnamese Docs Hub: [i18n/vi/README.md](i18n/vi/README.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)
 

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

docs/SUMMARY.zh-CN.md

@@ -4,11 +4,11 @@
 
 > 📖 [English version](SUMMARY.md)
 
-最后更新：**2026年2月18日**。
+最后更新：**2026年3月14日**。
 
 ## 语言入口
 
-- 文档结构图（按语言/分区/功能）：[structure/README.md](maintainers/structure-README.md)
+- 文档结构图（按语言/分区/功能）：[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)
@@ -22,68 +22,93 @@
 - 法文文档中心：[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)
+- 国际化覆盖图：[i18n-coverage.md](i18n/zh-CN/maintainers/i18n-coverage.zh-CN.md)
 
 ## 分类
 
 ### 1) 快速入门
 
-- [setup-guides/README.md](setup-guides/README.md)
-- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md)
+- [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](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)
+- [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) 运维与部署
+### 3) SOP（标准操作流程）
 
-- [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)
+- [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) 安全设计与提案
+### 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)
+- [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) 硬件与外设
+### 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)
+- [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) 贡献与 CI
+### 6) 硬件与外设
 
-- [contributing/README.md](contributing/README.md)
+- [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](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)
+- [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)
 
-### 7) 项目状态与快照
+### 8) 项目状态与快照
 
-- [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)
+- [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)

docs/i18n/el/config-reference.md

@@ -0,0 +1,114 @@
+# Οδηγός Ρυθμίσεων ZeroClaw (config.toml)
+
+Αυτός ο οδηγός εξηγεί τις πιο σημαντικές ρυθμίσεις που μπορείτε να κάνετε στο αρχείο `config.toml`.
+
+Τελευταίος έλεγχος: **19 Φεβρουαρίου 2026**.
+
+## Πού βρίσκεται το αρχείο ρυθμίσεων;
+
+Το ZeroClaw ψάχνει για τις ρυθμίσεις με την εξής σειρά:
+1. Στη διαδρομή που ορίζει η μεταβλητή `ZEROCLAW_WORKSPACE`.
+2. Στο αρχείο `~/.zeroclaw/config.toml` (αυτή είναι η συνηθισμένη θέση).
+
+## Βασικές Ρυθμίσεις (Core)
+
+| Ρύθμιση | Τι ορίζει |
+|---|---|
+| `default_provider` | Ποιον πάροχο AI χρησιμοποιείτε (π.χ. `openai`, `ollama`). |
+| `default_model` | Ποιο συγκεκριμένο μοντέλο AI χρησιμοποιείτε (π.χ. `gpt-4o`). |
+| `default_temperature` | Πόσο "δημιουργική" θα είναι η AI (τιμή από 0 έως 2). |
+
+## 1. Συμπεριφορά της AI (Agent)
+
+- `max_tool_iterations`: Πόσες φορές μπορεί η AI να χρησιμοποιήσει εργαλεία για να απαντήσει σε 1 μήνυμα (προεπιλογή: 10).
+- `max_history_messages`: Πόσα προηγούμενα μηνύματα θυμάται η AI στη συνομιλία (προεπιλογή: 50).
+
+## 2. Αυτονομία και Ασφάλεια (Autonomy)
+
+Εδώ ρυθμίζετε πόση ελευθερία έχει η AI να κάνει αλλαγές στον υπολογιστή σας.
+
+- `level`: 
+    - `read_only`: Μπορεί μόνο να διαβάζει αρχεία.
+    - `supervised`: Χρειάζεται την έγκρισή σας για σημαντικές ενέργειες (προεπιλογή).
+    - `full`: Μπορεί να τρέχει εντολές ελεύθερα (προσοχή!).
+- `allowed_commands`: Λίστα με τις εντολές που επιτρέπεται να τρέχει η AI.
+- `forbidden_paths`: Φάκελοι που η AI **δεν** επιτρέπεται να αγγίξει (π.χ. `/etc`).
+
+## 3. Μνήμη (Memory)
+
+Πώς αποθηκεύει η AI τις πληροφορίες που της δίνετε.
+- `backend`: Μπορεί να είναι `sqlite` (βάση δεδομένων), `markdown` (απλά αρχεία κειμένου) ή `none` (καμία μνήμη).
+
+## 4. Κανάλια Επικοινωνίας (Channels)
+
+Κάθε κανάλι (Telegram, Discord κ.λπ.) έχει τη δική του ενότητα στο αρχείο.
+
+Παράδειγμα για το **Telegram**:
+```toml
+[channels_config.telegram]
+bot_token = "το-κλειδί-σας"
+allowed_users = ["το-όνομά-σας"] # Ποιοι επιτρέπεται να μιλάνε στο bot
+```
+
+## 5. Έλεγχος Κόστους (Cost)
+
+Αν χρησιμοποιείτε πληρωμένες υπηρεσίες AI, μπορείτε να βάλετε όρια.
+- `daily_limit_usd`: Μέγιστο ποσό ανά ημέρα (π.χ. 10.00 δολάρια).
+- `monthly_limit_usd`: Μέγιστο ποσό ανά μήνα.
+
+## 6. Εικόνες (Multimodal)
+
+Ρυθμίσεις για το πώς η AI βλέπει εικόνες.
+- `max_images`: Μέγιστος αριθμός εικόνων ανά μήνυμα.
+- `allow_remote_fetch`: Αν επιτρέπεται στην AI να κατεβάζει εικόνες από το ίντερνετ μέσω συνδέσμων (links).
+
+---
+
+## Συμβουλές
+
+- Αν αλλάξετε το αρχείο `config.toml`, πρέπει να κάνετε επανεκκίνηση το ZeroClaw για να δει τις αλλαγές.
+- Χρησιμοποιήστε την εντολή `zeroclaw doctor` για να βεβαιωθείτε ότι οι ρυθμίσεις σας είναι σωστές.
+
+## Ενημέρωση (2026-03-03)
+
+- Στην ενότητα `[agent]` προστέθηκαν τα `allowed_tools` και `denied_tools`.
+  - Αν το `allowed_tools` δεν είναι κενό, ο primary agent βλέπει μόνο τα εργαλεία της λίστας.
+  - Το `denied_tools` εφαρμόζεται μετά το allowlist και αφαιρεί επιπλέον εργαλεία.
+- Άγνωστες τιμές στο `allowed_tools` αγνοούνται (με debug log) και δεν μπλοκάρουν την εκκίνηση.
+- Αν `allowed_tools` και `denied_tools` καταλήξουν να αφαιρέσουν όλα τα εκτελέσιμα εργαλεία, η εκκίνηση αποτυγχάνει άμεσα με σαφές μήνυμα ρύθμισης.
+- Για πλήρη πίνακα πεδίων και παράδειγμα, δείτε το αγγλικό `config-reference.md` στην ενότητα `[agent]`.
+- Μην μοιράζεστε ποτέ το αρχείο `config.toml` με άλλους, καθώς περιέχει τα μυστικά κλειδιά σας (tokens).
+
+## Ενημέρωση (2026-03-12)
+
+- Στην ενότητα `[agent]` προστέθηκε το `tool_filter_groups` για φιλτράρισμα schema tool MCP ανά γύρο.
+
+### `tool_filter_groups`
+
+Μειώνει τα tokens ανά γύρο περιορίζοντας ποια schema tool MCP αποστέλλονται στο LLM. Τα ενσωματωμένα εργαλεία (χωρίς πρόθεμα `mcp_`) περνούν πάντα αναλλοίωτα.
+
+Κάθε εγγραφή είναι πίνακας με τα εξής πεδία:
+
+| Πεδίο | Τύπος | Σκοπός |
+|---|---|---|
+| `mode` | `"always"` \| `"dynamic"` | `always`: το εργαλείο συμπεριλαμβάνεται πάντα. `dynamic`: συμπεριλαμβάνεται μόνο όταν το μήνυμα χρήστη περιέχει λέξη-κλειδί. |
+| `tools` | `[string]` | Μοτίβα ονόματος εργαλείου. Υποστηρίζεται ένα `*` wildcard (π.χ. `"mcp_vikunja_*"`). |
+| `keywords` | `[string]` | (Μόνο για dynamic) Υποαλφαριθμητικά χωρίς διάκριση πεζών-κεφαλαίων που αντιστοιχούν στο τελευταίο μήνυμα χρήστη. |
+
+Όταν το `tool_filter_groups` είναι κενό, η λειτουργία είναι ανενεργή και όλα τα εργαλεία περνούν κανονικά (συμβατό με προηγούμενες εκδόσεις).
+
+Παράδειγμα:
+
+```toml
+[agent]
+# Τα εργαλεία MCP Vikunja είναι πάντα διαθέσιμα.
+[[agent.tool_filter_groups]]
+mode = "always"
+tools = ["mcp_vikunja_*"]
+
+# Τα εργαλεία MCP browser συμπεριλαμβάνονται μόνο όταν ο χρήστης αναφέρει πλοήγηση.
+[[agent.tool_filter_groups]]
+mode = "dynamic"
+tools = ["mcp_browser_*"]
+keywords = ["περιήγηση", "πλοήγηση", "άνοιγμα url", "στιγμιότυπο"]
+```

docs/i18n/vi/config-reference.md

@@ -70,6 +70,7 @@ Lưu ý cho người dùng container:
 | `max_history_messages` | `50` | Số tin nhắn lịch sử tối đa giữ lại mỗi phiên |
 | `parallel_tools` | `false` | Bật thực thi tool song song trong một lượt |
 | `tool_dispatcher` | `auto` | Chiến lược dispatch tool |
+| `tool_call_dedup_exempt` | `[]` | Tên tool được miễn kiểm tra trùng lặp trong cùng một lượt |
 
 Lưu ý:
 
@@ -77,6 +78,7 @@ Lưu ý:
 - Nếu tin nhắn kênh vượt giá trị này, runtime trả về: `Agent exceeded maximum tool iterations (<value>)`.
 - Trong vòng lặp tool của CLI, gateway và channel, các lời gọi tool độc lập được thực thi đồng thời mặc định khi không cần phê duyệt; thứ tự kết quả giữ ổn định.
 - `parallel_tools` áp dụng cho API `Agent::turn()`. Không ảnh hưởng đến vòng lặp runtime của CLI, gateway hay channel.
+- `tool_call_dedup_exempt` nhận mảng tên tool chính xác. Các tool trong danh sách được phép gọi nhiều lần với cùng tham số trong một lượt. Ví dụ: `tool_call_dedup_exempt = ["browser"]`.
 
 ## `[agents.<name>]`
 

docs/i18n/zh-CN/contributing/README.zh-CN.md

@@ -0,0 +1,20 @@
+# 贡献、评审和 CI 文档
+
+适用于贡献者、评审者和维护者。
+
+## 核心政策
+
+- 贡献指南：[../../../../CONTRIBUTING.md](../../../../CONTRIBUTING.md)
+- PR 工作流规则：[./pr-workflow.zh-CN.md](./pr-workflow.zh-CN.md)
+- 评审者手册：[./reviewer-playbook.zh-CN.md](./reviewer-playbook.zh-CN.md)
+- CI 地图和所有权：[./ci-map.zh-CN.md](./ci-map.zh-CN.md)
+- Actions 源政策：[./actions-source-policy.zh-CN.md](./actions-source-policy.zh-CN.md)
+- 扩展示例：[./extension-examples.zh-CN.md](./extension-examples.zh-CN.md)
+- 测试指南：[./testing.zh-CN.md](./testing.zh-CN.md)
+
+## 建议阅读顺序
+
+1. `CONTRIBUTING.md`
+2. `pr-workflow.md`
+3. `reviewer-playbook.md`
+4. `ci-map.md`

docs/i18n/zh-CN/contributing/actions-source-policy.zh-CN.md

@@ -0,0 +1,79 @@
+# Actions 源政策
+
+本文档定义了本仓库当前的 GitHub Actions 源代码控制政策。
+
+## 当前政策
+
+- 仓库 Actions 权限：已启用
+- 允许的 Actions 模式：已选择
+
+已选白名单（质量门控、Beta 发布和稳定发布工作流中当前使用的所有 Actions）：
+
+| Action | 使用位置 | 目的 |
+|--------|---------|---------|
+| `actions/checkout@v4` | 所有工作流 | 仓库检出 |
+| `actions/upload-artifact@v4` | release、promote-release | 上传构建产物 |
+| `actions/download-artifact@v4` | release、promote-release | 下载构建产物用于打包 |
+| `dtolnay/rust-toolchain@stable` | 所有工作流 | 安装 Rust 工具链（1.92.0） |
+| `Swatinem/rust-cache@v2` | 所有工作流 | Cargo 构建/依赖缓存 |
+| `softprops/action-gh-release@v2` | release、promote-release | 创建 GitHub Releases |
+| `docker/setup-buildx-action@v3` | release、promote-release | Docker Buildx 设置 |
+| `docker/login-action@v3` | release、promote-release | GHCR 认证 |
+| `docker/build-push-action@v6` | release、promote-release | 多平台 Docker 镜像构建和推送 |
+
+等效的白名单模式：
+
+- `actions/*`
+- `dtolnay/rust-toolchain@*`
+- `Swatinem/rust-cache@*`
+- `softprops/action-gh-release@*`
+- `docker/*`
+
+## 工作流
+
+| 工作流 | 文件 | 触发条件 |
+|----------|------|---------|
+| 质量门控 | `.github/workflows/checks-on-pr.yml` | 指向 `master` 的拉取请求 |
+| Beta 发布 | `.github/workflows/release-beta-on-push.yml` | 推送到 `master` |
+| 稳定发布 | `.github/workflows/release-stable-manual.yml` | 手动 `workflow_dispatch` |
+
+## 变更控制
+
+记录每个政策变更时包含：
+
+- 变更日期/时间（UTC）
+- 操作者
+- 原因
+- 白名单变更（新增/移除的模式）
+- 回滚说明
+
+使用以下命令导出当前有效政策：
+
+```bash
+gh api repos/zeroclaw-labs/zeroclaw/actions/permissions
+gh api repos/zeroclaw-labs/zeroclaw/actions/permissions/selected-actions
+```
+
+## 护栏
+
+- 任何新增或变更 `uses:` Action 源的 PR 必须包含白名单影响说明。
+- 新的第三方 Action 在加入白名单前需要显式的维护者评审。
+- 仅为验证过的缺失 Action 扩展白名单；避免宽泛的通配符例外。
+
+## 变更日志
+
+- 2026-03-10：重命名工作流 — CI → 质量门控（`checks-on-pr.yml`）、Beta 发布 → Release Beta（`release-beta-on-push.yml`）、升级发布 → Release Stable（`release-stable-manual.yml`）。向质量门控添加了 `lint` 和 `security` 作业。添加了跨平台构建（`cross-platform-build-manual.yml`）。
+- 2026-03-05：完整工作流重构 — 将 22 个工作流替换为 3 个（CI、Beta 发布、升级发布）
+    - 移除不再使用的模式：`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/*`
+    - 新增：`Swatinem/rust-cache@*`（替代 `useblacksmith/*` rust-cache 分支）
+    - 保留：`actions/*`、`dtolnay/rust-toolchain@*`、`softprops/action-gh-release@*`、`docker/*`
+- 2026-03-05：CI 构建优化 — 添加了 mold 链接器、cargo-nextest、CARGO_INCREMENTAL=0
+    - 由于 GHA 缓存后端不稳定导致构建失败，移除了 sccache
+
+## 回滚
+
+紧急解除阻塞路径：
+
+1. 临时将 Actions 政策设置回 `all`。
+2. 识别缺失条目后恢复选中的白名单。
+3. 记录事件和最终白名单变更。

docs/i18n/zh-CN/contributing/adding-boards-and-tools.zh-CN.md

@@ -0,0 +1,116 @@
+# 添加开发板和工具 — ZeroClaw 硬件指南
+
+本指南解释如何向 ZeroClaw 添加新的硬件开发板和自定义工具。
+
+## 快速开始：通过 CLI 添加开发板
+
+```bash
+# 添加开发板（更新 ~/.zeroclaw/config.toml）
+zeroclaw peripheral add nucleo-f401re /dev/ttyACM0
+zeroclaw peripheral add arduino-uno /dev/cu.usbmodem12345
+zeroclaw peripheral add rpi-gpio native   # 用于树莓派 GPIO（Linux）
+
+# 重启守护进程应用更改
+zeroclaw daemon --host 127.0.0.1 --port 42617
+```
+
+## 支持的开发板
+
+| 开发板           | 传输方式 | 路径示例              |
+|-----------------|-----------|---------------------------|
+| nucleo-f401re   | 串口    | /dev/ttyACM0, /dev/cu.usbmodem* |
+| arduino-uno     | 串口    | /dev/ttyACM0, /dev/cu.usbmodem* |
+| arduino-uno-q   | 桥接    | （Uno Q IP 地址）                |
+| rpi-gpio        | 原生    | native                    |
+| esp32           | 串口    | /dev/ttyUSB0              |
+
+## 手动配置
+
+编辑 `~/.zeroclaw/config.toml`：
+
+```toml
+[peripherals]
+enabled = true
+datasheet_dir = "docs/datasheets" # 可选：RAG 支持，用于将"打开红色 LED"映射到引脚 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
+```
+
+## 添加数据手册（RAG）
+
+将 `.md` 或 `.txt` 文件放入 `docs/datasheets/`（或你的 `datasheet_dir`）。按开发板命名文件：`nucleo-f401re.md`、`arduino-uno.md`。
+
+### 引脚别名（推荐）
+
+添加 `## Pin Aliases` 部分，以便代理可以将"红色 LED"映射到引脚 13：
+
+```markdown
+# 我的开发板
+
+## 引脚别名
+
+| 别名       | 引脚 |
+|-------------|-----|
+| red_led     | 13  |
+| builtin_led | 13  |
+| user_led    | 5   |
+```
+
+或使用键值格式：
+
+```markdown
+## 引脚别名
+red_led: 13
+builtin_led: 13
+```
+
+### PDF 数据手册
+
+使用 `rag-pdf` 特性时，ZeroClaw 可以索引 PDF 文件：
+
+```bash
+cargo build --features hardware,rag-pdf
+```
+
+将 PDF 放入数据手册目录。它们会被提取和分块用于 RAG（检索增强生成）。
+
+## 添加新的开发板类型
+
+1. **创建数据手册** — `docs/datasheets/my-board.md`，包含引脚别名和 GPIO（通用输入输出）信息。
+2. **添加到配置** — `zeroclaw peripheral add my-board /dev/ttyUSB0`
+3. **实现外设**（可选）—— 对于自定义协议，在 `src/peripherals/` 中实现 `Peripheral` 特征，并在 `create_peripheral_tools` 中注册。
+
+完整设计请参见 [`docs/hardware/hardware-peripherals-design.md`](../hardware/hardware-peripherals-design.zh-CN.md)。
+
+## 添加自定义工具
+
+1. 在 `src/tools/` 中实现 `Tool` 特征。
+2. 在 `create_peripheral_tools`（硬件工具）或代理工具注册表中注册。
+3. 在 `src/agent/loop_.rs` 的代理 `tool_descs` 中添加工具描述。
+
+## CLI 参考
+
+| 命令 | 描述 |
+|---------|-------------|
+| `zeroclaw peripheral list` | 列出已配置的开发板 |
+| `zeroclaw peripheral add <board> <path>` | 添加开发板（写入配置） |
+| `zeroclaw peripheral flash` | 烧录 Arduino 固件 |
+| `zeroclaw peripheral flash-nucleo` | 烧录 Nucleo 固件 |
+| `zeroclaw hardware discover` | 列出 USB 设备 |
+| `zeroclaw hardware info` | 通过 probe-rs 获取芯片信息 |
+
+## 故障排除
+
+- **找不到串口** — macOS 上使用 `/dev/cu.usbmodem*`；Linux 上使用 `/dev/ttyACM0` 或 `/dev/ttyUSB0`。
+- **构建硬件支持** — `cargo build --features hardware`
+- **Nucleo 支持 probe-rs** — `cargo build --features hardware,probe`

docs/i18n/zh-CN/contributing/cargo-slicer-speedup.zh-CN.md

@@ -0,0 +1,57 @@
+# 使用 cargo-slicer 加速构建
+
+[cargo-slicer](https://github.com/nickel-org/cargo-slicer) 是一个 `RUSTC_WRAPPER`，它在 MIR（中级中间表示，Mid-level Intermediate Representation）层对不可达的库函数进行桩实现，跳过最终二进制永远不会调用的代码的 LLVM 代码生成。
+
+## 基准测试结果
+
+| 环境 | 模式 | 基准时间 | 使用 cargo-slicer | 耗时节省 |
+|---|---|---|---|---|
+| 48 核服务器 | syn 预分析 | 3分52秒 | 3分31秒 | **-9.1%** |
+| 48 核服务器 | MIR 精确模式 | 3分52秒 | 2分49秒 | **-27.2%** |
+| 树莓派 4 | syn 预分析 | 25分03秒 | 17分54秒 | **-28.6%** |
+
+所有测量都是干净的 `cargo +nightly build --release`。MIR 精确模式读取实际的编译器 MIR 来构建更准确的调用图，相比基于 syn 的分析的 799 个单体项，它可以桩实现 1060 个单体项。
+
+## CI 集成
+
+工作流 `.github/workflows/ci-build-fast.yml`（尚未实现）旨在与标准版本构建并行运行加速版本构建。它在 Rust 代码变更和工作流变更时触发，不阻塞合并，作为非阻塞检查并行运行。
+
+CI 使用弹性双路径策略：
+- **快速路径：** 安装 `cargo-slicer` 和 `rustc-driver` 二进制文件，运行 MIR 精确模式的切片构建。
+- **回退路径：** 如果 `rustc-driver` 安装失败（例如由于 nightly `rustc` API 变化），则运行普通的 `cargo +nightly build --release`，而不是让检查失败。
+
+这可以保持检查有用且正常通过，同时在工具链兼容时保留加速能力。
+
+## 本地使用
+
+```bash
+# 一次性安装
+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
+
+# 使用 syn 预分析构建（在 zeroclaw 根目录执行）
+cargo-slicer pre-analyze
+CARGO_SLICER_VIRTUAL=1 CARGO_SLICER_CODEGEN_FILTER=1 \
+  RUSTC_WRAPPER=$(which cargo_slicer_dispatch) \
+  cargo +nightly build --release
+
+# 使用 MIR 精确模式构建（更多桩实现，更大节省）
+# 步骤 1：生成 .mir-cache（首次构建使用 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
+# 步骤 2：后续构建自动使用 .mir-cache
+```
+
+## 工作原理
+
+1. **预分析** 通过 `syn` 扫描工作区源代码，构建跨 crate 调用图（约 2 秒）。
+2. **跨 crate 广度优先搜索** 从 `main()` 开始，识别哪些公共库函数是实际可达的。
+3. **MIR 桩实现** 将不可达的函数体替换为 `Unreachable` 终止符 —— 单体收集器找不到被调用者，会修剪整个代码生成子树。
+4. **MIR 精确模式**（可选）从二进制 crate 的角度读取实际的编译器 MIR，构建真实的调用图，识别更多不可达函数。
+
+不会修改任何源文件。输出的二进制功能完全相同。

docs/i18n/zh-CN/contributing/change-playbooks.zh-CN.md

@@ -0,0 +1,55 @@
+# 变更操作手册
+
+ZeroClaw 常见扩展和修改模式的分步指南。
+
+每个扩展特征的完整代码示例请参见 [extension-examples.md](./extension-examples.zh-CN.md)。
+
+## 添加提供商
+
+- 在 `src/providers/` 中实现 `Provider` 特征。
+- 在 `src/providers/mod.rs` 工厂中注册。
+- 为工厂接线和错误路径添加聚焦测试。
+- 避免提供商特定行为泄漏到共享编排代码中。
+
+## 添加渠道
+
+- 在 `src/channels/` 中实现 `Channel` 特征。
+- 保持 `send`、`listen`、`health_check`、输入语义一致。
+- 用测试覆盖认证/白名单/健康检查行为。
+
+## 添加工具
+
+- 在 `src/tools/` 中实现带有严格参数 schema 的 `Tool` 特征。
+- 验证和清理所有输入。
+- 返回结构化的 `ToolResult`；运行时路径中避免 panic。
+
+## 添加外设
+
+- 在 `src/peripherals/` 中实现 `Peripheral` 特征。
+- 外设暴露 `tools()` —— 每个工具委托给硬件（GPIO、传感器等）。
+- 如有需要，在配置 schema 中注册开发板类型。
+- 协议和固件说明请参见 `docs/hardware/hardware-peripherals-design.md`。
+
+## 安全/运行时/网关变更
+
+- 包含威胁/风险说明和回滚策略。
+- 为故障模式和边界添加/更新测试或验证证据。
+- 保持可观测性有用但不包含敏感信息。
+- 对于 `.github/workflows/**` 变更，在 PR 说明中包含 Actions 白名单影响，源变更时更新 `docs/contributing/actions-source-policy.md`。
+
+## 文档系统/README/信息架构变更
+
+- 将文档导航视为产品 UX：保持从 README → 文档中心 → SUMMARY → 分类索引的清晰路径。
+- 保持顶层导航简洁；避免相邻导航块之间的重复链接。
+- 运行时表面变更时，更新 `docs/reference/` 中的相关参考。
+- 导航或关键措辞变更时，保持所有支持的语言（`en`、`zh-CN`、`ja`、`ru`、`fr`、`vi`）的多语言入口点一致。
+- 共享文档措辞变更时，在同一个 PR 中同步对应的本地化文档（或显式记录延迟更新和后续 PR）。
+
+## 架构边界规则
+
+- 优先通过添加特征实现 + 工厂接线来扩展功能；避免为孤立功能进行跨模块重写。
+- 保持依赖方向向内指向契约：具体集成依赖于特征/配置/工具层，而不是其他具体集成。
+- 避免跨子系统耦合（例如提供商代码导入渠道内部实现，工具代码直接修改网关策略）。
+- 保持模块职责单一：编排在 `agent/`、传输在 `channels/`、模型 I/O 在 `providers/`、策略在 `security/`、执行在 `tools/`。
+- 仅在重复使用至少三次后（三原则）才引入新的共享抽象，且至少有一个真实调用者。
+- 对于配置/schema 变更，将键视为公共契约：记录默认值、兼容性影响和迁移/回滚路径。

docs/i18n/zh-CN/contributing/ci-map.zh-CN.md

@@ -0,0 +1,127 @@
+# CI 工作流地图
+
+本文档解释每个 GitHub 工作流的作用、运行时机以及是否应该阻塞合并。
+
+关于 PR、合并、推送和发布的逐事件交付行为，请参见 [`.github/workflows/master-branch-flow.md`](../../../../.github/workflows/master-branch-flow.md)。
+
+## 合并阻塞 vs 可选
+
+合并阻塞检查应保持小巧且具有确定性。可选检查对自动化和维护很有用，但不应阻塞正常开发。
+
+### 合并阻塞
+
+- `.github/workflows/ci-run.yml`（`CI`）
+    - 目的：Rust 验证（`cargo fmt --all -- --check`、`cargo clippy --locked --all-targets -- -D clippy::correctness`、变更 Rust 行的严格增量代码检查门控、`test`、发布构建冒烟测试）+ 文档变更时的质量检查（`markdownlint` 仅阻塞变更行上的问题；链接检查仅扫描变更行上添加的链接）
+    - 附加行为：对于影响 Rust 代码的 PR 和推送，`CI Required Gate` 要求 `lint` + `test` + `build` 全部通过（无 PR 专属构建绕过）
+    - 附加行为：变更 `.github/workflows/**` 的 PR 要求至少一名 `WORKFLOW_OWNER_LOGINS` 中的用户批准（仓库变量 fallback：`theonlyhennygod,JordanTheJet,SimianAstronaut7`）
+    - 附加行为：代码检查门控在 `test`/`build` 之前运行；当 PR 上的代码检查/文档门控失败时，CI 会发布带有失败门控名称和本地修复命令的可操作反馈评论
+    - 合并门控：`CI Required Gate`
+- `.github/workflows/workflow-sanity.yml`（`Workflow Sanity`）
+    - 目的：检查 GitHub 工作流文件（`actionlint`、制表符检查）
+    - 推荐用于变更工作流的 PR
+- `.github/workflows/pr-intake-checks.yml`（`PR Intake Checks`）
+    - 目的：CI 前的安全 PR 检查（模板完整性、新增行的制表符/尾随空格/冲突标记），带有即时置顶反馈评论
+
+### 非阻塞但重要
+
+- `.github/workflows/pub-docker-img.yml`（`Docker`）
+    - 目的：`master` PR 的 Docker 冒烟检查，仅在标签推送（`v*`）时发布镜像
+- `.github/workflows/sec-audit.yml`（`Security Audit`）
+    - 目的：依赖项安全公告检查（`rustsec/audit-check`，固定 SHA）和政策/许可证检查（`cargo deny`）
+- `.github/workflows/sec-codeql.yml`（`CodeQL Analysis`）
+    - 目的：计划/手动运行的静态分析，用于发现安全问题
+- `.github/workflows/sec-vorpal-reviewdog.yml`（`Sec Vorpal Reviewdog`）
+    - 目的：使用 reviewdog 注解对支持的非 Rust 文件（`.py`、`.js`、`.jsx`、`.ts`、`.tsx`）进行手动安全编码反馈扫描
+    - 噪音控制：默认排除常见测试/夹具路径和测试文件模式（`include_tests=false`）
+- `.github/workflows/pub-release.yml`（`Release`）
+    - 目的：在验证模式下构建发布产物（手动/计划），在标签推送或手动发布模式下发布 GitHub Release
+- `.github/workflows/pub-homebrew-core.yml`（`Pub Homebrew Core`）
+    - 目的：针对标记发布的手动、机器人拥有的 Homebrew core 公式升级 PR 流程
+    - 护栏：发布标签必须匹配 `Cargo.toml` 版本
+- `.github/workflows/pr-label-policy-check.yml`（`Label Policy Sanity`）
+    - 目的：验证 `.github/label-policy.json` 中的共享贡献者等级政策，并确保标签工作流使用该政策
+- `.github/workflows/test-rust-build.yml`（`Rust Reusable Job`）
+    - 目的：可复用的 Rust 设置/缓存 + 命令运行器，供工作流调用者使用
+
+### 可选仓库自动化
+
+- `.github/workflows/pr-labeler.yml`（`PR Labeler`）
+    - 目的：范围/路径标签 + 大小/风险标签 + 细粒度模块标签（`<module>: <component>`）
+    - 附加行为：标签描述作为悬停提示自动管理，解释每个自动判断规则
+    - 附加行为：provider/config/onboard/integration 变更中与提供商相关的关键词会提升为 `provider:*` 标签（例如 `provider:kimi`、`provider:deepseek`）
+    - 附加行为：层级去重仅保留最具体的范围标签（例如 `tool:composio` 会抑制 `tool:core` 和 `tool`）
+    - 附加行为：模块命名空间会被压缩 — 单个具体模块保留 `prefix:component` 格式；多个具体模块会折叠为仅 `prefix`
+    - 附加行为：根据已合并 PR 数量为 PR 应用贡献者等级（`trusted` ≥5 个，`experienced` ≥10 个，`principal` ≥20 个，`distinguished` ≥50 个）
+    - 附加行为：最终标签集按优先级排序（`risk:*` 优先，然后是 `size:*`，然后是贡献者等级，最后是模块/路径标签）
+    - 附加行为：受管理的标签颜色按显示顺序排列，当存在多个标签时产生从左到右的平滑渐变效果
+    - 手动治理：支持 `workflow_dispatch` 的 `mode=audit|repair` 参数，用于检查/修复整个仓库的受管理标签元数据偏差
+    - 附加行为：手动编辑 PR 标签时会自动校正风险 + 大小标签（`labeled`/`unlabeled` 事件）；当维护者有意覆盖自动化风险选择时应用 `risk: manual`
+    - 高风险启发式路径：`src/security/**`、`src/runtime/**`、`src/gateway/**`、`src/tools/**`、`.github/workflows/**`
+    - 护栏：维护者可以应用 `risk: manual` 冻结自动化风险重计算
+- `.github/workflows/pr-auto-response.yml`（`PR Auto Responder`）
+    - 目的：首次贡献者引导 + 标签驱动的响应路由（`r:support`、`r:needs-repro` 等）
+    - 附加行为：根据已合并 PR 数量为 Issue 应用贡献者等级（`trusted` ≥5 个，`experienced` ≥10 个，`principal` ≥20 个，`distinguished` ≥50 个），与 PR 等级阈值完全匹配
+    - 附加行为：贡献者等级标签被视为自动化管理的（PR/Issue 上的手动添加/移除会被自动校正）
+    - 护栏：基于标签的关闭路由仅适用于 Issue；PR 永远不会被路由标签自动关闭
+- `.github/workflows/pr-check-stale.yml`（`Stale`）
+    - 目的：陈旧 Issue/PR 生命周期自动化
+- `.github/dependabot.yml`（`Dependabot`）
+    - 目的：分组、速率限制的依赖更新 PR（Cargo + GitHub Actions）
+- `.github/workflows/pr-check-status.yml`（`PR Hygiene`）
+    - 目的：提醒陈旧但活跃的 PR 在队列饥饿前 rebase/重新运行必需检查
+
+## 触发地图
+
+- `CI`：推送到 `master`、针对 `master` 的 PR
+- `Docker`：标签推送（`v*`）用于发布，匹配的 `master` PR 用于冒烟构建，手动触发仅用于冒烟测试
+- `Release`：标签推送（`v*`）、每周计划（仅验证）、手动触发（验证或发布）
+- `Pub Homebrew Core`：仅手动触发
+- `Security Audit`：推送到 `master`、针对 `master` 的 PR、每周计划
+- `Sec Vorpal Reviewdog`：仅手动触发
+- `Workflow Sanity`：当 `.github/workflows/**`、`.github/*.yml` 或 `.github/*.yaml` 变更时的 PR/推送
+- `Dependabot`：所有更新 PR 指向 `master`
+- `PR Intake Checks`：`pull_request_target` 事件（opened/reopened/synchronize/edited/ready_for_review）
+- `Label Policy Sanity`：当 `.github/label-policy.json`、`.github/workflows/pr-labeler.yml` 或 `.github/workflows/pr-auto-response.yml` 变更时的 PR/推送
+- `PR Labeler`：`pull_request_target` 生命周期事件
+- `PR Auto Responder`：Issue opened/labeled、`pull_request_target` opened/labeled
+- `Stale PR Check`：每日计划、手动触发
+- `PR Hygiene`：每 12 小时计划、手动触发
+
+## 快速分类指南
+
+1. `CI Required Gate` 失败：从 `.github/workflows/ci-run.yml` 开始排查。
+2. PR 上的 Docker 失败：检查 `.github/workflows/pub-docker-img.yml` 的 `pr-smoke` 作业。
+3. 发布失败（标签/手动/计划）：检查 `.github/workflows/pub-release.yml` 和 `prepare` 作业输出。
+4. Homebrew 公式发布失败：检查 `.github/workflows/pub-homebrew-core.yml` 摘要输出和机器人令牌/fork 变量。
+5. 安全检查失败：检查 `.github/workflows/sec-audit.yml` 和 `deny.toml`。
+6. 工作流语法/代码检查失败：检查 `.github/workflows/workflow-sanity.yml`。
+7. PR 提交检查失败：检查 `.github/workflows/pr-intake-checks.yml` 的置顶评论和运行日志。
+8. 标签政策一致性失败：检查 `.github/workflows/pr-label-policy-check.yml`。
+9. CI 中的文档检查失败：检查 `.github/workflows/ci-run.yml` 中的 `docs-quality` 作业日志。
+10. CI 中的严格增量代码检查失败：检查 `lint-strict-delta` 作业日志，并与 `BASE_SHA` 差异范围比较。
+
+## 维护规则
+
+- 保持合并阻塞检查的确定性和可复现性（适用时使用 `--locked`）。
+- 发布节奏和标签规范遵循 [`docs/contributing/release-process.md`](./release-process.zh-CN.md) 的"发布前验证"要求。
+- 保持 `.github/workflows/ci-run.yml`、`dev/ci.sh` 和 `.githooks/pre-push` 中的 Rust 质量政策一致（`./scripts/ci/rust_quality_gate.sh` + `./scripts/ci/rust_strict_delta_gate.sh`）。
+- 使用 `./scripts/ci/rust_strict_delta_gate.sh`（或 `./dev/ci.sh lint-delta`）作为变更 Rust 行的增量严格合并门控。
+- 定期通过 `./scripts/ci/rust_quality_gate.sh --strict` 运行完整严格代码检查审计（例如通过 `./dev/ci.sh lint-strict`），并在聚焦的 PR 中跟踪清理工作。
+- 通过 `./scripts/ci/docs_quality_gate.sh` 保持文档 Markdown 门控的增量性（阻塞变更行问题，单独报告基线问题）。
+- 通过 `./scripts/ci/collect_changed_links.py` + lychee 保持文档链接门控的增量性（仅检查变更行上添加的链接）。
+- 优先使用显式工作流权限（最小权限原则）。
+- 保持 Actions 源政策限制为已批准的白名单模式（参见 [`docs/contributing/actions-source-policy.md`](./actions-source-policy.zh-CN.md)）。
+- 实际可行时为耗时工作流使用路径过滤器。
+- 保持文档质量检查低噪音（增量 Markdown + 增量新增链接检查）。
+- 保持依赖更新量可控（分组 + PR 限制）。
+- 避免将引导/社区自动化与合并门控逻辑混合。
+- 测试层级：`cargo test --test component`、`cargo test --test integration`、`cargo test --test system`。
+- 实时测试（仅手动）：`cargo test --test live -- --ignored`。
+
+## 自动化副作用控制
+
+- 优先使用可手动覆盖的确定性自动化（`risk: manual`），以应对上下文复杂的情况。
+- 保持自动响应评论去重，防止分类噪音。
+- 保持自动关闭行为仅适用于 Issue；维护者拥有 PR 关闭/合并决定权。
+- 如果自动化出错，首先校正标签，然后带着显式理由继续评审。
+- 在深度评审前使用 `superseded` / `stale-candidate` 标签清理重复或休眠的 PR。

docs/i18n/zh-CN/contributing/cla.zh-CN.md

@@ -0,0 +1,98 @@
+# ZeroClaw 贡献者许可协议（CLA）
+
+**版本 1.0 — 2026 年 2 月**
+**ZeroClaw Labs**
+
+---
+
+## 目的
+
+本贡献者许可协议（"CLA"）阐明了贡献者授予 ZeroClaw Labs 的知识产权权利。本协议同时保护 ZeroClaw 项目的贡献者和用户。
+
+通过向 ZeroClaw 仓库提交贡献（拉取请求、补丁、包含代码的 Issue，或任何其他形式的代码提交），即表示你同意本 CLA 的条款。
+
+---
+
+## 1. 定义
+
+- **"贡献"** 指任何原创作品，包括对现有作品的任何修改或补充，提交给 ZeroClaw Labs 以包含在 ZeroClaw 项目中。
+
+- **"你"** 指提交贡献的个人或法律实体。
+
+- **"ZeroClaw Labs"** 指负责 ZeroClaw 项目（位于 https://github.com/zeroclaw-labs/zeroclaw）的维护者和组织。
+
+---
+
+## 2. 版权许可授予
+
+你授予 ZeroClaw Labs 和 ZeroClaw Labs 分发软件的接收者永久的、全球性的、非排他的、免费的、免许可费的、不可撤销的版权许可，用于：
+
+- 在 **MIT 许可证和 Apache 许可证 2.0 下** 复制、准备衍生作品、公开展示、公开表演、再许可和分发你的贡献及衍生作品。
+
+---
+
+## 3. 专利许可授予
+
+你授予 ZeroClaw Labs 和 ZeroClaw Labs 分发软件的接收者永久的、全球性的、非排他的、免费的、免许可费的、不可撤销的专利许可，用于制造、委托制造、使用、许诺销售、销售、进口和以其他方式转让你的贡献。
+
+本专利许可仅适用于你可授权的专利权利要求，这些权利要求仅因你的贡献本身或与 ZeroClaw 项目组合而必然被侵权。
+
+**这对你的保护：** 如果第三方针对包含你贡献的 ZeroClaw 提起专利诉讼，你对项目的专利许可不会被撤销。
+
+---
+
+## 4. 你保留权利
+
+本 CLA **不会** 将你贡献的所有权转让给 ZeroClaw Labs。你保留对贡献的完整版权所有权。你可以在任何其他项目中以任何许可自由使用你的贡献。
+
+---
+
+## 5. 原创作品
+
+你声明：
+
+1. 每项贡献都是你的原创作品，或者你有足够的权利根据本 CLA 提交。
+2. 你的贡献不会故意侵犯任何第三方的专利、版权、商标或其他知识产权。
+3. 如果你的雇主对你创造的知识产权拥有权利，你已获得提交贡献的许可，或者你的雇主已与 ZeroClaw Labs 签署了企业 CLA。
+
+---
+
+## 6. 无商标权利
+
+本 CLA 不授予你使用 ZeroClaw 名称、商标、服务标记或徽标的任何权利。商标政策请参见 [trademark.md](../maintainers/trademark.zh-CN.md)。
+
+---
+
+## 7. 署名
+
+ZeroClaw Labs 会在仓库提交历史和 NOTICE 文件中保留贡献者的署名。你的贡献会被永久公开记录。
+
+---
+
+## 8. 双许可承诺
+
+所有被接受进入 ZeroClaw 项目的贡献均同时采用以下两种许可：
+
+- **MIT 许可证** — 宽松的开源使用
+- **Apache 许可证 2.0** — 专利保护和更强的知识产权保证
+
+这种双许可模式确保为整个贡献者社区提供最大的兼容性和保护。
+
+---
+
+## 9. 如何同意
+
+通过向 ZeroClaw 仓库打开拉取请求或提交补丁，即表示你同意本 CLA。个人贡献者无需单独签名。
+
+对于 **企业贡献者**（代表公司或组织提交），请打开标题为"企业 CLA — [公司名称]"的 Issue，维护者会跟进处理。
+
+---
+
+## 10. 问题
+
+如果你对本 CLA 有疑问，请在以下地址打开 Issue：
+https://github.com/zeroclaw-labs/zeroclaw/issues
+
+---
+
+*本 CLA 基于 Apache 个人贡献者许可协议 v2.0，针对 ZeroClaw 双许可模式进行了调整。*

docs/i18n/zh-CN/contributing/custom-providers.zh-CN.md

@@ -0,0 +1,206 @@
+# 自定义提供商配置
+
+ZeroClaw 支持兼容 OpenAI 和兼容 Anthropic 的自定义 API 端点。
+
+## 提供商类型
+
+### 兼容 OpenAI 的端点（`custom:`）
+
+适用于实现 OpenAI API 格式的服务：
+
+```toml
+default_provider = "custom:https://your-api.com"
+api_key = "your-api-key"
+default_model = "your-model-name"
+```
+
+### 兼容 Anthropic 的端点（`anthropic-custom:`）
+
+适用于实现 Anthropic API 格式的服务：
+
+```toml
+default_provider = "anthropic-custom:https://your-api.com"
+api_key = "your-api-key"
+default_model = "your-model-name"
+```
+
+## 配置方法
+
+### 配置文件
+
+编辑 `~/.zeroclaw/config.toml`：
+
+```toml
+api_key = "your-api-key"
+default_provider = "anthropic-custom:https://api.example.com"
+default_model = "claude-sonnet-4-6"
+```
+
+### 环境变量
+
+对于 `custom:` 和 `anthropic-custom:` 提供商，使用通用密钥环境变量：
+
+```bash
+export API_KEY="your-api-key"
+# 或：export ZEROCLAW_API_KEY="your-api-key"
+zeroclaw agent
+```
+
+## llama.cpp 服务器（推荐本地设置）
+
+ZeroClaw 包含 `llama-server` 的一流本地提供商支持：
+
+- 提供商 ID：`llamacpp`（别名：`llama.cpp`）
+- 默认端点：`http://localhost:8080/v1`
+- API 密钥可选，除非 `llama-server` 启动时指定了 `--api-key`
+
+启动本地服务器（示例）：
+
+```bash
+llama-server -hf ggml-org/gpt-oss-20b-GGUF --jinja -c 133000 --host 127.0.0.1 --port 8033
+```
+
+然后配置 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
+```
+
+快速验证：
+
+```bash
+zeroclaw models refresh --provider llamacpp
+zeroclaw agent -m "hello"
+```
+
+此流程不需要导出 `ZEROCLAW_API_KEY=dummy`。
+
+## SGLang 服务器
+
+ZeroClaw 包含 [SGLang](https://github.com/sgl-project/sglang) 的一流本地提供商支持：
+
+- 提供商 ID：`sglang`
+- 默认端点：`http://localhost:30000/v1`
+- API 密钥可选，除非服务器要求认证
+
+启动本地服务器（示例）：
+
+```bash
+python -m sglang.launch_server --model meta-llama/Llama-3.1-8B-Instruct --port 30000
+```
+
+然后配置 ZeroClaw：
+
+```toml
+default_provider = "sglang"
+default_model = "meta-llama/Llama-3.1-8B-Instruct"
+default_temperature = 0.7
+```
+
+快速验证：
+
+```bash
+zeroclaw models refresh --provider sglang
+zeroclaw agent -m "hello"
+```
+
+此流程不需要导出 `ZEROCLAW_API_KEY=dummy`。
+
+## vLLM 服务器
+
+ZeroClaw 包含 [vLLM](https://docs.vllm.ai/) 的一流本地提供商支持：
+
+- 提供商 ID：`vllm`
+- 默认端点：`http://localhost:8000/v1`
+- API 密钥可选，除非服务器要求认证
+
+启动本地服务器（示例）：
+
+```bash
+vllm serve meta-llama/Llama-3.1-8B-Instruct
+```
+
+然后配置 ZeroClaw：
+
+```toml
+default_provider = "vllm"
+default_model = "meta-llama/Llama-3.1-8B-Instruct"
+default_temperature = 0.7
+```
+
+快速验证：
+
+```bash
+zeroclaw models refresh --provider vllm
+zeroclaw agent -m "hello"
+```
+
+此流程不需要导出 `ZEROCLAW_API_KEY=dummy`。
+
+## 测试配置
+
+验证你的自定义端点：
+
+```bash
+# 交互模式
+zeroclaw agent
+
+# 单条消息测试
+zeroclaw agent -m "test message"
+```
+
+## 故障排除
+
+### 认证错误
+
+- 验证 API 密钥正确
+- 检查端点 URL 格式（必须包含 `http://` 或 `https://`）
+- 确保端点可从你的网络访问
+
+### 模型未找到
+
+- 确认模型名称与提供商可用模型匹配
+- 查看提供商文档获取准确的模型标识符
+- 确保端点和模型系列匹配。某些自定义网关仅暴露部分模型。
+- 使用你配置的同一端点和密钥验证可用模型：
+
+```bash
+curl -sS https://your-api.com/models \
+  -H "Authorization: Bearer $API_KEY"
+```
+
+- 如果网关未实现 `/models`，发送最小化聊天请求并检查提供商返回的模型错误文本。
+
+### 连接问题
+
+- 测试端点可访问性：`curl -I https://your-api.com`
+- 验证防火墙/代理设置
+- 检查提供商状态页面
+
+## 示例
+
+### 本地 LLM 服务器（通用自定义端点）
+
+```toml
+default_provider = "custom:http://localhost:8080/v1"
+api_key = "your-api-key-if-required"
+default_model = "local-model"
+```
+
+### 企业代理
+
+```toml
+default_provider = "anthropic-custom:https://llm-proxy.corp.example.com"
+api_key = "internal-token"
+```
+
+### 云提供商网关
+
+```toml
+default_provider = "custom:https://gateway.cloud-provider.com/v1"
+api_key = "gateway-api-key"
+default_model = "gpt-4"
+```

docs/i18n/zh-CN/contributing/doc-template.zh-CN.md

@@ -0,0 +1,62 @@
+# 文档模板（运营类）
+
+在 `docs/` 下添加新的运营或工程文档时使用此模板。
+
+保留适用的部分；合并前删除不适用的占位符。
+
+---
+
+## 1. 摘要
+
+- **目的：** <一句话说明本文档存在的原因>
+- **受众：** <运维人员 | 评审者 | 贡献者 | 维护者>
+- **范围：** <本文档涵盖的内容>
+- **非目标：** <本文档有意不涵盖的内容>
+
+## 2. 前置条件
+
+- <所需环境>
+- <所需权限>
+- <所需工具/配置>
+
+## 3. 操作流程
+
+### 3.1 基线检查
+
+1. <步骤>
+2. <步骤>
+
+### 3.2 主工作流
+
+1. <步骤>
+2. <步骤>
+3. <步骤>
+
+### 3.3 验证
+
+- <预期输出或成功信号>
+- <验证命令/日志/检查点>
+
+## 4. 安全、风险和回滚
+
+- **风险表面：** <可能受影响的组件>
+- **故障模式：** <可能出现的问题>
+- **回滚计划：** <具体的回滚命令/步骤>
+
+## 5. 故障排除
+
+- **症状：** <错误/信号>
+  - **原因：** <可能的原因>
+  - **修复：** <操作>
+
+## 6. 相关文档
+
+- [README.md](./README.zh-CN.md) — 文档分类和导航。
+- <related-doc-1.md>
+- <related-doc-2.md>
+
+## 7. 维护说明
+
+- **所有者：** <团队/角色/领域>
+- **更新触发条件：** <哪些变更需要强制更新本文档>
+- **最后审核：** <YYYY-MM-DD>

docs/i18n/zh-CN/contributing/docs-contract.zh-CN.md

@@ -0,0 +1,34 @@
+# 文档系统契约
+
+将文档视为一等产品表面，而非合并后的附属产物。
+
+## 规范入口点
+
+- 根目录 README：`README.md`、`README.zh-CN.md`、`README.ja.md`、`README.ru.md`、`README.fr.md`、`README.vi.md`
+- 文档中心：`docs/README.md`、`docs/README.zh-CN.md`、`docs/README.ja.md`、`docs/README.ru.md`、`docs/README.fr.md`、`docs/README.vi.md`
+- 统一目录：`docs/SUMMARY.md`
+
+## 支持的语言
+
+`en`、`zh-CN`、`ja`、`ru`、`fr`、`vi`
+
+## 分类索引
+
+- `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`
+
+## 治理规则
+
+- 保持 README/文档中心的顶部导航和快速路径直观且不重复。
+- 更改导航架构时，保持所有支持语言的入口点一致性。
+- 如果变更涉及文档 IA（信息架构）、运行时契约参考或共享文档中的用户-facing 措辞，在同一个 PR 中完成支持语言的国际化（i18n）跟进：
+  - 更新语言导航链接（`README*`、`docs/README*`、`docs/SUMMARY.md`）。
+  - 更新存在对应版本的本地化运行时契约文档。
+  - 对于越南语，将 `docs/vi/**` 视为权威版本。
+- 提案/路线图文档要显式标记；避免将提案文本混入运行时契约文档。
+- 项目快照要标注日期，被更新日期的版本取代后保持不可变。

docs/i18n/zh-CN/contributing/extension-examples.zh-CN.md

@@ -0,0 +1,407 @@
+# 扩展示例
+
+ZeroClaw 的架构是特征（trait）驱动和模块化的。
+要添加新的提供商、渠道、工具或内存后端，实现对应的特征并在工厂模块中注册即可。
+
+本页面包含每个核心扩展点的最小可运行示例。
+如需分步集成检查清单，请参见 [change-playbooks.md](./change-playbooks.zh-CN.md)。
+
+> **权威来源：** 特征定义位于 `src/*/traits.rs`。
+> 如果此处的示例与特征文件冲突，以特征文件为准。
+
+---
+
+## 工具（`src/tools/traits.rs`）
+
+工具是代理的手 —— 让它能够与世界交互。
+
+**必需方法：** `name()`、`description()`、`parameters_schema()`、`execute()`。
+`spec()` 方法有默认实现，由其他方法组合而成。
+
+在 `src/tools/mod.rs` 中通过 `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}")),
+            }),
+        }
+    }
+}
+```
+
+---
+
+## 渠道（`src/channels/traits.rs`）
+
+渠道让 ZeroClaw 可以通过任何消息平台通信。
+
+**必需方法：** `name()`、`send(&SendMessage)`、`listen()`。
+以下方法有默认实现：`health_check()`、`start_typing()`、`stop_typing()`、
+草稿方法（`send_draft`、`update_draft`、`finalize_draft`、`cancel_draft`），
+以及反应方法（`add_reaction`、`remove_reaction`）。
+
+在 `src/channels/mod.rs` 中注册你的渠道，并在 `src/config/schema.rs` 的 `ChannelsConfig` 中添加配置。
+
+```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)
+    }
+}
+```
+
+---
+
+## 提供商（`src/providers/traits.rs`）
+
+提供商是 LLM 后端适配器。每个提供商将 ZeroClaw 连接到不同的模型 API。
+
+**必需方法：** `chat_with_system(system_prompt: Option<&str>, message: &str, model: &str, temperature: f64) -> Result<String>`。
+其他所有方法都有默认实现：
+`simple_chat()` 和 `chat_with_history()` 委托给 `chat_with_system()`；
+`capabilities()` 默认返回不支持原生工具调用；
+流方法默认返回空/错误流。
+
+在 `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"))
+    }
+}
+```
+
+---
+
+## 内存（`src/memory/traits.rs`）
+
+内存后端为代理的知识提供可插拔的持久化。
+
+**必需方法：** `name()`、`store()`、`recall()`、`get()`、`list()`、`forget()`、`count()`、`health_check()`。
+`store()` 和 `recall()` 都接受可选的 `session_id` 用于范围限定。
+
+在 `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
+    }
+}
+```
+
+---
+
+## 注册模式
+
+所有扩展特征都遵循相同的接线模式：
+
+1. 在相关的 `src/*/` 目录中创建你的实现文件。
+2. 在模块的工厂函数中注册（例如 `default_tools()`、provider 匹配分支）。
+3. 在 `src/config/schema.rs` 中添加任何需要的配置键。
+4. 为工厂接线和错误路径编写聚焦的测试。
+
+每种扩展类型的完整检查清单请参见 [change-playbooks.md](./change-playbooks.zh-CN.md)。

docs/i18n/zh-CN/contributing/langgraph-integration.zh-CN.md

@@ -0,0 +1,239 @@
+# LangGraph 集成指南
+
+本指南解释如何使用 `zeroclaw-tools` Python 包与任何兼容 OpenAI 的 LLM（大语言模型，Large Language Model）提供商实现一致的工具调用。
+
+## 背景
+
+某些 LLM 提供商，特别是像 GLM-5（智谱 AI）这样的中文模型，在使用基于文本的工具调用时行为不一致。ZeroClaw 的 Rust 核心通过 OpenAI API 格式使用结构化工具调用，但某些模型对不同方法的响应更好。
+
+LangGraph 提供了有状态的图执行引擎，无论底层模型的原生能力如何，都能保证一致的工具调用行为。
+
+## 架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      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.)          │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 快速开始
+
+### 安装
+
+```bash
+pip install zeroclaw-tools
+```
+
+### 基本用法
+
+```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())
+```
+
+## 可用工具
+
+### 核心工具
+
+| 工具 | 描述 |
+|------|-------------|
+| `shell` | 执行 shell 命令 |
+| `file_read` | 读取文件内容 |
+| `file_write` | 向文件写入内容 |
+
+### 扩展工具
+
+| 工具 | 描述 |
+|------|-------------|
+| `web_search` | 网页搜索（需要 `BRAVE_API_KEY`） |
+| `http_request` | 发送 HTTP 请求 |
+| `memory_store` | 将数据存储到持久化内存 |
+| `memory_recall` | 召回存储的数据 |
+
+## 自定义工具
+
+使用 `@tool` 装饰器创建你自己的工具：
+
+```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"
+)
+```
+
+## 提供商配置
+
+### 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（本地）
+
+```python
+agent = create_agent(
+    model="llama3.2",
+    base_url="http://localhost:11434/v1"
+)
+```
+
+## Discord 机器人集成
+
+```python
+import os
+from zeroclaw_tools.integrations import DiscordBot
+
+bot = DiscordBot(
+    token=os.environ["DISCORD_TOKEN"],
+    guild_id=123456789,  # 你的 Discord 服务器 ID
+    allowed_users=["123456789"],  # 可以使用机器人的用户 ID
+    api_key=os.environ["API_KEY"],
+    model="glm-5"
+)
+
+bot.run()
+```
+
+## CLI 用法
+
+```bash
+# 设置环境变量
+export API_KEY="your-key"
+export BRAVE_API_KEY="your-brave-key"  # 可选，用于网页搜索
+
+# 单条消息
+zeroclaw-tools "What is the current date?"
+
+# 交互模式
+zeroclaw-tools -i
+```
+
+## 与 Rust ZeroClaw 的对比
+
+| 方面 | Rust ZeroClaw | zeroclaw-tools |
+|--------|---------------|-----------------|
+| **性能** | 超快（~10ms 启动） | Python 启动（~500ms） |
+| **内存** | <5 MB | ~50 MB |
+| **二进制大小** | ~3.4 MB | pip 包 |
+| **工具一致性** | 依赖模型 | LangGraph 保证 |
+| **可扩展性** | Rust 特征 | Python 装饰器 |
+| **生态系统** | Rust crates | PyPI 包 |
+
+**何时使用 Rust ZeroClaw：**
+- 生产环境边缘部署
+- 资源受限环境（树莓派等）
+- 最高性能要求
+
+**何时使用 zeroclaw-tools：**
+- 原生工具调用行为不一致的模型
+- 以 Python 为中心的开发
+- 快速原型开发
+- 与 Python 机器学习生态系统集成
+
+## 故障排除
+
+### "API key required" 错误
+
+设置 `API_KEY` 环境变量，或向 `create_agent()` 传递 `api_key` 参数。
+
+### 工具调用未执行
+
+确保你的模型支持函数调用。某些旧模型可能不支持工具。
+
+### 速率限制
+
+在调用之间添加延迟或实现你自己的速率限制：
+
+```python
+import asyncio
+
+for message in messages:
+    result = await agent.ainvoke({"messages": [message]})
+    await asyncio.sleep(1)  # 速率限制
+```
+
+## 相关项目
+
+- [rs-graph-llm](https://github.com/a-agmon/rs-graph-llm) - Rust 版 LangGraph 替代方案
+- [langchain-rust](https://github.com/Abraxas-365/langchain-rust) - Rust 版 LangChain
+- [llm-chain](https://github.com/sobelio/llm-chain) - Rust 中的 LLM 链

docs/i18n/zh-CN/contributing/pr-discipline.zh-CN.md

@@ -0,0 +1,86 @@
+# PR 规范
+
+ZeroClaw 拉取请求的质量、署名、隐私和交接规则。
+
+## 隐私/敏感数据（必填）
+
+将隐私和中立性视为合并门控，而非尽力而为的指南。
+
+- 永远不要在代码、文档、测试、夹具、快照、日志、示例或提交消息中提交个人或敏感数据。
+- 禁止的数据包括（非详尽）：真实姓名、个人邮箱、电话号码、地址、访问令牌、API 密钥、凭证、ID 和私有 URL。
+- 使用中立的项目范围占位符（例如 `user_a`、`test_user`、`project_bot`、`example.com`）代替真实身份数据。
+- 测试名称/消息/夹具必须是非个人的、以系统为中心的；避免第一人称或特定身份的语言。
+- 如果不可避免需要类似身份的上下文，仅使用 ZeroClaw 范围的角色/标签（例如 `ZeroClawAgent`、`ZeroClawOperator`、`zeroclaw_user`）。
+- 推荐的身份安全命名调色板：
+    - 参与者标签：`ZeroClawAgent`、`ZeroClawOperator`、`ZeroClawMaintainer`、`zeroclaw_user`
+    - 服务/运行时标签：`zeroclaw_bot`、`zeroclaw_service`、`zeroclaw_runtime`、`zeroclaw_node`
+    - 环境标签：`zeroclaw_project`、`zeroclaw_workspace`、`zeroclaw_channel`
+- 如果复现外部事件，提交前脱敏和匿名化所有有效负载。
+- 推送前，专门审查 `git diff --cached` 查找意外的敏感字符串和身份泄露。
+
+## 被取代 PR 的署名（必填）
+
+当一个 PR 取代另一个贡献者的 PR 并继承了实质性代码或设计决策时，显式保留作者署名。
+
+- 在合并提交消息中，为每个其工作被实质性包含的被取代贡献者添加一个 `Co-authored-by: 姓名 <邮箱>` 尾部。
+- 使用 GitHub 认可的邮箱（`<login@users.noreply.github.com>` 或贡献者已验证的提交邮箱）。
+- 将尾部放在提交消息末尾的空行之后，单独占行；永远不要将它们编码为转义的 `\\n` 文本。
+- 在 PR 正文中，列出被取代的 PR 链接，并简要说明从每个 PR 中合并了什么。
+- 如果没有实际合并代码/设计（仅灵感），不要使用 `Co-authored-by`；在 PR 说明中给予感谢即可。
+
+## 被取代 PR 模板
+
+### PR 标题/正文模板
+
+- 推荐标题格式：`feat(<范围>): 统一并取代 #<pr_a>、#<pr_b> [和 #<pr_n>]`
+- 在 PR 正文中包含：
+
+```md
+## 取代
+- #<pr_a> 作者 @<author_a>
+- #<pr_b> 作者 @<author_b>
+
+## 合并范围
+- 来自 #<pr_a>：<实质性合并的内容>
+- 来自 #<pr_b>：<实质性合并的内容>
+
+## 署名
+- 为实质性合并的贡献者添加了 Co-authored-by 尾部：是/否
+- 如果否，说明原因
+
+## 非目标
+- <显式列出未继承的内容>
+
+## 风险和回滚
+- 风险：<摘要>
+- 回滚：<恢复提交/PR 策略>
+```
+
+### 提交消息模板
+
+```text
+feat(<范围>): 统一并取代 #<pr_a>、#<pr_b> [和 #<pr_n>]
+
+<一段关于合并结果的摘要>
+
+取代：
+- #<pr_a> 作者 @<author_a>
+- #<pr_b> 作者 @<author_b>
+
+合并范围：
+- <子系统或功能_a>：来自 #<pr_x>
+- <子系统或功能_b>：来自 #<pr_y>
+
+Co-authored-by: <姓名 A> <login_a@users.noreply.github.com>
+Co-authored-by: <姓名 B> <login_b@users.noreply.github.com>
+```
+
+## 交接模板（代理 -> 代理 / 维护者）
+
+交接工作时，包含：
+
+1. 变更了什么
+2. 没有变更什么
+3. 已运行的验证和结果
+4. 剩余风险/未知项
+5. 推荐的下一步操作

docs/i18n/zh-CN/contributing/pr-workflow.zh-CN.md

@@ -0,0 +1,366 @@
+# ZeroClaw PR 工作流（高协作吞吐量场景）
+
+本文档定义了 ZeroClaw 在高 PR 提交量场景下的处理规则，以保持：
+
+- 高性能
+- 高效率
+- 高稳定性
+- 高可扩展性
+- 高可持续性
+- 高安全性
+
+相关参考：
+
+- [`docs/README.md`](../../../README.zh-CN.md) 了解文档分类和导航。
+- [`ci-map.md`](./ci-map.zh-CN.md) 了解各工作流的所有者、触发条件和分类流程。
+- [`reviewer-playbook.md`](./reviewer-playbook.zh-CN.md) 了解评审者日常执行指南。
+
+## 0. 摘要
+
+- **目的：** 为高吞吐量协作提供确定性、基于风险的 PR 操作模型。
+- **受众：** 贡献者、维护者和代理辅助评审者。
+- **范围：** 仓库设置、PR 生命周期、就绪契约、风险路由、队列规则和恢复协议。
+- **非目标：** 替代分支保护配置或 CI 工作流源文件作为实现权威。
+
+---
+
+## 1. 按 PR 场景快速路由
+
+在完整深度评审前使用本节进行快速路由。
+
+### 1.1 提交信息不完整
+
+1. 在一条评论中请求完成模板并补充缺失的验证证据。
+2. 在提交阻塞问题解决前停止深度评审。
+
+前往：
+
+- [第 5.1 节](#51-就绪定义dor-请求评审前)
+
+### 1.2 `CI Required Gate` 检查失败
+
+1. 通过 CI 地图路由失败问题，优先修复确定性检查项。
+2. 仅在 CI 返回一致信号后重新评估风险。
+
+前往：
+
+- [ci-map.md](./ci-map.zh-CN.md)
+- [第 4.2 节](#42-步骤b验证)
+
+### 1.3 涉及高风险路径
+
+1. 升级到深度评审通道。
+2. 需要显式的回滚方案、故障模式证据和安全边界检查。
+
+前往：
+
+- [第 9 节](#9-安全和稳定性规则)
+- [reviewer-playbook.md](./reviewer-playbook.zh-CN.md)
+
+### 1.4 PR 已被取代或重复
+
+1. 要求显式的取代关联和队列清理。
+2. 经维护者确认后关闭被取代的 PR。
+
+前往：
+
+- [第 8.2 节](#82-积压压力控制)
+
+---
+
+## 2. 治理目标和控制循环
+
+### 2.1 治理目标
+
+1. 在高 PR 负载下保持可预测的合并吞吐量。
+2. 保持 CI 信号质量（快速反馈、低误报率）。
+3. 对风险表面保持显式的安全评审。
+4. 保持变更易于理解和回滚。
+5. 保持仓库产物无个人/敏感数据泄露。
+
+### 2.2 治理设计逻辑（控制循环）
+
+本工作流采用分层设计，在保持问责清晰的同时减少评审者负担：
+
+1. **提交分类：** 通过路径/大小/风险/模块标签将 PR 路由到合适的评审深度。
+2. **确定性验证：** 合并门控依赖可复现的检查，而非主观评论。
+3. **基于风险的评审深度：** 高风险路径触发深度评审，低风险路径保持快速流转。
+4. **回滚优先的合并契约：** 每个合并路径都包含具体的恢复步骤。
+
+自动化辅助分类和护栏设置，但最终合并问责仍由人类维护者和 PR 作者承担。
+
+---
+
+## 3. 必需的仓库设置
+
+在 `master` 分支上维护以下分支保护规则：
+
+- 合并前要求状态检查通过。
+- 要求 `CI Required Gate` 检查通过。
+- 合并前要求拉取请求评审。
+- 受保护路径要求 CODEOWNERS 评审。
+- 对于 `.github/workflows/**`，要求通过 `CI Required Gate`（`WORKFLOW_OWNER_LOGINS`）的所有者审批，且限制组织所有者才能绕过分支/规则集。
+- 默认工作流所有者白名单通过 `WORKFLOW_OWNER_LOGINS` 仓库变量配置（当前维护者列表参见 CODEOWNERS）。
+- 推送新提交时驳回陈旧的批准。
+- 限制受保护分支的强制推送。
+- 所有贡献者 PR 直接指向 `master` 分支。
+
+---
+
+## 4. PR 生命周期操作手册
+
+### 4.1 步骤A：提交
+
+- 贡献者提交 PR 时完整填写 `.github/pull_request_template.md`。
+- `PR Labeler` 自动应用范围/路径标签 + 大小标签 + 风险标签 + 模块标签（例如 `channel:telegram`、`provider:kimi`、`tool:shell`），并根据已合并 PR 数量应用贡献者等级（`trusted` ≥5 个合并 PR，`experienced` ≥10 个，`principal` ≥20 个，`distinguished` ≥50 个），当存在更具体的模块标签时去重不那么具体的范围标签。
+- 对于所有模块前缀，模块标签会被压缩以减少噪音：单个具体模块保留 `prefix:component` 格式，但多个具体模块会折叠为基础范围标签 `prefix`。
+- 标签排序按优先级：`risk:*` → `size:*` → 贡献者等级 → 模块/路径标签。
+- 维护者可以手动运行 `PR Labeler`（`workflow_dispatch`）的 `audit` 模式查看偏差，或 `repair` 模式标准化整个仓库的受管理标签元数据。
+- 在 GitHub 上悬停标签会显示其自动管理的描述（规则/阈值摘要）。
+- 受管理标签颜色按显示顺序排列，在长标签行上创建平滑的渐变效果。
+- `PR Auto Responder` 发布首次贡献指南，处理低信号项的标签驱动路由，并使用与 `PR Labeler` 相同的阈值自动应用 Issue 贡献者等级（`trusted` ≥5 个，`experienced` ≥10 个，`principal` ≥20 个，`distinguished` ≥50 个）。
+
+### 4.2 步骤B：验证
+
+- `CI Required Gate` 是合并门控。
+- 仅文档变更的 PR 使用快速路径，跳过重量级 Rust 任务。
+- 非文档 PR 必须通过 lint、测试和发布构建冒烟检查。
+- 影响 Rust 代码的 PR 使用与 `master` 推送相同的必需检查集（无 PR 专属构建快捷方式）。
+
+### 4.3 步骤C：评审
+
+- 评审者按风险和大小标签排序优先级。
+- 安全敏感路径（`src/security`、`src/runtime`、`src/gateway` 和 CI 工作流）需要维护者关注。
+- 大型 PR（`size: L`/`size: XL`）应拆分，除非有充分理由。
+
+### 4.4 步骤D：合并
+
+- 优先使用 **squash 合并** 保持提交历史紧凑。
+- PR 标题应遵循约定式提交（Conventional Commit）风格。
+- 仅在回滚路径已文档化时合并。
+
+---
+
+## 5. PR 就绪契约（DoR / DoD）
+
+### 5.1 就绪定义（DoR，请求评审前）
+
+- PR 模板已完全填写。
+- 范围边界明确（变更了什么 / 没变更什么）。
+- 已附加验证证据（不只是"CI 会检查"）。
+- 风险路径的安全和回滚字段已填写。
+- 已完成隐私/数据卫生检查，测试语言中立且符合项目范围。
+- 如果测试/示例中出现类似身份的措辞，已标准化为 ZeroClaw/项目原生标签。
+
+### 5.2 完成定义（DoD，可合并）
+
+- `CI Required Gate` 状态为绿色。
+- 所需评审者已批准（包括 CODEOWNERS 路径）。
+- 风险等级标签与变更路径匹配。
+- 迁移/兼容性影响已文档化。
+- 回滚路径具体且快速。
+
+---
+
+## 6. PR 大小和批量策略
+
+### 6.1 大小层级
+
+- `size: XS` ≤ 80 行变更
+- `size: S` ≤ 250 行变更
+- `size: M` ≤ 500 行变更
+- `size: L` ≤ 1000 行变更
+- `size: XL` > 1000 行变更
+
+### 6.2 策略
+
+- 默认目标为 `XS/S/M` 大小。
+- `L/XL` PR 需要显式理由和更严格的测试证据。
+- 如果不可避免需要大型功能，拆分为堆叠 PR。
+
+### 6.3 自动化行为
+
+- `PR Labeler` 根据有效变更行数应用 `size:*` 标签。
+- 仅文档/锁文件变更多的 PR 会被标准化以避免大小膨胀。
+
+---
+
+## 7. AI/代理贡献政策
+
+欢迎 AI 辅助的 PR，评审也可以由代理辅助。
+
+### 7.1 要求
+
+1. 清晰的 PR 摘要和范围边界。
+2. 显式的测试/验证证据。
+3. 风险变更的安全影响和回滚说明。
+
+### 7.2 建议
+
+1. 当自动化对变更有重大影响时，简要说明工具/工作流。
+2. 可选的提示词/计划片段以支持可复现性。
+
+我们**不**要求贡献者量化 AI 与人类的代码行占比。
+
+### 7.3 AI 重度参与 PR 的评审重点
+
+- 契约兼容性。
+- 安全边界。
+- 错误处理和降级行为。
+- 性能和内存回归。
+
+---
+
+## 8. 评审 SLA 和队列规则
+
+- 首次维护者分类目标：48 小时内。
+- 如果 PR 被阻塞，维护者留下一个可执行的检查清单。
+- 使用 `stale` 自动化保持队列健康；维护者可在需要时应用 `no-stale` 标签。
+- `pr-hygiene` 自动化每 12 小时检查开放 PR，当 PR 48 小时以上无新提交且落后于 `master` 或头部提交的 `CI Required Gate` 缺失/失败时，发布提醒。
+
+### 8.1 队列预算控制
+
+- 使用评审队列预算：限制每个维护者的并发深度评审 PR 数量，其余保持在分类状态。
+- 对于堆叠工作，要求显式的 `Depends on #...` 以使评审顺序确定。
+
+### 8.2 积压压力控制
+
+- 如果新 PR 替代了旧的开放 PR，要求填写 `Supersedes #...`，经维护者确认后关闭旧 PR。
+- 标记休眠/冗余 PR 为 `stale-candidate` 或 `superseded` 以减少重复评审工作。
+
+### 8.3 Issue 分类规则
+
+- 不完整的 bug 报告标记为 `r:needs-repro`（深度分类前要求确定性复现步骤）。
+- 使用/帮助类问题标记为 `r:support`，更适合在 bug 积压之外处理。
+- `invalid` / `duplicate` 标签触发**仅 Issue** 关闭自动化并提供指引。
+
+### 8.4 自动化副作用防护
+
+- `PR Auto Responder` 去重基于标签的评论以避免垃圾信息。
+- 自动关闭路由仅适用于 Issue，不适用于 PR。
+- 当上下文需要人工覆盖时，维护者可以使用 `risk: manual` 冻结自动化风险重计算。
+
+---
+
+## 9. 安全和稳定性规则
+
+以下区域的变更需要更严格的评审和更强的测试证据：
+
+- `src/security/**`
+- 运行时进程管理。
+- 网关入口/认证行为（`src/gateway/**`）。
+- 文件系统访问边界。
+- 网络/认证行为。
+- GitHub 工作流和发布流水线。
+- 具备执行能力的工具（`src/tools/**`）。
+
+### 9.1 风险 PR 最低要求
+
+- 威胁/风险说明。
+- 缓解措施说明。
+- 回滚步骤。
+
+### 9.2 高风险 PR 建议
+
+- 包含一个聚焦的测试证明边界行为。
+- 包含一个显式的故障模式场景和预期降级表现。
+
+对于代理辅助的贡献，评审者还应验证作者理解运行时行为和影响范围。
+
+---
+
+## 10. 故障恢复协议
+
+如果合并的 PR 导致回归：
+
+1. 立即在 `master` 上回滚 PR。
+2. 打开跟进 Issue 进行根因分析。
+3. 仅在包含回归测试后重新引入修复。
+
+优先快速恢复服务质量，而非延迟的完美修复。
+
+---
+
+## 11. 维护者合并检查清单
+
+- 范围聚焦且可理解。
+- CI 门控为绿色。
+- 文档变更时文档质量检查为绿色。
+- 安全影响字段已填写完整。
+- 隐私/数据卫生字段已填写完整，证据已脱敏/匿名化。
+- 代理工作流说明足够支持可复现性（如果使用了自动化）。
+- 回滚计划明确。
+- 提交标题遵循约定式提交规范。
+
+---
+
+## 12. 代理评审操作模型
+
+为在高 PR 量下保持评审质量稳定，使用双通道评审模型。
+
+### 12.1 通道A：快速分类（代理友好）
+
+- 确认 PR 模板完整性。
+- 确认 CI 门控信号（`CI Required Gate`）。
+- 通过标签和变更路径确认风险等级。
+- 确认存在回滚说明。
+- 确认隐私/数据卫生部分和中立措辞要求已满足。
+- 确认任何必需的类似身份措辞使用了 ZeroClaw/项目原生术语。
+
+### 12.2 通道B：深度评审（基于风险）
+
+高风险变更（安全/运行时/网关/CI）需要：
+
+- 验证威胁模型假设。
+- 验证故障模式和降级行为。
+- 验证向后兼容性和迁移影响。
+- 验证可观测性/日志影响。
+
+---
+
+## 13. 队列优先级和标签规则
+
+### 13.1 分类顺序建议
+
+1. `size: XS`/`size: S` + bug/安全修复。
+2. `size: M` 聚焦变更。
+3. `size: L`/`size: XL` 拆分请求或分阶段评审。
+
+### 13.2 标签规则
+
+- 路径标签快速识别子系统所有者。
+- 大小标签驱动批量策略。
+- 风险标签驱动评审深度（`risk: low/medium/high`）。
+- 模块标签（`<module>: <component>`）改进集成特定变更的评审者路由，支持未来新增模块。
+- `risk: manual` 允许维护者在自动化缺乏上下文时保留人工风险判断。
+- `no-stale` 保留给已接受但被阻塞的工作。
+
+---
+
+## 14. 代理交接契约
+
+当一个代理交接给另一个代理（或维护者）时，包含：
+
+1. 范围边界（变更了什么 / 没变更什么）。
+2. 验证证据。
+3. 未解决的风险和未知项。
+4. 建议的下一步操作。
+
+这可以减少上下文丢失，避免重复深度审查。
+
+---
+
+## 15. 相关文档
+
+- [README.md](../../../README.zh-CN.md) — 文档分类和导航。
+- [ci-map.md](./ci-map.zh-CN.md) — CI 工作流所有者和分类地图。
+- [reviewer-playbook.md](./reviewer-playbook.zh-CN.md) — 评审者执行模型。
+- [actions-source-policy.md](./actions-source-policy.zh-CN.md) — Action 源白名单政策。
+
+---
+
+## 16. 维护说明
+
+- **所有者：** 负责协作治理和合并质量的维护者。
+- **更新触发条件：** 分支保护变更、标签/风险政策变更、队列治理更新或代理评审流程变更。
+- **最后审核：** 2026-02-18。

docs/i18n/zh-CN/contributing/release-process.zh-CN.md

@@ -0,0 +1,133 @@
+# ZeroClaw 发布流程
+
+本操作手册定义了维护者的标准发布流程。
+
+最后验证时间：**2026 年 2 月 21 日**。
+
+## 发布目标
+
+- 保持发布可预测和可重复。
+- 仅从 `master` 分支已有的代码发布。
+- 发布前验证多目标产物。
+- 即使在高 PR 量下也保持定期发布节奏。
+
+## 标准节奏
+
+- 补丁/次要版本：每周或每两周一次。
+- 紧急安全修复：按需发布。
+- 不要等待非常大的提交批次积累。
+
+## 工作流契约
+
+发布自动化位于：
+
+- `.github/workflows/pub-release.yml`
+- `.github/workflows/pub-homebrew-core.yml`（手动 Homebrew 公式 PR，机器人所有）
+
+模式：
+
+- 标签推送 `v*`：发布模式。
+- 手动触发：仅验证或发布模式。
+- 每周计划：仅验证模式。
+
+发布模式护栏：
+
+- 标签必须符合类 semver（语义化版本）格式 `vX.Y.Z[-后缀]`。
+- 标签必须已存在于 origin 上。
+- 标签提交必须可以从 `origin/master` 访问。
+- GitHub Release 发布完成前，匹配的 GHCR 镜像标签（`ghcr.io/<所有者>/<仓库>:<标签>`）必须可用。
+- 发布前验证产物。
+
+## 维护者流程
+
+### 1) `master` 分支预检查
+
+1. 确保最新 `master` 分支上的必需检查为绿色。
+2. 确认没有高优先级事件或已知回归未解决。
+3. 确认最近 `master` 提交上的安装程序和 Docker 工作流健康。
+
+### 2) 运行验证构建（不发布）
+
+手动运行 `Pub Release`：
+
+- `publish_release`: `false`
+- `release_ref`: `master`
+
+预期结果：
+
+- 完整目标矩阵构建成功。
+- `verify-artifacts` 确认所有预期归档文件存在。
+- 不发布 GitHub Release。
+
+### 3) 创建发布标签
+
+在同步到 `origin/master` 的干净本地检出上：
+
+```bash
+scripts/release/cut_release_tag.sh vX.Y.Z --push
+```
+
+此脚本强制要求：
+
+- 工作树干净
+- `HEAD == origin/master`
+- 标签不重复
+- 符合类 semver 标签格式
+
+### 4) 监控发布运行
+
+标签推送后，监控：
+
+1. `Pub Release` 发布模式
+2. `Pub Docker Img` 发布作业
+
+预期发布输出：
+
+- 发布归档文件
+- `SHA256SUMS`
+- `CycloneDX` 和 `SPDX` SBOM（软件物料清单，Software Bill of Materials）
+- cosign 签名/证书
+- GitHub Release 说明 + 资产
+
+### 5) 发布后验证
+
+1. 验证 GitHub Release 资产可下载。
+2. 验证已发布版本的 GHCR 标签（`vX.Y.Z`）和发布提交 SHA 标签（`sha-<12位>`）。
+3. 验证依赖发布资产的安装路径（例如引导二进制下载）。
+
+### 6) 发布 Homebrew Core 公式（机器人所有）
+
+手动运行 `Pub Homebrew Core`：
+
+- `release_tag`: `vX.Y.Z`
+- 先运行 `dry_run`: `true`，再运行 `false`
+
+非试运行所需的仓库设置：
+
+- 密钥：`HOMEBREW_CORE_BOT_TOKEN`（专用机器人账户的令牌，而非个人维护者账户）
+- 变量：`HOMEBREW_CORE_BOT_FORK_REPO`（例如 `zeroclaw-release-bot/homebrew-core`）
+- 可选变量：`HOMEBREW_CORE_BOT_EMAIL`
+
+工作流护栏：
+
+- 发布标签必须匹配 `Cargo.toml` 版本
+- 公式源 URL 和 SHA256 从标记的 tarball 更新
+- 公式许可证标准化为 `Apache-2.0 OR MIT`
+- PR 从机器人 fork 提交到 `Homebrew/homebrew-core:master`
+
+## 紧急/恢复路径
+
+如果标签推送发布在产物验证后失败：
+
+1. 在 `master` 上修复工作流或打包问题。
+2. 以发布模式重新运行手动 `Pub Release`，参数：
+   - `publish_release=true`
+   - `release_tag=<现有标签>`
+   - 发布模式下 `release_ref` 会自动固定到 `release_tag`
+3. 重新验证发布的资产。
+
+## 运营注意事项
+
+- 保持发布变更小且可回滚。
+- 每个版本优先使用一个发布 Issue/检查清单，以便交接清晰。
+- 避免从临时功能分支发布。

docs/i18n/zh-CN/contributing/reviewer-playbook.zh-CN.md

@@ -0,0 +1,191 @@
+# 评审者操作手册
+
+本操作手册是 [`pr-workflow.md`](./pr-workflow.zh-CN.md) 的运营配套文档。
+如需更广泛的文档导航，请使用 [`docs/README.md`](../../../README.zh-CN.md)。
+
+## 0. 摘要
+
+- **目的：** 定义确定性的评审者操作模型，在高 PR 量下保持高评审质量。
+- **受众：** 维护者、评审者和代理辅助评审者。
+- **范围：** 提交分类、风险到深度的路由、深度评审检查、自动化覆盖和交接协议。
+- **非目标：** 替代 `CONTRIBUTING.md` 中的 PR 政策权威或 CI 文件中的工作流权威。
+
+---
+
+## 1. 按评审场景快速路由
+
+在阅读完整细节前使用本节进行快速路由。
+
+### 1.1 前 5 分钟提交检查失败
+
+1. 留下一个可执行的检查清单评论。
+2. 在提交阻塞问题修复前停止深度评审。
+
+前往：
+
+- [第 3.1 节](#31-五分钟提交分类)
+
+### 1.2 风险高或不明确
+
+1. 默认按 `risk: high` 处理。
+2. 要求深度评审和显式的回滚证据。
+
+前往：
+
+- [第 2 节](#2-评审深度决策矩阵)
+- [第 3.3 节](#33-深度评审检查清单高风险)
+
+### 1.3 自动化输出错误/有噪音
+
+1. 应用覆盖协议（`risk: manual`，去重评论/标签）。
+2. 带着显式理由继续评审。
+
+前往：
+
+- [第 5 节](#5-自动化覆盖协议)
+
+### 1.4 需要评审交接
+
+1. 交接时提供范围/风险/验证/阻塞项信息。
+2. 分配具体的下一步操作。
+
+前往：
+
+- [第 6 节](#6-交接协议)
+
+---
+
+## 2. 评审深度决策矩阵
+
+| 风险标签 | 典型变更路径 | 最低评审深度 | 所需证据 |
+|---|---|---|---|
+| `risk: low` | 文档/测试/琐事、孤立的非运行时变更 | 1 名评审者 + CI 门控 | 一致的本地验证 + 无行为歧义 |
+| `risk: medium` | `src/providers/**`、`src/channels/**`、`src/memory/**`、`src/config/**` | 1 名了解子系统的评审者 + 行为验证 | 聚焦的场景证明 + 显式副作用说明 |
+| `risk: high` | `src/security/**`、`src/runtime/**`、`src/gateway/**`、`src/tools/**`、`.github/workflows/**` | 快速分类 + 深度评审 + 回滚就绪 | 安全/故障模式检查 + 清晰的回滚方案 |
+
+不确定时，按 `risk: high` 处理。
+
+如果自动化风险标签在上下文下不正确，维护者可以应用 `risk: manual` 并显式设置最终的 `risk:*` 标签。
+
+---
+
+## 3. 标准评审工作流
+
+### 3.1 五分钟提交分类
+
+对于每个新 PR：
+
+1. 确认模板完整性（`summary`、`validation`、`security`、`rollback`）。
+2. 确认标签存在且合理：
+   - `size:*`、`risk:*`
+   - 范围标签（例如 `provider`、`channel`、`security`）
+   - 模块级标签（`channel:*`、`provider:*`、`tool:*`）
+   - 适用时的贡献者等级标签
+3. 确认 CI 信号状态（`CI Required Gate`）。
+4. 确认范围单一（除非有理由，否则拒绝混合的大型 PR）。
+5. 确认隐私/数据卫生和中立测试措辞要求已满足。
+
+如果任何提交要求失败，留下一个可执行的检查清单评论，而非进行深度评审。
+
+### 3.2 快速通道检查清单（所有 PR）
+
+- 范围边界明确且可信。
+- 存在验证命令且结果一致。
+- 用户-facing 行为变更已文档化。
+- 作者理解行为和影响范围（尤其是代理辅助的 PR）。
+- 回滚路径具体（不只是"revert"）。
+- 兼容性/迁移影响清晰。
+- 差异产物中无个人/敏感数据泄露；示例/测试保持中立且符合项目范围。
+- 如果存在类似身份的措辞，使用 ZeroClaw/项目原生角色（而非个人或真实世界身份）。
+- 命名和架构边界遵循项目契约（`AGENTS.md`、`CONTRIBUTING.md`）。
+
+### 3.3 深度评审检查清单（高风险）
+
+对于高风险 PR，验证每个类别至少有一个具体示例：
+
+- **安全边界：** 保留默认拒绝行为，无意外的范围扩大。
+- **故障模式：** 错误处理显式且安全降级。
+- **契约稳定性：** CLI/配置/API 兼容性保留或已文档化迁移方案。
+- **可观测性：** 故障可诊断且不泄露密钥。
+- **回滚安全性：** 回滚路径和影响范围清晰。
+
+### 3.4 评审评论结果风格
+
+优先使用检查清单风格的评论，带有一个明确的结果：
+
+- **可合并**（说明原因）。
+- **需要作者操作**（有序的阻塞项列表）。
+- **需要更深入的安全/运行时评审**（说明确切风险和所需证据）。
+
+避免模糊的评论，以免造成不必要的来回延迟。
+
+---
+
+## 4. Issue 分类和积压治理
+
+### 4.1 Issue 分类标签操作手册
+
+使用标签保持积压可执行：
+
+- 不完整的 bug 报告标记为 `r:needs-repro`。
+- 使用/支持问题标记为 `r:support`，更适合路由到 bug 积压之外。
+- 不可操作的重复/噪音标记为 `duplicate` / `invalid`。
+- 等待外部阻塞项的已接受工作标记为 `no-stale`。
+- 当日志/有效负载包含个人标识符或敏感数据时，要求脱敏。
+
+### 4.2 PR 积压清理协议
+
+当评审需求超过容量时，按以下顺序应用：
+
+1. 将活跃的 bug/安全 PR（`size: XS/S`）保持在队列顶部。
+2. 要求重叠的 PR 合并；经确认后将旧 PR 关闭为 `superseded`。
+3. 在 stale 关闭窗口开始前，将休眠 PR 标记为 `stale-candidate`。
+4. 重新打开 stale/被取代的技术工作前，要求 rebase + 新的验证。
+
+---
+
+## 5. 自动化覆盖协议
+
+当自动化输出产生评审副作用时使用：
+
+1. **错误的风险标签：** 添加 `risk: manual`，然后设置预期的 `risk:*` 标签。
+2. **Issue 分类时错误的自动关闭：** 重新打开 Issue，移除路由标签，留下一条澄清评论。
+3. **标签垃圾信息/噪音：** 保留一条规范的维护者评论，移除冗余的路由标签。
+4. **模糊的 PR 范围：** 深度评审前要求拆分。
+
+---
+
+## 6. 交接协议
+
+如果将评审交接给另一位维护者/代理，包含：
+
+1. 范围摘要。
+2. 当前风险等级和理由。
+3. 已验证的内容。
+4. 未解决的阻塞项。
+5. 建议的下一步操作。
+
+---
+
+## 7. 每周队列卫生
+
+- 评审 stale 队列，仅对已接受但被阻塞的工作应用 `no-stale`。
+- 优先处理 `size: XS/S` 的 bug/安全 PR。
+- 将重复出现的支持问题转化为文档更新和自动响应指引。
+
+---
+
+## 8. 相关文档
+
+- [README.md](../../../README.zh-CN.md) — 文档分类和导航。
+- [pr-workflow.md](./pr-workflow.zh-CN.md) — 治理工作流和合并契约。
+- [ci-map.md](./ci-map.zh-CN.md) — CI 所有者和分类地图。
+- [actions-source-policy.md](./actions-source-policy.zh-CN.md) — Action 源白名单政策。
+
+---
+
+## 9. 维护说明
+
+- **所有者：** 负责评审质量和队列吞吐量的维护者。
+- **更新触发条件：** PR 政策变更、风险路由模型变更或自动化覆盖行为变更。
+- **最后审核：** 2026-02-18。

docs/i18n/zh-CN/contributing/testing-telegram.zh-CN.md

@@ -0,0 +1,310 @@
+# 🧪 测试执行指南
+
+## 快速参考
+
+```bash
+# 完整自动化测试套件（约 2 分钟）
+./tests/telegram/test_telegram_integration.sh
+
+# 快速冒烟测试（约 10 秒）
+./tests/telegram/quick_test.sh
+
+# 仅编译和单元测试（约 30 秒）
+cargo test telegram --lib
+```
+
+## 📝 已为你创建的内容
+
+### 1. **test_telegram_integration.sh**（主测试套件）
+
+   - **20+ 自动化测试** 覆盖所有修复
+   - **6 个测试阶段**：代码质量、构建、配置、健康检查、功能、手动
+   - **彩色输出** 带通过/失败指示器
+   - 结尾提供 **详细摘要**
+
+   ```bash
+   ./tests/telegram/test_telegram_integration.sh
+   ```
+
+### 2. **quick_test.sh**（快速验证）
+
+   - **4 个核心测试** 用于快速反馈
+   - **<10 秒** 执行时间
+   - 完美适合 **pre-commit** 检查
+
+   ```bash
+   ./tests/telegram/quick_test.sh
+   ```
+
+### 3. **generate_test_messages.py**（测试助手）
+
+   - 生成各种长度的测试消息
+   - 测试消息拆分功能
+   - 8 种不同的消息类型
+
+   ```bash
+   # 生成一条长消息（>4096 字符）
+   python3 tests/telegram/generate_test_messages.py long
+
+   # 显示所有消息类型
+   python3 tests/telegram/generate_test_messages.py all
+   ```
+
+### 4. **TESTING_TELEGRAM.md**（完整指南）
+
+   - 全面的测试文档
+   - 故障排除指南
+   - 性能基准
+   - CI/CD 集成示例
+
+## 🚀 分步指南：首次运行
+
+### 步骤 1：运行自动化测试
+
+```bash
+cd /Users/abdzsam/zeroclaw
+
+# 赋予脚本执行权限（已完成）
+chmod +x tests/telegram/test_telegram_integration.sh tests/telegram/quick_test.sh
+
+# 运行完整测试套件
+./tests/telegram/test_telegram_integration.sh
+```
+
+**预期输出：**
+```
+⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡
+
+███████╗███████╗██████╗  ██████╗  ██████╗██╗      █████╗ ██╗    ██╗
+...
+
+🧪 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! 🎉
+```
+
+### 步骤 2：配置 Telegram（如果未完成）
+
+```bash
+# 交互式设置
+zeroclaw onboard --interactive
+
+# 或仅渠道设置
+zeroclaw onboard --channels-only
+```
+
+提示时：
+1. 选择 **Telegram** 渠道
+2. 输入从 @BotFather 获取的 **机器人令牌**
+3. 输入你的 **Telegram 用户 ID** 或用户名
+
+### 步骤 3：验证健康状态
+
+```bash
+zeroclaw channel doctor
+```
+
+**预期输出：**
+```
+🩺 ZeroClaw Channel Doctor
+
+  ✅ Telegram  healthy
+
+Summary: 1 healthy, 0 unhealthy, 0 timed out
+```
+
+### 步骤 4：手动测试
+
+#### 测试 1：基础消息
+
+```bash
+# 终端 1：启动渠道
+zeroclaw channel start
+```
+
+**在 Telegram 中：**
+- 找到你的机器人
+- 发送：`Hello bot!`
+- **验证：** 机器人在 3 秒内响应
+
+#### 测试 2：长消息（拆分测试）
+
+```bash
+# 生成一条长消息
+python3 tests/telegram/generate_test_messages.py long
+```
+
+- **复制输出**
+- **粘贴到 Telegram** 发送给你的机器人
+- **验证：**
+  - 消息被拆分为 2+ 个块
+  - 第一个块以 `(continues...)` 结尾
+  - 中间块带有 `(continued)` 和 `(continues...)`
+  - 最后一个块以 `(continued)` 开头
+  - 所有块按顺序到达
+
+#### 测试 3：单词边界拆分
+
+```bash
+python3 tests/telegram/generate_test_messages.py word
+```
+
+- 发送给机器人
+- **验证：** 在单词边界拆分（不会拆分单词中间）
+
+## 🎯 测试结果检查清单
+
+运行所有测试后，验证：
+
+### 自动化测试
+
+- [ ] ✅ 所有 20 个自动化测试通过
+- [ ] ✅ 构建成功完成
+- [ ] ✅ 二进制大小 <10MB
+- [ ] ✅ 健康检查在 <5 秒内完成
+- [ ] ✅ 无 clippy 警告
+
+### 手动测试
+
+- [ ] ✅ 机器人响应基础消息
+- [ ] ✅ 长消息正确拆分
+- [ ] ✅ 出现继续标记
+- [ ] ✅ 尊重单词边界
+- [ ] ✅ 白名单阻止未授权用户
+- [ ] ✅ 日志中无错误
+
+### 性能
+
+- [ ] ✅ 响应时间 <3 秒
+- [ ] ✅ 内存使用 <10MB
+- [ ] ✅ 无消息丢失
+- [ ] ✅ 速率限制正常工作（100ms 延迟）
+
+## 🐛 故障排除
+
+### 问题：测试编译失败
+
+```bash
+# 清理构建
+cargo clean
+cargo build --release
+
+# 更新依赖
+cargo update
+```
+
+### 问题："Bot token not configured"
+
+```bash
+# 检查配置
+cat ~/.zeroclaw/config.toml | grep -A 5 telegram
+
+# 重新配置
+zeroclaw onboard --channels-only
+```
+
+### 问题：健康检查失败
+
+```bash
+# 直接测试机器人令牌
+curl "https://api.telegram.org/bot<YOUR_TOKEN>/getMe"
+
+# 应返回：{"ok":true,"result":{...}}
+```
+
+### 问题：机器人不响应
+
+```bash
+# 启用调试日志
+RUST_LOG=debug zeroclaw channel start
+
+# 查找：
+# - "Telegram channel listening for messages..."
+# - "ignoring message from unauthorized user"（如果是白名单问题）
+# - 任何错误消息
+```
+
+## 📊 性能基准
+
+所有修复完成后，你应该看到：
+
+| 指标 | 目标 | 命令 |
+|--------|--------|---------|
+| 单元测试通过率 | 24/24 | `cargo test telegram --lib` |
+| 构建时间 | <30s | `time cargo build --release` |
+| 二进制大小 | ~3-4MB | `ls -lh target/release/zeroclaw` |
+| 健康检查 | <5s | `time zeroclaw channel doctor` |
+| 首次响应 | <3s | Telegram 中手动测试 |
+| 消息拆分 | <50ms | 检查调试日志 |
+| 内存使用 | <10MB | `ps aux \| grep zeroclaw` |
+
+## 🔄 CI/CD 集成
+
+添加到你的工作流：
+
+```bash
+# Pre-commit 钩子
+#!/bin/bash
+./tests/telegram/quick_test.sh
+
+# CI 流水线
+./tests/telegram/test_telegram_integration.sh
+```
+
+## 📚 下一步
+
+1. **运行测试：**
+   ```bash
+   ./tests/telegram/test_telegram_integration.sh
+   ```
+
+2. **使用故障排除指南** 修复任何失败
+
+3. **使用检查清单** 完成手动测试
+
+4. **所有测试通过后** 部署到生产环境
+
+5. **监控日志** 查看任何问题：
+   ```bash
+   zeroclaw daemon
+   # 或
+   RUST_LOG=info zeroclaw channel start
+   ```
+
+## 🎉 成功
+
+如果所有测试通过：
+- ✅ 消息拆分正常工作（4096 字符限制）
+- ✅ 健康检查有 5 秒超时
+- ✅ 空 chat_id 被安全处理
+- ✅ 所有 24 个单元测试通过
+- ✅ 代码已准备好生产环境
+
+**你的 Telegram 集成已就绪！** 🚀
+
+---
+
+## 📞 支持
+
+- Issue：<https://github.com/zeroclaw-labs/zeroclaw/issues>
+- 文档：[testing-telegram.md](../../../../tests/telegram/testing-telegram.md)
+- 帮助：`zeroclaw --help`

docs/i18n/zh-CN/contributing/testing.zh-CN.md

@@ -0,0 +1,149 @@
+# 测试指南
+
+ZeroClaw 使用基于文件系统组织的五级测试分类体系。
+
+## 测试分类
+
+| 级别 | 测试内容 | 外部边界 | 目录 |
+|-------|--------------|-------------------|-----------|
+| **单元（Unit）** | 单个函数/结构体 | 所有内容都被模拟 | `src/**/*.rs` 中的 `#[cfg(test)]` 块，或独立的 `src/**/tests.rs` 文件 |
+| **组件（Component）** | 边界内的单个子系统 | 子系统为真实实现，其他所有内容被模拟 | `tests/component/` |
+| **集成（Integration）** | 多个内部组件组合在一起 | 内部为真实实现，外部 API 被模拟 | `tests/integration/` |
+| **系统（System）** | 跨所有内部边界的完整请求→响应流程 | 仅外部 API 被模拟 | `tests/system/` |
+| **实时（Live）** | 使用真实外部服务的完整栈 | 无模拟，标记为 `#[ignore]` | `tests/live/` |
+
+## 目录结构
+
+| 目录 | 级别 | 描述 | 运行命令 |
+|-----------|-------|-------------|-------------|
+| `src/**/*.rs` | 单元 | 与源代码共存的 `#[cfg(test)]` 块或独立的 `tests.rs` 文件 | `cargo test --lib` |
+| `tests/component/` | 组件 | 单个子系统，真实实现，边界被模拟 | `cargo test --test component` |
+| `tests/integration/` | 集成 | 多个组件组合在一起 | `cargo test --test integration` |
+| `tests/system/` | 系统 | 完整的渠道→代理→渠道流程 | `cargo test --test system` |
+| `tests/live/` | 实时 | 真实外部服务，标记为 `#[ignore]` | `cargo test --test live -- --ignored` |
+| `tests/manual/` | — | 人工驱动的测试脚本（shell、Python） | 直接运行 |
+| `tests/support/` | — | 共享模拟基础设施（非测试二进制文件） | — |
+| `tests/fixtures/` | — | 测试数据文件（JSON 追踪、媒体文件） | — |
+
+## 如何运行测试
+
+```bash
+# 运行所有测试（单元 + 组件 + 集成 + 系统）
+cargo test
+
+# 仅运行单元测试
+cargo test --lib
+
+# 运行组件测试
+cargo test --test component
+
+# 运行集成测试
+cargo test --test integration
+
+# 运行系统测试
+cargo test --test system
+
+# 运行实时测试（需要 API 凭证）
+cargo test --test live -- --ignored
+
+# 在某个级别内过滤测试
+cargo test --test integration agent
+
+# 完整 CI 验证
+./dev/ci.sh all
+
+# 特定级别的 CI 命令
+./dev/ci.sh test-component
+./dev/ci.sh test-integration
+./dev/ci.sh test-system
+```
+
+## 如何添加新测试
+
+1. **测试单个隔离的子系统？** → `tests/component/`
+2. **测试多个组件协同工作？** → `tests/integration/`
+3. **测试完整消息流程？** → `tests/system/`
+4. **需要真实 API 密钥？** → `tests/live/` 并标记为 `#[ignore]`
+
+创建测试文件后，将其添加到对应的 `mod.rs` 中，并使用 `tests/support/` 中的共享基础设施。
+
+## 共享基础设施（`tests/support/`）
+
+所有测试二进制文件都包含 `mod support;`，可以通过 `crate::support::*` 访问共享模拟。
+
+| 模块 | 内容 |
+|--------|----------|
+| `mock_provider.rs` | `MockProvider`（FIFO 脚本化）、`RecordingProvider`（捕获请求）、`TraceLlmProvider`（JSON 夹具重放） |
+| `mock_tools.rs` | `EchoTool`、`CountingTool`、`FailingTool`、`RecordingTool` |
+| `mock_channel.rs` | `TestChannel`（捕获发送内容、记录输入事件） |
+| `helpers.rs` | `make_memory()`、`make_observer()`、`build_agent()`、`text_response()`、`tool_response()`、`StaticMemoryLoader` |
+| `trace.rs` | `LlmTrace`、`TraceTurn`、`TraceStep` 类型 + `LlmTrace::from_file()` |
+| `assertions.rs` | 用于声明式追踪断言的 `verify_expects()` |
+
+### 用法
+
+```rust
+use crate::support::{MockProvider, EchoTool, CountingTool};
+use crate::support::helpers::{build_agent, text_response, tool_response};
+```
+
+## JSON 追踪测试夹具
+
+追踪夹具是存储在 `tests/fixtures/traces/` 中的 JSON 文件格式的 LLM 响应脚本。它们用声明式的对话脚本替代了内联的模拟设置。
+
+### 工作原理
+
+1. `TraceLlmProvider` 加载夹具并实现 `Provider` 特征
+2. 每个 `provider.chat()` 调用按 FIFO 顺序返回夹具中的下一步
+3. 真实工具正常执行（例如 `EchoTool` 处理参数）
+4. 所有轮次结束后，`verify_expects()` 检查声明式断言
+5. 如果代理调用提供商的次数超过步骤数，测试失败
+
+### 夹具格式
+
+```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
+  }
+}
+```
+
+**响应类型：** `"text"`（纯文本）或 `"tool_calls"`（LLM 请求工具执行）。
+
+**期望字段：** `response_contains`、`response_not_contains`、`tools_used`、`tools_not_used`、`max_tool_calls`、`all_tools_succeeded`、`response_matches`（正则表达式）。
+
+## 实时测试约定
+
+- 所有实时测试必须标记为 `#[ignore]`
+- 使用 `env::var("ZEROCLAW_TEST_*")` 获取凭证
+- 运行命令：`cargo test --test live -- --ignored --nocapture`
+
+## 手动测试（`tests/manual/`）
+
+无法通过 `cargo test` 自动化的人工驱动测试脚本：
+
+| 目录/文件 | 作用 |
+|---|---|
+| `manual/telegram/` | Telegram 集成测试套件、冒烟测试、消息生成器 |
+| `manual/test_dockerignore.sh` | 验证 `.dockerignore` 排除敏感路径 |
+
+Telegram 特定的测试细节请参见 [testing-telegram.md](./testing-telegram.zh-CN.md)。

docs/i18n/zh-CN/hardware/README.zh-CN.md

@@ -0,0 +1,19 @@
+# 硬件与外设文档
+
+用于开发板集成、固件流程和外设架构。
+
+ZeroClaw 的硬件子系统通过 `Peripheral` 特征实现对微控制器和外设的直接控制。每个开发板暴露 GPIO（通用输入输出）、ADC（模数转换器）和传感器操作工具，允许代理在 STM32 Nucleo、树莓派和 ESP32 等开发板上驱动硬件交互。完整架构请参见 [hardware-peripherals-design.md](hardware-peripherals-design.zh-CN.md)。
+
+## 入口点
+
+- 架构和外设模型：[hardware-peripherals-design.md](hardware-peripherals-design.zh-CN.md)
+- 添加新开发板/工具：[../contributing/adding-boards-and-tools.md](../contributing/adding-boards-and-tools.zh-CN.md)
+- Nucleo 设置：[nucleo-setup.md](nucleo-setup.zh-CN.md)
+- Arduino Uno R4 WiFi 设置：[arduino-uno-q-setup.md](arduino-uno-q-setup.zh-CN.md)
+
+## 数据手册
+
+- 数据手册索引：[datasheets](datasheets)
+- STM32 Nucleo-F401RE：[datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.zh-CN.md)
+- Arduino Uno：[datasheets/arduino-uno.md](datasheets/arduino-uno.zh-CN.md)
+- ESP32：[datasheets/esp32.md](datasheets/esp32.zh-CN.md)

docs/i18n/zh-CN/hardware/android-setup.zh-CN.md

@@ -0,0 +1,103 @@
+# Android 安装指南
+
+ZeroClaw 为 Android 设备提供预构建二进制文件。
+
+## 支持的架构
+
+| 目标 | Android 版本 | 设备 |
+|--------|-----------------|---------|
+| `armv7-linux-androideabi` | Android 4.1+ (API 16+) | 旧款 32 位手机（Galaxy S3 等） |
+| `aarch64-linux-android` | Android 5.0+ (API 21+) | 现代 64 位手机 |
+
+## 通过 Termux 安装
+
+在 Android 上运行 ZeroClaw 最简单的方式是通过 [Termux](https://termux.dev/)。
+
+### 1. 安装 Termux
+
+从 [F-Droid](https://f-droid.org/packages/com.termux/)（推荐）或 GitHub 发布页下载。
+
+> ⚠️ **注意：** Play Store 版本已过时且不受支持。
+
+### 2. 下载 ZeroClaw
+
+```bash
+# 检查你的架构
+uname -m
+# aarch64 = 64 位, armv7l/armv8l = 32 位
+
+# 下载对应的二进制文件
+# 64 位（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
+
+# 32 位（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. 安装和运行
+
+```bash
+chmod +x zeroclaw
+mv zeroclaw $PREFIX/bin/
+
+# 验证安装
+zeroclaw --version
+
+# 运行设置
+zeroclaw onboard
+```
+
+## 通过 ADB 直接安装
+
+适用于希望在 Termux 之外运行 ZeroClaw 的高级用户：
+
+```bash
+# 在安装了 ADB（Android 调试桥）的电脑上执行
+adb push zeroclaw /data/local/tmp/
+adb shell chmod +x /data/local/tmp/zeroclaw
+adb shell /data/local/tmp/zeroclaw --version
+```
+
+> ⚠️ 在 Termux 之外运行需要 root 权限或特定权限才能获得完整功能。
+
+## Android 上的限制
+
+- **无 systemd：** 守护进程模式使用 Termux 的 `termux-services`
+- **存储访问：** 需要 Termux 存储权限（`termux-setup-storage`）
+- **网络：** 某些功能可能需要 Android VPN 权限才能进行本地绑定
+
+## 从源码构建
+
+如需自行构建 Android 版本：
+
+```bash
+# 安装 Android NDK
+# 添加目标
+rustup target add armv7-linux-androideabi aarch64-linux-android
+
+# 设置 NDK 路径
+export ANDROID_NDK_HOME=/path/to/ndk
+export PATH=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH
+
+# 构建
+cargo build --release --target armv7-linux-androideabi
+cargo build --release --target aarch64-linux-android
+```
+
+## 故障排除
+
+### "Permission denied"
+
+```bash
+chmod +x zeroclaw
+```
+
+### "not found" 或链接器错误
+
+确保你下载了与设备架构匹配的正确版本。
+
+### 旧版 Android（4.x）
+
+使用 API 级别 16+ 支持的 `armv7-linux-androideabi` 构建。

docs/i18n/zh-CN/hardware/arduino-uno-q-setup.zh-CN.md

@@ -0,0 +1,217 @@
+# Arduino Uno Q 上的 ZeroClaw — 分步指南
+
+在 Arduino Uno Q 的 Linux 端运行 ZeroClaw。Telegram 通过 Wi-Fi 工作；GPIO 控制使用桥接（需要最小化的 App Lab 应用）。
+
+---
+
+## 已包含的内容（无需修改代码）
+
+ZeroClaw 包含 Arduino Uno Q 所需的一切。**克隆仓库并按照本指南操作 —— 无需补丁或自定义代码。**
+
+| 组件 | 位置 | 目的 |
+|-----------|----------|---------|
+| 桥接应用 | `firmware/uno-q-bridge/` | MCU 草图 + Python Socket 服务器（端口 9999）用于 GPIO |
+| 桥接工具 | `src/peripherals/uno_q_bridge.rs` | 通过 TCP 与桥接通信的 `gpio_read` / `gpio_write` 工具 |
+| 设置命令 | `src/peripherals/uno_q_setup.rs` | `zeroclaw peripheral setup-uno-q` 通过 scp + arduino-app-cli 部署桥接 |
+| 配置 schema | `board = "arduino-uno-q"`, `transport = "bridge"` | 在 `config.toml` 中支持 |
+
+使用 `--features hardware` 构建以包含 Uno Q 支持。
+
+---
+
+## 前置条件
+
+- 已配置 Wi-Fi 的 Arduino Uno Q
+- 安装在 Mac 上的 Arduino App Lab（用于初始设置和部署）
+- LLM 的 API 密钥（OpenRouter 等）
+
+---
+
+## 阶段 1：Uno Q 初始设置（一次性）
+
+### 1.1 通过 App Lab 配置 Uno Q
+
+1. 下载 [Arduino App Lab](https://docs.arduino.cc/software/app-lab/)（Linux 上是 AppImage）。
+2. 通过 USB 连接 Uno Q，开机。
+3. 打开 App Lab，连接到开发板。
+4. 按照设置向导操作：
+   - 设置用户名和密码（用于 SSH）
+   - 配置 Wi-Fi（SSID、密码）
+   - 应用所有固件更新
+5. 记录显示的 IP 地址（例如 `arduino@192.168.1.42`），或稍后在 App Lab 的终端中通过 `ip addr show` 查找。
+
+### 1.2 验证 SSH 访问
+
+```bash
+ssh arduino@<UNO_Q_IP>
+# 输入你设置的密码
+```
+
+---
+
+## 阶段 2：在 Uno Q 上安装 ZeroClaw
+
+### 选项 A：在设备上构建（更简单，约 20–40 分钟）
+
+```bash
+# SSH 进入 Uno Q
+ssh arduino@<UNO_Q_IP>
+
+# 安装 Rust
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+source ~/.cargo/env
+
+# 安装构建依赖（Debian）
+sudo apt-get update
+sudo apt-get install -y pkg-config libssl-dev
+
+# 克隆 zeroclaw（或 scp 你的项目）
+git clone https://github.com/zeroclaw-labs/zeroclaw.git
+cd zeroclaw
+
+# 构建（在 Uno Q 上约 15–30 分钟）
+cargo build --release --features hardware
+
+# 安装
+sudo cp target/release/zeroclaw /usr/local/bin/
+```
+
+### 选项 B：在 Mac 上交叉编译（更快）
+
+```bash
+# 在 Mac 上 — 添加 aarch64 目标
+rustup target add aarch64-unknown-linux-gnu
+
+# 安装交叉编译器（macOS；链接所需）
+brew tap messense/macos-cross-toolchains
+brew install aarch64-unknown-linux-gnu
+
+# 构建
+CC_aarch64_unknown_linux_gnu=aarch64-unknown-linux-gnu-gcc cargo build --release --target aarch64-unknown-linux-gnu --features hardware
+
+# 复制到 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/"
+```
+
+如果交叉编译失败，使用选项 A 在设备上构建。
+
+---
+
+## 阶段 3：配置 ZeroClaw
+
+### 3.1 运行引导配置（或手动创建配置）
+
+```bash
+ssh arduino@<UNO_Q_IP>
+
+# 快速配置
+zeroclaw onboard --api-key YOUR_OPENROUTER_KEY --provider openrouter
+
+# 或手动创建配置
+mkdir -p ~/.zeroclaw/workspace
+nano ~/.zeroclaw/config.toml
+```
+
+### 3.2 最小化 config.toml
+
+```toml
+api_key = "YOUR_OPENROUTER_API_KEY"
+default_provider = "openrouter"
+default_model = "anthropic/claude-sonnet-4-6"
+
+[peripherals]
+enabled = false
+# 通过桥接使用 GPIO 需要完成阶段 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
+```
+
+---
+
+## 阶段 4：运行 ZeroClaw 守护进程
+
+```bash
+ssh arduino@<UNO_Q_IP>
+
+# 运行守护进程（Telegram 轮询通过 Wi-Fi 工作）
+zeroclaw daemon --host 127.0.0.1 --port 42617
+```
+
+**此时：** Telegram 聊天正常工作。向你的机器人发送消息 —— ZeroClaw 会响应。还没有 GPIO 功能。
+
+---
+
+## 阶段 5：通过桥接实现 GPIO（ZeroClaw 自动处理）
+
+ZeroClaw 包含桥接应用和设置命令。
+
+### 5.1 部署桥接应用
+
+**从你的 Mac**（在 zeroclaw 仓库中）：
+```bash
+zeroclaw peripheral setup-uno-q --host 192.168.0.48
+```
+
+**从 Uno Q**（已 SSH 连接）：
+```bash
+zeroclaw peripheral setup-uno-q
+```
+
+这会将桥接应用复制到 `~/ArduinoApps/uno-q-bridge` 并启动。
+
+### 5.2 添加到 config.toml
+
+```toml
+[peripherals]
+enabled = true
+
+[[peripherals.boards]]
+board = "arduino-uno-q"
+transport = "bridge"
+```
+
+### 5.3 运行 ZeroClaw
+
+```bash
+zeroclaw daemon --host 127.0.0.1 --port 42617
+```
+
+现在当你向 Telegram 机器人发送 *"Turn on the LED"* 或 *"Set pin 13 high"* 时，ZeroClaw 会通过桥接使用 `gpio_write`。
+
+---
+
+## 命令摘要（从头到尾）
+
+| 步骤 | 命令 |
+|------|---------|
+| 1 | 在 App Lab 中配置 Uno Q（Wi-Fi、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 | 编辑 `~/.zeroclaw/config.toml`（添加 Telegram bot_token） |
+| 9 | `zeroclaw daemon --host 127.0.0.1 --port 42617` |
+| 10 | 向 Telegram 机器人发送消息 —— 它会响应 |
+
+---
+
+## 故障排除
+
+- **"command not found: zeroclaw"** — 使用完整路径：`/usr/local/bin/zeroclaw` 或确保 `~/.cargo/bin` 在 PATH 中。
+- **Telegram 不响应** — 检查 bot_token、allowed_users，以及 Uno Q 有互联网连接（Wi-Fi）。
+- **内存不足** — 保持特性最小化（Uno Q 使用 `--features hardware`）；考虑设置 `compact_context = true`。
+- **GPIO 命令被忽略** — 确保桥接应用正在运行（`zeroclaw peripheral setup-uno-q` 会部署并启动它）。配置必须包含 `board = "arduino-uno-q"` 和 `transport = "bridge"`。
+- **LLM 提供商（GLM/智谱）** — 使用 `default_provider = "glm"` 或 `"zhipu"`，并在环境或配置中设置 `GLM_API_KEY`。ZeroClaw 使用正确的 v4 端点。

docs/i18n/zh-CN/hardware/datasheets/arduino-uno.zh-CN.md

@@ -0,0 +1,37 @@
+# Arduino Uno
+
+## 引脚别名
+
+| 别名       | 引脚 |
+|-------------|-----|
+| red_led     | 13  |
+| builtin_led | 13  |
+| user_led    | 13  |
+
+## 概述
+
+Arduino Uno 是基于 ATmega328P 的微控制器开发板。它有 14 个数字 I/O 引脚（0–13）和 6 个模拟输入（A0–A5）。
+
+## 数字引脚
+
+- **引脚 0–13：** 数字 I/O。可设置为 INPUT 或 OUTPUT。
+- **引脚 13：** 板载内置 LED。可将 LED 连接到 GND 或用作输出。
+- **引脚 0–1：** 也用于串口（RX/TX）。如果使用串口请避免占用。
+
+## GPIO
+
+- 输出使用 `digitalWrite(pin, HIGH)` 或 `digitalWrite(pin, LOW)`。
+- 输入使用 `digitalRead(pin)`（返回 0 或 1）。
+- ZeroClaw 协议中的引脚编号：0–13。
+
+## 串口
+
+- UART 位于引脚 0（RX）和 1（TX）。
+- 通过 ATmega16U2 或 CH340（克隆板）实现 USB 连接。
+- ZeroClaw 固件使用的波特率：115200。
+
+## ZeroClaw 工具
+
+- `gpio_read`：读取引脚值（0 或 1）。
+- `gpio_write`：设置引脚为高电平（1）或低电平（0）。
+- `arduino_upload`：代理生成完整的 Arduino 草图代码；ZeroClaw 通过 arduino-cli 编译并上传。用于"制作心形"、自定义图案等场景 —— 代理编写代码，无需手动编辑。引脚 13 = 内置 LED。

docs/i18n/zh-CN/hardware/datasheets/esp32.zh-CN.md

@@ -0,0 +1,22 @@
+# ESP32 GPIO 参考
+
+## 引脚别名
+
+| 别名       | 引脚 |
+|-------------|-----|
+| builtin_led | 2   |
+| red_led     | 2   |
+
+## 常用引脚（ESP32 / ESP32-C3）
+
+- **GPIO 2**：许多开发板上的内置 LED（输出）
+- **GPIO 13**：通用输出
+- **GPIO 21/20**：常用于 UART0 TX/RX（如果使用串口请避免占用）
+
+## 协议
+
+ZeroClaw 主机通过串口发送 JSON（波特率 115200）：
+- `gpio_read`：`{"id":"1","cmd":"gpio_read","args":{"pin":13}}`
+- `gpio_write`：`{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}`
+
+响应：`{"id":"1","ok":true,"result":"0"}` 或 `{"id":"1","ok":true,"result":"done"}`

docs/i18n/zh-CN/hardware/datasheets/nucleo-f401re.zh-CN.md

@@ -0,0 +1,16 @@
+# Nucleo-F401RE GPIO
+
+## 引脚别名
+
+| 别名       | 引脚 |
+|-------------|-----|
+| red_led     | 13  |
+| user_led    | 13  |
+| ld2         | 13  |
+| builtin_led | 13  |
+
+## GPIO
+
+引脚 13：用户 LED（LD2）
+- 输出，高电平有效
+- STM32F401 上的 PA5

docs/i18n/zh-CN/hardware/hardware-peripherals-design.zh-CN.md

@@ -0,0 +1,324 @@
+# 硬件外设设计 — ZeroClaw
+
+ZeroClaw 让微控制器（MCU，Microcontroller Unit）和单板计算机（SBC，Single Board Computer）能够**动态解释自然语言命令**，生成硬件特定代码，并实时执行外设交互。
+
+## 1. 愿景
+
+**目标：** ZeroClaw 作为具备硬件感知能力的 AI 代理，能够：
+- 通过渠道（WhatsApp、Telegram）接收自然语言触发（例如"移动 X 机械臂"、"打开 LED"）
+- 获取准确的硬件文档（数据手册、寄存器映射）
+- 使用 LLM（大语言模型，如 Gemini、本地开源模型）合成 Rust 代码/逻辑
+- 执行逻辑操作外设（GPIO、I2C、SPI）
+- 持久化优化后的代码供未来复用
+
+**思维模型：** ZeroClaw = 理解硬件的大脑。外设 = 它控制的手臂和腿。
+
+## 2. 两种运行模式
+
+### 模式 1：边缘原生（独立运行）
+
+**目标：** 支持 Wi-Fi 的开发板（ESP32、树莓派）。
+
+ZeroClaw **直接运行在设备上**。开发板启动 gRPC/nanoRPC 服务器，与本地外设通信。
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  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)  │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+**工作流：**
+1. 用户发送 WhatsApp 消息：*"打开引脚 13 上的 LED"*
+2. ZeroClaw 获取开发板特定文档（例如 ESP32 GPIO 映射）
+3. LLM 合成 Rust 代码
+4. 代码在沙箱中运行（Wasm 或动态链接）
+5. GPIO 被切换；结果返回给用户
+6. 优化后的代码被持久化，供未来"打开 LED"请求使用
+
+**所有操作都在设备上完成。** 不需要主机。
+
+### 模式 2：主机介导（开发/调试）
+
+**目标：** 通过 USB / J-Link / Aardvark 连接到主机（macOS、Linux）的硬件。
+
+ZeroClaw 运行在**主机**上，并维护到目标的硬件感知链接。用于开发、内省和烧录。
+
+```
+┌─────────────────────┐                    ┌──────────────────────────────────┐
+│  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        │                                    │
+└─────────────────────┘                    └──────────────────────────────────┘
+```
+
+**工作流：**
+1. 用户发送 Telegram 消息：*"这个 USB 设备上的可读内存地址是什么？"*
+2. ZeroClaw 识别连接的硬件（VID/PID、架构）
+3. 执行内存映射；建议可用的地址空间
+4. 将结果返回给用户
+
+**或：**
+1. 用户：*"将这个固件烧录到 Nucleo"*
+2. ZeroClaw 通过 OpenOCD 或 probe-rs 写入/烧录
+3. 确认成功
+
+**或：**
+1. ZeroClaw 自动发现：*"STM32 Nucleo 位于 /dev/ttyACM0，ARM Cortex-M4"*
+2. 建议：*"我可以读取/写入 GPIO、ADC、闪存。你想做什么？"*
+
+---
+
+### 模式对比
+
+| 方面           | 边缘原生                    | 主机介导                    |
+|------------------|--------------------------------|----------------------------------|
+| ZeroClaw 运行位置 | 设备（ESP32、树莓派）           | 主机（Mac、Linux）                |
+| 硬件链接    | 本地（GPIO、I2C、SPI）        | USB、J-Link、Aardvark            |
+| LLM              | 设备端或云端（Gemini）   | 主机（云端或本地）            |
+| 使用场景         | 生产环境、独立运行         | 开发、调试、内省       |
+| 渠道         | WhatsApp 等（通过 Wi-Fi）      | Telegram、CLI 等              |
+
+## 3. 传统/简单模式（边缘 LLM 之前）
+
+对于没有 Wi-Fi 的开发板，或在边缘原生模式完全就绪之前：
+
+### 模式 A：主机 + 远程外设（通过串口的 STM32）
+
+主机运行 ZeroClaw；外设运行最小化固件。通过串口传输简单 JSON。
+
+### 模式 B：树莓派作为主机（原生 GPIO）
+
+ZeroClaw 运行在树莓派上；通过 rppal 或 sysfs 访问 GPIO。不需要单独的固件。
+
+## 4. 技术要求
+
+| 要求 | 描述 |
+|-------------|-------------|
+| **语言** | 纯 Rust。嵌入式目标（STM32、ESP32）适用时使用 `no_std`。 |
+| **通信** | 轻量级 gRPC 或 nanoRPC 栈，用于低延迟命令处理。 |
+| **动态执行** | 安全地即时运行 LLM 生成的逻辑：用于隔离的 Wasm 运行时，或支持时使用动态链接。 |
+| **文档检索** | RAG（检索增强生成）流水线，将数据手册片段、寄存器映射和引脚定义输入到 LLM 上下文。 |
+| **硬件发现** | USB 设备基于 VID/PID 的识别；架构检测（ARM Cortex-M、RISC-V 等）。 |
+
+### RAG 流水线（数据手册检索）
+
+- **索引：** 数据手册、参考手册、寄存器映射（PDF → 分块、嵌入向量）。
+- **检索：** 用户查询（"打开 LED"）时，获取相关片段（例如目标开发板的 GPIO 部分）。
+- **注入：** 添加到 LLM 系统提示或上下文。
+- **结果：** LLM 生成准确的、开发板特定的代码。
+
+### 动态执行选项
+
+| 选项 | 优点 | 缺点 |
+|-------|------|------|
+| **Wasm** | 沙箱化、可移植、无 FFI | 开销大；Wasm 对硬件访问有限 |
+| **动态链接** | 原生速度、完全硬件访问 | 平台特定；安全隐患 |
+| **解释型 DSL** | 安全、可审计 | 速度慢；表达能力有限 |
+| **预编译模板** | 快速、安全 | 灵活性较低；需要模板库 |
+
+**建议：** 从预编译模板 + 参数化开始；稳定后演进到 Wasm 支持用户自定义逻辑。
+
+## 5. CLI 和配置
+
+### CLI 标志
+
+```bash
+# 边缘原生：在设备上运行（ESP32、树莓派）
+zeroclaw agent --mode edge
+
+# 主机介导：连接到 USB/J-Link 目标
+zeroclaw agent --peripheral nucleo-f401re:/dev/ttyACM0
+zeroclaw agent --probe jlink
+
+# 硬件内省
+zeroclaw hardware discover
+zeroclaw hardware introspect /dev/ttyACM0
+```
+
+### 配置（config.toml）
+
+```toml
+[peripherals]
+enabled = true
+mode = "host"  # "edge" | "host"
+datasheet_dir = "docs/datasheets"  # RAG: 供 LLM 上下文使用的开发板特定文档
+
+[[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"
+# 边缘原生：ZeroClaw 运行在 ESP32 上
+```
+
+## 6. 架构：外设作为扩展点
+
+### 新特征：`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>>;
+}
+```
+
+### 流程
+
+1. **启动：** ZeroClaw 加载配置，读取 `peripherals.boards`。
+2. **连接：** 为每个开发板创建 `Peripheral` 实现，调用 `connect()`。
+3. **工具：** 收集所有连接外设的工具；与默认工具合并。
+4. **代理循环：** 代理可以调用 `gpio_write`、`sensor_read` 等 —— 这些调用委托给外设。
+5. **关闭：** 对每个外设调用 `disconnect()`。
+
+### 开发板支持
+
+| 开发板              | 传输方式 | 固件 / 驱动      | 工具                    |
+|--------------------|-----------|------------------------|--------------------------|
+| nucleo-f401re      | 串口    | Zephyr / Embassy       | gpio_read, gpio_write, adc_read |
+| rpi-gpio           | 原生    | rppal or sysfs         | gpio_read, gpio_write    |
+| esp32              | 串口/websocket | ESP-IDF / Embassy      | gpio, wifi, mqtt         |
+
+## 7. 通信协议
+
+### gRPC / nanoRPC（边缘原生、主机介导）
+
+用于 ZeroClaw 和外设之间的低延迟、类型化 RPC：
+
+- **nanoRPC** 或 **tonic**（gRPC）：Protobuf 定义的服务。
+- 方法：`GpioWrite`、`GpioRead`、`I2cTransfer`、`SpiTransfer`、`MemoryRead`、`FlashWrite` 等。
+- 支持流、双向调用和从 `.proto` 文件生成代码。
+
+### 串口回退（主机介导、传统）
+
+对于不支持 gRPC 的开发板，通过串口传输简单 JSON：
+
+**请求（主机 → 外设）：**
+```json
+{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}
+```
+
+**响应（外设 → 主机）：**
+```json
+{"id":"1","ok":true,"result":"done"}
+```
+
+## 8. 固件（独立仓库或 crate）
+
+- **zeroclaw-firmware** 或 **zeroclaw-peripheral** —— 独立的 crate/工作区。
+- 目标：`thumbv7em-none-eabihf`（STM32）、`armv7-unknown-linux-gnueabihf`（树莓派）等。
+- STM32 使用 `embassy` 或 Zephyr。
+- 实现上述协议。
+- 用户将其烧录到开发板；ZeroClaw 连接并发现能力。
+
+## 9. 实现阶段
+
+### 阶段 1：骨架 ✅（已完成）
+
+- [x] 添加 `Peripheral` 特征、配置 schema、CLI（`zeroclaw peripheral list/add`）
+- [x] 为代理添加 `--peripheral` 标志
+- [x] 在 AGENTS.md 中记录
+
+### 阶段 2：主机介导 — 硬件发现 ✅（已完成）
+
+- [x] `zeroclaw hardware discover`：枚举 USB 设备（VID/PID）
+- [x] 开发板注册表：映射 VID/PID → 架构、名称（例如 Nucleo-F401RE）
+- [x] `zeroclaw hardware introspect <path>`：内存映射、外设列表
+
+### 阶段 3：主机介导 — 串口 / J-Link
+
+- [x] 支持通过 USB CDC 连接 STM32 的 `SerialPeripheral`
+- [ ] 集成 probe-rs 或 OpenOCD 用于烧录/调试
+- [x] 工具：`gpio_read`、`gpio_write`（未来支持 memory_read、flash_write）
+
+### 阶段 4：RAG 流水线 ✅（已完成）
+
+- [x] 数据手册索引（markdown/text → 分块）
+- [x] 硬件相关查询时检索并注入到 LLM 上下文
+- [x] 开发板特定提示增强
+
+**用法：** 在 config.toml 的 `[peripherals]` 部分添加 `datasheet_dir = "docs/datasheets"`。按开发板命名放置 `.md` 或 `.txt` 文件（例如 `nucleo-f401re.md`、`rpi-gpio.md`）。`_generic/` 目录下或名为 `generic.md` 的文件适用于所有开发板。通过关键词匹配检索分块并注入到用户消息上下文。
+
+### 阶段 5：边缘原生 — 树莓派 ✅（已完成）
+
+- [x] 树莓派上的 ZeroClaw（通过 rppal 实现原生 GPIO）
+- [ ] 用于本地外设访问的 gRPC/nanoRPC 服务器
+- [ ] 代码持久化（存储合成的片段）
+
+### 阶段 6：边缘原生 — ESP32
+
+- [x] 主机介导的 ESP32（串口传输）—— 与 STM32 相同的 JSON 协议
+- [x] `esp32` 固件 crate（`firmware/esp32`）—— 通过 UART 实现 GPIO
+- [x] 硬件注册表中的 ESP32（CH340 VID/PID）
+- [ ] ESP32 上运行 ZeroClaw（Wi-Fi + LLM，边缘原生）—— 未来
+- [ ] 基于 Wasm 或模板的 LLM 生成逻辑执行
+
+**用法：** 将 `firmware/esp32` 烧录到 ESP32，在配置中添加 `board = "esp32"`、`transport = "serial"`、`path = "/dev/ttyUSB0"`。
+
+### 阶段 7：动态执行（LLM 生成代码）
+
+- [ ] 模板库：参数化的 GPIO/I2C/SPI 片段
+- [ ] 可选：用于用户自定义逻辑的 Wasm 运行时（沙箱化）
+- [ ] 持久化和复用优化的代码路径
+
+## 10. 安全考虑
+
+- **串口路径：** 验证 `path` 在白名单中（例如 `/dev/ttyACM*`、`/dev/ttyUSB*`）；永远不允许任意路径。
+- **GPIO：** 限制暴露的引脚；避免电源/复位引脚。
+- **外设上无密钥：** 固件不应存储 API 密钥；主机处理认证。
+
+## 11. 非目标（目前）
+
+- 在裸 STM32 上运行完整 ZeroClaw（无 Wi-Fi、RAM 有限）—— 改用主机介导模式
+- 实时保证 —— 外设是尽力而为的
+- LLM 生成的任意原生代码执行 —— 优先使用 Wasm 或模板
+
+## 12. 相关文档
+
+- [adding-boards-and-tools.md](../contributing/adding-boards-and-tools.zh-CN.md) — 如何添加开发板和数据手册
+- [network-deployment.md](../ops/network-deployment.zh-CN.md) — 树莓派和网络部署
+
+## 13. 参考
+
+- [Zephyr RTOS Rust support](https://docs.zephyrproject.org/latest/develop/languages/rust/index.html)
+- [Embassy](https://embassy.dev/) — 异步嵌入式框架
+- [rppal](https://github.com/golemparts/rppal) — Rust 实现的树莓派 GPIO
+- [STM32 Nucleo-F401RE](https://www.st.com/en/evaluation-tools/nucleo-f401re.html)
+- [tonic](https://github.com/hyperium/tonic) — Rust 实现的 gRPC
+- [probe-rs](https://probe.rs/) — ARM 调试探针、烧录、内存访问
+- [nusb](https://github.com/nic-hartley/nusb) — USB 设备枚举（VID/PID）
+
+## 14. 原始提示词摘要
+
+> *"像 ESP、树莓派或带 Wi-Fi 的开发板可以连接到 LLM（Gemini 或开源模型）。ZeroClaw 运行在设备上，创建自己的 gRPC 服务，启动服务并与外设通信。用户通过 WhatsApp 询问：'移动 X 机械臂'或'打开 LED'。ZeroClaw 获取准确的文档，编写代码，执行它，优化存储，运行并打开 LED —— 所有操作都在开发板上完成。*
+>
+> *对于通过 USB/J-Link/Aardvark 连接到我 Mac 的 STM Nucleo：我 Mac 上的 ZeroClaw 访问硬件，在设备上安装或写入想要的内容，并返回结果。示例：'嘿 ZeroClaw，这个 USB 设备上的可用/可读地址是什么？'它能找出连接的内容和位置并给出建议。"*

docs/i18n/zh-CN/hardware/nucleo-setup.zh-CN.md

@@ -0,0 +1,147 @@
+# Nucleo-F401RE 上的 ZeroClaw — 分步指南
+
+在 Mac 或 Linux 主机上运行 ZeroClaw。通过 USB 连接 Nucleo-F401RE。通过 Telegram 或 CLI 控制 GPIO（LED、引脚）。
+
+---
+
+## 通过 Telegram 获取开发板信息（无需固件）
+
+ZeroClaw 可以通过 USB 从 Nucleo 读取芯片信息，**无需烧录任何固件**。向你的 Telegram 机器人发送消息：
+
+- *"我有什么开发板信息？"*
+- *"开发板信息"*
+- *"连接了什么硬件？"*
+- *"芯片信息"*
+
+代理使用 `hardware_board_info` 工具返回芯片名称、架构和内存映射。启用 `probe` 特性时，它会通过 USB/SWD 读取实时数据；否则返回静态数据手册信息。
+
+**配置：** 首先将 Nucleo 添加到 `config.toml`（以便代理知道查询哪个开发板）：
+
+```toml
+[[peripherals.boards]]
+board = "nucleo-f401re"
+transport = "serial"
+path = "/dev/ttyACM0"
+baud = 115200
+```
+
+**CLI 替代方案：**
+
+```bash
+cargo build --features hardware,probe
+zeroclaw hardware info
+zeroclaw hardware discover
+```
+
+---
+
+## 已包含的内容（无需修改代码）
+
+ZeroClaw 包含 Nucleo-F401RE 所需的一切：
+
+| 组件 | 位置 | 目的 |
+|-----------|----------|---------|
+| 固件 | `firmware/nucleo/` | Embassy Rust — USART2（115200）、gpio_read、gpio_write |
+| 串门外设 | `src/peripherals/serial.rs` | 基于串口的 JSON 协议（与 Arduino/ESP32 相同） |
+| 烧录命令 | `zeroclaw peripheral flash-nucleo` | 构建固件，通过 probe-rs 烧录 |
+
+协议：换行符分隔的 JSON。请求：`{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}`。响应：`{"id":"1","ok":true,"result":"done"}`。
+
+---
+
+## 前置条件
+
+- Nucleo-F401RE 开发板
+- USB 线（USB-A 转 Mini-USB；Nucleo 内置 ST-Link）
+- 烧录所需：`cargo install probe-rs-tools --locked`（或使用[安装脚本](https://probe.rs/docs/getting-started/installation/)）
+
+---
+
+## 阶段 1：烧录固件
+
+### 1.1 连接 Nucleo
+
+1. 通过 USB 将 Nucleo 连接到 Mac/Linux。
+2. 开发板会显示为 USB 设备（ST-Link）。现代系统不需要单独的驱动。
+
+### 1.2 通过 ZeroClaw 烧录
+
+在 zeroclaw 仓库根目录执行：
+
+```bash
+zeroclaw peripheral flash-nucleo
+```
+
+这会构建 `firmware/nucleo` 并运行 `probe-rs run --chip STM32F401RETx`。固件烧录后立即运行。
+
+### 1.3 手动烧录（替代方案）
+
+```bash
+cd firmware/nucleo
+cargo build --release --target thumbv7em-none-eabihf
+probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/nucleo
+```
+
+---
+
+## 阶段 2：查找串口
+
+- **macOS：** `/dev/cu.usbmodem*` 或 `/dev/tty.usbmodem*`（例如 `/dev/cu.usbmodem101`）
+- **Linux：** `/dev/ttyACM0`（或插入后查看 `dmesg`）
+
+USART2（PA2/PA3）桥接到 ST-Link 的虚拟 COM 端口，因此主机看到一个串口设备。
+
+---
+
+## 阶段 3：配置 ZeroClaw
+
+添加到 `~/.zeroclaw/config.toml`：
+
+```toml
+[peripherals]
+enabled = true
+
+[[peripherals.boards]]
+board = "nucleo-f401re"
+transport = "serial"
+path = "/dev/cu.usbmodem101"   # 调整为你的端口
+baud = 115200
+```
+
+---
+
+## 阶段 4：运行和测试
+
+```bash
+zeroclaw daemon --host 127.0.0.1 --port 42617
+```
+
+或直接使用代理：
+
+```bash
+zeroclaw agent --message "Turn on the LED on pin 13"
+```
+
+引脚 13 = PA5 = Nucleo-F401RE 上的用户 LED（LD2）。
+
+---
+
+## 命令摘要
+
+| 步骤 | 命令 |
+|------|---------|
+| 1 | 通过 USB 连接 Nucleo |
+| 2 | `cargo install probe-rs-tools --locked` |
+| 3 | `zeroclaw peripheral flash-nucleo` |
+| 4 | 将 Nucleo 添加到 config.toml（path = 你的串口） |
+| 5 | `zeroclaw daemon` 或 `zeroclaw agent -m "Turn on LED"` |
+
+---
+
+## 故障排除
+
+- **flash-nucleo 无法识别** — 从仓库构建：`cargo run --features hardware -- peripheral flash-nucleo`。该子命令仅在仓库构建中包含，crates.io 安装版本不包含。
+- **找不到 probe-rs** — `cargo install probe-rs-tools --locked`（`probe-rs` crate 是库；CLI 在 `probe-rs-tools` 中）
+- **未检测到探针** — 确保 Nucleo 已连接。尝试其他 USB 线/端口。
+- **找不到串口** — 在 Linux 上，将用户添加到 `dialout` 组：`sudo usermod -a -G dialout $USER`，然后注销/登录。
+- **GPIO 命令被忽略** — 检查配置中的 `path` 与你的串口匹配。运行 `zeroclaw peripheral list` 验证。