11edda3ed6
Adds a full NostrChannel implementation enabling ZeroClaw to send and receive private messages over the Nostr protocol via user-configured relay WebSocket connections. Key design decisions: - Implements the Channel trait in src/channels/nostr.rs; registered via the existing factory in channels/mod.rs - Supports both NIP-04 (legacy encrypted DMs) and NIP-17 (gift-wrapped private messages); replies automatically mirror the sender's protocol - Deny-by-default allowlist (allowed_pubkeys = [] denies all) - Private key encrypted at rest via SecretStore (ChaCha20-Poly1305 AEAD) when secrets.encrypt = true (the default) - nostr-sdk added with default-features = false and only nip04 + nip59 features to minimise binary size impact - health_check() returns true if any relay reports is_connected() Wiring: - New NostrConfig struct and optional field in ChannelsConfig - has_supervised_channels() in daemon updated to include nostr - Onboarding wizard extended with a dedicated Nostr step (key validation, relay selection, allowlist configuration) Docs compliance: - channels-reference.md: channel matrix, delivery modes table, allowlist field names, numbered config section (4.12), log keyword table (7.2), and log filter command all updated - config-reference.md: [channels_config.nostr] sub-section with key table and security notes added - network-deployment.md and README.md updated - .github/pull_request_template.md: resolved stale conflict markers from chore/labeler-spacing-trusted-tier |
||
|---|---|---|
| .. | ||
| contributing | ||
| datasheets | ||
| getting-started | ||
| hardware | ||
| i18n | ||
| operations | ||
| project | ||
| reference | ||
| security | ||
| vi | ||
| actions-source-policy.md | ||
| adding-boards-and-tools.md | ||
| agnostic-security.md | ||
| architecture.svg | ||
| arduino-uno-q-setup.md | ||
| audit-logging.md | ||
| channels-reference.md | ||
| ci-map.md | ||
| commands-reference.md | ||
| commands-reference.vi.md | ||
| config-reference.md | ||
| config-reference.vi.md | ||
| custom-providers.md | ||
| doc-template.md | ||
| docs-inventory.md | ||
| frictionless-security.md | ||
| Hardware_architecture.jpg | ||
| hardware-peripherals-design.md | ||
| i18n-coverage.md | ||
| langgraph-integration.md | ||
| matrix-e2ee-guide.md | ||
| mattermost-setup.md | ||
| network-deployment.md | ||
| nextcloud-talk-setup.md | ||
| nucleo-setup.md | ||
| one-click-bootstrap.md | ||
| one-click-bootstrap.vi.md | ||
| operations-runbook.md | ||
| pr-workflow.md | ||
| project-triage-snapshot-2026-02-18.md | ||
| providers-reference.md | ||
| proxy-agent-playbook.md | ||
| README.fr.md | ||
| README.ja.md | ||
| README.md | ||
| README.ru.md | ||
| README.vi.md | ||
| README.zh-CN.md | ||
| release-process.md | ||
| resource-limits.md | ||
| reviewer-playbook.md | ||
| sandboxing.md | ||
| security-roadmap.md | ||
| SUMMARY.md | ||
| troubleshooting.md | ||
| troubleshooting.vi.md | ||
| zai-glm-setup.md | ||
ZeroClaw Documentation Hub
This page is the primary entry point for the documentation system.
Last refreshed: February 21, 2026.
Localized hubs: 简体中文 · 日本語 · Русский · Français · 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 |
| 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? → getting-started/README.md
- Need exact CLI/config keys? → reference/README.md
- Need production/service operations? → operations/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: getting-started/README.md
- Reference catalogs: reference/README.md
- Operations & deployment: operations/README.md
- Security docs: security/README.md
- Hardware/peripherals: hardware/README.md
- Contributing/CI: contributing/README.md
- Project snapshots: project/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
- 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