@rozek/nanoclaw 0.0.5 → 0.0.7

package/CHANGELOG.md

@@ -1,8 +0,0 @@
-# Changelog
-
-All notable changes to NanoClaw will be documented in this file.
-
-## [1.2.0](https://github.com/qwibitai/nanoclaw/compare/v1.1.6...v1.2.0)
-
-[BREAKING] WhatsApp removed from core, now a skill. Run `/add-whatsapp` to re-add (existing auth/groups preserved).
-- **fix:** Prevent scheduled tasks from executing twice when container runtime exceeds poll interval (#138, #669)

package/CONTRIBUTING.md

@@ -1,23 +0,0 @@
-# Contributing
-
-## Source Code Changes
-
-**Accepted:** Bug fixes, security fixes, simplifications, reducing code.
-
-**Not accepted:** Features, capabilities, compatibility, enhancements. These should be skills.
-
-## Skills
-
-A [skill](https://code.claude.com/docs/en/skills) is a markdown file in `.claude/skills/` that teaches Claude Code how to transform a NanoClaw installation.
-
-A PR that contributes a skill should not modify any source files.
-
-Your skill should contain the **instructions** Claude follows to add the feature—not pre-built code. See `/add-telegram` for a good example.
-
-### Why?
-
-Every user should have clean and minimal code that does exactly what they need. Skills let users selectively add features to their fork without inheriting code for features they don't want.
-
-### Testing
-
-Test your skill by running it on a fresh clone before submitting.

package/CONTRIBUTORS.md

@@ -1,15 +0,0 @@
-# Contributors
-
-Thanks to everyone who has contributed to NanoClaw!
-
-- [Alakazam03](https://github.com/Alakazam03) — Vaibhav Aggarwal
-- [tydev-new](https://github.com/tydev-new)
-- [pottertech](https://github.com/pottertech) — Skip Potter
-- [rgarcia](https://github.com/rgarcia) — Rafael
-- [AmaxGuan](https://github.com/AmaxGuan) — Lingfeng Guan
-- [happydog-intj](https://github.com/happydog-intj) — happy dog
-- [bindoon](https://github.com/bindoon) — 潕量
-- [taslim](https://github.com/taslim) — Taslim
-- [baijunjie](https://github.com/baijunjie) — BaiJunjie
-- [Michaelliv](https://github.com/Michaelliv) — Michael
-- [kk17](https://github.com/kk17) — Kyle Zhike Chen

package/NanoClaw_with_Web-Support.md

@@ -1,326 +0,0 @@
-# NanoClaw with Web Support
-
-This document describes the changes added in the [rozek/nanoclaw](https://github.com/rozek/nanoclaw) fork of [qwibitai/nanoclaw](https://github.com/qwibitai/nanoclaw). It serves as installation guide, feature reference, and API documentation.
-
----
-
-## Quick Start (npx)
-
-No cloning, no `npm install` — just run:
-
-```bash
-npx @rozek/nanoclaw
-```
-
-Then open **http://localhost:3099** in your browser.
-
-### Prerequisites
-
-| Requirement | How to check | Notes |
-|-------------|-------------|-------|
-| **Node.js ≥ 20** | `node --version` | |
-| **Claude Code** | `claude --version` | `npm install -g @anthropic-ai/claude-code` |
-| **Container runtime** | `docker info` *or* `container --version` | Docker Desktop **or** macOS Sequoia 15+ Apple Container Runtime |
-
-> **No API key required** if you have a Claude Pro or Max subscription — NanoClaw uses Claude Code, which is included in those plans.
-
----
-
-## Web Channel Features
-
-### UI & Design
-
-- **Light and dark themes** — with your system theme as default
-- **Full-viewport layout** — always fills the screen
-- **Responsive** — desktop: fixed sidebar; mobile: sidebar as overlay with backdrop
-
-### Rich Content Rendering
-
-Bot responses are rendered with full Markdown support:
-
-| Library | Purpose |
-|---------|---------|
-| [marked.js](https://marked.js.org) | GitHub Flavored Markdown |
-| [KaTeX](https://katex.org) | Inline (`$...$`) and block (`$$...$$`) math formulas |
-| [highlight.js](https://highlightjs.org) | Syntax highlighting (TypeScript, Java, and many more) |
-| [Mermaid](https://mermaid.js.org) | Flowcharts, sequence diagrams, etc. |
-
-### Multi-Session Chat
-
-- Unlimited parallel chat sessions per browser
-- Sessions are listed in the sidebar, freely sortable by dragging
-- Each session has an editable name (pencil icon ✏; default: date+time)
-- Sessions persist in `localStorage` and SQLite — survive browser reloads and server restarts
-- Sessions from other devices appear automatically in the sidebar (polled every 5 s)
-- Unread message indicators (blue dot) per session, persisted in `localStorage`
-- Sessions can be deleted (removes all messages from DB and `localStorage`)
-
-### Session Name Sync
-
-Conflict-free name synchronisation across devices:
-
-- Every rename carries a `nameUpdatedAt` UNIX timestamp
-- Server-side guard: `UPDATE … WHERE excluded.name_updated_at >= chats.name_updated_at`
-- On SSE connect, the client pushes its local name; if it is newer than the server's name, the server adopts it
-
-### Message History
-
-- Local `localStorage` cache (`hist:{sid}`) for instant display on load
-- Full conversation history served from SQLite via `GET /history?sid=…`
-- Both user messages and bot replies are persisted and synced across devices
-- Individual messages can be deleted (trash icon; removes from DOM, cache, and DB)
-
-### Real-Time Updates (Server-Sent Events)
-
-All live updates arrive over a single SSE connection (`GET /events?sid=…`):
-
-| Event | Payload | Purpose |
-|-------|---------|---------|
-| `message` | `{"text":"…","id":"…"}` | Append bot reply |
-| `typing` | `"true"` / `"false"` | Show/hide typing indicator |
-| `status` | `{"tool":"…","input":"…"}` or `null` | Display active tool (e.g. "searching…") |
-| `cwd` | path string | Update working-directory display in header |
-
-On connect, the server immediately sends the current `typing`, `status`, and `cwd` state so reconnects are seamless. Additionally, the client fetches `GET /pwd?sid=…` in the SSE `open` handler to reliably sync the CWD even if the `cwd` event arrives before the session is fully initialized.
-
-### Working Folder (CWD)
-
-- Current working folder shown in the header: `NanoClaw — IP:Port — <relative-path>`
-- Set by the agent or user via `switching to folder: <relative-path>` (in any message or response)
-- User shorthand commands available in the chat input:
-  - `/cwd <path>` — change the working folder instantly (no agent invocation)
-  - `/pwd` — display the current working folder
-- Persisted in `chats.cwd` (SQLite) — survives server restarts
-- Also cached in `localStorage` per session
-- NanoClaw ships with built-in skills (`container/skills/cwd/` and `container/skills/pwd/`) that instruct the AI how to use these commands
-- All CWD values (from agent output, `/cwd` command, or `POST /cwd`) are passed through `sanitizeCwd()` which resolves paths relative to the workspace root and rejects any attempt to escape it (absolute paths outside the workspace are silently clamped to `''`)
-
-### File Upload
-
-- Drag files into the browser window
-- Files are written to the session's current working directory (or group root if no CWD)
-- Maximum file size: 10 MB
-
-### Cancel In-Progress Requests
-
-- A **Cancel** button appears while the agent is processing
-- Clicking it immediately kills the container process (SIGTERM) via `POST /cancel?sid=…`
-- The button is disabled while the cancel request is in flight to prevent double-clicks
-
-### Cron Jobs Tab
-
-- A dedicated **Cron Jobs** tab (`local@web-cron`) shows output from all scheduled tasks
-- The text input is disabled in this tab — it is reserved for task output only
-
-### Access Control
-
-Token-based authentication is optional but recommended when NanoClaw is reachable from the LAN:
-
-```bash
-npx @rozek/nanoclaw --token mySecretToken
-```
-
-Clients authenticate via:
-1. `Authorization: Bearer mySecretToken` header
-2. `?token=mySecretToken` URL query parameter (sets an HttpOnly session cookie)
-3. The HttpOnly session cookie set after step 2
-
----
-
-## Installation & Usage
-
-### Simplest start
-
-```bash
-npx @rozek/nanoclaw
-```
-
-Auto-detects the container runtime (Docker first, then Apple Container). Binds to `127.0.0.1:3099` by default (localhost only).
-
-### Common options
-
-```bash
-# Custom port
-npx @rozek/nanoclaw --port 8080
-
-# Custom workspace (directory NanoClaw works in)
-npx @rozek/nanoclaw --workspace ~/my-workspace
-
-# Token protection — recommended when accessible from the LAN
-npx @rozek/nanoclaw --token mySecretToken
-
-# Make accessible from the LAN (bind to all interfaces) — use with a token!
-npx nanoclaw --host 0.0.0.0 --token mySecretToken
-
-# Explicit container runtime
-npx @rozek/nanoclaw --sandbox docker
-npx @rozek/nanoclaw --sandbox apple
-
-# With an Anthropic API key (for users without Pro/Max)
-npx @rozek/nanoclaw --key sk-ant-...
-
-# Combine options
-npx @rozek/nanoclaw --port 8080 --workspace ~/my-workspace --token mySecretToken --sandbox docker
-```
-
-### All CLI options
-
-```
-Options:
-  --host <address>      Bind address for the web channel   (default: 127.0.0.1)
-  --port <number>       Port for the web channel           (default: 3099)
-  --workspace <path>    Workspace directory                (default: current directory)
-  --key <api-key>       Anthropic API key
-                          Not required with Claude Pro/Max — NanoClaw uses
-                          Claude Code, which is included in those plans.
-  --token <token>       Access token for the web interface (default: no protection)
-                          Clients supply it via:
-                            Authorization: Bearer <token>
-                            ?token=<value> query parameter
-                            or a session cookie
-  --sandbox <type>      Container runtime: "docker" or "apple"
-                          Defaults to auto-detect (docker → apple).
-  -h, --help            Show this help and exit
-```
-
-### Environment variables
-
-CLI flags take precedence. Alternatively, set environment variables:
-
-```bash
-NANOCLAW_HOST=127.0.0.1
-NANOCLAW_PORT=3099
-NANOCLAW_TOKEN=mySecretToken
-NANOCLAW_KEY=sk-ant-...
-NANOCLAW_WORKSPACE=/path/to/workspace
-NANOCLAW_SANDBOX=docker   # or: apple
-```
-
----
-
-## HTTP API Reference
-
-| Method | Path | Description |
-|--------|------|-------------|
-| `GET` | `/` | Serves the web UI (HTML) |
-| `GET` | `/events?sid=…` | SSE stream for real-time updates |
-| `GET` | `/sessions` | All web sessions with custom display order (JSON) |
-| `GET` | `/history?sid=…` | Conversation history (JSON) |
-| `GET` | `/favicon.ico` | Favicon (ICO) |
-| `GET` | `/favicon.png` | Favicon (PNG) |
-| `GET` | `/apple-touch-icon.png` | iOS home-screen icon |
-| `POST` | `/message` | Send a chat message |
-| `POST` | `/session-name` | Rename a session |
-| `POST` | `/session-order` | Persist the user-defined session display order (drag-and-drop) |
-| `POST` | `/delete-session` | Delete a session and all its messages |
-| `POST` | `/delete-message` | Delete a single message `{sid, id}` |
-| `GET` | `/pwd?sid=…` | Get the current working folder for a session (JSON: `{cwd}`) |
-| `POST` | `/cwd` | Set the working folder for a session (`{cwd, sessionId}`) |
-| `POST` | `/upload` | Upload a file (Base64-encoded body) |
-| `POST` | `/cancel?sid=…` | Cancel the active request for a session |
-
----
-
-## Architecture
-
-```
-Browser                        Server (web.ts)               DB (SQLite)
-───────                        ───────────────               ───────────
-GET /          ←─────────────  Embedded HTML/CSS/JS
-GET /events    ←── SSE ──────  sseClients Map
-POST /message  ────────────→   onMessage() → agent run
-                               agent replies → broadcastToSession()
-GET /sessions  ←── poll 5s ─   getAllChats() + sessionCwds   chats table
-POST /session-name  ────────→  updateChatName() (with guard) chats.name
-POST /session-order ────────→  setWebSessionOrder()          router_state
-GET /history   ←─────────────  getConversation()             messages table
-POST /delete-session  ──────→  deleteChat()                  chats + messages
-POST /delete-message  ──────→  deleteMessage(id)             messages table
-GET /pwd       ←─────────────  sessionCwds.get(sid)
-POST /cwd      ────────────→   updateChatCwd() → broadcast   chats.cwd
-POST /upload   ────────────→   fs.writeFile() into CWD dir
-POST /cancel   ────────────→   onCancelRequest()
-```
-
-### In-Memory Server State
-
-| Variable | Type | Content |
-|----------|------|---------|
-| `sseClients` | `Map<sid, Set<Response>>` | Open SSE connections per session |
-| `sessionCwds` | `Map<sid, string>` | Current CWD per session |
-| `sessionTyping` | `Map<sid, boolean>` | Whether the agent is processing |
-| `sessionStatus` | `Map<sid, string\|null>` | Last tool-status payload |
-| `registeredSessions` | `Set<sid>` | Sessions already registered with NanoClaw |
-
-### Database Schema (relevant columns in `chats`)
-
-| Column | Type | Purpose |
-|--------|------|---------|
-| `jid` | TEXT PK | `local@web-{sessionId}` |
-| `name` | TEXT | Session display name |
-| `name_updated_at` | INTEGER | UNIX epoch of the last rename |
-| `cwd` | TEXT | Current working directory |
-| `last_message_time` | TEXT | ISO timestamp updated on every message |
-
----
-
-## Development Workflow
-
-If you are running NanoClaw from source (not via `npx`):
-
-```bash
-# 1. Install dependencies
-npm install
-
-# 2. Build
-npm run build
-
-# 3. Run
-node dist/cli.js [options]
-```
-
-To apply changes and rebuild in one step:
-
-```bash
-npm run build && node dist/cli.js
-```
-
----
-
-## What's New
-
-The following files were added or changed relative to [qwibitai/nanoclaw](https://github.com/qwibitai/nanoclaw) `main`:
-
-### New files
-
-| File | Purpose |
-|------|---------|
-| `src/cli.ts` | CLI entry point — parses arguments, validates them, starts NanoClaw; enables `npx @rozek/nanoclaw` |
-| `src/channels/web.ts` | Complete HTTP server with embedded browser chat UI (HTML/CSS/JS inline) |
-| `src/mount-security.ts` | Validates additional container mounts against an allowlist stored outside the project root (prevents agents from tampering with security config) |
-| `src/session-commands.ts` | Session management commands (e.g. `/compact` for context compaction) — merged from upstream `skill/compact` branch |
-| `src/session-commands.test.ts` | Unit tests for session commands |
-| `container/skills/cwd/SKILL.md` | Built-in skill: instructs the AI to output `switching to folder: <path>` to update the working folder display |
-| `container/skills/pwd/SKILL.md` | Built-in skill: instructs the AI how to determine and report the current working folder |
-
-### Modified files
-
-| File | What changed |
-|------|-------------|
-| `package.json` | Added `"bin": {"nanoclaw": "dist/cli.js"}` so the package works as an `npx` command; `setup/` must be included in the TypeScript compilation (`tsconfig.json`) so `dist/setup/index.js` is available at runtime |
-| `src/cli.ts` | Added `runFirstTimeSetup()`: detects first run by checking for `store/messages.db`; if missing, automatically runs the setup steps `environment`, `container`, `mounts --empty`, and `verify` before starting NanoClaw — makes `npx @rozek/nanoclaw` self-configuring on first launch |
-| `src/channels/index.ts` | Exports the new web channel |
-| `src/channels/registry.ts` | Adds `registerGroup` and `onCancelRequest` to `ChannelOpts` so channels can register groups and handle cancel requests |
-| `src/index.ts` | Integrates the web channel and session commands into the orchestrator's main loop; exports `main()` for use by `cli.ts`; adds `formatApiError()` to display Anthropic API errors (401/429/529/500) as user-facing chat messages; uses per-session chat IDs as Claude session keys; adds `statusCallback` to forward live tool-use events to the channel; adds `initWorkspace()` which runs at startup and creates all required workspace directories (`store/`, `groups/main/`, `groups/global/`, `data/ipc/`, `data/sessions/`, `groups/main/Tools/`, `groups/main/Skills/`, `groups/main/MCP-Servers/`, `groups/main/conversations/`) if they don't exist yet |
-| `src/group-queue.ts` | Adds `cancelContainer()` — writes the close sentinel and sends SIGTERM to the container process for immediate cancellation |
-| `src/db.ts` | Adds `name_updated_at` and `cwd` columns to the `chats` table; updates `updateChatName()` with timestamp guard and optional `nameUpdatedAt` argument; extends `getAllChats()` to return the new columns; adds `getWebSessionOrder()`, `setWebSessionOrder()`, `updateChatCwd()`, `getConversation()`, `deleteChat()`, `clearChatMessages()`, `deleteMessage()` |
-| `src/types.ts` | Adds optional `setStatus?(jid, tool, inputSnippet)` to the channel interface so channels can show live tool-use status |
-| `src/container-runner.ts` | Adds status-marker protocol (`---NANOCLAW_STATUS_START---` / `---NANOCLAW_STATUS_END---`) so the agent runner can emit tool-use status events; always syncs agent-runner source from master on container start |
-| `src/task-scheduler.ts` | Routes scheduled task output for web sessions to a dedicated `local@web-cron` session (with task header); each task runs in its own queue slot (`task:<id>`) for parallel execution; uses per-session session IDs; falls back to the first `isMain` group when the task's `group_folder` is not found |
-| `container/agent-runner/src/index.ts` | Updated agent runner: emits status markers for tool use; supports external MCP servers from `MCP-Servers/`; supports context compaction (`/compact`) |
-
----
-
-## License
-
-MIT — same as the upstream [qwibitai/nanoclaw](https://github.com/qwibitai/nanoclaw).

package/README_zh.md

@@ -1,200 +0,0 @@
-<p align="center">
-  <img src="assets/nanoclaw-logo.png" alt="NanoClaw" width="400">
-</p>
-
-<p align="center">
-  NanoClaw —— 您的专属 Claude 助手，在容器中安全运行。它轻巧易懂，并能根据您的个人需求灵活定制。
-</p>
-
-<p align="center">
-  <a href="https://nanoclaw.dev">nanoclaw.dev</a>&nbsp; • &nbsp;
-  <a href="README.md">English</a>&nbsp; • &nbsp;
-  <a href="https://discord.gg/VDdww8qS42"><img src="https://img.shields.io/discord/1470188214710046894?label=Discord&logo=discord&v=2" alt="Discord" valign="middle"></a>&nbsp; • &nbsp;
-  <a href="repo-tokens"><img src="repo-tokens/badge.svg" alt="34.9k tokens, 17% of context window" valign="middle"></a>
-</p>
-通过 Claude Code，NanoClaw 可以动态重写自身代码，根据您的需求定制功能。
-
-**新功能：** 首个支持 [Agent Swarms（智能体集群）](https://code.claude.com/docs/en/agent-teams) 的 AI 助手。可轻松组建智能体团队，在您的聊天中高效协作。
-
-## 我为什么创建这个项目
-
-[OpenClaw](https://github.com/openclaw/openclaw) 是一个令人印象深刻的项目，但我无法安心使用一个我不了解却能访问我个人隐私的软件。OpenClaw 有近 50 万行代码、53 个配置文件和 70+ 个依赖项。其安全性是应用级别的（通过白名单、配对码实现），而非操作系统级别的隔离。所有东西都在一个共享内存的 Node 进程中运行。
-
-NanoClaw 用一个您能快速理解的代码库，为您提供了同样的核心功能。只有一个进程，少数几个文件。智能体（Agent）运行在具有文件系统隔离的真实 Linux 容器中，而不是依赖于权限检查。
-
-## 快速开始
-
-```bash
-git clone https://github.com/qwibitai/nanoclaw.git
-cd nanoclaw
-claude
-```
-
-然后运行 `/setup`。Claude Code 会处理一切：依赖安装、身份验证、容器设置、服务配置。
-
-> **注意：** 以 `/` 开头的命令（如 `/setup`、`/add-whatsapp`）是 [Claude Code 技能](https://code.claude.com/docs/en/skills)。请在 `claude` CLI 提示符中输入，而非在普通终端中。
-
-## 设计哲学
-
-**小巧易懂：** 单一进程，少量源文件。无微服务、无消息队列、无复杂抽象层。让 Claude Code 引导您轻松上手。
-
-**通过隔离保障安全:** 智能体运行在 Linux 容器（在 macOS 上是 Apple Container，或 Docker）中。它们只能看到被明确挂载的内容。即便通过 Bash 访问也十分安全，因为所有命令都在容器内执行，不会直接操作您的宿主机。
-
-**为单一用户打造:** 这不是一个框架，是一个完全符合您个人需求的、可工作的软件。您可以 Fork 本项目，然后让 Claude Code 根据您的精确需求进行修改和适配。
-
-**定制即代码修改:** 没有繁杂的配置文件。想要不同的行为？直接修改代码。代码库足够小，这样做是安全的。
-
-**AI 原生:** 无安装向导（由 Claude Code 指导安装）。无需监控仪表盘，直接询问 Claude 即可了解系统状况。无调试工具（描述问题，Claude 会修复它）。
-
-**技能（Skills）优于功能（Features）:** 贡献者不应该向代码库添加新功能（例如支持 Telegram）。相反，他们应该贡献像 `/add-telegram` 这样的 [Claude Code 技能](https://code.claude.com/docs/en/skills)，这些技能可以改造您的 fork。最终，您得到的是只做您需要事情的整洁代码。
-
-**最好的工具套件，最好的模型:** 本项目运行在 Claude Agent SDK 之上，这意味着您直接运行的就是 Claude Code。Claude Code 高度强大，其编码和问题解决能力使其能够修改和扩展 NanoClaw，为每个用户量身定制。
-
-## 功能支持
-
-- **多渠道消息** - 通过 WhatsApp、Telegram、Discord、Slack 或 Gmail 与您的助手对话。使用 `/add-whatsapp` 或 `/add-telegram` 等技能添加渠道，可同时运行一个或多个。
-- **隔离的群组上下文** - 每个群组都拥有独立的 `CLAUDE.md` 记忆和隔离的文件系统。它们在各自的容器沙箱中运行，且仅挂载所需的文件系统。
-- **主频道** - 您的私有频道（self-chat），用于管理控制；其他所有群组都完全隔离
-- **计划任务** - 运行 Claude 的周期性作业，并可以给您回发消息
-- **网络访问** - 搜索和抓取网页内容
-- **容器隔离** - 智能体在 Apple Container (macOS) 或 Docker (macOS/Linux) 的沙箱中运行
-- **智能体集群（Agent Swarms）** - 启动多个专业智能体团队，协作完成复杂任务（首个支持此功能的个人 AI 助手）
-- **可选集成** - 通过技能添加 Gmail (`/add-gmail`) 等更多功能
-
-## 使用方法
-
-使用触发词（默认为 `@Andy`）与您的助手对话：
-
-```
-@Andy 每周一到周五早上9点，给我发一份销售渠道的概览（需要访问我的 Obsidian vault 文件夹）
-@Andy 每周五回顾过去一周的 git 历史，如果与 README 有出入，就更新它
-@Andy 每周一早上8点，从 Hacker News 和 TechCrunch 收集关于 AI 发展的资讯，然后发给我一份简报
-```
-
-在主频道（您的self-chat）中，可以管理群组和任务：
-```
-@Andy 列出所有群组的计划任务
-@Andy 暂停周一简报任务
-@Andy 加入"家庭聊天"群组
-```
-
-## 定制
-
-没有需要学习的配置文件。直接告诉 Claude Code 您想要什么：
-
-- "把触发词改成 @Bob"
-- "记住以后回答要更简短直接"
-- "当我说早上好的时候，加一个自定义的问候"
-- "每周存储一次对话摘要"
-
-或者运行 `/customize` 进行引导式修改。
-
-代码库足够小，Claude 可以安全地修改它。
-
-## 贡献
-
-**不要添加功能，而是添加技能。**
-
-如果您想添加 Telegram 支持，不要创建一个 PR 同时添加 Telegram 和 WhatsApp。而是贡献一个技能文件 (`.claude/skills/add-telegram/SKILL.md`)，教 Claude Code 如何改造一个 NanoClaw 安装以使用 Telegram。
-
-然后用户在自己的 fork 上运行 `/add-telegram`，就能得到只做他们需要事情的整洁代码，而不是一个试图支持所有用例的臃肿系统。
-
-### RFS (技能征集)
-
-我们希望看到的技能：
-
-**通信渠道**
-- `/add-signal` - 添加 Signal 作为渠道
-
-**会话管理**
-- `/clear` - 添加一个 `/clear` 命令，用于压缩会话（在同一会话中总结上下文，同时保留关键信息）。这需要研究如何通过 Claude Agent SDK 以编程方式触发压缩。
-
-## 系统要求
-
-- macOS 或 Linux
-- Node.js 20+
-- [Claude Code](https://claude.ai/download)
-- [Apple Container](https://github.com/apple/container) (macOS) 或 [Docker](https://docker.com/products/docker-desktop) (macOS/Linux)
-
-## 架构
-
-```
-渠道 --> SQLite --> 轮询循环 --> 容器 (Claude Agent SDK) --> 响应
-```
-
-单一 Node.js 进程。渠道通过技能添加，启动时自注册 — 编排器连接具有凭据的渠道。智能体在具有文件系统隔离的 Linux 容器中执行。每个群组的消息队列带有并发控制。通过文件系统进行 IPC。
-
-完整架构详情请见 [docs/SPEC.md](docs/SPEC.md)。
-
-关键文件：
-- `src/index.ts` - 编排器：状态管理、消息循环、智能体调用
-- `src/channels/registry.ts` - 渠道注册表（启动时自注册）
-- `src/ipc.ts` - IPC 监听与任务处理
-- `src/router.ts` - 消息格式化与出站路由
-- `src/group-queue.ts` - 带全局并发限制的群组队列
-- `src/container-runner.ts` - 生成流式智能体容器
-- `src/task-scheduler.ts` - 运行计划任务
-- `src/db.ts` - SQLite 操作（消息、群组、会话、状态）
-- `groups/*/CLAUDE.md` - 各群组的记忆
-
-## FAQ
-
-**为什么是 Docker？**
-
-Docker 提供跨平台支持（macOS 和 Linux）和成熟的生态系统。在 macOS 上，您可以选择通过运行 `/convert-to-apple-container` 切换到 Apple Container，以获得更轻量级的原生运行时体验。
-
-**我可以在 Linux 上运行吗？**
-
-可以。Docker 是默认的容器运行时，在 macOS 和 Linux 上都可以使用。只需运行 `/setup`。
-
-**这个项目安全吗？**
-
-智能体在容器中运行，而不是在应用级别的权限检查之后。它们只能访问被明确挂载的目录。您仍然应该审查您运行的代码，但这个代码库小到您真的可以做到。完整的安全模型请见 [docs/SECURITY.md](docs/SECURITY.md)。
-
-**为什么没有配置文件？**
-
-我们不希望配置泛滥。每个用户都应该定制它，让代码完全符合他们的需求，而不是去配置一个通用的系统。如果您喜欢用配置文件，告诉 Claude 让它加上。
-
-**我可以使用第三方或开源模型吗？**
-
-可以。NanoClaw 支持任何 API 兼容的模型端点。在 `.env` 文件中设置以下环境变量：
-
-```bash
-ANTHROPIC_BASE_URL=https://your-api-endpoint.com
-ANTHROPIC_AUTH_TOKEN=your-token-here
-```
-
-这使您能够使用：
-- 通过 [Ollama](https://ollama.ai) 配合 API 代理运行的本地模型
-- 托管在 [Together AI](https://together.ai)、[Fireworks](https://fireworks.ai) 等平台上的开源模型
-- 兼容 Anthropic API 格式的自定义模型部署
-
-注意：为获得最佳兼容性，模型需支持 Anthropic API 格式。
-
-**我该如何调试问题？**
-
-问 Claude Code。"为什么计划任务没有运行？" "最近的日志里有什么？" "为什么这条消息没有得到回应？" 这就是 AI 原生的方法。
-
-**为什么我的安装不成功？**
-
-如果遇到问题，安装过程中 Claude 会尝试动态修复。如果问题仍然存在，运行 `claude`，然后运行 `/debug`。如果 Claude 发现一个可能影响其他用户的问题，请开一个 PR 来修改 setup SKILL.md。
-
-**什么样的代码更改会被接受？**
-
-安全修复、bug 修复，以及对基础配置的明确改进。仅此而已。
-
-其他一切（新功能、操作系统兼容性、硬件支持、增强功能）都应该作为技能来贡献。
-
-这使得基础系统保持最小化，并让每个用户可以定制他们的安装，而无需继承他们不想要的功能。
-
-## 社区
-
-有任何疑问或建议？欢迎[加入 Discord 社区](https://discord.gg/VDdww8qS42)与我们交流。
-
-## 更新日志
-
-破坏性变更和迁移说明请见 [CHANGELOG.md](CHANGELOG.md)。
-
-## 许可证
-
-MIT

package/config-examples/mount-allowlist.json

@@ -1,25 +0,0 @@
-{
-  "allowedRoots": [
-    {
-      "path": "~/projects",
-      "allowReadWrite": true,
-      "description": "Development projects"
-    },
-    {
-      "path": "~/repos",
-      "allowReadWrite": true,
-      "description": "Git repositories"
-    },
-    {
-      "path": "~/Documents/work",
-      "allowReadWrite": false,
-      "description": "Work documents (read-only)"
-    }
-  ],
-  "blockedPatterns": [
-    "password",
-    "secret",
-    "token"
-  ],
-  "nonMainReadOnly": true
-}