APIZ

Tài liệu APIZ

OpenClaw: trợ lý AI tự làm việc

Cài OpenClaw, nối với APIZ bằng Custom Provider rồi giao việc qua trình duyệt, Telegram hay Zalo. Đã chạy thử với APIZ ngày 18/09/2026.

OpenClaw là gì

OpenClaw là phần mềm mã nguồn mở chạy trên máy của bạn (macOS, Linux, Windows). Bạn giao việc bằng tin nhắn, nó tự làm: đọc và ghi tệp, chạy lệnh, tra web, làm việc theo lịch. OpenClaw không kèm mô hình AI — bạn nối nó với APIZ để dùng Claude, GPT… và trả bằng tiền Việt.

Đã chạy thử với APIZ ngày 18/09/2026 (OpenClaw 2026.9.4): trả lời đúng với cả claude-sonnet-5 và gpt-5.6-sol; tự ghi rồi đọc lại tệp đã thử với claude-sonnet-5.

1. Cài OpenClaw

macOS / Linux — dán vào Terminal:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows — dán vào PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

Trình cài tự cài Node.js nếu máy chưa có (OpenClaw cần Node 24.16 trở lên hoặc 26.1 trở lên; Node 25 không chạy), cài OpenClaw rồi mở phần thiết lập. Cách cài khác (ứng dụng Windows Hub, ứng dụng macOS): trang cài đặt của OpenClaw.

2. Tạo khoá APIZ

Vào api.apiz.vn → Khóa API, tạo khoá nhóm Claude (hợp nhất cho trợ lý tự làm việc) rồi bấm chép khoá. Muốn dùng GPT thì tạo khoá nhóm GPT. Cách tạo khoá: API key & hạn mức.

3. Nối OpenClaw với APIZ

Khi phần thiết lập hỏi nhà cung cấp mô hình, chọn Custom Provider (nằm trong mục More…) rồi điền:

ÔNhập
Base URLhttps://api.apiz.vn/v1
API keyKhoá APIZ vừa chép, dạng sk-...
CompatibilityOpenAI-compatible
Model IDclaude-sonnet-5 (key nhóm Claude) hoặc gpt-5.6-sol (key nhóm GPT)

OpenClaw gọi thử một câu, trả lời được thì mới lưu. Đã cài OpenClaw từ trước và muốn chuyển sang APIZ: gõ openclaw onboard để chạy lại phần thiết lập.

Chọn OpenAI-compatible, đừng chọn Anthropic-compatible hay Unknown. Ở kiểu Anthropic, OpenClaw gửi hai tin nhắn liền nhau và mô hình Claude nhận theo kiểu này bị mất tin đầu, nên trợ lý không thấy câu hỏi và chỉ đáp “I'm ready…” (APIZ đo ngày 18/09/2026).

4. Bắt đầu giao việc

  • Gõ openclaw dashboard: mở khung trò chuyện trên trình duyệt, không cần cài thêm gì.
  • Muốn nhắn qua Telegram, Zalo, WhatsApp, Discord…: gõ openclaw channels add và làm theo hướng dẫn trên màn hình. Telegram là cách dễ nhất: tạo bot với @BotFather rồi dán token.

Dùng qua Zalo

  • Zalo Bot (nên dùng): bot tạo trên Zalo Bot Platform, plugin chính thức của OpenClaw nhưng còn ở dạng thử nghiệm. Mỗi tin nhắn tối đa 2.000 ký tự, tệp tối đa 5 MB.
  • Zalo cá nhân: chạy bằng tài khoản Zalo thật qua thư viện không chính thức. Chính OpenClaw cảnh báo tài khoản có thể bị khoá — đừng dùng tài khoản Zalo chính.

Chi tiết: danh sách kênh của OpenClaw.

Chọn mô hình và chi phí

Mỗi lượt, OpenClaw gửi kèm khoảng 20–30 nghìn token hướng dẫn nền (danh sách công cụ, quy tắc), nên một câu hỏi ngắn cũng tốn hơn bạn nghĩ. APIZ đo ngày 18/09/2026:

Model IDChi phí
claude-sonnet-5khoảng 36 ₫ một câu hỏi ngắn — nên dùng mặc định
claude-haiku-4-5rẻ bằng một nửa Sonnet 5, hợp việc nhẹ, lặp lại
gpt-5.6-solkhoảng 160 ₫ một câu hỏi ngắn

Theo dõi từng lượt ở Nhật ký API. Giá theo mô hình: Mô hình & giá.

Lỗi thường gặp

  • Trợ lý đáp “I'm ready…” mà không làm theo câu hỏi: đang dùng kiểu Anthropic. Gõ openclaw onboard, chọn lại Custom Provider với OpenAI-compatible.
  • Báo sai khoá (401): chép lại khoá; khoá phải thuộc đúng nhóm của Model ID.
  • Báo không có mô hình: Model ID phải đúng tên trong Mô hình & giá và thuộc nhóm của khoá.