Skip to main content
v1.2.23 source sync and credential proxy skill
UpdatedFixed
2026-03-24
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-proxy skill instead of deleted src/credential-proxy.ts file path
  • Skills system: Added /use-native-credential-proxy to 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 sender field
  • Containers: Fixed .env shadow mount to note conditional existence check, clarified container stop timeout cascade
  • Configuration and installation: Added onecli --help references
  • 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
OneCLI gateway documentation
NewUpdated
2026-03-24
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/sdk dependency
  • Containers, Ollama, Skills examples: Passing references updated to version-neutral language
  • Customization: Mount allowlist format updated (allowedPathsallowedRoots with per-root read/write control)
  • Product changelog: Added v1.2.22 release entry and v1.2.0 scheduled task fix
Upstream docs audit and platform fixes
UpdatedFixed
2026-03-24
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.dev link 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
PR consolidation and issue cleanup
NewUpdatedFixed
2026-03-23
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 /claw Python 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-formatting skill
  • 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 /claw as example
  • Architecture — fixed database table names (scheduled_tasks, task_run_logs), isScheduledTask flag, stdin description, startup sequence expansion
  • Message routing — added syncGroups to 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 /clear from 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”
Content gap sweep — 13 issues resolved
NewUpdated
2026-03-20
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 /compact session 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 formatMessages signature (added timezone param and <context> header)
  • Configuration — Added OLLAMA_HOST, expanded ANTHROPIC_BASE_URL and SENDER_ALLOWLIST_PATH docs

Housekeeping

  • Deleted 6 stale mintlify/* branches
  • Created tracking issues for 3 remaining low-priority gaps (#49, #50)
Source code accuracy audit
Fixed
2026-03-19
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 .env shadow mount and CREDENTIAL_PROXY_HOST documentation
  • Fixed syncGroupMetadatasyncGroups across IPC docs
Logging and container docs
Updated
2026-03-19
  • Updated error log examples to show prompt redaction — input metadata only, no full prompt content
  • Added log privacy section to security docs
  • Corrected docker stop grace period from 15s to 1 second across all references
Source sync and remote control
Updated
2026-03-19
  • Fixed remote-control commands documentation
  • Deduplicated IPC docs
  • Added update_task to auth tables in API reference
Rendering fixes
Fixed
2026-03-18
Fixed rendering issues and remaining WhatsApp-as-default framing reported in issues #14–#18.
v1.2.17 source sync
NewUpdated
2026-03-18
  • Documented /capabilities and /status container-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_task operation
Credential proxy and task lifecycle
Fixed
2026-03-16
Fixed stale documentation for credential proxy, database path, mount allowlist, and task lifecycle to match current source code.
Automation workflows
New
2026-03-16
  • Added Mintlify workflow to sync docs automatically on upstream code changes
  • Added weekly docs audit and skill branch documentation workflows
Portal branding and UX
Updated
2026-03-16
  • 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
Portal launch
New
2026-03-15
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
Last modified on March 24, 2026