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

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

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

Đố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.

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.

🚀 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 88api/model-ID.

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

1. Khai báo nhà cung cấp 88api theo models.providers.
2. Trỏ baseUrl vào địa chỉ 88API của bạn, đảm bảo nó bao gồm /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 88api/....

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

Trước tiên, hãy cung cấp khóa 88API của bạn trong shell, môi trường dịch vụ hiện tại hoặc một tệp .env có thể đọc được bởi OpenClaw:

export API88_API_KEY="sk-your-88api-key"

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

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

  agents: {
    defaults: {
      model: {
        primary: "88api/gemini-2.5-flash",
        fallbacks: ["88api/kimi-k2.5"],
      },
      models: {
        "88api/gemini-2.5-flash": { alias: "flash" },
        "88api/kimi-k2.5": { 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 tài nguyên mô hình được hiển thị của bạn thông qua 88API.

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

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à 88api/... 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ố 88api/ 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.88api.models.
• API key chỉ có tác dụng trong terminal hiện tại: Nếu Gateway chạy dưới dạng dịch vụ nền, hãy đảm bảo tiến trình dịch vụ cũng có thể đọc được API88_API_KEY.
• Để 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.