88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support

OpenClaw - Nền tảng trợ lý AI tự lưu trữ

Hướng dẫn OpenClaw — Cài đặt OpenClaw, tích hợp 88API và nhanh chóng thiết lập trợ lý AI tự lưu trữ. Dự án mã nguồn mở, hỗ trợ tích hợp đa kênh như Telegram, Discord, WhatsApp.

Giới thiệu dự án

OpenClaw là AI cá nhân mã nguồn mở, tự lưu trữ nền tảng trợ lý kết nối ứng dụng nhắn tin với AI tác nhân chạy trên phần cứng của riêng bạn. Được thiết kế cho các nhà phát triển và người dùng nâng cao, nó cho phép bạn có trợ lý AI tự động mà không từ bỏ quyền kiểm soát dữ liệu của mình.

OpenClaw hoàn toàn là nguồn mở. Bạn có thể duyệt mã nguồn, gửi vấn đề hoặc đóng góp trên kho GitHub của OpenClaw. Hướng dẫn này bao gồm các bước hoàn chỉnh để cài đặt, định cấu hình và tích hợp OpenClaw với 88API.

🌟 Tính năng cốt lõi

Tích hợp đa kênh

  • Tích hợp đa kênh: Hỗ trợ nhiều kênh nhắn tin khác nhau như Telegram, Discord, WhatsApp, iMessage và có thể được mở rộng sang nhiều nền tảng hơn thông qua plugin.
  • Cổng đơn: Quản lý thống nhất tất cả các kênh thông qua một quy trình Cổng duy nhất.
  • Hỗ trợ giọng nói: Hỗ trợ tương tác giọng nói macOS/iOS/Android.
  • Giao diện Canvas: Có thể hiển thị giao diện Canvas tương tác.

Tự lưu trữ và bảo mật dữ liệu

  • Hoàn toàn tự lưu trữ: Chạy trên máy hoặc máy chủ của riêng bạn.
  • Tính minh bạch của nguồn mở: Giấy phép nguồn mở của MIT, mã hoàn toàn minh bạch.
  • Dữ liệu cục bộ: Ngữ cảnh và kỹ năng được lưu trữ trên máy tính cục bộ của bạn chứ không phải trên đám mây.

Khả năng của Agent thông minh

  • Hoạt động liên tục: Hỗ trợ hoạt động nền liên tục với bộ nhớ dài hạn.
  • Nhiệm vụ theo lịch trình: Hỗ trợ các tác vụ theo lịch trình cron.
  • Cách ly phiên: Cách ly các phiên theo tác nhân/không gian làm việc/người gửi.
  • Định tuyến đa tác nhân: Hỗ trợ công việc cộng tác giữa nhiều tác nhân.
  • Gọi công cụ: Hỗ trợ gốc cho việc gọi công cụ và thực thi mã.

📦 Chuẩn bị trước khi hội nhập

Thông tin chuẩn bị

  • Node.js 24.16+ hoặc 26.1+ (khuyến nghị chính thức là Node 26; Node 22, 23, 25 không được hỗ trợ. Script cài đặt chính thức sẽ tự chuẩn bị môi trường Node)
  • Địa chỉ API của 88API: https://api.88api.ai/v1
  • API Key tạo trong bảng điều khiển 88API
  • Hãy giữ API Key an toàn, không dán vào ứng dụng hoặc trang web không rõ nguồn gốc.

Trước khi tích hợp 88API, trước tiên bạn nên chạy Giao diện người dùng Cổng và Điều khiển theo quy trình được đề xuất chính thức hiện tại của OpenClaw. Điều này giúp dễ dàng phân biệt liệu bản thân OpenClaw không khởi động hay cấu hình của nhà cung cấp mô hình không chính xác khi khắc phục sự cố sau này.

1. Cài đặt OpenClaw

macOS/Linux:

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

Windows (PowerShell):

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

Đối với các phương pháp cài đặt khác, hãy tham khảo tài liệu chính thức của OpenClaw: Bắt đầu.

2. Chạy Trình hướng dẫn tích hợp

openclaw onboard --install-daemon

Trình hướng dẫn này sẽ hoàn tất quá trình xác thực cơ bản, thiết lập Cổng và khởi tạo kênh tùy chọn. Mục tiêu ở đây là để OpenClaw chạy trước, sau đó chuyển mô hình mặc định sang 88API.

Script cài đặt chính thức sẽ tự khởi chạy trình hướng dẫn này khi kết thúc; nếu bạn đã hoàn tất trình hướng dẫn trong lúc cài đặt thì có thể bỏ qua bước này. Trình hướng dẫn yêu cầu kết nối một mô hình dùng được trước khi hoàn tất. Nếu bạn chỉ có khóa 88API, hãy chọn More… → Custom Provider trong danh sách nhà cung cấp mô hình: Base URL điền https://api.88api.ai/v1 (bắt buộc có /v1), Compatibility giữ mặc định openai, Model ID điền gpt-6.1-sol, rồi dán khóa 88API. Trình hướng dẫn sẽ gửi thử một yêu cầu thật và chỉ lưu khi xác minh thành công. Provider do trình hướng dẫn tạo có tên dạng custom-api-88api-ai, có thể dùng song song với api88 thêm thủ công ở phần sau.

Không chọn Skip for now: nó sẽ thoát ngay mà không khởi động Gateway, khiến bước kiểm tra tiếp theo thất bại.

3. Kiểm tra cổng và giao diện người dùng điều khiển

openclaw gateway status
openclaw dashboard

Nếu trình duyệt mở được Control UI nghĩa là hoạt động cơ bản của OpenClaw vẫn bình thường. Ở giai đoạn này, chưa cần định cấu hình Telegram, Discord, Feishu hoặc các kênh nhắn tin khác.

4. Xác định vị trí file cấu hình

File cấu hình của OpenClaw thường nằm ở ~/.openclaw/openclaw.json. Bạn có thể tiếp tục sửa đổi nó dựa trên những gì trình hướng dẫn tích hợp đã tạo.

Biến môi trường liên quan đến đường dẫn

Nếu bạn chạy OpenClaw trong tài khoản dịch vụ chuyên dụng hoặc muốn tùy chỉnh thư mục cấu hình/trạng thái, bạn có thể sử dụng:

  • OPENCLAW_HOME
  • OPENCLAW_STATE_DIR
  • OPENCLAW_CONFIG_PATH

Để biết hướng dẫn chi tiết, hãy xem tài liệu về biến môi trường chính thức: Biến môi trường.

🚀 Sử dụng 88API làm Nhà cung cấp mô hình

OpenClaw hỗ trợ tích hợp các cổng mô hình tùy chỉnh hoặc tương thích với OpenAI thông qua models.providers. Đối với 88API, cách tiếp cận phổ biến nhất là thêm nó làm nhà cung cấp tùy chỉnh vào cấu hình, sau đó trỏ mô hình mặc định tới api88/model-ID.

Phương pháp tích hợp

  1. Khai báo nhà cung cấp api88 theo models.providers.
  2. Đặt baseUrl thành https://api.88api.ai/v1 (bắt buộc có /v1).
  3. Đặt api thành openai-completions.
  4. Liệt kê các ID mẫu mà bạn muốn OpenClaw sử dụng trong models.
  5. Chuyển model mặc định trong agents.defaults.model.primary sang api88/....

Cách thực hành được đề xuất: Lưu trữ khóa API trong các biến môi trường

Khi Gateway chạy dưới dạng dịch vụ nền (--install-daemon ở bước 2), nó không đọc được các biến bạn export trong terminal. Hãy ghi khóa vào tệp môi trường toàn cục được OpenClaw khuyến nghị chính thức là ~/.openclaw/.env (nếu đã đặt OPENCLAW_STATE_DIR thì là tệp .env trong thư mục đó), sau đó khởi động lại Gateway:

macOS/Linux:

echo 'API88_API_KEY=sk-your-88api-key' >> ~/.openclaw/.env
openclaw gateway restart

Windows (PowerShell):

Add-Content -Path "$HOME\.openclaw\.env" -Value 'API88_API_KEY=sk-your-88api-key' -Encoding ascii
openclaw gateway restart

Sau đó, thêm hoặc sửa đổi đoạn mã sau trong openclaw.json:

{
  models: {
    mode: "merge",
    providers: {
      api88: {
        baseUrl: "https://api.88api.ai/v1",
        apiKey: "${API88_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
          { id: "kimi-k3", name: "Kimi K3" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "api88/gemini-3.5-flash",
        fallbacks: ["api88/kimi-k3"],
      },
      models: {
        "api88/gemini-3.5-flash": { alias: "flash" },
        "api88/kimi-k3": { alias: "kimi" },
      },
    },
  },
}

Đây không phải là cấu hình hoàn chỉnh cần phải được sao chép chính xác mà là phần quan trọng nhất để tích hợp 88API. Miễn là provider, ID mô hình và tham chiếu mô hình mặc định là chính xác, OpenClaw sẽ có thể gọi các mô hình tương ứng thông qua 88API.

Chi tiết cấu hình chính

Mục cấu hìnhMô tả
models.modeKhuyến nghị đặt thành merge, thêm api88 trong khi vẫn giữ lại các nhà cung cấp tích hợp của OpenClaw
models.providers.api88.baseUrlĐịa chỉ API của 88API https://api.88api.ai/v1, bắt buộc có /v1
models.providers.api88.apiKeyKhóa 88API, nên tiêm qua ${API88_API_KEY}
models.providers.api88.apiĐối với các cổng tương thích với OpenAI như 88API, hãy sử dụng openai-completions
models.providers.api88.modelsCác ID mô hình liệt kê ở đây phải khớp với tên mô hình mà 88API thực sự cung cấp
agents.defaults.model.primaryMô hình chính mặc định, định dạng phải là provider/model-id
agents.defaults.model.fallbacksDanh sách mô hình dự phòng, tự động chuyển đổi nếu mô hình chính bị lỗi
agents.defaults.modelsTùy chọn, dùng để tạo bí danh cho mô hình, thuận tiện cho việc tham chiếu trong UI hoặc phiên

Xác minh tích hợp thành công

Sau khi hoàn tất cấu hình, quay lại Control UI hoặc mở lại:

openclaw dashboard

Nếu bạn có thể bắt đầu các cuộc hội thoại một cách bình thường trong OpenClaw và mô hình mặc định là api88/... thì việc tích hợp đã thành công. Bạn cũng có thể sử dụng:

openclaw models list

để xác nhận rằng các model có tiền tố api88/ xuất hiện trong danh sách có thể lựa chọn.

Các vấn đề thường gặp

  • baseUrl thiếu /v1: Đây là một trong những lỗi tích hợp phổ biến nhất.
  • ID model không chính xác: primary và fallbacks phải tương ứng với id trong models.providers.api88.models.
  • API key chỉ có tác dụng trong terminal hiện tại: dịch vụ nền không kế thừa các biến đã export trong terminal. Hãy ghi khóa vào ~/.openclaw/.env rồi chạy openclaw gateway restart.
  • Để khắc phục sự cố trên nền trước: Sử dụng phương pháp chạy nền trước chính thức openclaw gateway --port 18789 để quan sát nhật ký và lỗi.