renato97/picoclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
759f4cfe254bb58de6abd12622289bab475fd154
picoclaw/README.ja.md
Sunwood-ai-labs 759f4cfe25 refactor(docker): consolidate compose files and move config to config/ directory 
- Deleted docker-compose.discord.yml and merged into docker-compose.yml
- Moved config.example.json to config/
- Updated volume mounts to use ./config/config.json
- Updated verify script permissions (implied if valid)
2026-02-13 00:25:08 +08:00

13 KiB
Raw Blame History

PicoClaw

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

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

Go Hardware License

日本語 | 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$
PicoClaw

🦾 デモンストレーション

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

🧩 フルスタックエンジニア

🗂️ ログ＆計画管理

🔎 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 config.example.json config/config.json
vim config/config.json      # DISCORD_BOT_TOKEN, プロバイダーの API キーを設定

# 3. ビルドと起動
docker compose --profile gateway up -d

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

# 5. 停止
docker compose --profile gateway down

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

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

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

リビルド

docker compose --profile gateway build --no-cache
docker compose --profile gateway 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 キーの取得

注意: 完全な設定テンプレートは 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 を作成

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

設定 (Configuration)

PicoClaw は設定に config.json を使用します。

  1. 設定ファイルの作成:

    サンプル設定ファイルをコピーします:

    cp config.example.json config/config.json

  2. 設定の編集:

    config/config.json を開き、APIキーや設定を記述します。

    {
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-..."
    }
  },
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_DISCORD_BOT_TOKEN"
    }
  }
}

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

PicoClaw

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

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）
Reference in New Issue View Git Blame Copy Permalink