picoclaw/README.ja.md

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

$10 ハードウェア · 10MB RAM · 1秒起動 · 皮皮虾，我们走！

日本語 | English

---

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

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

📢 ニュース

2026-02-09 🎉 PicoClaw リリース！$10 ハードウェアで 10MB 未満の RAM で動く AI エージェントを 1 日で構築。🦐 皮皮虾，我们走！

✨ 特徴

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

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

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

🌍 真のポータビリティ: RISC-V、ARM、x86 対応の単一バイナリ。ワンクリックで Go！

🤖 AI ブートストラップ: 自律的な Go ネイティブ実装 — コアの 95% が AI 生成、人間によるレビュー付き。

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

🦾 デモンストレーション

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

🧩 フルスタックエンジニア	🗂️ ログ＆計画管理	🔎 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

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

📦 インストール

コンパイル済みバイナリでインストール

リリースページ からお使いのプラットフォーム用のファームウェアをダウンロードしてください。

ソースからインストール（最新機能、開発向け推奨）

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

cd picoclaw
make deps

# ビルド（インストール不要）
make build

# 複数プラットフォーム向けビルド
make build-all

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

🐳 Docker Compose

Docker Compose を使えば、ローカルにインストールせずに PicoClaw を実行できます。

クイックスタート（Discord Bot）

# 1. リポジトリをクローン
git clone https://github.com/Sunwood-AI-OSS-Hub/picoclaw.git
cd picoclaw

# 2. API キーを設定
cp .env.example .env
vim .env                    # DISCORD_BOT_TOKEN, OPENROUTER_API_KEY などを設定
vim config/config.json      # プロバイダーの API キーを設定

# 3. ビルドと起動
docker compose -f docker-compose.discord.yml up -d

# 4. ログ確認
docker compose -f docker-compose.discord.yml logs -f picoclaw

# 5. 停止
docker compose -f docker-compose.discord.yml down

Agent モード（ワンショット）

# 質問を投げる
docker compose run --rm picoclaw-agent -m "What is 2+2?"

# インタラクティブモード
docker compose run --rm picoclaw-agent

リビルド

docker compose -f docker-compose.discord.yml build --no-cache
docker compose -f docker-compose.discord.yml up -d

🚀 クイックスタート（ネイティブ）

Tip

~/.picoclaw/config.json に API キーを設定してください。 API キーの取得先: OpenRouter (LLM) · Zhipu (LLM) Web 検索は 任意 です - 無料の Brave Search API (月 2000 クエリ無料)

1. 初期化

picoclaw onboard

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

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "glm-4.7",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "xxx",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  },
  "tools": {
    "web": {
      "search": {
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      }
    }
  }
}

3. API キーの取得

• LLM プロバイダー: OpenRouter · Zhipu · Anthropic · OpenAI · Gemini
• Web 検索（任意）: Brave Search - 無料枠あり（月 2000 リクエスト）

注意: 完全な設定テンプレートは config.example.json を参照してください。

3. チャット

picoclaw agent -m "What is 2+2?"

これだけです！2 分で AI アシスタントが動きます。

---

💬 チャットアプリ

Telegram で PicoClaw と会話できます

チャネル	セットアップ
Telegram	簡単（トークンのみ）
Discord	簡単（Bot トークン + Intents）

Telegram（推奨）

1. Bot を作成

• Telegram を開き、@BotFather を検索
• /newbot を送信、プロンプトに従う
• トークンをコピー

2. 設定

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["YOUR_USER_ID"]
    }
  }
}

ユーザー ID は Telegram の @userinfobot から取得できます。

3. 起動

picoclaw gateway

Discord

1. Bot を作成

• https://discord.com/developers/applications にアクセス
• アプリケーションを作成 → Bot → Add Bot
• Bot トークンをコピー

2. Intents を有効化

• Bot の設定画面で MESSAGE CONTENT INTENT を有効化
• （任意）SERVER MEMBERS INTENT も有効化

3. ユーザー ID を取得

• Discord 設定 → 詳細設定 → 開発者モード を有効化
• 自分のアバターを右クリック → ユーザーIDをコピー

4. 設定

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["YOUR_USER_ID"]
    }
  }
}

5. Bot を招待

• OAuth2 → URL Generator
• Scopes: bot
• Bot Permissions: Send Messages, Read Message History
• 生成された招待 URL を開き、サーバーに Bot を追加

6. 起動

picoclaw gateway

⚙️ 設定

設定ファイル: ~/.picoclaw/config.json

プロバイダー

Note

Groq は Whisper 経由の無料音声文字起こしを提供します。設定すると、Telegram の音声メッセージが自動的に文字起こしされます。

プロバイダー	用途	API キー取得先
gemini	LLM (Gemini 直接)	aistudio.google.com
zhipu	LLM (Zhipu 直接)	bigmodel.cn
openrouter(テスト中)	LLM（推奨、全モデルアクセス）	openrouter.ai
anthropic(テスト中)	LLM (Claude 直接)	console.anthropic.com
openai(テスト中)	LLM (GPT 直接)	platform.openai.com
deepseek(テスト中)	LLM (DeepSeek 直接)	platform.deepseek.com
groq	LLM + 音声文字起こし (Whisper)	console.groq.com

Zhipu

1. API キーとベース URL を取得

• API キー を取得

2. 設定

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "glm-4.7",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "zhipu": {
      "api_key": "Your API Key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    },
  },
}

3. 実行

picoclaw agent -m "Hello"

完全な設定例

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-5"
    }
  },
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-xxx"
    },
    "groq": {
      "apiKey": "gsk_xxx"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456:ABC...",
      "allowFrom": ["123456789"]
    },
    "discord": {
      "enabled": true,
      "token": "",
      "allow_from": [""]
    },
    "whatsapp": {
      "enabled": false
    },
    "feishu": {
      "enabled": false,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "encryptKey": "",
      "verificationToken": "",
      "allowFrom": []
    }
  },
  "tools": {
    "web": {
      "search": {
        "apiKey": "BSA..."
      }
    }
  }
}

CLI リファレンス

コマンド	説明
picoclaw onboard	設定＆ワークスペースの初期化
picoclaw agent -m "..."	エージェントとチャット
picoclaw agent	インタラクティブチャットモード
picoclaw gateway	ゲートウェイを起動
picoclaw status	ステータスを表示

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

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

Discord: https://discord.gg/V4sAZ9XWpN

🐛 トラブルシューティング

Web 検索で「API 配置问题」と表示される

検索 API キーをまだ設定していない場合、これは正常です。PicoClaw は手動検索用の便利なリンクを提供します。

Web 検索を有効にするには：

1. https://brave.com/search/api で無料の API キーを取得（月 2000 クエリ無料）
2. ~/.picoclaw/config.json に追加：

   {
     "tools": {
       "web": {
         "search": {
           "api_key": "YOUR_BRAVE_API_KEY",
           "max_results": 5
         }
       }
     }
   }
   

コンテンツフィルタリングエラーが出る

一部のプロバイダー（Zhipu など）にはコンテンツフィルタリングがあります。クエリを言い換えるか、別のモデルを使用してください。

Telegram Bot で「Conflict: terminated by other getUpdates」と表示される

別のインスタンスが実行中の場合に発生します。picoclaw gateway が 1 つだけ実行されていることを確認してください。

---

📝 API キー比較

サービス	無料枠	ユースケース
OpenRouter	月 200K トークン	複数モデル（Claude, GPT-4 など）
Zhipu	月 200K トークン	中国ユーザー向け最適
Brave Search	月 2000 クエリ	Web 検索機能
Groq	無料枠あり	高速推論（Llama, Mixtral）