OPenClaw là một công cụ dịch vụ API mạnh mẽ, ngày càng nhiều nhà phát triển quan tâm đến cách sử dụng. Hướng dẫn này sẽ chỉ bạn từng bước từ đăng ký tài khoản đến cấu hình API key, giúp bạn nhanh chóng làm quen với các tính năng của OPenClaw.
Đăng ký tài khoản OPenClaw
Truy cập trang web chính thức của OPenClaw, nhấn vào nút "Đăng ký" ở góc trên bên phải. Bạn cần cung cấp địa chỉ email hợp lệ và đặt mật khẩu đăng nhập, nên sử dụng cả chữ hoa, chữ thường và số để tăng cường bảo mật. Sau khi xác minh email, hệ thống sẽ đưa bạn đến trang chủ bảng điều khiển, lúc này tài khoản đã được tạo thành công.
Nếu gặp lỗi tải captcha khi đăng ký, hãy thử đổi trình duyệt hoặc xóa bộ nhớ cache. Người dùng ở một số khu vực có thể cần môi trường mạng ổn định để hoàn tất bước đăng ký.
Lấy và quản lý API key
Sau khi đăng nhập vào bảng điều khiển, tìm mục "API Keys" hoặc "Quản lý khóa" ở thanh điều hướng bên trái. Nhấn "Tạo khóa mới", hệ thống sẽ tự động tạo một chuỗi API key duy nhất – hãy sao chép và lưu trữ ngay lập tức. Một khi đóng trang, bạn sẽ không thể xem lại khóa này, chỉ có thể tạo lại.
Nên tạo riêng một khóa cho mỗi dự án hoặc mục đích sử dụng, để khi có sự cố bất thường có thể vô hiệu hóa riêng mà không ảnh hưởng đến các dịch vụ khác. Bạn có thể xem thời gian tạo, số lần gọi và trạng thái hiện tại trong danh sách khóa, đồng thời thực hiện các thao tác bật, tắt hoặc xóa.
Cấu hình môi trường phát triển và gọi cơ bản
Sau khi có API key, bạn có thể cấu hình header yêu cầu trong mã. Ví dụ với Python, thêm trường `Authorization: Bearer ` vào thư viện requests, và đặt endpoint API theo base URL được cung cấp trong tài liệu chính thức. Lưu ý một số chức năng có thể yêu cầu truyền thêm tham số trong body, hãy tham khảo tài liệu cụ thể của từng API.
Lần gọi đầu tiên nên sử dụng endpoint kiểm tra do chính thức cung cấp; nếu nhận được mã phản hồi thành công thì cấu hình đã đúng. Nếu gặp lỗi 401, hãy kiểm tra lại khóa hoặc xem khóa đã bị vô hiệu hóa chưa; nếu là lỗi 429, nghĩa là tần suất yêu cầu vượt quá giới hạn, cần giảm tốc độ gọi hoặc xin nâng hạn mức.
Các vấn đề thường gặp và cách khắc phục
Nhiều người dùng gặp thông báo "Không có quyền truy cập" khi liên kết tài khoản, thường là do chưa xác thực danh tính hoặc chưa kích hoạt dịch vụ tương ứng trong bảng điều khiển. Hãy vào "Cài đặt tài khoản" để xem gói hiện tại và phạm vi quyền; một số gói miễn phí có giới hạn số lần gọi API, khi vượt quá cần nâng cấp gói để tiếp tục sử dụng.
Nếu bạn đổi tài khoản và thấy khóa cũ không còn hiệu lực, hãy kiểm tra xem có đăng nhập nhầm vào tài khoản phụ OPenClaw khác không. Nên sử dụng tài khoản chính để quản lý khóa tập trung, và thường xuyên thay đổi khóa để tăng cường bảo mật. Nhìn chung, làm theo các bước trong tài liệu chính thức sẽ giải quyết được hầu hết vấn đề.
