Skip to content

Commit f73f0d4

Browse files
committed
docs: fix maturity scorecard docs checks
1 parent c265af4 commit f73f0d4

19 files changed

Lines changed: 1518 additions & 10859 deletions

docs/.i18n/glossary.zh-CN.json

Lines changed: 1396 additions & 584 deletions
Large diffs are not rendered by default.

docs/maturity-scorecard/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ version: 3
66
# Maturity scorecard process
77

88
This directory is an artifact root maintained by the local `claw-score` skill
9-
at [SKILL.md](/Users/kevinlin/code/claw/maintainers/.agents/skills/claw-score/SKILL.md).
9+
defined in the external `claw-score` `SKILL.md`.
1010

1111
The skill owns scoring policy, scoring workflow, validation, artifact shape,
1212
and renderer expectations. This README is the human-facing directory contract
@@ -210,5 +210,5 @@ contract or regeneration guidance changes.
210210
taxonomy.
211211
- Do not hand-edit taxonomy-derived `## Features` sections in category notes;
212212
update `taxonomy.yaml` and rerender the owning surface report instead.
213-
- Keep agent instructions in [SKILL.md](/Users/kevinlin/code/claw/maintainers/.agents/skills/claw-score/SKILL.md), not in this
213+
- Keep agent instructions in the external `claw-score` `SKILL.md`, not in this
214214
directory.

docs/maturity-scorecard/audits/20270531/audit.md

Lines changed: 0 additions & 4023 deletions
This file was deleted.

docs/maturity-scorecard/audits/20270531/inventory.md

Lines changed: 0 additions & 6130 deletions
This file was deleted.

docs/maturity-scorecard/inventory/discord/threads-forums-and-delegated-agent-bindings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,7 @@ discrawl status --json
177177

178178
Results:
179179

180-
- Succeeded; recorded freshness: generated_at=2026-05-28T20:13:14Z, state=current, last_sync_at=2026-05-28T19:15:50Z, messages=1485267, channels=25766, threads=25539, members=173089, embedding_backlog=0, share remote git@github.com-personal:openclaw/discord-store.git.
180+
- Succeeded; recorded freshness: generated_at=2026-05-28T20:13:14Z, state=current, last_sync_at=2026-05-28T19:15:50Z, messages=1485267, channels=25766, threads=25539, members=173089, embedding_backlog=0, share remote `git@github.com-personal:openclaw/discord-store.git`.
181181

182182
Query:
183183

docs/maturity-scorecard/inventory/feishu-qq-bot-wechat-yuanbao-zalo-zalo-personal-regional-channels/access-and-identity.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,12 +63,12 @@ Included in this category:
6363
- Inbound and outbound rich media including: Covers Inbound and outbound rich media including images, voice, video, files, STT/TTS, and native voice sends behavior.
6464
- Slash commands: Covers Slash commands, approval buttons, reminder/channel tools, and framework command registration behavior.
6565
- Multi-account gateway connections: Covers Multi-account gateway connections, token cache, credential backups, diagnostics, and reconnect behavior behavior.
66-
- Tencent Yuanbao external channel `openclaw-plugin-yuanbao: Evidence scope for Tencent Yuanbao external channel `openclaw-plugin-yuanbao`.
66+
- Tencent Yuanbao external channel `openclaw-plugin-yuanbao`: Evidence scope for Tencent Yuanbao external channel `openclaw-plugin-yuanbao`.
6767
- AppKey/AppSecret setup: Covers AppKey/AppSecret setup, login wizard, multi-account config, and default account routing behavior.
6868
- DMs: Covers DMs, groups, mention requirements, reply-to mode, group history context, slash-command menus, and fallback replies behavior.
6969
- Outbound queue strategy: Covers Outbound queue strategy, merge-text tuning, max chars, media caps, overflow behavior, and block-level streaming behavior.
7070
- Core-side official external catalog: Covers Core-side official external catalog, install metadata, aliases, wizard blurbs, and channel catalog contracts behavior.
71-
- zalouser` channel plugin for Zalo Personal: Covers zalouser` channel plugin for Zalo Personal Account automation via native `zca-js behavior.
71+
- `zalouser` channel plugin for Zalo Personal: Covers `zalouser` channel plugin for Zalo Personal Account automation via native `zca-js` behavior.
7272
- QR login: Covers QR login, saved profiles, multi-account/profile selection, and gateway-local runtime behavior.
7373
- DM pairing: Covers DM pairing, group policy, group gating, directory peers, and sender/session routing behavior.
7474
- Message send: Covers Message send, image/link/document media, reactions, status, friends/groups/me tools, and text style normalization behavior.

docs/maturity-scorecard/inventory/feishu-qq-bot-wechat-yuanbao-zalo-zalo-personal-regional-channels/conversation-routing-and-delivery.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ Included in this category:
6363
- Inbound and outbound rich media including: Covers Inbound and outbound rich media including images, voice, video, files, STT/TTS, and native voice sends behavior.
6464
- Slash commands: Covers Slash commands, approval buttons, reminder/channel tools, and framework command registration behavior.
6565
- Multi-account gateway connections: Covers Multi-account gateway connections, token cache, credential backups, diagnostics, and reconnect behavior behavior.
66-
- Tencent Yuanbao external channel `openclaw-plugin-yuanbao: Evidence scope for Tencent Yuanbao external channel `openclaw-plugin-yuanbao`.
66+
- Tencent Yuanbao external channel `openclaw-plugin-yuanbao`: Evidence scope for Tencent Yuanbao external channel `openclaw-plugin-yuanbao`.
6767
- AppKey/AppSecret setup: Covers AppKey/AppSecret setup, login wizard, multi-account config, and default account routing behavior.
6868
- DMs: Covers DMs, groups, mention requirements, reply-to mode, group history context, slash-command menus, and fallback replies behavior.
6969
- Outbound queue strategy: Covers Outbound queue strategy, merge-text tuning, max chars, media caps, overflow behavior, and block-level streaming behavior.
@@ -74,7 +74,7 @@ Included in this category:
7474
- Group policy schema and fail-closed group: Covers Group policy schema and fail-closed group gates even where Marketplace groups are not usable behavior.
7575
- Text: Covers Text, media placeholders, outbound chunking, replay dedupe, rate limiting, webhook secrets, and proxy support behavior.
7676
- Status probes and troubleshooting for token/config/webhook problems: Evidence scope for Status probes and troubleshooting for token/config/webhook problems.
77-
- zalouser` channel plugin for Zalo Personal: Covers zalouser` channel plugin for Zalo Personal Account automation via native `zca-js behavior.
77+
- `zalouser` channel plugin for Zalo Personal: Covers `zalouser` channel plugin for Zalo Personal Account automation via native `zca-js` behavior.
7878
- QR login: Covers QR login, saved profiles, multi-account/profile selection, and gateway-local runtime behavior.
7979
- DM pairing: Covers DM pairing, group policy, group gating, directory peers, and sender/session routing behavior.
8080
- Message send: Covers Message send, image/link/document media, reactions, status, friends/groups/me tools, and text style normalization behavior.

docs/maturity-scorecard/inventory/feishu-qq-bot-wechat-yuanbao-zalo-zalo-personal-regional-channels/shared-regional-channel-catalog-install-status.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ Included in this category:
6969
- Inbound and outbound rich media including: Covers Inbound and outbound rich media including images, voice, video, files, STT/TTS, and native voice sends behavior.
7070
- Slash commands: Covers Slash commands, approval buttons, reminder/channel tools, and framework command registration behavior.
7171
- Multi-account gateway connections: Covers Multi-account gateway connections, token cache, credential backups, diagnostics, and reconnect behavior behavior.
72-
- Tencent Yuanbao external channel `openclaw-plugin-yuanbao: Evidence scope for Tencent Yuanbao external channel `openclaw-plugin-yuanbao`.
72+
- Tencent Yuanbao external channel `openclaw-plugin-yuanbao`: Evidence scope for Tencent Yuanbao external channel `openclaw-plugin-yuanbao`.
7373
- AppKey/AppSecret setup: Covers AppKey/AppSecret setup, login wizard, multi-account config, and default account routing behavior.
7474
- DMs: Covers DMs, groups, mention requirements, reply-to mode, group history context, slash-command menus, and fallback replies behavior.
7575
- Outbound queue strategy: Covers Outbound queue strategy, merge-text tuning, max chars, media caps, overflow behavior, and block-level streaming behavior.
@@ -80,7 +80,7 @@ Included in this category:
8080
- Group policy schema and fail-closed group: Covers Group policy schema and fail-closed group gates even where Marketplace groups are not usable behavior.
8181
- Text: Covers Text, media placeholders, outbound chunking, replay dedupe, rate limiting, webhook secrets, and proxy support behavior.
8282
- Status probes and troubleshooting for token/config/webhook problems: Evidence scope for Status probes and troubleshooting for token/config/webhook problems.
83-
- zalouser` channel plugin for Zalo Personal: Covers zalouser` channel plugin for Zalo Personal Account automation via native `zca-js behavior.
83+
- `zalouser` channel plugin for Zalo Personal: Covers `zalouser` channel plugin for Zalo Personal Account automation via native `zca-js` behavior.
8484
- QR login: Covers QR login, saved profiles, multi-account/profile selection, and gateway-local runtime behavior.
8585
- DM pairing: Covers DM pairing, group policy, group gating, directory peers, and sender/session routing behavior.
8686
- Message send: Covers Message send, image/link/document media, reactions, status, friends/groups/me tools, and text style normalization behavior.

docs/maturity-scorecard/inventory/gateway-runtime/observability-health-and-repair.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -217,7 +217,7 @@ Label: **Medium**
217217
- `gitcrawl search openclaw/openclaw --query "gateway doctor" --mode keyword --limit 10 --json`
218218
- Result: #84340 open PR "Doctor: expose extra gateway service findings"; #69947 closed PR "fix: quiet noninteractive doctor checks"; #69896 closed PR "Fix doctor bundled runtime dependency ordering"; #53197 closed PR "fix(doctor): honor --fix in non-interactive mode"; #84224 open PR "fix(doctor): handle gateway SecretRefs in auth checks"; #80055 closed PR "Doctor: add health-check contract and --lint validation"; #62338 open PR "doctor(memory): surface FTS5 unavailable state in doctor checks"; #83715 open PR "[codex] Guard doctor repairs for newer configs"; #86627 open PR "Keep core doctor health in contribution order"; #77613 closed PR "docs(doctor): clarify configured plugin repair".
219219
- `gitcrawl search openclaw/openclaw --query "gateway health status" --mode keyword --limit 10 --json`
220-
- Result: #13602 closed issue "Add /health endpoint for AWS ALB and Kubernetes probes"; #36422 closed PR "gateway: keep health channel runtime state consistent with channels.status"; #80277 closed PR "fix(status): surface model-pricing health degradation"; #71974 closed issue "Bug: WhatsApp channel health JSON reports running=false/connected=false while status --deep shows OK/LINKED"; #49758 closed issue "Bug: `status` / `gateway probe` / `health --json` misreport local gateway + Telegram state on 2026.3.13"; #57374 closed PR "fix(gateway): use configured probe auth during restart health checks"; #27619 closed issue "Dashboard API: System health endpoint returns hardcoded mock data"; #42538 open issue "Bug: health endpoint returns incorrect running=false for WhatsApp"; #59287 closed issue "[Bug]: openclaw health --json reports telegram.running=false while probe succeeds and status --deep shows Telegram OK"; #59511 closed issue "[Bug]: node openclaw.mjs gateway run can not use http://127.0.0.1:18789/health link to get openclaw status".
220+
- Result: #13602 closed issue "Add /health endpoint for AWS ALB and Kubernetes probes"; #36422 closed PR "gateway: keep health channel runtime state consistent with channels.status"; #80277 closed PR "fix(status): surface model-pricing health degradation"; #71974 closed issue "Bug: WhatsApp channel health JSON reports running=false/connected=false while status --deep shows OK/LINKED"; #49758 closed issue "Bug: `status` / `gateway probe` / `health --json` misreport local gateway + Telegram state on 2026.3.13"; #57374 closed PR "fix(gateway): use configured probe auth during restart health checks"; #27619 closed issue "Dashboard API: System health endpoint returns hardcoded mock data"; #42538 open issue "Bug: health endpoint returns incorrect running=false for WhatsApp"; #59287 closed issue "[Bug]: openclaw health --json reports telegram.running=false while probe succeeds and status --deep shows Telegram OK"; #59511 closed issue "[Bug]: node openclaw.mjs gateway run can not use `http://127.0.0.1:18789/health` link to get openclaw status".
221221
- `gitcrawl search openclaw/openclaw --query "payload.large stability diagnostics" --mode keyword --limit 10 --json`
222222
- Result: #70324 closed PR "Improve gateway diagnostics export for support reports"; #82674 closed PR "fix(gateway): capture opt-in memory pressure snapshots"; #82937 closed PR "fix: yield diagnostic event drains"; #86160 open PR "fix(codex): preserve semantic native threads across compaction"; #83795 closed issue "[Feature]: OpenClaw trace emission should include captureContent"; #81402 open PR "refactor: move runtime state to SQLite".
223223
- `gitcrawl search openclaw/openclaw --query "gateway port collision doctor service drift" --mode keyword --limit 10 --json`

docs/maturity-scorecard/inventory/gateway-runtime/runtime-lifecycle-and-supervision.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -185,13 +185,13 @@ Label: **High**
185185
- `gitcrawl search issues "gateway config reload hot restart hybrid" -R openclaw/openclaw --state open --json number,title,url,state --limit 10`
186186
- Result: `[{"number":43803,"state":"open","title":"[BUG] config.patch still sends SIGUSR1 for hot-reloadable paths (browser.profiles.*), bypassing reload mode","url":"https://github.com/openclaw/openclaw/issues/43803"}]`
187187
- `gitcrawl search issues "multiple gateways port config state workspace isolation" -R openclaw/openclaw --state open --json number,title,url,state --limit 10`
188-
- Result: `[{"number":71216,"state":"open","title":"Config schema: add `sandbox`, `routing.rules`, `instances`, and `gateway.nodes.denyPaths`","url":"https://github.com/openclaw/openclaw/issues/71216"},{"number":64555,"state":"open","title":"[Bug]: WhatsApp credentials leak across `--profile` boundaries","url":"https://github.com/openclaw/openclaw/issues/64555"}]`
188+
- Result: #71216 open issue "Config schema: add `sandbox`, `routing.rules`, `instances`, and `gateway.nodes.denyPaths`"; #64555 open issue "[Bug]: WhatsApp credentials leak across `--profile` boundaries".
189189
- `gitcrawl search issues "gateway launchd restart handoff not loaded restart stop status" -R openclaw/openclaw --state closed --json number,title,url,state --limit 10`
190-
- Result: `[{"number":81894,"state":"closed","title":"v2026.5.12 agent-invoked self-update can leave macOS LaunchAgent unloaded or fail before package swap","url":"https://github.com/openclaw/openclaw/issues/81894"},{"number":85120,"state":"closed","title":"[Bug]: in-band `openclaw update` on macOS LaunchAgent can stop the gateway supervising it","url":"https://github.com/openclaw/openclaw/issues/85120"}]`
190+
- Result: #81894 closed issue "v2026.5.12 agent-invoked self-update can leave macOS LaunchAgent unloaded or fail before package swap"; #85120 closed issue "[Bug]: in-band `openclaw update` on macOS LaunchAgent can stop the gateway supervising it".
191191
- `gitcrawl search issues "gateway systemd service restart user unit linger XDG_RUNTIME_DIR" -R openclaw/openclaw --state closed --json number,title,url,state --limit 10`
192-
- Result: `[{"number":40275,"state":"closed","title":"[Bug]: openclaw gateway restart fails while user systemd service works via systemctl --user (service shown as disabled/stopped inconsistently)","url":"https://github.com/openclaw/openclaw/issues/40275"},{"number":44417,"state":"closed","title":"Bug: systemctl --user detection fails and hangs during `sudo -u`due to SUDO_USER fallback","url":"https://github.com/openclaw/openclaw/issues/44417"},{"number":65184,"state":"closed","title":"[Bug]:openclaw gateway install may fail with \"Unit file openclaw-gateway.service does not exist\" on migrated root + systemd --user installs","url":"https://github.com/openclaw/openclaw/issues/65184"},{"number":32635,"state":"closed","title":"Bug: gateway install fails on fresh Linux servers - execFileUtf8 clobbers systemctl stdout","url":"https://github.com/openclaw/openclaw/issues/32635"},{"number":36495,"state":"closed","title":"[Bug] Gateway install regression in 2026.3.2:`is-enabled`exit code`not-found` treated as \"systemctl unavailable\"","url":"https://github.com/openclaw/openclaw/issues/36495"}]`
192+
- Result: #40275 closed issue "[Bug]: openclaw gateway restart fails while user systemd service works via systemctl --user (service shown as disabled/stopped inconsistently)"; #44417 closed issue "Bug: systemctl --user detection fails and hangs during `sudo -u` due to SUDO_USER fallback"; #65184 closed issue "[Bug]: openclaw gateway install may fail with \"Unit file openclaw-gateway.service does not exist\" on migrated root + systemd --user installs"; #32635 closed issue "Bug: gateway install fails on fresh Linux servers - execFileUtf8 clobbers systemctl stdout"; #36495 closed issue "[Bug] Gateway install regression in 2026.3.2: `is-enabled` exit code `not-found` treated as \"systemctl unavailable\"".
193193
- `gitcrawl search issues "gateway schtasks Windows scheduled task restart stop port" -R openclaw/openclaw --state closed --json number,title,url,state --limit 10`
194-
- Result: `[{"number":69970,"state":"closed","title":"[Bug]: Windows auto-update restart script hangs indefinitely on `schtasks /End`, leaves zombie cmd.exe and flashing Terminal window","url":"https://github.com/openclaw/openclaw/issues/69970"},{"number":52049,"state":"closed","title":"Bug: gateway stop doesn't terminate node.exe process on Windows","url":"https://github.com/openclaw/openclaw/issues/52049"},{"number":72279,"state":"closed","title":"[Bug][Windows] openclaw update still hangs with stuck findstr on 2026.4.24 - prior fixes (#57682, #44693, #27802, #41804) are incomplete","url":"https://github.com/openclaw/openclaw/issues/72279"},{"number":52044,"state":"closed","title":"Bug: gateway restart spawns duplicate processes on Windows (3 windows)","url":"https://github.com/openclaw/openclaw/issues/52044"},{"number":41047,"state":"closed","title":"[Bug]: OpenClaw Dashboard Control UI fails to send gateway token (token_missing) while gateway/runtime remain healthy","url":"https://github.com/openclaw/openclaw/issues/41047"}]`
194+
- Result: #69970 closed issue "[Bug]: Windows auto-update restart script hangs indefinitely on `schtasks /End`, leaves zombie cmd.exe and flashing Terminal window"; #52049 closed issue "Bug: gateway stop doesn't terminate node.exe process on Windows"; #72279 closed issue "[Bug] [Windows] openclaw update still hangs with stuck findstr on 2026.4.24 - prior fixes (#57682, #44693, #27802, #41804) are incomplete"; #52044 closed issue "Bug: gateway restart spawns duplicate processes on Windows (3 windows)"; #41047 closed issue "[Bug]: OpenClaw Dashboard Control UI fails to send gateway token (token_missing) while gateway/runtime remain healthy".
195195
- `gitcrawl search issues "gateway port precedence OPENCLAW_GATEWAY_PORT --port gateway.port service args" -R openclaw/openclaw --state closed --json number,title,url,state --limit 10`
196196
- Result: `[]`
197197

0 commit comments

Comments
 (0)