Context
Update src/content/docs/channels/troubleshooting.md after netclaw-dev/netclaw#1368 ships.
Current
- "Run
netclaw init" as the fix for token/channel configuration issues
- Fix examples reference raw
DefaultChannelName / DefaultChannelId fields
- No mention of the display-name → canonical-ID migration introduced in #1368
Should become
- Replace "run
netclaw init" token-fix instructions with "run netclaw config → Channels"
- New symptom section: "Channel messages silently dropped after upgrading from pre-0.24.0"
- Cause:
AllowedChannelIds held display names (e.g. #general) that no longer match canonical IDs after the upgrade — the ACL check fails silently
- Fix: Re-enter the channel list via
netclaw config → Channels (resolve-before-add stores canonical IDs automatically)
- Manual JSON fix (for advanced users): replace display names with canonical IDs; add a "config does this automatically" note
- Retain existing diagnostic steps for other symptoms; update any
netclaw init re-run instructions to use the new action menu (Redo Identity / Open config editor / Start over / Cancel)
Screenshots or tapes needed
None required — prose/copy update. Optionally include config-channels-resolve from sub-issue #13 if helpful.
Acceptance criteria
Dependencies
Part of #55
Context
Update
src/content/docs/channels/troubleshooting.mdafter netclaw-dev/netclaw#1368 ships.Current
netclaw init" as the fix for token/channel configuration issuesDefaultChannelName/DefaultChannelIdfieldsShould become
netclaw init" token-fix instructions with "runnetclaw config→ Channels"AllowedChannelIdsheld display names (e.g.#general) that no longer match canonical IDs after the upgrade — the ACL check fails silentlynetclaw config→ Channels (resolve-before-add stores canonical IDs automatically)netclaw initre-run instructions to use the new action menu (Redo Identity / Open config editor / Start over / Cancel)Screenshots or tapes needed
None required — prose/copy update. Optionally include
config-channels-resolvefrom sub-issue #13 if helpful.Acceptance criteria
netclaw init" token-fix replaced withnetclaw confignetclaw initre-run references updated to action menuDependencies
cli/config.md) for cross-linkPart of #55