+
+PicoClaw: Go で書かれた超効率 AI アシスタント
+ +$10 ハードウェア · 10MB RAM · 1秒起動 · 皮皮虾，我们走！
+ + +
+
+
+
+
|
+
+ |
+
+
+ |
+
+
+
+## 🦾 デモンストレーション
+### 🛠️ スタンダードアシスタントワークフロー
+🧩 フルスタックエンジニア |
+ 🗂️ ログ＆計画管理 |
+ 🔎 Web 検索＆学習 |
+
|---|---|---|
|
+
|
+
|
+
| 開発 · デプロイ · スケール | +スケジュール · 自動化 · メモリ | +発見 · インサイト · トレンド | +
+
+
+## 🐛 トラブルシューティング
+
+### Web 検索で「API 配置问题」と表示される
+
+検索 API キーをまだ設定していない場合、これは正常です。PicoClaw は手動検索用の便利なリンクを提供します。
+
+Web 検索を有効にするには：
+1. [https://brave.com/search/api](https://brave.com/search/api) で無料の API キーを取得（月 2000 クエリ無料）
+2. `~/.picoclaw/config.json` に追加：
+ ```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） |
diff --git a/README.md b/README.md
index 8f27a78..4b4652b 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,8 @@
+[日本語](README.ja.md) | **English**
+
---
@@ -118,6 +120,49 @@ make build-all
make install
```
+## 🐳 Docker Compose
+
+You can also run PicoClaw using Docker Compose without installing anything locally.
+
+### Quick Start (Discord Bot)
+
+```bash
+# 1. Clone this repo
+git clone https://github.com/Sunwood-AI-OSS-Hub/picoclaw.git
+cd picoclaw
+
+# 2. Set your API keys
+cp .env.example .env
+vim .env # Set DISCORD_BOT_TOKEN, OPENROUTER_API_KEY, etc.
+vim config/config.json # Set provider API keys
+
+# 3. Build & Start
+docker compose -f docker-compose.discord.yml up -d
+
+# 4. Check logs
+docker compose -f docker-compose.discord.yml logs -f picoclaw
+
+# 5. Stop
+docker compose -f docker-compose.discord.yml down
+```
+
+### Agent Mode (One-shot)
+
+```bash
+# Ask a question
+docker compose run --rm picoclaw-agent -m "What is 2+2?"
+
+# Interactive mode
+docker compose run --rm picoclaw-agent
+```
+
+### Rebuild
+
+```bash
+docker compose -f docker-compose.discord.yml build --no-cache
+docker compose -f docker-compose.discord.yml up -d
+```
+
### 🚀 Quick Start
> [!TIP]
diff --git a/docker-compose.discord.yml b/docker-compose.discord.yml
new file mode 100644
index 0000000..d9a44ec
--- /dev/null
+++ b/docker-compose.discord.yml
@@ -0,0 +1,24 @@
+services:
+ # ─────────────────────────────────────────────
+ # PicoClaw Discord Bot
+ # ─────────────────────────────────────────────
+ picoclaw:
+ build:
+ context: .
+ dockerfile: Dockerfile
+ container_name: picoclaw-discord
+ restart: unless-stopped
+ env_file:
+ - .env
+ environment:
+ - PICOCLAW_CHANNELS_DISCORD_ENABLED=true
+ - PICOCLAW_CHANNELS_DISCORD_TOKEN=${DISCORD_BOT_TOKEN}
+ volumes:
+ # Configuration file
+ - ./config/config.json:/root/.picoclaw/config.json:ro
+ # Persistent workspace (sessions, memory, logs)
+ - picoclaw-workspace:/root/.picoclaw/workspace
+ command: ["gateway"]
+
+volumes:
+ picoclaw-workspace:
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..4412e37
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,25 @@
+services:
+
+
+ # ─────────────────────────────────────────────
+ # PicoClaw Agent (one-shot query)
+ # docker compose run --rm picoclaw-agent -m "Hello"
+ # ─────────────────────────────────────────────
+ picoclaw-agent:
+ build:
+ context: .
+ dockerfile: Dockerfile
+ container_name: picoclaw-agent
+ profiles:
+ - agent
+ env_file:
+ - .env
+ volumes:
+ - ./config/config.json:/root/.picoclaw/config.json:ro
+ - picoclaw-workspace:/root/.picoclaw/workspace
+ entrypoint: ["picoclaw", "agent"]
+ stdin_open: true
+ tty: true
+
+volumes:
+ picoclaw-workspace:
+ 
+ 
