mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
BeaconCat
403ceb39be
## Config field fixes (cross-verified against Go source) - MaixCam: server_address → host + port - IRC: use_tls → tls, channels_to_join → channels (all 6 languages) - WeCom AI Bot: callback port 18791 → 18790 - credential_encryption: base_url → api_base, add required model field, remove incorrect passphrase-only mode docs - providers.md: agents.defaults.model → model_name (×4), remove non-existent session.backlog_limit - migration guide, troubleshooting: agents.defaults.model → model_name - ANTIGRAVITY_AUTH: fix file path, Go 1.21 → 1.25, model → model_name - spawn-tasks: fix truncated file, add Heartbeat introduction - tools_configuration: add Tavily/SearXNG/GLMSearch, exec allow_remote/ timeout_seconds/custom_allow_patterns, cron allow_command, skills github/search_cache, clawhub timeout/max_zip_size/max_response_size - configuration: fix builtin skills path (build-time embedded, not cwd), HEARTBEAT.md marked auto-generated ## Broken link fixes (15 total) - chat-apps.md: WeCom/Matrix links with wrong relative paths - providers.md: migration link with extra docs/ prefix - hardware-compatibility.md: README links with wrong depth (all 5 langs) - chat-apps.md: WhatsApp dead links → anchor links (zh/ja) ## Getting-started accuracy - README (all 6 langs): add picoclaw.io as recommended download, add missing picoclaw model CLI command - docker.md: clarify first-run trigger condition (all 6 langs) - configuration.md: fix builtin skills path description (all 6 langs) ## QQ channel - Add quick setup via q.qq.com/qqbot/openclaw (one-click bot creation) - Add manual setup as fallback (all 6 languages) ## Feishu channel - Update setup flow: WebSocket/SDK mode, no webhook URL needed - Preserve Lark international domain note (all 6 languages) ## chat-apps.md - Add Feishu, Slack, IRC, OneBot detail sections (all 6 languages) - Add MaixCam section to ja/fr/pt-br/vi - Fix all channel doc links to point to correct language version ## New translations (25 files, 5 docs × 5 languages) debug.md, credential_encryption.md, hardware-compatibility.md, ANTIGRAVITY_AUTH.md, ANTIGRAVITY_USAGE.md → zh/ja/fr/pt-br/vi ## Channel docs (6 languages each, 60 new files) telegram, discord, qq, feishu, maixcam, dingtalk, line, slack, onebot, wecom/wecom_aibot, wecom/wecom_app, wecom/wecom_bot Co-authored-by: BeaconCat <BeaconCat@users.noreply.github.com>
73 lines
3.2 KiB
Markdown
73 lines
3.2 KiB
Markdown
> Quay lại [README](../../README.vi.md)
|
|
|
|
# Sử dụng nhà cung cấp Antigravity trong PicoClaw
|
|
|
|
Hướng dẫn này giải thích cách thiết lập và sử dụng nhà cung cấp **Antigravity** (Google Cloud Code Assist) trong PicoClaw.
|
|
|
|
## Điều kiện tiên quyết
|
|
|
|
1. Một tài khoản Google.
|
|
2. Đã kích hoạt Google Cloud Code Assist (thường có sẵn thông qua quy trình giới thiệu "Gemini for Google Cloud").
|
|
|
|
## 1. Xác thực
|
|
|
|
Để xác thực với Antigravity, chạy lệnh sau:
|
|
|
|
```bash
|
|
picoclaw auth login --provider antigravity
|
|
```
|
|
|
|
### Xác thực thủ công (Headless/VPS)
|
|
Nếu bạn đang chạy trên máy chủ (Coolify/Docker) và không thể truy cập `localhost`, hãy làm theo các bước sau:
|
|
1. Chạy lệnh ở trên.
|
|
2. Sao chép URL được cung cấp và mở nó trong trình duyệt cục bộ của bạn.
|
|
3. Hoàn tất đăng nhập.
|
|
4. Trình duyệt của bạn sẽ chuyển hướng đến URL `localhost:51121` (trang sẽ không tải được).
|
|
5. **Sao chép URL cuối cùng đó** từ thanh địa chỉ trình duyệt.
|
|
6. **Dán nó vào terminal** nơi PicoClaw đang chờ.
|
|
|
|
PicoClaw sẽ tự động trích xuất mã ủy quyền và hoàn tất quy trình.
|
|
|
|
## 2. Quản lý mô hình
|
|
|
|
### Liệt kê các mô hình khả dụng
|
|
Để xem dự án của bạn có quyền truy cập vào những mô hình nào và kiểm tra hạn mức của chúng:
|
|
|
|
```bash
|
|
picoclaw auth models
|
|
```
|
|
|
|
### Chuyển đổi mô hình
|
|
Bạn có thể thay đổi mô hình mặc định trong `~/.picoclaw/config.json` hoặc ghi đè qua CLI:
|
|
|
|
```bash
|
|
# Ghi đè cho một lệnh duy nhất
|
|
picoclaw agent -m "Hello" --model claude-opus-4-6-thinking
|
|
```
|
|
|
|
## 3. Sử dụng thực tế (Coolify/Docker)
|
|
|
|
Nếu bạn đang triển khai qua Coolify hoặc Docker, hãy làm theo các bước sau để kiểm tra:
|
|
|
|
1. **Biến môi trường**:
|
|
* `PICOCLAW_AGENTS_DEFAULTS_MODEL=gemini-flash`
|
|
2. **Lưu trữ xác thực**:
|
|
Nếu bạn đã đăng nhập cục bộ, bạn có thể sao chép thông tin xác thực lên máy chủ:
|
|
```bash
|
|
scp ~/.picoclaw/auth.json user@your-server:~/.picoclaw/
|
|
```
|
|
*Hoặc*, chạy lệnh `auth login` một lần trên máy chủ nếu bạn có quyền truy cập terminal.
|
|
|
|
## 4. Khắc phục sự cố
|
|
|
|
* **Phản hồi trống**: Nếu một mô hình trả về phản hồi trống, nó có thể bị hạn chế cho dự án của bạn. Hãy thử `gemini-3-flash` hoặc `claude-opus-4-6-thinking`.
|
|
* **429 Giới hạn tốc độ**: Antigravity có hạn mức nghiêm ngặt. PicoClaw sẽ hiển thị "thời gian đặt lại" trong thông báo lỗi nếu bạn đạt đến giới hạn.
|
|
* **404 Không tìm thấy**: Đảm bảo bạn đang sử dụng ID mô hình từ danh sách `picoclaw auth models`. Sử dụng ID ngắn (ví dụ: `gemini-3-flash`) thay vì đường dẫn đầy đủ.
|
|
|
|
## 5. Tóm tắt các mô hình hoạt động tốt
|
|
|
|
Dựa trên kiểm tra, các mô hình sau đáng tin cậy nhất:
|
|
* `gemini-3-flash` (Nhanh, khả dụng cao)
|
|
* `gemini-2.5-flash-lite` (Nhẹ)
|
|
* `claude-opus-4-6-thinking` (Mạnh mẽ, bao gồm khả năng suy luận)
|