campaign お知らせ

info はじめに

NanoClaw は Anthropic Claude Agent SDK 上に構築された軽量で完全自律型のパーソナルAIアシスタントです。エージェントは隔離された Linux コンテナ（macOS では Apple Container、Linux/macOS では Docker）で実行。WhatsApp 標準搭載、その他のチャネルはスキルで追加。永続 SQLite メモリ、スケジュールタスク、ウェブアクセス、エージェント群。

download インストール

NanoClaw は TypeScript プロジェクトです。リポジトリをクローンして npm でインストールしてください。

npm / Claude CLI

# macOS / Linux — clone and setup
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
claude
# Then run /setup in the Claude session

# Or install Claude CLI first:
npm install -g @anthropic-ai/claude-code

クイックセットアップ（推奨）

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
claude
# Run /setup inside the Claude session

# With environment variables pre-configured:
ANTHROPIC_API_KEY="sk-..." claude

# Quick start after setup:
npm start

手動ビルドとインストール

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
npm install
# Edit src/index.ts to configure your settings
npm start

開発用フォールバック：ホットリロード付き開発モードで 'npm run dev' を実行。

rocket_launch クイックスタート

初回にオンボーディングを実行して設定を行い、チャットを開始しましょう。

# Clone and setup
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw && npm install

# Run setup wizard
npm run setup

# Start NanoClaw
npm start

# Development mode (hot reload)
npm run dev

# Run tests
npm test

設定はソースコードを直接編集して行います。API キーは .env に、チャネル設定は src/index.ts に記述します。

terminal コマンド

NanoClaw はすべてのワークフローに npm スクリプトを使用します。

forum チャネル

WhatsApp は標準搭載チャネルです（Baileys ライブラリ経由）。その他のチャネル — Telegram、Discord、Slack — は Claude Code スキル（/add-telegram、/add-discord、/add-slack）で追加できます。各グループは独自の隔離コンテナと CLAUDE.md メモリを持ちます。

# WhatsApp (built-in via Baileys library)
# Run 'npm run auth' to pair via QR code
# Per-group containers with isolated CLAUDE.md memory

# Add more channels via Claude Code skills:
# /add-telegram — Telegram bot support
# /add-discord — Discord gateway support
# /add-slack — Slack Events API support

# Start the agent (connects WhatsApp)
npm start

ヒント：Claude Code で /add-telegram や /add-discord を実行してチャネルを追加。スキルがフォークのソースコードを直接変更します。

build ツール

ツールは会話中にエージェントが呼び出せる機能です。すべての組み込みツールはデフォルトでサンドボックス化され、ワークスペースにスコープされています。

# Built-in tools (provided by Claude Code inside containers):
# shell commands, file read/write, web search,
# web browsing (Chromium + agent-browser),
# agent delegation (swarms)

# Host-provided capabilities:
# SQLite memory, scheduled tasks (cron),
# WhatsApp messaging, IPC between host and containers

# Container image includes Chromium and agent-browser
# Apple Container on macOS, Docker on Linux

database メモリシステム

NanoClaw は永続ストレージに SQLite（better-sqlite3）を使用 — メッセージ、グループ、セッション、スケジュールタスク。各グループにはコンテナにマウントされる独自の CLAUDE.md ファイルもあります。

# SQLite database (better-sqlite3)
# Messages, groups, sessions, scheduled tasks, router state

# Per-group CLAUDE.md memory files
# Mounted into each group's container

# IPC via filesystem between host and containers
# No external database — everything is local

settings 設定

NanoClaw は設定ファイルを使用しません。変更するには Claude Code に要望を伝えてください。コードベースは Claude が安全に変更できるほど小さいです。API キーは .env に、その他はすべてソースコードに記述します。

# NanoClaw doesn't use configuration files
# To make changes, tell Claude Code what you want

# Key files:
# src/index.ts — orchestrator, state, message loop
# src/config.ts — constants, trigger pattern, paths
# .env — API key and runtime settings

# Environment variables:
ANTHROPIC_API_KEY="sk-ant-..."
ASSISTANT_NAME="Andy"
CONTAINER_IMAGE="nanoclaw-agent:latest"

model_training AIプロバイダー

NanoClaw は Anthropic Claude Agent SDK 上でのみ動作します。Claude Code が各コンテナ内で実行され、すべてのAI機能を提供します。

NanoClaw は設計上単一プロバイダーです。Claude Agent SDK がモデル選択を内部的に処理します。.env に ANTHROPIC_API_KEY を設定するか、Claude Code OAuth で認証してください。

key 環境変数

ローカルの .env ファイルで設定する環境変数。シークレットはオンデマンドで読み取られ、process.env には読み込まれません。

# Required
ANTHROPIC_API_KEY=sk-ant-...

# Optional
ASSISTANT_NAME=Andy
ASSISTANT_HAS_OWN_NUMBER=false
CONTAINER_IMAGE=nanoclaw-agent:latest
CONTAINER_TIMEOUT=1800000
TZ=America/New_York

shield セキュリティ

エージェントはアプリケーションレベルの権限チェックではなく、コンテナで実行されます。明示的にマウントされたディレクトリのみアクセス可能です。

# Container isolation (Apple Container / Docker)
# Each agent runs in its own Linux container

# Secrets passed via stdin JSON, never in process.env
# Mount allowlists with symlink escape detection
# Containers run as non-root with read-only project mounts

account_tree アーキテクチャ

単一 Node.js プロセス。エージェントはファイルシステム隔離された Linux コンテナで実行。グループごとの同時実行制御付きメッセージキュー。ファイルシステム経由の IPC。

code 開発

標準的な TypeScript/Node.js ワークフロー。ホットリロード付き開発には 'npm run dev' を実行。

# Clone the repo
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

menu_book ドキュメントハブ

詳細なドキュメントは公式リポジトリの docs ディレクトリをご参照ください。

git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude