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

Files

T

BeaconCat 403ceb39be docs: fix inaccuracies, add translations, and expand channel docs (#1837 )

## 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>

2026-03-20 22:37:05 +08:00

3.2 KiB

Raw Blame History

Quay lại README

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

Một tài khoản Google.
Đã 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:

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:

Chạy lệnh ở trên.
Sao chép URL được cung cấp và mở nó trong trình duyệt cục bộ của bạn.
Hoàn tất đăng nhập.
Trình duyệt của bạn sẽ chuyển hướng đến URL localhost:51121 (trang sẽ không tải được).
Sao chép URL cuối cùng đó từ thanh địa chỉ trình duyệt.
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:

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:

# 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:

Biến môi trường:
- PICOCLAW_AGENTS_DEFAULTS_MODEL=gemini-flash
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ủ:
```
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)

3.2 KiB Raw Blame History