44725da08c
Analysis of Feb 17 data showed 400+ workflow runs/day consuming ~398 billable minutes (~200 hours/month projected). Implemented targeted optimizations: High-impact changes: - sec-audit.yml: add path filters (Cargo.toml, src/**, crates/**, deny.toml); skip docs-only PRs - test-benchmarks.yml: move from every-push-to-main to weekly schedule; retention 30d -> 7d - pub-docker-img.yml: tighten PR smoke build path filters to Docker-specific files only - sec-codeql.yml: reduce from twice-daily (14 runs/week) to weekly Medium-impact changes: - ci-run.yml: merge lint + lint-strict-delta into single job; drop --release from smoke build - feature-matrix.yml: remove push trigger (weekly-only); remove redundant cargo test step - dependabot.yml: monthly instead of weekly; reduce PR limits from 11 to 5/month; group all deps Runner cost savings: - Switch 6 lightweight API-only workflows to ubuntu-latest (PR Labeler, Intake, Auto Responder, Check Stale, Check Status, Sync Contributors) - pr-check-status.yml: reduce from every 12h to daily New files: - docs/ci-cost-optimization.md: comprehensive analysis and revised architecture documentation - scripts/ci/fetch_actions_data.py: reusable GitHub Actions cost analysis script Estimated impact: daily billable minutes ~400 -> ~120-150 (60-65%% reduction), monthly hours ~200 -> ~60-75, Dependabot PRs ~44/month -> ~5 (89%% reduction) |
||
|---|---|---|
| .. | ||
| contributing | ||
| datasheets | ||
| getting-started | ||
| hardware | ||
| operations | ||
| project | ||
| reference | ||
| security | ||
| 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-cost-optimization.md | ||
| ci-map.md | ||
| commands-reference.md | ||
| config-reference.md | ||
| custom-providers.md | ||
| doc-template.md | ||
| docs-inventory.md | ||
| frictionless-security.md | ||
| hardware-peripherals-design.md | ||
| Hardware_architecture.jpg | ||
| langgraph-integration.md | ||
| matrix-e2ee-guide.md | ||
| mattermost-setup.md | ||
| network-deployment.md | ||
| nucleo-setup.md | ||
| one-click-bootstrap.md | ||
| operations-runbook.md | ||
| pr-workflow.md | ||
| project-triage-snapshot-2026-02-18.md | ||
| providers-reference.md | ||
| proxy-agent-playbook.md | ||
| README.ja.md | ||
| README.md | ||
| README.ru.md | ||
| README.zh-CN.md | ||
| resource-limits.md | ||
| reviewer-playbook.md | ||
| sandboxing.md | ||
| security-roadmap.md | ||
| SUMMARY.md | ||
| troubleshooting.md | ||
| zai-glm-setup.md | ||
ZeroClaw Documentation Hub
This page is the primary entry point for the documentation system.
Last refreshed: February 18, 2026.
Localized hubs: 简体中文 · 日本語 · Русский.
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
- Project triage snapshot: project-triage-snapshot-2026-02-18.md