Back to Picoclaw

README.Ja

docs/project/README.ja.md

0.2.830.6 KB
Original Source
<div align="center"> <h1>PicoClaw: Go で書かれた超効率 AI アシスタント</h1> <h3>$10 ハードウェア · 10MB RAM · ms 起動 · Let's Go, PicoClaw!</h3> <p>
<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>
</p>

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

</div>

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

PicoClawNanoBot にインスパイアされた超軽量パーソナル 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>
</tr> </table>

[!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">
OpenClawNanoBotPicoClaw
言語TypeScriptPythonGo
RAM>1GB>100MB< 10MB*
起動時間</br>(0.8GHz コア)>500秒>30秒<1秒
コストMac Mini $599大半の Linux ボード ~$50あらゆる Linux ボード</br>最安 $10
</div>

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

<p align="center"> </p>

🦾 デモンストレーション

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

<table align="center"> <tr align="center"> <th><p align="center">フルスタックエンジニアモード</p></th> <th><p align="center">ログ&計画管理</p></th> <th><p align="center">Web 検索&学習</p></th> </tr> <tr> <td align="center"><p align="center"></p></td> <td align="center"><p align="center"></p></td> <td align="center"><p align="center"></p></td> </tr> <tr> <td align="center">開発 · デプロイ · スケール</td> <td align="center">スケジュール · 自動化 · メモリ</td> <td align="center">発見 · インサイト · トレンド</td> </tr> </table>

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

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+ が必要
bash
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: コマンドライン

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

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

bash
picoclaw-launcher -public
<p align="center"> </p>

始め方:

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

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

<details> <summary><b>Docker(代替手段)</b></summary>
bash
# 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 フラグを使用してください。

bash
# ログを確認
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
</details> <details> <summary><b>macOS — 初回起動時のセキュリティ警告</b></summary>

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

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

<p align="center"> </p>

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

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

<p align="center"> </p>

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

</details>

<a id="-run-on-old-android-phones"></a>

📱 Android

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>
  1. Termux をインストール(GitHub Releases からダウンロード、または F-Droid / Google Play で検索)
  2. 以下のコマンドを実行:
bash
# 最新リリースをダウンロード
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. 初期化

bash
picoclaw onboard

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

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

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. チャット

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

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

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

🔌 Provider(LLM)

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

ProviderProtocolAPI キー備考
OpenAIopenai/必須GPT-5.4、GPT-4o、o3 など
Anthropicanthropic/必須Claude Opus 4.6、Sonnet 4.6 など
Google Geminigemini/必須Gemini 3 Flash、2.5 Pro など
OpenRouteropenrouter/必須200 以上のモデル、統合 API
Zhipu (GLM)zhipu/必須GLM-4.7、GLM-5 など
DeepSeekdeepseek/必須DeepSeek-V3、DeepSeek-R1
Volcenginevolcengine/必須Doubao、Ark モデル
Qwenqwen/必須Qwen3、Qwen-Max など
Groqgroq/必須高速推論(Llama、Mixtral)
Moonshot (Kimi)moonshot/必須Kimi モデル
Minimaxminimax/必須MiniMax モデル
Mistralmistral/必須Mistral Large、Codestral
NVIDIA NIMnvidia/必須NVIDIA ホスティングモデル
Cerebrascerebras/必須高速推論
Novita AInovita/必須各種オープンモデル
Xiaomi MiMomimo/必須MiMo モデル
Ollamaollama/不要ローカルモデル、セルフホスト
vLLMvllm/不要ローカルデプロイ、OpenAI 互換
LiteLLMlitellm/場合による100 以上の Provider のプロキシ
Azure OpenAIazure/必須エンタープライズ Azure デプロイ
GitHub Copilotgithub-copilot/OAuthデバイスコードログイン
Antigravityantigravity/OAuthGoogle Cloud AI
<details> <summary><b>ローカルデプロイ(Ollama、vLLM など)</b></summary>

Ollama:

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

vLLM:

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

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

</details>

💬 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)。サポートされる値:debuginfowarnerrorfatalPICOCLAW_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 をインストール:

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

ClawHub トークンを設定(オプション、レート制限を上げるため):

config.json に追加:

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

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

🔗 MCP(Model Context Protocol)

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

json
{
  "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 weixinWeChat アカウントを QR で接続
picoclaw agent -m "..."Agent とチャット
picoclaw agentインタラクティブチャットモード
picoclaw gatewayGateway を起動
picoclaw statusステータスを表示
picoclaw versionバージョン情報を表示
picoclaw modelデフォルトモデルの表示・切替
picoclaw cron listスケジュールジョブ一覧
picoclaw cron add ...スケジュールジョブを追加
picoclaw cron disableスケジュールジョブを無効化
picoclaw cron removeスケジュールジョブを削除
picoclaw skills listインストール済み Skill 一覧
picoclaw skills installSkill をインストール
picoclaw migrate旧バージョンからデータを移行
picoclaw auth loginProvider への認証

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

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: