3a38c80c05
`supports_vision` is currently hardcoded per-provider. The same Ollama instance can run `llava` (vision) or
`codellama` (no vision), but the code fixes vision support at the provider level with no user override.
This adds a top-level `model_support_vision: Option<bool>` config key — tri-state:
- **Unset (default):** provider's built-in value, zero behavior change
- **`true`:** force vision on (e.g. Ollama + llava)
- **`false`:** force vision off
Follows the exact same pattern as `reasoning_enabled`. Override is applied at the wrapper layer (`ReliableProvider` /
`RouterProvider`) — no concrete provider code is touched.
## Changes
**Config surface:**
- Top-level `model_support_vision` field in `Config` struct with `#[serde(default)]`
- Env override: `ZEROCLAW_MODEL_SUPPORT_VISION` / `MODEL_SUPPORT_VISION`
**Provider wrappers (core logic):**
- `ReliableProvider`: `vision_override` field + `with_vision_override()` builder + `supports_vision()` override
- `RouterProvider`: same pattern
**Wiring (1-line each):**
- `ProviderRuntimeOptions` struct + factory functions
- 5 construction sites: `loop_.rs`, `channels/mod.rs`, `gateway/mod.rs`, `tools/mod.rs`, `onboard/wizard.rs`
**Docs (i18n parity):**
- `config-reference.md` — Core Keys table
- `providers-reference.md` — new "Ollama Vision Override" section
- Vietnamese sync: `docs/i18n/vi/` + `docs/vi/` (4 files)
## Non-goals
- Does not change any concrete provider implementation
- Does not auto-detect model vision capability
## Test plan
- [x] `cargo fmt --all -- --check`
- [x] `cargo clippy --all-targets -- -D warnings` (no new errors)
- [x] 5 new tests passing:
- `model_support_vision_deserializes` — TOML parse + default None
- `env_override_model_support_vision` — env var override + invalid value ignored
- `vision_override_forces_true` — ReliableProvider override
- `vision_override_forces_false` — ReliableProvider override
- `vision_override_none_defers_to_provider` — passthrough behavior
## Risk and Rollback
- **Risk:** Low. `None` default = zero behavior change for existing users.
- **Rollback:** Revert commit. Field is `#[serde(default)]` so old configs without it will deserialize fine.
(cherry picked from commit
|
||
|---|---|---|
| .. | ||
| contributing | ||
| datasheets | ||
| getting-started | ||
| hardware | ||
| i18n | ||
| operations | ||
| project | ||
| reference | ||
| security | ||
| sop | ||
| structure | ||
| vi | ||
| actions-source-policy.md | ||
| adding-boards-and-tools.md | ||
| agnostic-security.md | ||
| android-setup.md | ||
| architecture.svg | ||
| arduino-uno-q-setup.md | ||
| audit-event-schema.md | ||
| audit-logging.md | ||
| cargo-slicer-speedup.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 | ||
| docker-setup.md | ||
| docs-audit-2026-02-24.md | ||
| docs-inventory.md | ||
| frictionless-security.md | ||
| Hardware_architecture.jpg | ||
| hardware-peripherals-design.md | ||
| i18n-coverage.md | ||
| i18n-gap-backlog.md | ||
| i18n-guide.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.el.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.el.md | ||
| SUMMARY.fr.md | ||
| SUMMARY.ja.md | ||
| SUMMARY.md | ||
| SUMMARY.ru.md | ||
| SUMMARY.vi.md | ||
| SUMMARY.zh-CN.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 |
| Set up on Android (Termux/ADB) | android-setup.md |
| Update or uninstall on macOS | getting-started/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 |
| Apply proxy scope safely | proxy-agent-playbook.md |
| Operate runtime (day-2 runbook) | operations-runbook.md |
| Operate provider connectivity probes in CI | operations/connectivity-probes-runbook.md |
| Troubleshoot install/runtime/channel issues | troubleshooting.md |
| Run Matrix encrypted-room setup and diagnostics | matrix-e2ee-guide.md |
| Build deterministic SOP procedures | sop/README.md |
| Browse docs by category | SUMMARY.md |
| See project PR/issue docs snapshot | project-triage-snapshot-2026-02-18.md |
| Perform i18n completion for docs changes | i18n-guide.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
- Building automated SOP workflows? → sop/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
- 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
- i18n completion guide: i18n-guide.md
- i18n gap backlog: i18n-gap-backlog.md
- Docs audit snapshot (2026-02-24): docs-audit-2026-02-24.md
- Project triage snapshot: project-triage-snapshot-2026-02-18.md