#10894: Docs: fix legacy branding, add config reference, expand cron troubleshooting
docs
gateway
stale
## Summary
- **Fix legacy branding**: rename "Clawdbot" → "OpenClaw" in all 3 GitHub issue templates (bug report, feature request, contact links)
- **Add configuration reference**: new `docs/gateway/configuration-reference.md` with all 200+ config fields organized by group, sourced from `src/config/schema.ts` field labels and help text
- **Expand cron troubleshooting**: from 2 items to 6 — covers timer drift, stuck jobs, delivery failures, and legacy migration (addresses recurring issues from #10776, #9733, #9823, #9948, #9932)
- **Clarify CLI command relationships**: add cross-linked callout boxes for `config` vs `configure` and `node` vs `nodes`
- **Add architecture overview**: AGENTS.md/CLAUDE.md now includes a data flow diagram and subsystem map for onboarding new contributors
## Test plan
- [ ] Verify issue templates render correctly on GitHub (new issue page)
- [ ] Verify `docs/gateway/configuration-reference.md` renders in Mintlify (`pnpm docs:dev`)
- [ ] Verify nav link appears under "Configuration and operations" in docs sidebar
- [ ] Verify cron troubleshooting section renders with correct anchors
- [ ] Verify CLI doc callout boxes render and cross-links resolve
🤖 Generated with [Claude Code](https://claude.ai/claude-code)
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
- Updates GitHub issue templates to use "OpenClaw" branding instead of legacy naming.
- Expands `docs/automation/cron-jobs.md` troubleshooting guidance with additional common failure modes.
- Adds cross-links/callouts clarifying related CLI commands (`config` vs `configure`, `node` vs `nodes`).
- Extends docs navigation (`docs/docs.json`) and adds a new gateway configuration reference page listing schema fields.
- Adds an architecture overview section to `AGENTS.md` to help onboard contributors.
<h3>Confidence Score: 3/5</h3>
- Mostly safe to merge, but there are a couple of docs correctness issues that will mislead readers if not fixed.
- Changes are documentation-only and scoped, but there are concrete correctness problems: `AGENTS.md` is mislabeled as `CLAUDE.md`, and the new configuration reference points to a likely wrong config file path/format. These should be corrected to avoid ongoing confusion and support burden.
- AGENTS.md; docs/gateway/configuration-reference.md; docs/cli/configure.md
<!-- greptile_other_comments_section -->
<sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub>
**Context used:**
- Context from `dashboard` - CLAUDE.md ([source](https://app.greptile.com/review/custom-context?memory=fd949e91-5c3a-4ab5-90a1-cbe184fd6ce8))
- Context from `dashboard` - AGENTS.md ([source](https://app.greptile.com/review/custom-context?memory=0d0c8278-ef8e-4d6c-ab21-f5527e322f13))
<!-- /greptile_comment -->
Most Similar PRs
#7252: docs: align config examples and tool docs with current runtime
by nice-and-precise · 2026-02-02
84.2%
#14871: Claude/audit codebase architecture 8a ql2
by MagnoliaLex · 2026-02-12
83.4%
#8203: fix clawdbot references
by anton-roos · 2026-02-03
82.8%
#11915: Docs: Docker + reverse proxy deployment notes and pairing pitfalls
by walshd1 · 2026-02-08
82.3%
#15852: fix: pass agentId when resolving IRC session paths
by MisterGuy420 · 2026-02-14
81.6%
#20700: docs: add real-world setups and use cases guide
by aiagentswiz · 2026-02-19
81.1%
#12834: docs(gateway): clarify there is no standalone clawrouter binary
by JBrady · 2026-02-09
80.1%
#23757: docs: replace outdated legacy names and paths
by jainilDesai · 2026-02-22
79.9%
#5036: docs: improve Slack setup and troubleshooting guide
by DanBatten · 2026-01-31
79.6%
#8713: feat: gateway memory monitor, install linger, docs and failover
by quratus · 2026-02-04
79.6%