picoclaw/docs/project/README.ja.md

PicoClaw: Go で書かれた超効率 AI アシスタント

$10 ハードウェア · 10MB RAM · ms 起動 · Let's Go, PicoClaw!

中文 | 日本語 | 한국어 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | Malay | English

---

PicoClaw は Sipeed が立ち上げた独立したオープンソースプロジェクトです。完全に Go 言語で一から書かれており、OpenClaw、NanoBot、その他のプロジェクトのフォークではありません。

PicoClaw は NanoBot にインスパイアされた超軽量パーソナル AI アシスタントです。Go でゼロからリビルドされ、「セルフブートストラッピング」プロセスで構築されました — AI Agent 自身がアーキテクチャの移行とコード最適化を推進しました。

$10 のハードウェアで 10MB 未満の RAM で動作 — OpenClaw より 99% 少ないメモリ、Mac mini より 98% 安い！

Caution

セキュリティに関する注意

• 暗号通貨なし: PicoClaw には公式トークン/コインは一切ありません。pump.fun やその他の取引プラットフォームでの主張はすべて詐欺です。
• 公式ドメイン: 唯一の公式サイトは picoclaw.io、企業サイトは sipeed.com です。
• 注意: 多くの .ai/.org/.com/.net/... ドメインは第三者によって登録されています。信頼しないでください。
• 注記: PicoClaw は初期開発段階にあり、未解決のネットワークセキュリティ問題がある可能性があります。v1.0 リリース前に本番環境へのデプロイは避けてください。
• 注記: PicoClaw は最近多くの PR をマージしており、最新バージョンではメモリフットプリントが大きくなる場合があります（10〜20MB）。機能セットが安定次第、リソース最適化を優先する予定です。

📢 ニュース

2026-03-31 📱 Android サポート！ PicoClawがAndroidで動作！APKはpicoclaw.ioからダウンロード

2026-03-25 🚀 v0.2.4 リリース！ Agent アーキテクチャ全面刷新（SubTurn、Hooks、Steering、EventBus）、WeChat/WeCom 統合、セキュリティ強化（.security.yml、機密データフィルタリング）、新プロバイダー（AWS Bedrock、Azure、Xiaomi MiMo）、35 件のバグ修正。PicoClaw 26K ⭐ 達成！

2026-03-17 🚀 v0.2.3 リリース！ システムトレイ UI（Windows & Linux）、サブエージェントステータス追跡（spawn_status）、実験的 Gateway ホットリロード、cron セキュリティゲート、セキュリティ修正 2 件。PicoClaw 25K ⭐ 達成！

2026-03-09 🎉 v0.2.1 — 最大のアップデート！ MCP プロトコルサポート、4 つの新チャンネル (Matrix/IRC/WeCom/Discord Proxy)、3 つの新プロバイダー (Kimi/Minimax/Avian)、ビジョンパイプライン、JSONL メモリストア、モデルルーティング。

2026-02-28 📦 v0.2.0 リリース — Docker Compose と Web UI Launcher サポート。

過去のニュース...

2026-02-26 🎉 PicoClaw がわずか 17 日で 20K スター 達成！Channel 自動オーケストレーションとケイパビリティインターフェースが実装されました。

2026-02-16 🎉 PicoClaw が 1 週間で 12K スター達成！コミュニティメンテナーの役割とロードマップが正式に公開されました。

2026-02-13 🎉 PicoClaw が 4 日間で 5000 スター達成！プロジェクトロードマップと開発者グループの準備が進行中。

2026-02-09 🎉 PicoClaw リリース！ $10 ハードウェアで 10MB 未満の RAM で動く AI Agent を 1 日で構築。Let's Go, PicoClaw!

✨ 特徴

🪶 超軽量: コアメモリフットプリント 10MB 未満 — OpenClaw より 99% 小さい。*

💰 最小コスト: $10 ハードウェアで動作 — Mac mini より 98% 安い。

⚡️ 超高速起動: 起動時間 400 倍高速。0.6GHz シングルコアでも 1 秒未満で起動。

🌍 真のポータビリティ: RISC-V、ARM、MIPS、x86 対応の単一バイナリ。どこでも動く！

🤖 AI ブートストラップ: 純粋な Go ネイティブ実装 — コアコードの 95% が Agent によって生成され、人間によるレビューで調整。

🔌 MCP 対応: ネイティブ Model Context Protocol 統合 — 任意の MCP サーバーに接続して Agent 機能を拡張。

👁️ ビジョンパイプライン: 画像やファイルを Agent に直接送信 — マルチモーダル LLM 向けの自動 base64 エンコーディング。

🧠 スマートルーティング: ルールベースのモデルルーティング — 簡単なクエリは軽量モデルへ、API コストを節約。

*最近のバージョンでは急速な PR マージにより 10〜20MB になる場合があります。リソース最適化は計画中です。起動時間の比較は 0.8GHz シングルコアベンチマークに基づいています（下表参照）。

	OpenClaw	NanoBot	PicoClaw
言語	TypeScript	Python	Go
RAM	>1GB	>100MB	< 10MB*
起動時間 (0.8GHz コア)	>500秒	>30秒	<1秒
コスト	Mac Mini $599	大半の Linux ボード ~$50	あらゆる Linux ボード 最安 $10

ハードウェア互換性リスト — テスト済みの全ボード一覧（$5 RISC-V から Raspberry Pi、Android スマートフォンまで）。お使いのボードが未掲載？PR を送ってください！

🦾 デモンストレーション

🛠️ スタンダードアシスタントワークフロー

フルスタックエンジニアモード	ログ＆計画管理	Web 検索＆学習
開発 · デプロイ · スケール	スケジュール · 自動化 · メモリ	発見 · インサイト · トレンド

🐜 革新的な省フットプリントデプロイ

PicoClaw はほぼすべての Linux デバイスにデプロイできます！

• $9.9 LicheeRV-Nano E(Ethernet) または W(WiFi6) バージョン、最小ホームアシスタントに
• $30~50 NanoKVM または $100 NanoKVM-Pro サーバー自動メンテナンスに
• $50 MaixCAM または $100 MaixCAM2 スマート監視に

https://private-user-images.githubusercontent.com/83055338/547056448-e7b031ff-d6f5-4468-bcca-5726b6fecb5c.mp4

🌟 もっと多くのデプロイ事例が待っています！

📦 インストール

picoclaw.io からダウンロード（推奨）

picoclaw.io にアクセス — 公式サイトがプラットフォームを自動検出し、ワンクリックでダウンロードできます。アーキテクチャを手動で選ぶ必要はありません。

プリコンパイル済みバイナリをダウンロード

または、GitHub Releases ページからプラットフォームに合ったバイナリをダウンロードしてください。

ソースからビルド（開発用）

前提条件:

• Go 1.25+
• Web UI / launcher のビルドには Node.js 22+ と pnpm 10.33.0+ が必要

git clone https://github.com/sipeed/picoclaw.git

cd picoclaw
make deps

# フロントエンド依存関係をインストール
(cd web/frontend && pnpm install --frozen-lockfile)

# コアバイナリをビルド
make build

# Web UI Launcher をビルド（WebUI モードに必要）
make build-launcher

# Makefile が管理するすべてのプラットフォーム向けにコアバイナリをビルド
make build-all

# Raspberry Pi Zero 2 W 向けビルド（32-bit: make build-linux-arm; 64-bit: make build-linux-arm64）
make build-pi-zero

# ビルドとインストール
make install

Raspberry Pi Zero 2 W: OS に合ったバイナリを使用してください：32-bit Raspberry Pi OS → make build-linux-arm、64-bit → make build-linux-arm64。または make build-pi-zero で両方をビルド。

🚀 クイックスタートガイド

🌐 WebUI Launcher（デスクトップ向け推奨）

WebUI Launcher はブラウザベースの設定・チャットインターフェースを提供します。コマンドラインの知識不要で、最も簡単に始められる方法です。

オプション 1: ダブルクリック（デスクトップ）

picoclaw.io からダウンロード後、picoclaw-launcher（Windows では picoclaw-launcher.exe）をダブルクリックしてください。ブラウザが自動的に http://localhost:18800 を開きます。

オプション 2: コマンドライン

picoclaw-launcher
# ブラウザで http://localhost:18800 を開く

Tip

リモートアクセス / Docker / VM: すべてのインターフェースでリッスンするには -public フラグを追加してください：

picoclaw-launcher -public

始め方:

WebUI を開いたら：1) Provider を設定（LLM API キーを追加）→ 2) Channel を設定（例：Telegram）→ 3) Gateway を起動 → 4) チャット！

WebUI の詳細なドキュメントは docs.picoclaw.io を参照してください。

Docker（代替手段）

# 1. このリポジトリをクローン
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. 初回実行 — docker/data/config.json を自動生成して終了
#    （config.json と workspace/ の両方が存在しない場合のみ実行）
docker compose -f docker/docker-compose.yml --profile launcher up
# コンテナが "First-run setup complete." を出力して停止します。

# 3. API キーを設定
vim docker/data/config.json

# 4. 起動
docker compose -f docker/docker-compose.yml --profile launcher up -d
# http://localhost:18800 を開く

Docker / VM ユーザー: Gateway はデフォルトで 127.0.0.1 でリッスンします。ホストからアクセスできるようにするには PICOCLAW_GATEWAY_HOST=0.0.0.0 を設定するか、-public フラグを使用してください。

# ログを確認
docker compose -f docker/docker-compose.yml logs -f

# 停止
docker compose -f docker/docker-compose.yml --profile launcher down

# 更新
docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile launcher up -d

macOS — 初回起動時のセキュリティ警告

picoclaw-launcher はインターネットからダウンロードされ、Mac App Store を通じて公証されていないため、macOS が初回起動時にブロックする場合があります。

ステップ 1： picoclaw-launcher をダブルクリックすると、セキュリティ警告が表示されます：

"picoclaw-launcher" は開けません — "picoclaw-launcher" がMacに害を与えたりプライバシーを侵害するマルウェアを含まないことをAppleは確認できません。

ステップ 2： システム設定 → プライバシーとセキュリティ を開き、セキュリティ セクションまでスクロールして このまま開く をクリック → ダイアログで再度 開く をクリックします。

この操作を一度行うと、以降の起動では警告が表示されなくなります。

📱 Android

10 年前のスマホに第二の人生を！PicoClaw でスマート AI アシスタントに変身させましょう。

オプション 1: APK インストール

プレビュー：

picoclaw.io から APK をダウンロードして直接インストール。Termux 不要！

オプション 2: Termux

Terminal Launcher（リソース制約環境向け）

1. Termux をインストール（GitHub Releases からダウンロード、または F-Droid / Google Play で検索）
2. 以下のコマンドを実行：

# 最新リリースをダウンロード
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard   # chroot で標準的な Linux ファイルシステムレイアウトを提供

その後、下記の Terminal Launcher セクションの手順に従って設定を完了してください。

picoclaw コアバイナリのみが利用可能な最小環境（Launcher UI なし）では、コマンドラインと JSON 設定ファイルですべてを設定できます。

1. 初期化

picoclaw onboard

~/.picoclaw/config.json とワークスペースディレクトリが作成されます。

2. 設定 (~/.picoclaw/config.json)

{
  "agents": {
    "defaults": {
      "model_name": "gpt-5.4"
    }
  },
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_key": "sk-your-api-key"
    }
  ]
}

利用可能なすべてのオプションを含む完全な設定テンプレートは、リポジトリの config/config.example.json を参照してください。

3. チャット

# ワンショット質問
picoclaw agent -m "What is 2+2?"

# インタラクティブモード
picoclaw agent

# チャットアプリ統合用 Gateway を起動
picoclaw gateway

🔌 Provider（LLM）

PicoClaw は model_list 設定を通じて 30 以上の LLM Provider をサポートしています。protocol/model 形式を使用してください：

Provider	Protocol	API キー	備考
OpenAI	openai/	必須	GPT-5.4、GPT-4o、o3 など
Anthropic	anthropic/	必須	Claude Opus 4.6、Sonnet 4.6 など
Google Gemini	gemini/	必須	Gemini 3 Flash、2.5 Pro など
OpenRouter	openrouter/	必須	200 以上のモデル、統合 API
Zhipu (GLM)	zhipu/	必須	GLM-4.7、GLM-5 など
DeepSeek	deepseek/	必須	DeepSeek-V3、DeepSeek-R1
Volcengine	volcengine/	必須	Doubao、Ark モデル
Qwen	qwen/	必須	Qwen3、Qwen-Max など
Groq	groq/	必須	高速推論（Llama、Mixtral）
Moonshot (Kimi)	moonshot/	必須	Kimi モデル
Minimax	minimax/	必須	MiniMax モデル
Mistral	mistral/	必須	Mistral Large、Codestral
NVIDIA NIM	nvidia/	必須	NVIDIA ホスティングモデル
Cerebras	cerebras/	必須	高速推論
Novita AI	novita/	必須	各種オープンモデル
Xiaomi MiMo	mimo/	必須	MiMo モデル
Ollama	ollama/	不要	ローカルモデル、セルフホスト
vLLM	vllm/	不要	ローカルデプロイ、OpenAI 互換
LiteLLM	litellm/	場合による	100 以上の Provider のプロキシ
Azure OpenAI	azure/	必須	エンタープライズ Azure デプロイ
GitHub Copilot	github-copilot/	OAuth	デバイスコードログイン
Antigravity	antigravity/	OAuth	Google Cloud AI

ローカルデプロイ（Ollama、vLLM など）

Ollama:

{
  "model_list": [
    {
      "model_name": "local-llama",
      "model": "ollama/llama3.1:8b",
      "api_base": "http://localhost:11434/v1"
    }
  ]
}

vLLM:

{
  "model_list": [
    {
      "model_name": "local-vllm",
      "model": "vllm/your-model",
      "api_base": "http://localhost:8000/v1"
    }
  ]
}

Provider の完全な設定詳細は Provider とモデル を参照してください。

💬 Channel（チャットアプリ）

17 以上のメッセージングプラットフォームで PicoClaw と会話できます：

Channel	セットアップ	Protocol	ドキュメント
Telegram	簡単（bot トークン）	Long polling	ガイド
Discord	簡単（bot トークン + intents）	WebSocket	ガイド
WhatsApp	簡単（QR スキャンまたは bridge URL）	Native / Bridge	ガイド
微信 (Weixin)	簡単（QR スキャン）	iLink API	ガイド
QQ	簡単（AppID + AppSecret）	WebSocket	ガイド
Slack	簡単（bot + app トークン）	Socket Mode	ガイド
Matrix	中級（homeserver + トークン）	Sync API	ガイド
DingTalk	中級（クライアント認証情報）	Stream	ガイド
Feishu / Lark	中級（App ID + Secret）	WebSocket/SDK	ガイド
LINE	中級（認証情報 + webhook）	Webhook	ガイド
WeCom	簡単（QR ログインまたは手動）	WebSocket	ガイド
IRC	中級（サーバー + nick）	IRC protocol	ガイド
OneBot	中級（WebSocket URL）	OneBot v11	ガイド
MaixCam	簡単（有効化）	TCP socket	ガイド
Pico	簡単（有効化）	Native protocol	内蔵
Pico Client	簡単（WebSocket URL）	WebSocket	内蔵

webhook ベースのすべての Channel は単一の Gateway HTTP サーバー（gateway.host:gateway.port、デフォルト 127.0.0.1:18790）を共有します。Feishu は WebSocket/SDK モードを使用し、共有 HTTP サーバーを使用しません。

ログの詳細度は gateway.log_level で制御します（デフォルト：warn）。サポートされる値：debug、info、warn、error、fatal。PICOCLAW_LOG_LEVEL 環境変数でも設定可能です。詳細は設定ガイドを参照してください。

Channel の詳細なセットアップ手順は チャットアプリ設定 を参照してください。

🔧 ツール

🔍 Web 検索

PicoClaw は最新情報を提供するために Web を検索できます。tools.web で設定してください：

検索エンジン	API キー	無料枠	リンク
DuckDuckGo	不要	無制限	内蔵フォールバック
Baidu Search	必須	1000 クエリ/日	AI 搭載、中国語に最適化
Tavily	必須	1000 クエリ/月	AI Agent 向けに最適化
Brave Search	必須	2000 クエリ/月	高速でプライベート
Perplexity	必須	有料	AI 搭載検索
SearXNG	不要	セルフホスト	無料メタ検索エンジン
GLM Search	必須	場合による	Zhipu Web 検索

⚙️ その他のツール

PicoClaw にはファイル操作、コード実行、スケジューリングなどの組み込みツールが含まれています。詳細は ツール設定 を参照してください。

🎯 Skill

Skill は Agent を拡張するモジュール型の機能です。ワークスペース内の SKILL.md ファイルから読み込まれます。

ClawHub から Skill をインストール：

picoclaw skills search "web scraping"
picoclaw skills install <skill-name>

ClawHub トークンを設定（オプション、レート制限を上げるため）：

config.json に追加：

{
  "tools": {
    "skills": {
      "registries": {
        "clawhub": {
          "auth_token": "your-clawhub-token"
        }
      }
    }
  }
}

詳細は ツール設定 - Skill を参照してください。

🔗 MCP（Model Context Protocol）

PicoClaw は MCP をネイティブサポートしています — 任意の MCP サーバーに接続して、外部ツールやデータソースで Agent の機能を拡張できます。

{
  "tools": {
    "mcp": {
      "enabled": true,
      "servers": {
        "filesystem": {
          "enabled": true,
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
        }
      }
    }
  }
}

MCP の完全な設定（stdio、SSE、HTTP トランスポート、Tool Discovery）は ツール設定 - MCP を参照してください。

エージェントソーシャルネットワークに参加

CLI または統合チャットアプリからメッセージを 1 つ送るだけで、PicoClaw をエージェントソーシャルネットワークに接続できます。

https://clawdchat.ai/skill.md を読み、指示に従って ClawdChat.ai に参加してください

🖥️ CLI リファレンス

コマンド	説明
picoclaw onboard	設定＆ワークスペースの初期化
picoclaw auth weixin	WeChat アカウントを QR で接続
picoclaw agent -m "..."	Agent とチャット
picoclaw agent	インタラクティブチャットモード
picoclaw gateway	Gateway を起動
picoclaw status	ステータスを表示
picoclaw version	バージョン情報を表示
picoclaw model	デフォルトモデルの表示・切替
picoclaw cron list	スケジュールジョブ一覧
picoclaw cron add ...	スケジュールジョブを追加
picoclaw cron disable	スケジュールジョブを無効化
picoclaw cron remove	スケジュールジョブを削除
picoclaw skills list	インストール済み Skill 一覧
picoclaw skills install	Skill をインストール
picoclaw migrate	旧バージョンからデータを移行
picoclaw auth login	Provider への認証

⏰ スケジュールタスク / リマインダー

PicoClaw は cron ツールによるスケジュールリマインダーと定期タスクをサポートしています：

• ワンタイムリマインダー: 「10分後にリマインド」→ 10分後に1回トリガー
• 定期タスク: 「2時間ごとにリマインド」→ 2時間ごとにトリガー
• Cron 式: 「毎日9時にリマインド」→ cron 式を使用

📚 ドキュメント

この README を超えた詳細なガイドについては：

トピック	説明
Docker & クイックスタート	Docker Compose セットアップ、Launcher/Agent モード
チャットアプリ	17 以上の Channel セットアップガイド
設定	環境変数、ワークスペース構成、セキュリティサンドボックス
Provider とモデル	30 以上の LLM Provider、モデルルーティング、model_list 設定
Spawn & 非同期タスク	クイックタスク、spawn による長時間タスク、非同期サブエージェントオーケストレーション
Hook システム	イベント駆動 Hook：オブザーバー、インターセプター、承認 Hook
Steering	実行中の Agent ループにメッセージを注入
SubTurn	サブ Agent の調整、並行制御、ライフサイクル
トラブルシューティング	よくある問題と解決策
ツール設定	ツールごとの有効/無効、exec ポリシー、MCP、Skill
ハードウェア互換性	テスト済みボード、最小要件

🤝 コントリビュート＆ロードマップ

PR 歓迎！コードベースは意図的に小さく読みやすくしています。

コミュニティロードマップとCONTRIBUTING.mdをご覧ください。

開発者グループ構築中、最初の PR がマージされたら参加できます！

ユーザーグループ:

Discord: https://discord.gg/V4sAZ9XWpN

WeChat: