docs/project/README.ja.md
<a href="https://picoclaw.io"></a>
<a href="https://docs.picoclaw.io/"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"></a>
<a href="https://x.com/SipeedIO"></a>
<a href="../../assets/wechat.png"></a>
<a href="https://discord.gg/V4sAZ9XWpN"></a>
中文 | 日本語 | 한국어 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | Malay | English
</div>PicoClaw は Sipeed が立ち上げた独立したオープンソースプロジェクトです。完全に Go 言語で一から書かれており、OpenClaw、NanoBot、その他のプロジェクトのフォークではありません。
PicoClaw は NanoBot にインスパイアされた超軽量パーソナル AI アシスタントです。Go でゼロからリビルドされ、「セルフブートストラッピング」プロセスで構築されました — AI Agent 自身がアーキテクチャの移行とコード最適化を推進しました。
$10 のハードウェアで 10MB 未満の RAM で動作 — OpenClaw より 99% 少ないメモリ、Mac mini より 98% 安い!
<table align="center"> <tr align="center"> <td align="center" valign="top"> <p align="center"> </p>
</td>
<td align="center" valign="top">
<p align="center">
</p>
</td>
[!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 サポート。
<details> <summary>過去のニュース...</summary>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!
</details>🪶 超軽量: コアメモリフットプリント 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 シングルコアベンチマークに基づいています(下表参照)。
<div align="center">| OpenClaw | NanoBot | PicoClaw | |
|---|---|---|---|
| 言語 | TypeScript | Python | Go |
| RAM | >1GB | >100MB | < 10MB* |
| 起動時間</br>(0.8GHz コア) | >500秒 | >30秒 | <1秒 |
| コスト | Mac Mini $599 | 大半の Linux ボード ~$50 | あらゆる Linux ボード</br>最安 $10 |
<p align="center"> </p>ハードウェア互換性リスト — テスト済みの全ボード一覧($5 RISC-V から Raspberry Pi、Android スマートフォンまで)。お使いのボードが未掲載?PR を送ってください!
PicoClaw はほぼすべての Linux デバイスにデプロイできます!
🌟 もっと多くのデプロイ事例が待っています!
picoclaw.io にアクセス — 公式サイトがプラットフォームを自動検出し、ワンクリックでダウンロードできます。アーキテクチャを手動で選ぶ必要はありません。
または、GitHub Releases ページからプラットフォームに合ったバイナリをダウンロードしてください。
前提条件:
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 はブラウザベースの設定・チャットインターフェースを提供します。コマンドラインの知識不要で、最も簡単に始められる方法です。
オプション 1: ダブルクリック(デスクトップ)
picoclaw.io からダウンロード後、picoclaw-launcher(Windows では picoclaw-launcher.exe)をダブルクリックしてください。ブラウザが自動的に http://localhost:18800 を開きます。
オプション 2: コマンドライン
picoclaw-launcher
# ブラウザで http://localhost:18800 を開く
<p align="center"> </p>[!TIP] リモートアクセス / Docker / VM: すべてのインターフェースでリッスンするには
-publicフラグを追加してください:bashpicoclaw-launcher -public
始め方:
WebUI を開いたら:1) Provider を設定(LLM API キーを追加)→ 2) Channel を設定(例:Telegram)→ 3) Gateway を起動 → 4) チャット!
WebUI の詳細なドキュメントは docs.picoclaw.io を参照してください。
<details> <summary><b>Docker(代替手段)</b></summary># 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
picoclaw-launcher はインターネットからダウンロードされ、Mac App Store を通じて公証されていないため、macOS が初回起動時にブロックする場合があります。
ステップ 1: picoclaw-launcher をダブルクリックすると、セキュリティ警告が表示されます:
"picoclaw-launcher" は開けません — "picoclaw-launcher" がMacに害を与えたりプライバシーを侵害するマルウェアを含まないことをAppleは確認できません。
ステップ 2: システム設定 → プライバシーとセキュリティ を開き、セキュリティ セクションまでスクロールして このまま開く をクリック → ダイアログで再度 開く をクリックします。
<p align="center"> </p>この操作を一度行うと、以降の起動では警告が表示されなくなります。
</details><a id="-run-on-old-android-phones"></a>
10 年前のスマホに第二の人生を!PicoClaw でスマート AI アシスタントに変身させましょう。
オプション 1: APK インストール
プレビュー:
<table> <tr> <td></td> <td></td> <td></td> <td></td> </tr> </table>picoclaw.io から APK をダウンロードして直接インストール。Termux 不要!
オプション 2: Termux
<details> <summary><b>Terminal Launcher(リソース制約環境向け)</b></summary># 最新リリースをダウンロード
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
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:
{
"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 とモデル を参照してください。
</details>17 以上のメッセージングプラットフォームで PicoClaw と会話できます:
| Channel | セットアップ | Protocol | ドキュメント |
|---|---|---|---|
| Telegram | 簡単(bot トークン) | Long polling | ガイド |
| Discord | 簡単(bot トークン + intents) | WebSocket | ガイド |
| 簡単(QR スキャンまたは bridge URL) | Native / Bridge | ガイド | |
| 微信 (Weixin) | 簡単(QR スキャン) | iLink API | ガイド |
| 簡単(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 の詳細なセットアップ手順は チャットアプリ設定 を参照してください。
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 は 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 を参照してください。
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 に参加してください
| コマンド | 説明 |
|---|---|
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 ツールによるスケジュールリマインダーと定期タスクをサポートしています:
この 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: