システム要件
PicoClawのハードウェア要件は非常に低く設定されています：
- OS：Linux / macOS / Windows (WSL2)
- アーキテクチャ：x86_64 / ARM64 / RISC-V
- 最小メモリ：64MB（512MB以上を推奨）
- 依存関係：LLM API Key（設定しない場合、AI対話機能は利用できません）
対応プラットフォーム：macOS、Linux、Windows (WSL2)、Raspberry Pi、Docker
ステップ1：リポジトリのクローン
ターミナルを開き、以下のコマンドを実行します：
git clone https://github.com/sipeed/picoclaw.gitクローン完了後、プロジェクトディレクトリに移動します：
cd picoclawステップ2：初期設定
onboardコマンドを実行して初期化を行います：
picoclaw onboard画面の指示に従って設定を完了してください：
- LLM API Key：利用するLLMプロバイダーのAPI Keyを入力
- モデル設定：デフォルトで使用するAIモデルを選択
- メッセージプラットフォームのToken（任意）：Telegram、Discord、QQ、DingTalk（釘釘）との連携が必要な場合、それぞれのBot Tokenを入力
設定ファイルはローカルに保存され、すべてのデータはユーザーのデバイス内に留まります。クラウドへアップロードされることはありません。
ステップ3：対話を開始する
設定完了後、AIとの対話を開始できます。
インタラクティブモード
picoclaw agent対話型インターフェースを起動し、メッセージを連続して送信・受信できます。
単発クエリモード
picoclaw agent -m "こんにちは、自己紹介をお願いします"メッセージを1回送信して回答を得た後に終了します。スクリプト内での利用に適しています。
ゲートウェイサービスの起動
TelegramやQQなどのメッセージプラットフォームで使用する場合：
picoclaw gateway起動後、各プラットフォームのBotを通じてPicoClawと対話可能です。
マルチプラットフォームBotの設定
Telegram Bot
Telegramで @BotFather を検索し、/newbot を送信してBotを作成しTokenを取得します。そのTokenを設定ファイルに入力し、picoclaw gateway を起動してください。
Discord Bot
Discord Developer Portalでアプリケーションを作成し、Bot設定からTokenを取得します。Botをサーバーに招待し、Tokenを設定ファイルに入力してください。
QQ Bot
QQオープンプラットフォームのドキュメントを参照してBotを登録し、AppIDとTokenを取得して設定ファイルに入力してください。
DingTalk（釘釘）Bot
DingTalkオープンプラットフォームでロボットアプリを作成し、Webhook URLとシークレットを取得して設定ファイルに入力してください。
Dockerでのデプロイ
PicoClawはDockerデプロイに対応しており、サーバーやデスクトップ環境がない場合に最適です：
docker pull ghcr.io/sipeed/picoclaw:latestdocker run -d --name picoclaw -v /path/to/config:/config -e PICOCLAW_API_KEY=your_key ghcr.io/sipeed/picoclaw:latest定期タスクの設定
PicoClawはcronを内蔵しており、設定ファイルから管理可能です。
一回限りのリマインダー
tasks: - type: reminder time: "1h" message: "会議リマインダー：チーム週次ミーティング"定期タスク
tasks: - type: cron schedule: "0 8 * * *" message: "本日の業務まとめを生成"よくある質問
PicoClawはインターネット接続が必要ですか？
PicoClaw自体はオフラインで動作可能ですが、LLM APIの呼び出しやメッセージプラットフォームとの連携にはインターネット接続が必要です。
どのLLMプロバイダーに対応していますか？
OpenRouter、智譜AI、Anthropic、OpenAI、DeepSeek、Groqなどに対応しており、設定ファイルで自由に切り替え可能です。
PicoClawをアップデートするには？
プロジェクトディレクトリで git pull を実行して最新のコードを取得し、再コンパイルしてください。
データはどこに保存されますか？
すべての対話履歴と設定データはローカルのファイルシステムに保存され、ユーザーが完全に管理します。
Dockerイメージのサイズはどのくらいですか？
PicoClawのDockerイメージは約15MBで、競合製品の350MB以上と比較して非常に軽量です。
Raspberry Piで動作しますか？
はい、ARM64アーキテクチャをサポートしているため、Raspberry Pi 4（4GB以上）で快適に動作します。
複数のBotを同時に使用するには？
設定ファイルに各プラットフォームのTokenと設定項目をそれぞれ追加し、picoclaw gateway を起動すれば、すべてのBotが同時に有効化されます。