83f1d474bd
Extends the hardware subsystem with three clusters of functionality, all feature-gated (hardware / peripheral-rpi) with no impact on default builds. Raspberry Pi native support: - src/hardware/rpi.rs: board self-discovery (model, serial, revision), sysfs GPIO pin read/write, and ACT LED control - scripts/99-act-led.rules: udev rule for non-root ACT LED access - scripts/deploy-rpi.sh, scripts/rpi-config.toml, scripts/zeroclaw.service: one-shot deployment helper and systemd service template Total Phase Aardvark USB adapter (I2C / SPI / GPIO): - crates/aardvark-sys/: new workspace crate with FFI bindings loaded at runtime via libloading; graceful stub fallback when .so is absent or arch mismatches (Rosetta 2 detection) - src/hardware/aardvark.rs: AardvarkTransport implementing Transport trait - src/hardware/aardvark_tools.rs: agent tools i2c_scan, i2c_read, i2c_write, spi_transfer, gpio_aardvark - src/hardware/datasheet.rs: datasheet search/download for detected devices - docs/aardvark-integration.md, examples/hardware/aardvark/: guide + examples Hardware plugin / ToolRegistry system: - src/hardware/tool_registry.rs: ToolRegistry for hardware module tool sets - src/hardware/loader.rs, src/hardware/manifest.rs: manifest-driven loader - src/hardware/subprocess.rs: subprocess execution helper for board I/O - src/gateway/hardware_context.rs: POST /api/hardware/reload endpoint - src/hardware/mod.rs: exports all new modules; merge_hardware_tools and load_hardware_context_prompt helpers Integration hooks (minimal surface): - src/hardware/device.rs: DeviceKind::Aardvark, DeviceRuntime::Aardvark, has_aardvark / resolve_aardvark_device on DeviceRegistry - src/hardware/transport.rs: TransportKind::Aardvark - src/peripherals/mod.rs: gate create_board_info_tools behind hardware feature - src/agent/loop_.rs: TOOL_CHOICE_OVERRIDE task-local for Anthropic provider - src/providers/anthropic.rs: read TOOL_CHOICE_OVERRIDE; add tool_choice field - Cargo.toml: add aardvark-sys to workspace and as dependency - firmware/zeroclaw-nucleo/: update Cargo.toml and Cargo.lock Non-goals: - No changes to agent orchestration, channels, providers, or security policy - No new config keys outside existing [hardware] / [peripherals] sections - No CI workflow changes Risk: Low. All new paths are feature-gated; aardvark.so loads at runtime only when present. No schema migrations or persistent state introduced. Rollback: revert this single commit. |
||
|---|---|---|
| .. | ||
| assets | ||
| contributing | ||
| hardware | ||
| i18n | ||
| maintainers | ||
| ops | ||
| reference | ||
| security | ||
| setup-guides | ||
| vi | ||
| aardvark-integration.md | ||
| README.ar.md | ||
| README.bn.md | ||
| README.cs.md | ||
| README.da.md | ||
| README.de.md | ||
| README.el.md | ||
| README.es.md | ||
| README.fi.md | ||
| README.fr.md | ||
| README.he.md | ||
| README.hi.md | ||
| README.hu.md | ||
| README.id.md | ||
| README.it.md | ||
| README.ja.md | ||
| README.ko.md | ||
| README.md | ||
| README.nb.md | ||
| README.nl.md | ||
| README.pl.md | ||
| README.pt.md | ||
| README.ro.md | ||
| README.ru.md | ||
| README.sv.md | ||
| README.th.md | ||
| README.tl.md | ||
| README.tr.md | ||
| README.uk.md | ||
| README.ur.md | ||
| README.vi.md | ||
| README.zh-CN.md | ||
| SUMMARY.ar.md | ||
| SUMMARY.bn.md | ||
| SUMMARY.cs.md | ||
| SUMMARY.da.md | ||
| SUMMARY.de.md | ||
| SUMMARY.el.md | ||
| SUMMARY.es.md | ||
| SUMMARY.fi.md | ||
| SUMMARY.fr.md | ||
| SUMMARY.he.md | ||
| SUMMARY.hi.md | ||
| SUMMARY.hu.md | ||
| SUMMARY.id.md | ||
| SUMMARY.it.md | ||
| SUMMARY.ja.md | ||
| SUMMARY.ko.md | ||
| SUMMARY.md | ||
| SUMMARY.nb.md | ||
| SUMMARY.nl.md | ||
| SUMMARY.pl.md | ||
| SUMMARY.pt.md | ||
| SUMMARY.ro.md | ||
| SUMMARY.ru.md | ||
| SUMMARY.sv.md | ||
| SUMMARY.th.md | ||
| SUMMARY.tl.md | ||
| SUMMARY.tr.md | ||
| SUMMARY.uk.md | ||
| SUMMARY.ur.md | ||
| SUMMARY.vi.md | ||
| SUMMARY.zh-CN.md | ||
ZeroClaw Documentation Hub
This page is the primary entry point for the documentation system.
Last refreshed: February 21, 2026.
Localized hubs: العربية · বাংলা · Čeština · Dansk · Deutsch · Ελληνικά · Español · Suomi · Français · עברית · हिन्दी · Magyar · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Norsk Bokmål · Nederlands · Polski · Português · Română · Русский · Svenska · ไทย · Tagalog · Türkçe · Українська · اردو · Tiếng Việt · 简体中文.
Start Here
| I want to… | Read this |
|---|---|
| Install and run ZeroClaw quickly | README.md (Quick Start) |
| Bootstrap in one command | one-click-bootstrap.md |
| Update or uninstall on macOS | macos-update-uninstall.md |
| Find commands by task | commands-reference.md |
| Check config defaults and keys quickly | config-reference.md |
| Configure custom providers/endpoints | custom-providers.md |
| Configure Z.AI / GLM provider | zai-glm-setup.md |
| Use LangGraph integration patterns | langgraph-integration.md |
| Operate runtime (day-2 runbook) | operations-runbook.md |
| Troubleshoot install/runtime/channel issues | troubleshooting.md |
| Run Matrix encrypted-room setup and diagnostics | matrix-e2ee-guide.md |
| Browse docs by category | SUMMARY.md |
| See project PR/issue docs snapshot | project-triage-snapshot-2026-02-18.md |
Quick Decision Tree (10 seconds)
- Need first-time setup or install? → setup-guides/README.md
- Need exact CLI/config keys? → reference/README.md
- Need production/service operations? → ops/README.md
- Seeing failures or regressions? → troubleshooting.md
- Working on security hardening or roadmap? → security/README.md
- Working with boards/peripherals? → hardware/README.md
- Contributing/reviewing/CI workflow? → contributing/README.md
- Want the full map? → SUMMARY.md
Collections (Recommended)
- Getting started: setup-guides/README.md
- Reference catalogs: reference/README.md
- Operations & deployment: ops/README.md
- Security docs: security/README.md
- Hardware/peripherals: hardware/README.md
- Contributing/CI: contributing/README.md
- Project snapshots: maintainers/README.md
By Audience
Users / Operators
- commands-reference.md — command lookup by workflow
- providers-reference.md — provider IDs, aliases, credential env vars
- channels-reference.md — channel capabilities and setup paths
- matrix-e2ee-guide.md — Matrix encrypted-room (E2EE) setup and no-response diagnostics
- config-reference.md — high-signal config keys and secure defaults
- custom-providers.md — custom provider/base URL integration templates
- zai-glm-setup.md — Z.AI/GLM setup and endpoint matrix
- langgraph-integration.md — fallback integration for model/tool-calling edge cases
- operations-runbook.md — day-2 runtime operations and rollback flow
- troubleshooting.md — common failure signatures and recovery steps
Contributors / Maintainers
Security / Reliability
Note: this area includes proposal/roadmap docs. For current behavior, start with config-reference.md, operations-runbook.md, and troubleshooting.md.
- security/README.md
- agnostic-security.md
- frictionless-security.md
- sandboxing.md
- audit-logging.md
- resource-limits.md
- security-roadmap.md
System Navigation & Governance
- Unified TOC: SUMMARY.md
- Docs structure map (language/part/function): structure/README.md
- Documentation inventory/classification: docs-inventory.md
- i18n docs index: i18n/README.md
- i18n coverage map: i18n-coverage.md
- Project triage snapshot: project-triage-snapshot-2026-02-18.md