系統要求
PicoClaw 的硬體門檻非常低：
- 作業系統：Linux / macOS / Windows (WSL2)
- 架構支援：x86_64 / ARM64 / RISC-V
- 最低記憶體：64MB（推薦 512MB 以上）
- 依賴：LLM API Key（未配置則無法使用 AI 對話）
支援平台：macOS、Linux、Windows (WSL2)、樹莓派、Docker
第一步：複製程式碼倉庫
開啟終端機，執行以下指令：
git clone https://github.com/sipeed/picoclaw.git複製完成後，進入專案目錄：
cd picoclaw第二步：初始化配置
執行 onboard 指令進行初始化：
picoclaw onboard按照提示完成配置：
- LLM API Key：輸入你的 LLM 服務商 API Key
- 模型偏好設定：選擇預設使用的 AI 模型
- 訊息平台 Token（可選）：如需啟用 Telegram、Discord、QQ 或釘釘整合，分別輸入對應的 Bot Token
設定檔儲存在本地，所有資料均在使用者裝置上，不會上傳到雲端。
第三步：啟動對話
配置完成後，即可開始與 AI 對話。
互動模式
picoclaw agent啟動互動式對話介面，可連續發送訊息並獲取回覆。
單次查詢模式
picoclaw agent -m "你好，請介紹一下你自己"發送單條訊息並獲取回覆後退出，適合在腳本中使用。
啟動閘道服務
如需在 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，填入設定檔。
釘釘 Bot
在釘釘開放平台建立機器人應用，獲取 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+。
可以在樹莓派上執行嗎？
可以，PicoClaw 支援 ARM64 架構，樹莓派 4（4GB+）即可流暢執行。
如何配置多個 Bot 同時使用？
在設定檔中分別加入各平台的 Token 和配置項，啟動 picoclaw gateway 即可同時啟用所有 Bot。