zeroclaw-labs/zeroclaw

[Bug]: Document the use of gateway.web_dist_dir & ZEROCLAW_WEB_DIST_DIR

Open

#5847 opened on Apr 17, 2026

View on GitHub
 (8 comments) (1 reaction) (0 assignees)Rust (31,341 stars) (4,614 forks)batch import
bugconfigdocumentationgatewayhelp wantedonboardpriority:p2risk: lowstatus:acceptedstatus:no-stale

Description

Affected component

runtime/daemon

Severity

S0 - data loss / security risk

Current behavior

As asked in #5846, about:
INFO zeroclaw_gateway: Web dashboard: not available (set gateway.web_dist_dir or ZEROCLAW_WEB_DIST_DIR).

How to use the mentioned variable and settings?

Documentation needed.

Expected behavior

na

Steps to reproduce

That critical setting for enabling web dashboard is documented.

Impact

  • New users will be asking a lot of questions about how to enable dashboard

Logs / stack traces

# rustc --version; cargo --version; rustup --version

rustc 1.95.0 (59807616e 2026-04-14)
cargo 1.95.0 (f2d3ce0bd 2026-03-21)
rustup 1.27.1 (2025-05-09)

ZeroClaw version

v0.7.0

Rust version

see above

Operating system

Debian

Regression?

Unknown

Pre-flight checks

  • I reproduced this on the latest master branch or latest release.
  • I redacted secrets, tokens, and personal data from all submitted content.

Contributor guide

Tech stack
rust
Domain
documentationbackend
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
basic Rust knowledgeunderstanding of zeroClaw configuration
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85
Research direction
Examine the runtime/daemon component to locate where gateway.web dist dir and ZEROCLAW WEB DIST DIR are read. Refer to the discussion in issue #5846 for additional context about how users encountered the missing documentation. Then produce documentation that explains how to set these variables (e.g., via command line or environment) to enable the web dashboard.