lzh/picoclaw

Fork 0

mirror of https://github.com/sipeed/picoclaw.git synced 2026-06-12 18:08:54 +00:00

Files

T

Administrator f7f27e237a merge: resolve conflicts between refactor/agent and main

2026-03-22 19:21:58 +08:00

46 KiB

Raw Blame History

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

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

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

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

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

Caution

🚨 セキュリティ＆公式チャンネル

暗号通貨なし: PicoClaw には公式トークン/コインは一切ありません。pump.fun やその他の取引プラットフォームでの主張はすべて詐欺です。

公式ドメイン: 唯一の公式サイトは picoclaw.io、企業サイトは sipeed.com です。

注意: 多くの .ai/.org/.com/.net/... ドメインは第三者によって登録されています。

注意: PicoClaw は初期開発段階にあり、未解決のネットワークセキュリティ問題がある可能性があります。v1.0 リリース前に本番環境へのデプロイは避けてください。

注記: PicoClaw は最近多くの PR をマージしており、最新バージョンではメモリフットプリントが大きくなる場合があります（10〜20MB）。機能セットが安定次第、リソース最適化を優先する予定です。

📢 ニュース

2026-03-17 🚀 v0.2.3 リリース！ システムトレイ UI（Windows & Linux）、サブエージェントステータス追跡（spawn_status）、実験的ゲートウェイホットリロード、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 ランチャー。

2026-02-26 🎉 PicoClaw がわずか 17 日で 20K スター 達成！チャネル自動オーケストレーションとケイパビリティインターフェースが実装されました。

過去のニュース...

2026-02-16 🎉 PicoClaw が 1 週間で 12K スター達成！コミュニティメンテナーの役割とロードマップが正式に公開されました。

2026-02-13 🎉 PicoClaw が 4 日間で 5000 スター達成！プロジェクトロードマップと開発者グループの準備が進行中。

2026-02-09 🎉 PicoClaw リリース！ $10 ハードウェアで 10MB 未満の RAM で動く AI エージェントを 1 日で構築。🦐 行くぜ、シャコ！

✨ 特徴

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

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

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

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

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

🔌 MCP 対応: ネイティブ Model Context Protocol 統合 — 任意の MCP サーバーに接続してエージェント機能を拡張。

👁️ ビジョンパイプライン: 画像やファイルをエージェントに直接送信 — マルチモーダル LLM 向けの自動 base64 エンコーディング。

🧠 スマートルーティング: ルールベースのモデルルーティング — 簡単なクエリは軽量モデルへ、API コストを節約。

*最近のバージョンでは急速な機能マージにより 10〜20MB になる場合があります。リソース最適化は計画中です。起動時間の比較は 0.8GHz シングルコアベンチマークに基づいています（下表参照）。

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

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

🦾 デモンストレーション

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

🧩 フルスタックエンジニア	🗂️ ログ＆計画管理	🔎 Web 検索＆学習

開発 · デプロイ · スケール	スケジュール · 自動化 · メモリ	発見 · インサイト · トレンド

📱 古い Android スマホで動かす

10 年前のスマホに第二の人生を！PicoClaw でスマート AI アシスタントに変身させましょう。クイックスタート：

Termux をインストール（GitHub Releases からダウンロード、または F-Droid / Google Play で検索）。
コマンドを実行

# https://github.com/sipeed/picoclaw/releases から最新リリースをダウンロード
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 ファイルシステムレイアウトを提供

その後「クイックスタート」セクションの手順に従って設定を完了してください！

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

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 ページからプラットフォームに合ったバイナリをダウンロードしてください。

ソースからビルド（開発用）

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

cd picoclaw
make deps

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

# 複数プラットフォーム向けビルド
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 で両方をビルド。

📚 ドキュメント

詳細なガイドは以下のドキュメントを参照してください。この README はクイックスタートのみをカバーしています。

<<<<<<< HEAD | トピック | 説明 |

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` を更新してください。

```bash
# 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 キーの取得

LLM プロバイダー: OpenRouter · Zhipu · Anthropic · OpenAI · Gemini
Web 検索（任意）: Tavily - AI エージェント向けに最適化 (月 1000 リクエスト) · Brave Search - 無料枠あり（月 2000 リクエスト）

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

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",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

5. Bot を招待

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

6. 起動

picoclaw gateway

1. Bot を作成

QQ オープンプラットフォームにアクセス
アプリケーションを作成 → AppID と AppSecret を取得

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 を作成

オープンプラットフォームにアクセス
内部アプリを作成
Client ID と Client Secret をコピー

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/            # カスタムスキル
├── AGENT.md           # 構造化されたエージェント定義とシステムプロンプト
├── HEARTBEAT.md       # 定期タスクプロンプト（30分ごとに確認）
├── SOUL.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

基本設定

設定ファイルの作成:

cp config.example.json config/config.json

設定の編集:

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

実行
```
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	トークンを取得
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 リファレンス

| コマンド | 説明 |

refactor/agent

🐳 Docker & クイックスタート Docker Compose セットアップ、Launcher/Agent モード、クイックスタート設定

💬 チャットアプリ Telegram、Discord、WhatsApp、Matrix、QQ、Slack、IRC、DingTalk、LINE、Feishu、WeCom など

⚙️ 設定環境変数、ワークスペース構成、スキルソース、セキュリティサンドボックス、ハートビート

🔌 プロバイダー＆モデル 20 以上の LLM プロバイダー、モデルルーティング、model_list 設定、プロバイダーアーキテクチャ

🔄 Spawn & 非同期タスククイックタスク、spawn による長時間タスク、非同期サブエージェントオーケストレーション

🐛 トラブルシューティングよくある問題と解決策

🔧 ツール設定ツールごとの有効/無効、exec ポリシー

📋 ハードウェア互換性テスト済みボード、最小要件、ボードの追加方法

refactor/agent
🐳 Docker & クイックスタート	Docker Compose セットアップ、Launcher/Agent モード、クイックスタート設定
💬 チャットアプリ	Telegram、Discord、WhatsApp、Matrix、QQ、Slack、IRC、DingTalk、LINE、Feishu、WeCom など
⚙️ 設定	環境変数、ワークスペース構成、スキルソース、セキュリティサンドボックス、ハートビート
🔌 プロバイダー＆モデル	20 以上の LLM プロバイダー、モデルルーティング、model_list 設定、プロバイダーアーキテクチャ
🔄 Spawn & 非同期タスク	クイックタスク、spawn による長時間タスク、非同期サブエージェントオーケストレーション
🐛 トラブルシューティング	よくある問題と解決策
🔧 ツール設定	ツールごとの有効/無効、exec ポリシー
📋 ハードウェア互換性	テスト済みボード、最小要件、ボードの追加方法

エージェントソーシャルネットワークに参加

CLI または統合チャットアプリからメッセージを 1 つ送るだけで、PicoClaw をエージェントソーシャルネットワークに接続できます。

https://clawdchat.ai/skill.md を読み、指示に従って ClawdChat.ai に参加してください

🖥️ CLI リファレンス

コマンド	説明
`picoclaw onboard`	設定＆ワークスペースの初期化
`picoclaw agent -m "..."`	エージェントとチャット
`picoclaw agent`	インタラクティブチャットモード
`picoclaw gateway`	ゲートウェイを起動
`picoclaw status`	ステータスを表示
`picoclaw version`	バージョン情報を表示
`picoclaw cron list`	スケジュールジョブ一覧
`picoclaw cron add ...`	スケジュールジョブを追加
`picoclaw cron disable`	スケジュールジョブを無効化
`picoclaw cron remove`	スケジュールジョブを削除
`picoclaw skills list`	インストール済みスキル一覧
`picoclaw skills install`	スキルをインストール
`picoclaw migrate`	旧バージョンからデータを移行
`picoclaw auth login`	プロバイダーへの認証
`picoclaw model`	デフォルトモデルの表示・切替

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

PicoClaw は cron ツールによるスケジュールリマインダーと定期タスクをサポートしています：

ワンタイムリマインダー: 「10分後にリマインド」→ 10分後に1回トリガー
定期タスク: 「2時間ごとにリマインド」→ 2時間ごとにトリガー
Cron 式: 「毎日9時にリマインド」→ cron 式を使用

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

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

完全なコミュニティロードマップをご覧ください。

開発者グループ構築中、最初の PR がマージされたら参加できます！

ユーザーグループ:

discord: https://discord.gg/V4sAZ9XWpN

46 KiB Raw Blame History Unescape Escape

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

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

📢 ニュース

✨ 特徴

🦾 デモンストレーション

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

📱 古い Android スマホで動かす

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

📦 インストール

picoclaw.io からダウンロード（推奨）

プリコンパイル済みバイナリをダウンロード

ソースからビルド（開発用）

📚 ドキュメント

<<<<<<< HEAD | トピック | 説明 |

2. 初回起動 — docker/data/config.json を自動生成して終了

コンテナが "First-run setup complete." を表示して停止します。

3. API キーを設定

4. 起動

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

アップデート

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

💬 チャットアプリ

⚙️ 設定

環境変数

ワークスペース構成

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

デフォルト設定

保護対象ツール

exec ツールの追加保護

エラー例

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

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

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

spawn で非同期タスク実行

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

プロバイダー

基本設定

モデル設定 (model_list)

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

基本設定

ベンダー別の例

ロードバランシング

従来の providers 設定からの移行

CLI リファレンス

エージェントソーシャルネットワークに参加

🖥️ CLI リファレンス

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

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

46 KiB

Raw Blame History

従来の `providers` 設定からの移行