ef1aff1532
Some checks failed
Bump version / bump-version (push) Has been cancelled
Sync upstream & merge-forward skill branches / sync-and-merge (push) Has been cancelled
Merge-forward skill branches / merge-forward (push) Has been cancelled
Update token count / update-tokens (push) Has been cancelled
- Add ASSISTANT_NAME and claude-minimax.sh for MiniMax API usage - Switch container runtime from Docker to Apple Container - Add CJK character restriction notice to CLAUDE.md files - Add stop.sh for graceful shutdown Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
87 lines
4.2 KiB
Markdown
87 lines
4.2 KiB
Markdown
# NanoClaw
|
||
|
||
**CRITICAL — NO CHINESE/JAPANESE CHARACTERS**
|
||
|
||
You MUST write in Korean (한글) and English only. Chinese characters (漢字/Hanja), Japanese kanji, and Japanese-Romaji mixed text (オペレーション, インストール, etc.) are STRICTLY FORBIDDEN in all your responses. This applies to ALL output — code, comments, documentation, and conversation. Use pure Korean or English equivalents.
|
||
|
||
Examples of violations (절대 사용 금지):
|
||
- 漢字, 適用, 確認, 完了, 問題, 報告
|
||
- オペレーション, インストール, コンテンツ, パスワード, プログラム
|
||
- Any CJK Unified Ideographs (U+4E00–U+9FFF)
|
||
|
||
---
|
||
|
||
Personal Claude assistant. See [README.md](README.md) for philosophy and setup. See [docs/REQUIREMENTS.md](docs/REQUIREMENTS.md) for architecture decisions.
|
||
|
||
## Quick Context
|
||
|
||
Single Node.js process with skill-based channel system. Channels (WhatsApp, Telegram, Slack, Discord, Gmail) are skills that self-register at startup. Messages route to Claude Agent SDK running in containers (Linux VMs). Each group has isolated filesystem and memory.
|
||
|
||
## Key Files
|
||
|
||
| File | Purpose |
|
||
|------|---------|
|
||
| `src/index.ts` | Orchestrator: state, message loop, agent invocation |
|
||
| `src/channels/registry.ts` | Channel registry (self-registration at startup) |
|
||
| `src/ipc.ts` | IPC watcher and task processing |
|
||
| `src/router.ts` | Message formatting and outbound routing |
|
||
| `src/config.ts` | Trigger pattern, paths, intervals |
|
||
| `src/container-runner.ts` | Spawns agent containers with mounts |
|
||
| `src/task-scheduler.ts` | Runs scheduled tasks |
|
||
| `src/db.ts` | SQLite operations |
|
||
| `groups/{name}/CLAUDE.md` | Per-group memory (isolated) |
|
||
| `container/skills/` | Skills loaded inside agent containers (browser, status, formatting) |
|
||
|
||
## Skills
|
||
|
||
Four types of skills exist in NanoClaw. See [CONTRIBUTING.md](CONTRIBUTING.md) for the full taxonomy and guidelines.
|
||
|
||
- **Feature skills** — merge a `skill/*` branch to add capabilities (e.g. `/add-telegram`, `/add-slack`)
|
||
- **Utility skills** — ship code files alongside SKILL.md (e.g. `/claw`)
|
||
- **Operational skills** — instruction-only workflows, always on `main` (e.g. `/setup`, `/debug`)
|
||
- **Container skills** — loaded inside agent containers at runtime (`container/skills/`)
|
||
|
||
| Skill | When to Use |
|
||
|-------|-------------|
|
||
| `/setup` | First-time installation, authentication, service configuration |
|
||
| `/customize` | Adding channels, integrations, changing behavior |
|
||
| `/debug` | Container issues, logs, troubleshooting |
|
||
| `/update-nanoclaw` | Bring upstream NanoClaw updates into a customized install |
|
||
| `/qodo-pr-resolver` | Fetch and fix Qodo PR review issues interactively or in batch |
|
||
| `/get-qodo-rules` | Load org- and repo-level coding rules from Qodo before code tasks |
|
||
|
||
## Contributing
|
||
|
||
Before creating a PR, adding a skill, or preparing any contribution, you MUST read [CONTRIBUTING.md](CONTRIBUTING.md). It covers accepted change types, the four skill types and their guidelines, SKILL.md format rules, PR requirements, and the pre-submission checklist (searching for existing PRs/issues, testing, description format).
|
||
|
||
## Development
|
||
|
||
Run commands directly—don't tell the user to run them.
|
||
|
||
```bash
|
||
npm run dev # Run with hot reload
|
||
npm run build # Compile TypeScript
|
||
./container/build.sh # Rebuild agent container
|
||
```
|
||
|
||
Service management:
|
||
```bash
|
||
# macOS (launchd)
|
||
launchctl load ~/Library/LaunchAgents/com.nanoclaw.plist
|
||
launchctl unload ~/Library/LaunchAgents/com.nanoclaw.plist
|
||
launchctl kickstart -k gui/$(id -u)/com.nanoclaw # restart
|
||
|
||
# Linux (systemd)
|
||
systemctl --user start nanoclaw
|
||
systemctl --user stop nanoclaw
|
||
systemctl --user restart nanoclaw
|
||
```
|
||
|
||
## Troubleshooting
|
||
|
||
**WhatsApp not connecting after upgrade:** WhatsApp is now a separate skill, not bundled in core. Run `/add-whatsapp` (or `npx tsx scripts/apply-skill.ts .claude/skills/add-whatsapp && npm run build`) to install it. Existing auth credentials and groups are preserved.
|
||
|
||
## Container Build Cache
|
||
|
||
The container buildkit caches the build context aggressively. `--no-cache` alone does NOT invalidate COPY steps — the builder's volume retains stale files. To force a truly clean rebuild, prune the builder then re-run `./container/build.sh`.
|