Merged 3 automated PRs syncing docs with v1.2.23 upstream changes (#82, #84, #85). Closed #83 (would have removed legacy credential proxy tabs).
Updated
- Legacy credential proxy tabs: Updated to reference
/use-native-credential-proxyskill instead of deletedsrc/credential-proxy.tsfile path - Skills system: Added
/use-native-credential-proxyto upstream skills list - Architecture: Fixed startup sequence order (OneCLI agent sync before Remote Control restore), enriched database schema descriptions
- IPC system: Documented in-container poll interval (500ms), removed undocumented
senderfield - Containers: Fixed
.envshadow mount to note conditional existence check, clarified container stop timeout cascade - Configuration and installation: Added
onecli --helpreferences - Introduction and skills system: Updated token count from ~41k to ~39.8k
- Product changelog: Updated v1.2.23 entry with credential proxy skill and dead code cleanup
Added tabbed documentation for OneCLI gateway secret injection (v1.2.22+) alongside legacy credential proxy across 9 pages. Updated container image base from Node 22 to Node 24. Added OneCLI as installation prerequisite.
Pages updated
- Security overview and deep dive: Credential handling sections now use tabs for OneCLI Gateway vs Credential Proxy (legacy)
- Configuration: Environment variables, example
.env, and security notes updated with tabs - Container runtime: Container arguments code and key flags documented for both methods
- Architecture: Startup sequence and container image updated
- Installation: OneCLI added as prerequisite #5, Node 24,
@onecli-sh/sdkdependency - Containers, Ollama, Skills examples: Passing references updated to version-neutral language
- Customization: Mount allowlist format updated (
allowedPaths→allowedRootswith per-root read/write control) - Product changelog: Added v1.2.22 release entry and v1.2.0 scheduled task fix
Audited documentation in the upstream NanoClaw repo against the docs portal and submitted fixes via qwibitai/nanoclaw#1388.
Updated
- Installation, introduction, creating-skills: Added Windows (WSL2) to all platform references — NanoClaw supports macOS, Linux, and Windows via WSL2
- Introduction: Fixed token count from 34.9k to ~41k (matches auto-generated
repo-tokens/badge.svg) - CLAUDE.md: Added guidance for automated PR triage, changelogs, upstream PR workflow, and token count source of truth
Upstream PR (#1388)
- Added
docs.nanoclaw.devlink to README header - Populated CHANGELOG.md with all releases from v1.1.0 through v1.2.21
- Updated
docs/REQUIREMENTS.md— multi-channel support, current RFS, WSL2 deployment - Updated
docs/SECURITY.md— channel-neutral language - Updated
docs/DEBUG_CHECKLIST.md— Docker (default) commands, channel-neutral - Added
docs/README.md— index pointing to docs portal as authoritative source
Reviewed, triaged, and consolidated 10 automated Mintlify PRs (#60–#69). Verified all changes against NanoClaw source code, excluded 6 incorrect changes, and resolved the final 2 open issues.
New pages
- Claw CLI (
features/cli) — documents the/clawPython CLI for running agents from the command line (#64)
New sections
- Apple Container vs Docker (
advanced/container-runtime) — when to use each runtime, key differences table, switching instructions (closes #50) - Container internals (
concepts/containers) — allowed tools table, conversation archival, global memory injection, additional directory auto-discovery - Slack message formatting (
integrations/slack) — mrkdwn syntax differences and/slack-formattingskill - 200-message history cap (
features/messaging) — documents the default query limit on message retrieval (closes #49) - Opt-in diagnostics (
concepts/security,quickstart) — PostHog telemetry, consent flow, permanent opt-out (#68)
Updated pages
- Skill system — updated from 3 to 4 skill types (feature, utility, operational, container) across 6 pages
- Skills documentation — added utility skill structure, creation steps, and
/clawas example - Architecture — fixed database table names (
scheduled_tasks,task_run_logs),isScheduledTaskflag, stdin description, startup sequence expansion - Message routing — added
syncGroupsto Channel interface - Configuration — fixed DATA_DIR description (runtime data, not legacy)
- Skills system — added missing skills (
/get-qodo-rules,/qodo-pr-resolver,/x-integration,/add-compact,/add-parallel,/slack-formatting) - Contributing — removed
/clearfrom RFS (exists as/add-compact), updated to 4 skill types - SEO descriptions — improved frontmatter across 10 pages for better search discoverability
Fixed
- 13-page factual error sweep against source code (#67) — credential proxy terminology, IPC operations, container mount behavior, removed phantom MCP tool
- Consolidated overlapping fixes from 6 PRs into 2 clean PRs (#70, #71), closing 7 automated PRs as superseded
- Excluded incorrect automated changes: Channel Factory rename, fabricated commit reference, speculative formatting table, unverified frontmatter claims
Housekeeping
- Product changelog: added v1.2.20 (ESLint) and v1.2.21 (diagnostics) entries, fixed version ordering
- Resolved all open issues — 0 issues remaining
- Token count updated from “under 35k” to “~41k”
Ran a full docs-gap analysis against the upstream codebase and resolved 13 of 15 content-gap issues. Two low-priority items remain open (#49, #50).
New pages
- Ollama integration (
integrations/ollama) — MCP server architecture, local model setup, third-party endpoints - Voice transcription (
features/voice-transcription) — Whisper API (cloud) and whisper.cpp (local) with comparison table - Image vision (
features/image-vision) — Multimodal image understanding for WhatsApp - PDF reader (
features/pdf-reader) — Text extraction via poppler-utils - X (Twitter) integration (
integrations/x-twitter) — Host+agent architecture, OAuth setup - Parallel AI (
integrations/parallel-ai) — Web research MCP servers (quick search + deep research)
Updated pages
- Skills system — Documented channel fork architecture (5 fork repos), updated merge workflows, separated upstream vs fork skills
- Installation — Added Windows (WSL) support across all sections: prerequisites, Docker Desktop WSL 2 backend, troubleshooting
- Security — Documented sender allowlist: trigger/drop modes, per-chat overrides, file format
- Messaging — Added
/compactsession command and authorization rules - Telegram — Expanded agent swarm section with installation and per-bot config
- WhatsApp — Added skills summary table and emoji reactions section
- API reference — Fixed
formatMessagessignature (addedtimezoneparam and<context>header) - Configuration — Added
OLLAMA_HOST, expandedANTHROPIC_BASE_URLandSENDER_ALLOWLIST_PATHdocs
Housekeeping
- Deleted 6 stale
mintlify/*branches - Created tracking issues for 3 remaining low-priority gaps (#49, #50)
Corrected 30+ inaccuracies across 12 documentation pages by auditing against the NanoClaw source code.
- Fixed credential proxy documentation — removed incorrect claims about hot-swapping and auto-refresh
- Corrected container runtime detection, base image references, and stdin secrets pattern
- Updated task scheduling docs with correct table names and interfaces
- Added missing
.envshadow mount andCREDENTIAL_PROXY_HOSTdocumentation - Fixed
syncGroupMetadata→syncGroupsacross IPC docs
- Updated error log examples to show prompt redaction — input metadata only, no full prompt content
- Added log privacy section to security docs
- Corrected
docker stopgrace period from 15s to 1 second across all references
- Fixed remote-control commands documentation
- Deduplicated IPC docs
- Added
update_taskto auth tables in API reference
- Added automatic sidebar tag management via Mintlify workflows (
UPDATEDandNEWtags) - Replaced all ASCII directory trees with Mintlify
<Tree>component across the site - Tags auto-clean after 2 weeks via weekly audit workflow
Fixed rendering issues and remaining WhatsApp-as-default framing reported in issues #14–#18.
- Documented
/capabilitiesand/statuscontainer-agent skills as new pages - Synced docs with source code v1.2.17 — corrected mount allowlist format, interval drift handling, credential proxy behavior, and IPC config
- Documented IPC task snapshot refresh and
update_taskoperation
Fixed stale documentation for credential proxy, database path, mount allowlist, and task lifecycle to match current source code.
- Added Mintlify workflow to sync docs automatically on upstream code changes
- Added weekly docs audit and skill branch documentation workflows
- Applied NanoClaw branding with custom theme colors, fonts, and SEO metadata
- Switched theme from Aspen to Mint for better sidebar typography
- Cleaned up introduction page, footer, and removed callout CSS override
Launched docs.nanoclaw.dev — the NanoClaw documentation site built with Mintlify.
- Audited all content against v1.2.14 codebase
- Added Remote Control and Docker Sandboxes pages
- Made quickstart channel-agnostic (removed WhatsApp-as-default bias)
- Updated skills documentation to reflect git-branch architecture
- Fixed navigation structure with logical page ordering
- Added Mintlify skill for consistent docs development