lzh/picoclaw

Fork 0

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

Files

T

AlbertBui010 8428446d69 docs: fix allow_from typo in config examples

2026-02-18 00:17:56 +07:00

27 KiB

Raw Blame History

PicoClaw: Trợ lý AI Siêu Nhẹ viết bằng Go

Phần cứng $10 · RAM 10MB · Khởi động 1 giây · 皮皮虾，我们走！

Tiếng Việt | 中文 | 日本語 | English

🦐 PicoClaw là trợ lý AI cá nhân siêu nhẹ, lấy cảm hứng từ nanobot, được viết lại hoàn toàn bằng Go thông qua quá trình "tự khởi tạo" (self-bootstrapping) — nơi chính AI Agent đã tự dẫn dắt toàn bộ quá trình chuyển đổi kiến trúc và tối ưu hóa mã nguồn.

⚡️ Cực kỳ nhẹ: Chạy trên phần cứng chỉ $10 với RAM <10MB. Tiết kiệm 99% bộ nhớ so với OpenClaw và rẻ hơn 98% so với Mac mini!

Caution

🚨 TUYÊN BỐ BẢO MẬT & KÊNH CHÍNH THỨC

KHÔNG CÓ CRYPTO: PicoClaw KHÔNG có bất kỳ token/coin chính thức nào. Mọi thông tin trên pump.fun hoặc các sàn giao dịch khác đều là LỪA ĐẢO.

DOMAIN CHÍNH THỨC: Website chính thức DUY NHẤT là picoclaw.io, website công ty là sipeed.com.

Cảnh báo: Nhiều tên miền .ai/.org/.com/.net/... đã bị bên thứ ba đăng ký, không phải của chúng tôi.

Cảnh báo: PicoClaw đang trong giai đoạn phát triển sớm và có thể còn các vấn đề bảo mật mạng chưa được giải quyết. Không nên triển khai lên môi trường production trước phiên bản v1.0.

Lưu ý: PicoClaw gần đây đã merge nhiều PR, dẫn đến bộ nhớ sử dụng có thể lớn hơn (10–20MB) ở các phiên bản mới nhất. Chúng tôi sẽ ưu tiên tối ưu tài nguyên khi bộ tính năng đã ổn định.

📢 Tin tức

2026-02-16 🎉 PicoClaw đạt 12K stars chỉ trong một tuần! Cảm ơn tất cả mọi người! PicoClaw đang phát triển nhanh hơn chúng tôi tưởng tượng. Do số lượng PR tăng cao, chúng tôi cấp thiết cần maintainer từ cộng đồng. Các vai trò tình nguyện viên và roadmap đã được công bố tại đây — rất mong đón nhận sự tham gia của bạn!

2026-02-13 🎉 PicoClaw đạt 5000 stars trong 4 ngày! Cảm ơn cộng đồng! Chúng tôi đang hoàn thiện Lộ trình dự án (Roadmap) và thiết lập Nhóm phát triển để đẩy nhanh tốc độ phát triển PicoClaw.
🚀 Kêu gọi hành động: Vui lòng gửi yêu cầu tính năng tại GitHub Discussions. Chúng tôi sẽ xem xét và ưu tiên trong cuộc họp hàng tuần.

2026-02-09 🎉 PicoClaw chính thức ra mắt! Được xây dựng trong 1 ngày để mang AI Agent đến phần cứng $10 với RAM <10MB. 🦐 PicoClaw, Lên Đường!

✨ Tính năng nổi bật

🪶 Siêu nhẹ: Bộ nhớ sử dụng <10MB — nhỏ hơn 99% so với Clawdbot (chức năng cốt lõi).

💰 Chi phí tối thiểu: Đủ hiệu quả để chạy trên phần cứng $10 — rẻ hơn 98% so với Mac mini.

⚡️ Khởi động siêu nhanh: Nhanh gấp 400 lần, khởi động trong 1 giây ngay cả trên CPU đơn nhân 0.6GHz.

🌍 Di động thực sự: Một file binary duy nhất chạy trên RISC-V, ARM và x86. Một click là chạy!

🤖 AI tự xây dựng: Triển khai Go-native tự động — 95% mã nguồn cốt lõi được Agent tạo ra, với sự tinh chỉnh của con người.

	OpenClaw	NanoBot	PicoClaw
Ngôn ngữ	TypeScript	Python	Go
RAM	>1GB	>100MB	< 10MB
Thời gian khởi động (CPU 0.8GHz)	>500s	>30s	<1s
Chi phí	Mac Mini $599	Hầu hết SBC Linux ~$50	Mọi bo mạch Linux Chỉ từ $10

🦾 Demo

🛠️ Quy trình trợ lý tiêu chuẩn

🧩 Lập trình Full-Stack	🗂️ Quản lý Nhật ký & Kế hoạch	🔎 Tìm kiếm Web & Học hỏi

Phát triển • Triển khai • Mở rộng	Lên lịch • Tự động hóa • Ghi nhớ	Khám phá • Phân tích • Xu hướng

🐜 Triển khai sáng tạo trên phần cứng tối thiểu

PicoClaw có thể triển khai trên hầu hết mọi thiết bị Linux!

$9.9 LicheeRV-Nano phiên bản E (Ethernet) hoặc W (WiFi6), dùng làm Trợ lý Gia đình tối giản.
$30~50 NanoKVM, hoặc $100 NanoKVM-Pro, dùng cho quản trị Server tự động.
$50 MaixCAM hoặc $100 MaixCAM2, dùng cho Giám sát thông minh.

https://private-user-images.githubusercontent.com/83055338/547056448-e7b031ff-d6f5-4468-bcca-5726b6fecb5c.mp4

🌟 Nhiều hình thức triển khai hơn đang chờ bạn khám phá!

📦 Cài đặt

Cài đặt bằng binary biên dịch sẵn

Tải file binary cho nền tảng của bạn từ trang Release.

Cài đặt từ mã nguồn (có tính năng mới nhất, khuyên dùng cho phát triển)

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

cd picoclaw
make deps

# Build (không cần cài đặt)
make build

# Build cho nhiều nền tảng
make build-all

# Build và cài đặt
make install

🐳 Docker Compose

Bạn cũng có thể chạy PicoClaw bằng Docker Compose mà không cần cài đặt gì trên máy.

# 1. Clone repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. Thiết lập API Key
cp config/config.example.json config/config.json
vim config/config.json      # Thiết lập DISCORD_BOT_TOKEN, API keys, v.v.

# 3. Build & Khởi động
docker compose --profile gateway up -d

# 4. Xem logs
docker compose logs -f picoclaw-gateway

# 5. Dừng
docker compose --profile gateway down

Chế độ Agent (chạy một lần)

# Đặt câu hỏi
docker compose run --rm picoclaw-agent -m "2+2 bằng mấy?"

# Chế độ tương tác
docker compose run --rm picoclaw-agent

Build lại

docker compose --profile gateway build --no-cache
docker compose --profile gateway up -d

🚀 Bắt đầu nhanh

Tip

Thiết lập API key trong ~/.picoclaw/config.json. Lấy API key: OpenRouter (LLM) · Zhipu (LLM) Tìm kiếm web là tùy chọn — lấy Brave Search API miễn phí (2000 truy vấn/tháng) hoặc dùng tính năng auto fallback tích hợp sẵn.

1. Khởi tạo

picoclaw onboard

2. Cấu hình (~/.picoclaw/config.json)

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "glm-4.7",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "xxx",
      "api_base": "https://openrouter.ai/api/v1"
    }
  },
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  }
}

3. Lấy API Key

Nhà cung cấp LLM: OpenRouter · Zhipu · Anthropic · OpenAI · Gemini
Tìm kiếm Web (tùy chọn): Brave Search — Có gói miễn phí (2000 truy vấn/tháng)

Lưu ý: Xem config.example.json để có mẫu cấu hình đầy đủ.

4. Trò chuyện

picoclaw agent -m "Xin chào, bạn là ai?"

Vậy là xong! Bạn đã có một trợ lý AI hoạt động chỉ trong 2 phút.

💬 Tích hợp ứng dụng Chat

Trò chuyện với PicoClaw qua Telegram, Discord, DingTalk hoặc LINE.

Kênh	Mức độ thiết lập
Telegram	Dễ (chỉ cần token)
Discord	Dễ (bot token + intents)
QQ	Dễ (AppID + AppSecret)
DingTalk	Trung bình (app credentials)
LINE	Trung bình (credentials + webhook URL)

Telegram (Khuyên dùng)

1. Tạo bot

Mở Telegram, tìm @BotFather
Gửi /newbot, làm theo hướng dẫn
Sao chép token

2. Cấu hình

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

Lấy User ID từ @userinfobot trên Telegram.

3. Chạy

picoclaw gateway

Discord

1. Tạo bot

Truy cập https://discord.com/developers/applications
Create an application → Bot → Add Bot
Sao chép bot token

2. Bật Intents

Trong phần Bot settings, bật MESSAGE CONTENT INTENT
(Tùy chọn) Bật SERVER MEMBERS INTENT nếu muốn dùng danh sách cho phép theo thông tin thành viên

3. Lấy User ID

Discord Settings → Advanced → bật Developer Mode
Click chuột phải vào avatar → Copy User ID

4. Cấu hình

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

5. Mời bot vào server

OAuth2 → URL Generator
Scopes: bot
Bot Permissions: Send Messages, Read Message History
Mở URL mời được tạo và thêm bot vào server của bạn

6. Chạy

picoclaw gateway

1. Tạo bot

Truy cập QQ Open Platform
Tạo ứng dụng → Lấy AppID và AppSecret

2. Cấu hình

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

Để allow_from trống để cho phép tất cả người dùng, hoặc chỉ định số QQ để giới hạn quyền truy cập.

3. Chạy

picoclaw gateway

DingTalk

1. Tạo bot

Truy cập Open Platform
Tạo ứng dụng nội bộ
Sao chép Client ID và Client Secret

2. Cấu hình

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

Để allow_from trống để cho phép tất cả người dùng, hoặc chỉ định ID để giới hạn quyền truy cập.

3. Chạy

picoclaw gateway

LINE

1. Tạo tài khoản LINE Official

Truy cập LINE Developers Console
Tạo provider → Tạo Messaging API channel
Sao chép Channel Secret và Channel Access Token

2. Cấu hình

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

3. Thiết lập Webhook URL

LINE yêu cầu HTTPS cho webhook. Sử dụng reverse proxy hoặc tunnel:

# Ví dụ với ngrok
ngrok http 18791

Sau đó cài đặt Webhook URL trong LINE Developers Console thành https://your-domain/webhook/line và bật Use webhook.

4. Chạy

picoclaw gateway

Trong nhóm chat, bot chỉ phản hồi khi được @mention. Các câu trả lời sẽ trích dẫn tin nhắn gốc.

Docker Compose: Thêm ports: ["18791:18791"] vào service picoclaw-gateway để mở port webhook.

Tham gia Mạng xã hội Agent

Kết nối PicoClaw với Mạng xã hội Agent chỉ bằng cách gửi một tin nhắn qua CLI hoặc bất kỳ ứng dụng Chat nào đã tích hợp.

Đọc https://clawdchat.ai/skill.md và làm theo hướng dẫn để tham gia ClawdChat.ai

⚙️ Cấu hình chi tiết

File cấu hình: ~/.picoclaw/config.json

Cấu trúc Workspace

PicoClaw lưu trữ dữ liệu trong workspace đã cấu hình (mặc định: ~/.picoclaw/workspace):

~/.picoclaw/workspace/
├── sessions/          # Phiên hội thoại và lịch sử
├── memory/           # Bộ nhớ dài hạn (MEMORY.md)
├── state/            # Trạng thái lưu trữ (kênh cuối cùng, v.v.)
├── cron/             # Cơ sở dữ liệu tác vụ định kỳ
├── skills/           # Kỹ năng tùy chỉnh
├── AGENTS.md         # Hướng dẫn hành vi Agent
├── HEARTBEAT.md      # Prompt tác vụ định kỳ (kiểm tra mỗi 30 phút)
├── IDENTITY.md       # Danh tính Agent
├── SOUL.md           # Tâm hồn/Tính cách Agent
├── TOOLS.md          # Mô tả công cụ
└── USER.md           # Tùy chọn người dùng

🔒 Hộp cát bảo mật (Security Sandbox)

PicoClaw chạy trong môi trường sandbox theo mặc định. Agent chỉ có thể truy cập file và thực thi lệnh trong phạm vi workspace.

Cấu hình mặc định

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "restrict_to_workspace": true
    }
  }
}

Tùy chọn	Mặc định	Mô tả
`workspace`	`~/.picoclaw/workspace`	Thư mục làm việc của agent
`restrict_to_workspace`	`true`	Giới hạn truy cập file/lệnh trong workspace

Công cụ được bảo vệ

Khi restrict_to_workspace: true, các công cụ sau bị giới hạn trong sandbox:

Công cụ	Chức năng	Giới hạn
`read_file`	Đọc file	Chỉ file trong workspace
`write_file`	Ghi file	Chỉ file trong workspace
`list_dir`	Liệt kê thư mục	Chỉ thư mục trong workspace
`edit_file`	Sửa file	Chỉ file trong workspace
`append_file`	Thêm vào file	Chỉ file trong workspace
`exec`	Thực thi lệnh	Đường dẫn lệnh phải trong workspace

Bảo vệ bổ sung cho Exec

Ngay cả khi restrict_to_workspace: false, công cụ exec vẫn chặn các lệnh nguy hiểm sau:

rm -rf, del /f, rmdir /s — Xóa hàng loạt
format, mkfs, diskpart — Định dạng ổ đĩa
dd if= — Tạo ảnh đĩa
Ghi vào /dev/sd[a-z] — Ghi trực tiếp lên đĩa
shutdown, reboot, poweroff — Tắt/khởi động lại hệ thống
Fork bomb :(){ :|:& };:

Ví dụ lỗi

[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)}

Tắt giới hạn (Rủi ro bảo mật)

Nếu bạn cần agent truy cập đường dẫn ngoài workspace:

Cách 1: File cấu hình

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

Cách 2: Biến môi trường

export PICOCLAW_AGENTS_DEFAULTS_RESTRICT_TO_WORKSPACE=false

⚠️ Cảnh báo: Tắt giới hạn này cho phép agent truy cập mọi đường dẫn trên hệ thống. Chỉ sử dụng cẩn thận trong môi trường được kiểm soát.

Tính nhất quán của ranh giới bảo mật

Cài đặt restrict_to_workspace áp dụng nhất quán trên mọi đường thực thi:

Đường thực thi	Ranh giới bảo mật
Agent chính	`restrict_to_workspace` ✅
Subagent / Spawn	Kế thừa cùng giới hạn ✅
Tác vụ Heartbeat	Kế thừa cùng giới hạn ✅

Tất cả đường thực thi chia sẻ cùng giới hạn workspace — không có cách nào vượt qua ranh giới bảo mật thông qua subagent hoặc tác vụ định kỳ.

Heartbeat (Tác vụ định kỳ)

PicoClaw có thể tự động thực hiện các tác vụ định kỳ. Tạo file HEARTBEAT.md trong workspace:

# Tác vụ định kỳ

- Kiểm tra email xem có tin nhắn quan trọng không
- Xem lại lịch cho các sự kiện sắp tới
- Kiểm tra dự báo thời tiết

Agent sẽ đọc file này mỗi 30 phút (có thể cấu hình) và thực hiện các tác vụ bằng công cụ có sẵn.

Tác vụ bất đồng bộ với Spawn

Đối với các tác vụ chạy lâu (tìm kiếm web, gọi API), sử dụng công cụ spawn để tạo subagent:

# Tác vụ định kỳ

## Tác vụ nhanh (trả lời trực tiếp)
- Báo cáo thời gian hiện tại

## Tác vụ lâu (dùng spawn cho async)
- Tìm kiếm tin tức AI trên web và tóm tắt
- Kiểm tra email và báo cáo tin nhắn quan trọng

Hành vi chính:

Tính năng	Mô tả
spawn	Tạo subagent bất đồng bộ, không chặn heartbeat
Context độc lập	Subagent có context riêng, không có lịch sử phiên
message tool	Subagent giao tiếp trực tiếp với người dùng qua công cụ message
Không chặn	Sau khi spawn, heartbeat tiếp tục tác vụ tiếp theo

Cách Subagent giao tiếp

Heartbeat kích hoạt
    ↓
Agent đọc HEARTBEAT.md
    ↓
Tác vụ lâu: spawn subagent
    ↓                           ↓
Tiếp tục tác vụ tiếp theo   Subagent làm việc độc lập
    ↓                           ↓
Tất cả tác vụ hoàn thành    Subagent dùng công cụ "message"
    ↓                           ↓
Phản hồi HEARTBEAT_OK       Người dùng nhận kết quả trực tiếp

Subagent có quyền truy cập các công cụ (message, web_search, v.v.) và có thể giao tiếp với người dùng một cách độc lập mà không cần thông qua agent chính.

Cấu hình:

{
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

Tùy chọn	Mặc định	Mô tả
`enabled`	`true`	Bật/tắt heartbeat
`interval`	`30`	Khoảng thời gian kiểm tra (phút, tối thiểu: 5)

Biến môi trường:

PICOCLAW_HEARTBEAT_ENABLED=false để tắt
PICOCLAW_HEARTBEAT_INTERVAL=60 để thay đổi khoảng thời gian

Nhà cung cấp (Providers)

Note

Groq cung cấp dịch vụ chuyển giọng nói thành văn bản miễn phí qua Whisper. Nếu đã cấu hình Groq, tin nhắn thoại trên Telegram sẽ được tự động chuyển thành văn bản.

Nhà cung cấp	Mục đích	Lấy API Key
`gemini`	LLM (Gemini trực tiếp)	aistudio.google.com
`zhipu`	LLM (Zhipu trực tiếp)	bigmodel.cn
`openrouter` (Đang thử nghiệm)	LLM (khuyên dùng, truy cập mọi model)	openrouter.ai
`anthropic` (Đang thử nghiệm)	LLM (Claude trực tiếp)	console.anthropic.com
`openai` (Đang thử nghiệm)	LLM (GPT trực tiếp)	platform.openai.com
`deepseek` (Đang thử nghiệm)	LLM (DeepSeek trực tiếp)	platform.deepseek.com
`groq`	LLM + Chuyển giọng nói (Whisper)	console.groq.com

Cấu hình Zhipu

1. Lấy API key

Lấy API key

2. Cấu hình

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "glm-4.7",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "zhipu": {
      "api_key": "Your API Key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  }
}

3. Chạy

picoclaw agent -m "Xin chào"

Ví dụ cấu hình đầy đủ

{
  "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": []
    },
    "qq": {
      "enabled": false,
      "app_id": "",
      "app_secret": "",
      "allow_from": []
    }
  },
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "BSA...",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  },
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

Tham chiếu CLI

Lệnh	Mô tả
`picoclaw onboard`	Khởi tạo cấu hình & workspace
`picoclaw agent -m "..."`	Trò chuyện với agent
`picoclaw agent`	Chế độ chat tương tác
`picoclaw gateway`	Khởi động gateway (cho bot chat)
`picoclaw status`	Hiển thị trạng thái
`picoclaw cron list`	Liệt kê tất cả tác vụ định kỳ
`picoclaw cron add ...`	Thêm tác vụ định kỳ

Tác vụ định kỳ / Nhắc nhở

PicoClaw hỗ trợ nhắc nhở theo lịch và tác vụ lặp lại thông qua công cụ cron:

Nhắc nhở một lần: "Remind me in 10 minutes" (Nhắc tôi sau 10 phút) → kích hoạt một lần sau 10 phút
Tác vụ lặp lại: "Remind me every 2 hours" (Nhắc tôi mỗi 2 giờ) → kích hoạt mỗi 2 giờ
Biểu thức Cron: "Remind me at 9am daily" (Nhắc tôi lúc 9 giờ sáng mỗi ngày) → sử dụng biểu thức cron

Các tác vụ được lưu trong ~/.picoclaw/workspace/cron/ và được xử lý tự động.

🤝 Đóng góp & Lộ trình

Chào đón mọi PR! Mã nguồn được thiết kế nhỏ gọn và dễ đọc. 🤗

Lộ trình sắp được công bố...

Nhóm phát triển đang được xây dựng. Điều kiện tham gia: Ít nhất 1 PR đã được merge.

Nhóm người dùng:

Discord: https://discord.gg/V4sAZ9XWpN

🐛 Xử lý sự cố

Tìm kiếm web hiện "API 配置问题"

Điều này là bình thường nếu bạn chưa cấu hình API key cho tìm kiếm. PicoClaw sẽ cung cấp các liên kết hữu ích để tìm kiếm thủ công.

Để bật tìm kiếm web:

Tùy chọn 1 (Khuyên dùng): Lấy API key miễn phí tại https://brave.com/search/api (2000 truy vấn miễn phí/tháng) để có kết quả tốt nhất.
Tùy chọn 2 (Không cần thẻ tín dụng): Nếu không có key, hệ thống tự động chuyển sang dùng DuckDuckGo (không cần key).

Thêm key vào ~/.picoclaw/config.json nếu dùng Brave:

{
  "tools": {
    "web": {
      "brave": {
        "enabled": true,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  }
}

Gặp lỗi lọc nội dung (Content Filtering)

Một số nhà cung cấp (như Zhipu) có bộ lọc nội dung nghiêm ngặt. Thử diễn đạt lại câu hỏi hoặc sử dụng model khác.

Telegram bot báo "Conflict: terminated by other getUpdates"

Điều này xảy ra khi có một instance bot khác đang chạy. Đảm bảo chỉ có một tiến trình picoclaw gateway chạy tại một thời điểm.

📝 So sánh API Key

Dịch vụ	Gói miễn phí	Trường hợp sử dụng
OpenRouter	200K tokens/tháng	Đa model (Claude, GPT-4, v.v.)
Zhipu	200K tokens/tháng	Tốt nhất cho người dùng Trung Quốc
Brave Search	2000 truy vấn/tháng	Chức năng tìm kiếm web
Groq	Có gói miễn phí	Suy luận siêu nhanh (Llama, Mixtral)

27 KiB Raw Blame History Unescape Escape

PicoClaw: Trợ lý AI Siêu Nhẹ viết bằng Go

Phần cứng $10 · RAM 10MB · Khởi động 1 giây · 皮皮虾，我们走！

📢 Tin tức

✨ Tính năng nổi bật

🦾 Demo

🛠️ Quy trình trợ lý tiêu chuẩn

🐜 Triển khai sáng tạo trên phần cứng tối thiểu

📦 Cài đặt

Cài đặt bằng binary biên dịch sẵn

Cài đặt từ mã nguồn (có tính năng mới nhất, khuyên dùng cho phát triển)

🐳 Docker Compose

Chế độ Agent (chạy một lần)

Build lại

🚀 Bắt đầu nhanh

💬 Tích hợp ứng dụng Chat

Tham gia Mạng xã hội Agent

⚙️ Cấu hình chi tiết

Cấu trúc Workspace

🔒 Hộp cát bảo mật (Security Sandbox)

Cấu hình mặc định

Công cụ được bảo vệ

Bảo vệ bổ sung cho Exec

Ví dụ lỗi

Tắt giới hạn (Rủi ro bảo mật)

Tính nhất quán của ranh giới bảo mật

Heartbeat (Tác vụ định kỳ)

Tác vụ bất đồng bộ với Spawn

Cách Subagent giao tiếp

Nhà cung cấp (Providers)

Tham chiếu CLI

Tác vụ định kỳ / Nhắc nhở

🤝 Đóng góp & Lộ trình

🐛 Xử lý sự cố

Tìm kiếm web hiện "API 配置问题"

Gặp lỗi lọc nội dung (Content Filtering)

Telegram bot báo "Conflict: terminated by other getUpdates"

📝 So sánh API Key

27 KiB

Raw Blame History