Hướng dẫn cấu hình OpenClaw với Beeknoee

OpenClaw là gì?

OpenClaw là AI agent chạy nền (gateway) — nhận việc qua web UI, Telegram, WhatsApp… và tự làm bằng bộ skill của nó. Beeknoee đóng vai trò nhà cung cấp model cho OpenClaw qua giao thức OpenAI-compatible.

Có 2 cách nối Beeknoee vào OpenClaw:

Yêu cầu

• OpenClaw đã cài và chạy được (openclaw --version)
• Windows: OpenClaw chạy trong WSL2 + Ubuntu — mọi lệnh dưới đây gõ trong terminal Ubuntu, không phải PowerShell
• API Key từ Beeknoee Platform

📌 Bước 1: Tạo API Key

1. Truy cập https://platform.beeknoee.com/api-keys
2. Đăng nhập bằng tài khoản Google → nhấn "Tạo API Key"
3. Copy API Key (dạng sk-bee-xxxx...)

⚠️ API key chỉ hiển thị 24 giờ đầu — copy và lưu ngay!

🚀 Bước 2: Cấu hình qua Quick Setup (khuyên dùng)

1. Vào API Keys → ⚙️ Cấu hình API Key → tab Quick Setup
2. Chọn tab OpenClaw, chọn hệ điều hành và 3 khe model (Small / Medium / High)
3. Copy lệnh → dán vào terminal (Windows: terminal Ubuntu/WSL)
4. Chạy openclaw gateway restart để áp dụng

Script làm đúng những việc sau:

• ✅ Ghi key vào ~/.openclaw/.env (chmod 600), không để key trong file cấu hình
• ✅ Thêm provider bằng chính CLI của OpenClaw (openclaw config set … --merge) → giữ nguyên provider, agent, plugin bạn đang có
• ✅ Thêm model vào allowlist agents.defaults.models — thiếu bước này OpenClaw sẽ từ chối model
• ✅ Đặt model mặc định, in ra model cũ để bạn khôi phục nếu muốn
• ✅ Chạy openclaw config validate để chắc chắn file vẫn hợp lệ

💡 Muốn xem trước script làm gì mà chưa chạy thật? Dùng nút Xem trước (không ghi gì) trong khối Công cụ khác — xem Quick Setup.

🛠️ Hoặc cấu hình thủ công

OpenClaw lưu cấu hình ở ~/.openclaw/openclaw.json (định dạng JSON5, có comment). Đừng sửa tay file này — dùng CLI để OpenClaw tự kiểm tra schema và giữ nguyên comment.

1. Đặt key vào ~/.openclaw/.env:

echo 'BEEKNOEE_API_KEY="sk-bee-YOUR_API_KEY"' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

2. Thêm Beeknoee làm provider:

openclaw config set models.providers.beeknoee '{
  "baseUrl": "https://platform.beeknoee.com/v1",
  "apiKey": "${BEEKNOEE_API_KEY}",
  "api": "openai-completions",
  "models": [
    { "id": "claude-sonnet-4-6", "name": "claude-sonnet-4-6" }
  ]
}' --strict-json --merge

3. Cho phép model đó được dùng (bỏ bước này là OpenClaw từ chối model):

openclaw config set agents.defaults.models '{"beeknoee/claude-sonnet-4-6":{}}' --strict-json --merge

4. Đặt làm model mặc định:

openclaw config get agents.defaults.model.primary        # ghi lại giá trị cũ trước
openclaw config set agents.defaults.model.primary "beeknoee/claude-sonnet-4-6"

5. Kiểm tra rồi khởi động lại:

openclaw config validate
openclaw gateway restart
openclaw models list       # phải thấy model beeknoee/...

⚠️ --merge là bắt buộc. Thiếu cờ này, config set sẽ thay thế toàn bộ nhánh models.providers và xoá mất provider khác của bạn.

💡 Tham chiếu ${BEEKNOEE_API_KEY} được OpenClaw thay bằng giá trị thật lúc chạy, nên key không nằm trong openclaw.json.

⚠️ Cấu hình cũ bằng biến môi trường đã hết tác dụng

Nếu bạn từng làm theo hướng dẫn cũ (của Beeknoee hoặc trên mạng) kiểu này:

# ❌ KHÔNG còn tác dụng với OpenClaw
OPENAI_BASE_URL="https://platform.beeknoee.com/v1"
SMALL_MODEL="..."
MEDIUM_MODEL="..."
HIGH_MODEL="..."

thì OpenClaw không đọc bất kỳ biến nào trong số đó. Hậu quả: key Beeknoee được nạp nhưng request vẫn bay thẳng tới api.openai.com và báo lỗi key sai.

Cách sửa: chạy lại Quick Setup (bản mới tự dọn mấy dòng rác này trong .env và chuyển sang openclaw.json), hoặc làm theo phần cấu hình thủ công ở trên.

📌 Streaming

Provider openai-completions stream sẵn, không có cờ nào cần bật. Đừng thêm "stream": true vào cấu hình provider — đó không phải field hợp lệ của OpenClaw.

🔧 Lỗi thường gặp

Lỗi khác: xem Xử lý sự cố OpenClaw.

Xem thêm

• OpenClaw + 9Router — cách nối qua dashboard 9Router
• Xử lý sự cố OpenClaw — bộ sưu tập lỗi đầy đủ
• Quick Setup — cài 1 lệnh + 4 công cụ kiểm tra
• Models — danh sách model và ID chính xác