Skip to content

README.ja.md

Latest commit

 

History

History
1165 lines (912 loc) · 39.6 KB

README.ja.md

File metadata and controls

1165 lines (912 loc) · 39.6 KB
PicoClaw

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

$10 ハードウェア · 10MB RAM · 1秒起動 · 行くぜ、シャコ！

Go Hardware License
Website Docs Wiki
Twitter Discord

中文 | 日本語 | Português | Tiếng Việt | Français | 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、MIPS、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 スマート監視に
picoclaw_detect_person.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 を実行できます。

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

# 2. 初回起動 — docker/data/config.json を自動生成して終了
docker compose -f docker/docker-compose.yml --profile gateway up
# コンテナが "First-run setup complete." を表示して停止します。

# 3. API キーを設定
vim docker/data/config.json   # プロバイダー API キー、Bot トークンなどを設定

# 4. 起動
docker compose -f docker/docker-compose.yml --profile gateway up -d

Tip

Docker ユーザー: デフォルトでは、Gateway は 127.0.0.1 でリッスンしており、ホストからアクセスできません。ヘルスチェックエンドポイントにアクセスしたり、ポートを公開したりする必要がある場合は、環境変数で PICOCLAW_GATEWAY_HOST=0.0.0.0 を設定するか、config.json を更新してください。

# 5. ログ確認
docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway

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

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

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

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

アップデート

docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile gateway up -d

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

Tip

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

1. 初期化

picoclaw onboard

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

{
  "model_list": [
    {
      "model_name": "ark-code-latest",
      "model": "volcengine/ark-code-latest",
      "api_key": "sk-your-api-key",
      "api_base":"https://ark.cn-beijing.volces.com/api/coding/v3"
    },
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_key": "sk-your-openai-key",
      "request_timeout": 300,
      "api_base": "https://api.openai.com/v1"
    }
  ],
  "agents": {
    "defaults": {
      "model_name": "gpt-5.4"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_TELEGRAM_BOT_TOKEN",
      "allow_from": []
    }
  },
  "tools": {
    "web": {
      "search": {
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "tavily": {
        "enabled": false,
        "api_key": "YOUR_TAVILY_API_KEY",
        "max_results": 5
      }
    },
    "cron": {
      "exec_timeout_minutes": 5
    }
  },
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

新機能: model_list 形式により、プロバイダーをコード変更なしで追加できます。詳細は モデル設定 を参照してください。 request_timeout は任意の秒単位設定です。省略または <= 0 の場合、PicoClaw はデフォルトのタイムアウト（120秒）を使用します。

3. API キーの取得

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

4. チャット

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

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

💬 チャットアプリ

Telegram、Discord、QQ、DingTalk、LINE、WeCom で PicoClaw と会話できます

チャネル セットアップ
Telegram 簡単（トークンのみ）
Discord 簡単（Bot トークン + Intents）
QQ 簡単（AppID + AppSecret）
DingTalk 普通（アプリ認証情報）
LINE 普通（認証情報 + Webhook URL）
WeCom AI Bot 普通（Token + AES キー）
Telegram（推奨）

1. Bot を作成

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

2. 設定

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["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",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

5. Bot を招待

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

6. 起動

picoclaw gateway
QQ

1. Bot を作成

2. 設定

{
  "channels": {
    "qq": {
      "enabled": true,
      "app_id": "YOUR_APP_ID",
      "app_secret": "YOUR_APP_SECRET",
      "allow_from": []
    }
  }
}

allow_from を空にすると全ユーザーを許可、QQ番号を指定してアクセス制限可能。

3. 起動

picoclaw gateway
DingTalk

1. Bot を作成

2. 設定

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "client_id": "YOUR_CLIENT_ID",
      "client_secret": "YOUR_CLIENT_SECRET",
      "allow_from": []
    }
  }
}

allow_from を空にすると全ユーザーを許可、ユーザーIDを指定してアクセス制限可能。

3. 起動

picoclaw gateway
LINE

1. LINE 公式アカウントを作成

  • LINE Developers Console にアクセス
  • プロバイダーを作成 → Messaging API チャネルを作成
  • チャネルシークレット と チャネルアクセストークン をコピー

2. 設定

{
  "channels": {
    "line": {
      "enabled": true,
      "channel_secret": "YOUR_CHANNEL_SECRET",
      "channel_access_token": "YOUR_CHANNEL_ACCESS_TOKEN",
      "webhook_path": "/webhook/line",
      "allow_from": []
    }
  }
}

3. Webhook URL を設定

LINE の Webhook には HTTPS が必要です。リバースプロキシまたはトンネルを使用してください:

# ngrok の例
ngrok http 18790

LINE Developers Console で Webhook URL を https://あなたのドメイン/webhook/line に設定し、Webhook の利用 を有効にしてください。

注意: LINE の Webhook は共有の Gateway HTTP サーバー（デフォルト: 127.0.0.1:18790）で提供されます。ホストからアクセスする場合は Gateway のポートを公開するか、リバースプロキシを設定してください。

4. 起動

picoclaw gateway

グループチャットでは @メンション時のみ応答します。返信は元メッセージを引用する形式です。

Docker Compose: Gateway HTTP サーバーは共有の 127.0.0.1:18790 で Webhook を提供します。ホストからアクセスするには picoclaw-gateway サービスに ports: ["18790:18790"] を追加してください。

WeCom (企業微信)

PicoClaw は3種類の WeCom 統合をサポートしています：

オプション1: WeCom Bot (ロボット) - 簡単な設定、グループチャット対応 オプション2: WeCom App (カスタムアプリ) - より多機能、アクティブメッセージング対応、プライベートチャットのみ オプション3: WeCom AI Bot (スマートボット) - 公式 AI Bot、ストリーミング返信、グループ・プライベート両対応

詳細な設定手順は WeCom AI Bot Configuration Guide を参照してください。

クイックセットアップ - WeCom Bot:

1. ボットを作成

  • WeCom 管理コンソール → グループチャット → グループボットを追加
  • Webhook URL をコピー（形式: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx）

2. 設定

{
  "channels": {
    "wecom": {
      "enabled": true,
      "token": "YOUR_TOKEN",
      "encoding_aes_key": "YOUR_ENCODING_AES_KEY",
      "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY",
      "webhook_path": "/webhook/wecom",
      "allow_from": []
    }
  }
}

> **注意**: WeCom Bot の Webhook 受信は共有の Gateway HTTP サーバー（デフォルト: `127.0.0.1:18790`）で提供されます。ホストからアクセスする場合は Gateway のポートを公開するか、HTTPS 用のリバースプロキシを設定してください。

クイックセットアップ - WeCom App:

1. アプリを作成

  • WeCom 管理コンソール → アプリ管理 → アプリを作成
  • AgentId と Secret をコピー
  • "マイ会社" ページで CorpID をコピー

2. メッセージ受信を設定

  • アプリ詳細で "メッセージを受信" → "APIを設定" をクリック
  • URL を http://your-server:18790/webhook/wecom-app に設定
  • Token と EncodingAESKey を生成

3. 設定

{
  "channels": {
    "wecom_app": {
      "enabled": true,
      "corp_id": "wwxxxxxxxxxxxxxxxx",
      "corp_secret": "YOUR_CORP_SECRET",
      "agent_id": 1000002,
      "token": "YOUR_TOKEN",
      "encoding_aes_key": "YOUR_ENCODING_AES_KEY",
      "webhook_path": "/webhook/wecom-app",
      "allow_from": []
    }
  }
}

4. 起動

picoclaw gateway

注意: WeCom App の Webhook コールバックは共有の Gateway HTTP サーバー（デフォルト: 127.0.0.1:18790）で提供されます。ホストからアクセスする場合は HTTPS 用のリバースプロキシを設定してください。

クイックセットアップ - WeCom AI Bot:

1. AI Bot を作成

  • WeCom 管理コンソール → アプリ管理 → AI Bot
  • コールバック URL を設定: http://your-server:18791/webhook/wecom-aibot
  • Token をコピーし、EncodingAESKey を生成

2. 設定

{
  "channels": {
    "wecom_aibot": {
      "enabled": true,
      "token": "YOUR_TOKEN",
      "encoding_aes_key": "YOUR_43_CHAR_ENCODING_AES_KEY",
      "webhook_path": "/webhook/wecom-aibot",
      "allow_from": [],
      "welcome_message": "こんにちは！何かお手伝いできますか？"
    }
  }
}

3. 起動

picoclaw gateway

注意: WeCom AI Bot はストリーミングプルプロトコルを使用 — 返信タイムアウトの心配なし。長時間タスク（>30秒）は自動的に response_url によるプッシュ配信に切り替わります。

⚙️ 設定

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

環境変数

環境変数を使用してデフォルトのパスを上書きできます。これは、ポータブルインストール、コンテナ化されたデプロイメント、または picoclaw をシステムサービスとして実行する場合に便利です。これらの変数は独立しており、異なるパスを制御します。

変数 説明 デフォルトパス
PICOCLAW_CONFIG 設定ファイルへのパスを上書きします。これにより、picoclaw は他のすべての場所を無視して、指定された config.json をロードします。 ~/.picoclaw/config.json
PICOCLAW_HOME picoclaw データのルートディレクトリを上書きします。これにより、workspace やその他のデータディレクトリのデフォルトの場所が変更されます。 ~/.picoclaw

例：

# 特定の設定ファイルを使用して picoclaw を実行する
# ワークスペースのパスはその設定ファイル内から読み込まれます
PICOCLAW_CONFIG=/etc/picoclaw/production.json picoclaw gateway

# すべてのデータを /opt/picoclaw に保存して picoclaw を実行する
# 設定はデフォルトの ~/.picoclaw/config.json からロードされます
# ワークスペースは /opt/picoclaw/workspace に作成されます
PICOCLAW_HOME=/opt/picoclaw picoclaw agent

# 両方を使用して完全にカスタマイズされたセットアップを行う
PICOCLAW_HOME=/srv/picoclaw PICOCLAW_CONFIG=/srv/picoclaw/main.json picoclaw gateway

ワークスペース構成

PicoClaw は設定されたワークスペース（デフォルト: ~/.picoclaw/workspace）にデータを保存します：

~/.picoclaw/workspace/
├── sessions/          # 会話セッションと履歴
├── memory/            # 長期メモリ（MEMORY.md）
├── state/             # 永続状態（最後のチャネルなど）
├── cron/              # スケジュールジョブデータベース
├── skills/            # カスタムスキル
├── AGENTS.md          # エージェントの行動ガイド
├── HEARTBEAT.md       # 定期タスクプロンプト（30分ごとに確認）
├── IDENTITY.md        # エージェントのアイデンティティ
├── SOUL.md            # エージェントのソウル
└── USER.md            # ユーザー設定

🔒 セキュリティサンドボックス

PicoClaw はデフォルトでサンドボックス環境で実行されます。エージェントは設定されたワークスペース内のファイルにのみアクセスし、コマンドを実行できます。

デフォルト設定

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "restrict_to_workspace": true
    }
  }
}
オプション デフォルト 説明
workspace ~/.picoclaw/workspace エージェントの作業ディレクトリ
restrict_to_workspace true ファイル/コマンドアクセスをワークスペースに制限

保護対象ツール

restrict_to_workspace: true の場合、以下のツールがサンドボックス化されます：

ツール 機能 制限
read_file ファイル読み込み ワークスペース内のファイルのみ
write_file ファイル書き込み ワークスペース内のファイルのみ
list_dir ディレクトリ一覧 ワークスペース内のディレクトリのみ
edit_file ファイル編集 ワークスペース内のファイルのみ
append_file ファイル追記 ワークスペース内のファイルのみ
exec コマンド実行 コマンドパスはワークスペース内である必要あり

exec ツールの追加保護

restrict_to_workspace: false でも、exec ツールは以下の危険なコマンドをブロックします：

  • rm -rf, del /f, rmdir /s — 一括削除
  • format, mkfs, diskpart — ディスクフォーマット
  • dd if= — ディスクイメージング
  • /dev/sd[a-z] への書き込み — 直接ディスク書き込み
  • shutdown, reboot, poweroff — システムシャットダウン
  • フォークボム :(){ :|:& };:

エラー例

[ERROR] tool: Tool execution failed
{tool=exec, error=Command blocked by safety guard (path outside working dir)}

[ERROR] tool: Tool execution failed
{tool=exec, error=Command blocked by safety guard (dangerous pattern detected)}

制限の無効化（セキュリティリスク）

エージェントにワークスペース外のパスへのアクセスが必要な場合：

方法1: 設定ファイル

{
  "agents": {
    "defaults": {
      "restrict_to_workspace": false
    }
  }
}

方法2: 環境変数

export PICOCLAW_AGENTS_DEFAULTS_RESTRICT_TO_WORKSPACE=false

⚠️ 警告: この制限を無効にすると、エージェントはシステム上の任意のパスにアクセスできるようになります。制御された環境でのみ慎重に使用してください。

セキュリティ境界の一貫性

restrict_to_workspace 設定は、すべての実行パスで一貫して適用されます：

実行パス セキュリティ境界
メインエージェント restrict_to_workspace ✅
サブエージェント / Spawn 同じ制限を継承 ✅
ハートビートタスク 同じ制限を継承 ✅

すべてのパスで同じワークスペース制限が適用されます — サブエージェントやスケジュールタスクを通じてセキュリティ境界をバイパスする方法はありません。

ハートビート（定期タスク）

PicoClaw は自動的に定期タスクを実行できます。ワークスペースに HEARTBEAT.md ファイルを作成します：

# 定期タスク

- 重要なメールをチェック
- 今後の予定を確認
- 天気予報をチェック

エージェントは30分ごと（設定可能）にこのファイルを読み込み、利用可能なツールを使ってタスクを実行します。

spawn で非同期タスク実行

時間のかかるタスク（Web検索、API呼び出し）には spawn ツールを使ってサブエージェントを作成します：

# 定期タスク

## クイックタスク（直接応答）
- 現在時刻を報告

## 長時間タスク（spawn で非同期）
- AIニュースを検索して要約
- メールをチェックして重要なメッセージを報告

主な特徴:

機能 説明
spawn 非同期サブエージェントを作成、ハートビートをブロックしない
独立コンテキスト サブエージェントは独自のコンテキストを持ち、セッション履歴なし
message ツール サブエージェントは message ツールで直接ユーザーと通信
非ブロッキング spawn 後、ハートビートは次のタスクへ継続

サブエージェントの通信方法

ハートビート発動
    ↓
エージェントが HEARTBEAT.md を読む
    ↓
長いタスク: spawn サブエージェント
    ↓                           ↓
次のタスクへ継続          サブエージェントが独立して動作
    ↓                           ↓
全タスク完了              message ツールを使用
    ↓                           ↓
HEARTBEAT_OK 応答         ユーザーが直接結果を受け取る

サブエージェントはツール（message、web_search など）にアクセスでき、メインエージェントを経由せずにユーザーと通信できます。

設定:

{
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}
オプション デフォルト 説明
enabled true ハートビートの有効/無効
interval 30 チェック間隔（分）、最小5分

環境変数:

  • PICOCLAW_HEARTBEAT_ENABLED=false で無効化
  • PICOCLAW_HEARTBEAT_INTERVAL=60 で間隔変更

プロバイダー

Note

Groq は Whisper による無料の音声文字起こしを提供しています。設定すると、あらゆるチャンネルからの音声メッセージがエージェントレベルで自動的に文字起こしされます。

プロバイダー 用途 API キー取得先
gemini LLM（Gemini 直接） aistudio.google.com
zhipu LLM（Zhipu 直接） bigmodel.cn
volcengine LLM(Volcengine 直接) volcengine.com
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
cerebras LLM（Cerebras 直接） cerebras.ai

基本設定

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

    cp config.example.json config/config.json

  2. 設定の編集:

    {
  "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": {
      "api_key": "sk-or-v1-xxx"
    },
    "groq": {
      "api_key": "gsk_xxx"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456:ABC...",
      "allow_from": ["123456789"]
    },
    "discord": {
      "enabled": true,
      "token": "",
      "allow_from": [""]
    },
    "whatsapp": {
      "enabled": false
    },
    "feishu": {
      "enabled": false,
      "app_id": "cli_xxx",
      "app_secret": "xxx",
      "encrypt_key": "",
      "verification_token": "",
      "allow_from": []
    }
  },
  "tools": {
    "web": {
      "search": {
        "api_key": "BSA..."
      }
    },
    "cron": {
      "exec_timeout_minutes": 5
    }
  },
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

モデル設定 (model_list)

新機能！ PicoClaw は現在 モデル中心 の設定アプローチを採用しています。ベンダー/モデル 形式（例: zhipu/glm-4.7）を指定するだけで、新しいプロバイダーを追加できます—コードの変更は一切不要！

この設計は、柔軟なプロバイダー選択による マルチエージェントサポート も可能にします：

  • 異なるエージェント、異なるプロバイダー : 各エージェントは独自の LLM プロバイダーを使用可能
  • フォールバックモデル : 耐障性のため、プライマリモデルとフォールバックモデルを設定可能
  • ロードバランシング : 複数のエンドポイントにリクエストを分散
  • 集中設定管理 : すべてのプロバイダーを一箇所で管理

📋 サポートされているすべてのベンダー

ベンダー model プレフィックス デフォルト API Base プロトコル API キー
OpenAI openai/ https://api.openai.com/v1 OpenAI キーを取得
Anthropic anthropic/ https://api.anthropic.com/v1 Anthropic キーを取得
Zhipu AI (GLM) zhipu/ https://open.bigmodel.cn/api/paas/v4 OpenAI キーを取得
DeepSeek deepseek/ https://api.deepseek.com/v1 OpenAI キーを取得
Google Gemini gemini/ https://generativelanguage.googleapis.com/v1beta OpenAI キーを取得
Groq groq/ https://api.groq.com/openai/v1 OpenAI キーを取得
Moonshot moonshot/ https://api.moonshot.cn/v1 OpenAI キーを取得
Qwen (Alibaba) qwen/ https://dashscope.aliyuncs.com/compatible-mode/v1 OpenAI キーを取得
NVIDIA nvidia/ https://integrate.api.nvidia.com/v1 OpenAI キーを取得
Ollama ollama/ http://localhost:11434/v1 OpenAI ローカル（キー不要）
OpenRouter openrouter/ https://openrouter.ai/api/v1 OpenAI キーを取得
VLLM vllm/ http://localhost:8000/v1 OpenAI ローカル
Cerebras cerebras/ https://api.cerebras.ai/v1 OpenAI キーを取得
VolcEngine (Doubao) volcengine/ https://ark.cn-beijing.volces.com/api/v3 OpenAI キーを取得
ShengsuanYun shengsuanyun/ https://router.shengsuanyun.com/api/v1 OpenAI -
BytePlus byteplus/ https://ark.ap-southeast.bytepluses.com/api/v3 OpenAI キーを取得
LongCat longcat/ https://api.longcat.chat/openai OpenAI キーを取得
ModelScope (魔搭) modelscope/ https://api-inference.modelscope.cn/v1 OpenAI トークンを取得
Azure OpenAI azure/ https://{resource}.openai.azure.com Azure キーを取得
Antigravity antigravity/ Google Cloud カスタム OAuthのみ
GitHub Copilot github-copilot/ localhost:4321 gRPC -

基本設定

{
  "model_list": [
    {
      "model_name": "ark-code-latest",
      "model": "volcengine/ark-code-latest",
      "api_key": "sk-your-api-key"
    },
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_key": "sk-your-openai-key"
    },
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "sk-ant-your-key"
    },
    {
      "model_name": "glm-4.7",
      "model": "zhipu/glm-4.7",
      "api_key": "your-zhipu-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "gpt-5.4"
    }
  }
}

ベンダー別の例

OpenAI

{
  "model_name": "gpt-5.4",
  "model": "openai/gpt-5.4",
  "api_key": "sk-..."
}

VolcEngine (Doubao)

{
  "model_name": "ark-code-latest",
  "model": "volcengine/ark-code-latest",
  "api_key": "sk-..."
}

Zhipu AI (GLM)

{
  "model_name": "glm-4.7",
  "model": "zhipu/glm-4.7",
  "api_key": "your-key"
}

Anthropic (OAuth使用)

{
  "model_name": "claude-sonnet-4.6",
  "model": "anthropic/claude-sonnet-4.6",
  "auth_method": "oauth"
}

OAuth認証を設定するには、picoclaw auth login --provider anthropic を実行してください。

カスタムプロキシ/API

{
  "model_name": "my-custom-model",
  "model": "openai/custom-model",
  "api_base": "https://my-proxy.com/v1",
  "api_key": "sk-...",
  "request_timeout": 300
}

ロードバランシング

同じモデル名で複数のエンドポイントを設定すると、PicoClaw が自動的にラウンドロビンで分散します：

{
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_base": "https://api1.example.com/v1",
      "api_key": "sk-key1"
    },
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_base": "https://api2.example.com/v1",
      "api_key": "sk-key2"
    }
  ]
}

従来の providers 設定からの移行

古い providers 設定は非推奨ですが、後方互換性のためにサポートされています。

旧設定（非推奨）:

{
  "providers": {
    "zhipu": {
      "api_key": "your-key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  },
  "agents": {
    "defaults": {
      "provider": "zhipu",
      "model": "glm-4.7"
    }
  }
}

新設定（推奨）:

{
  "model_list": [
    {
      "model_name": "glm-4.7",
      "model": "zhipu/glm-4.7",
      "api_key": "your-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "glm-4.7"
    }
  }
}

詳細な移行ガイドは、docs/migration/model-list-migration.md を参照してください。

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://tavily.com (月 1000 クエリ無料) または https://brave.com/search/api で無料の API キーを取得（月 2000 クエリ無料）
  2. ~/.picoclaw/config.json に追加： 
    {
  "tools": {
    "web": {
      "brave": {
        "enabled": true,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  }
}

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

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

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

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

📝 API キー比較

サービス 無料枠 ユースケース
OpenRouter 月 200K トークン 複数モデル（Claude, GPT-4 など）
Volcengine CodingPlan 9.9元/初月 中国ユーザーに最適、複数のSOTAモデル（Doubao、DeepSeek等）
Zhipu 月 200K トークン 中国ユーザーに適している
Qwen 無料枠あり 通義千問 (Qwen)
Brave Search 月 2000 クエリ Web 検索機能
Tavily 月 1000 クエリ AI エージェント検索最適化
Groq 無料枠あり 高速推論（Llama, Mixtral）
Cerebras 無料枠あり 高速推論（Llama, Qwen など）
ModelScope 1 日 2000 リクエスト 無料推論（Qwen, GLM, DeepSeek など）
PicoClaw Meme