Seedream 5.0 Pro đã ra mắt | Thử trong Trình tạo ảnh →
Đăng nhập
Bảng điều khiểnKhám pháTrình tạo AIHotỨng dụng máy tínhAPI KeysNạp tiền
Setup agent

Kết nối OpenClaw với WaveSpeed LLM API

Copy setup ~/.openclaw/openclaw.json được khuyến nghị cho OpenClaw, định tuyến request tới /v1/chat/completions và xác minh các lệnh gọi agent local trong WaveSpeed Logs.

API keyModel thử nghiệm
File cấu hình

~/.openclaw/openclaw.json

Giao thức

Chat completions tương thích OpenAI

Endpoint

/v1/chat/completions

Bắt đầu nhanh

1

Tạo access key WaveSpeed

2

Export key cần thiết ở máy local

3

Dán cấu hình vào~/.openclaw/openclaw.json

4

Chạy openclaw gateway và kiểm tra Logs

Chat completions tương thích OpenAI

Mức sử dụng hiển thị trong Dashboard và Logs

Đổi model mà không phải viết lại code agent

Sửa ~/.openclaw/openclaw.json
// File: ~/.openclaw/openclaw.json  (JSON5)
{
  agents: {
    defaults: {
      model: { primary: "wavespeed/deepseek/deepseek-v4-flash" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      wavespeed: {
        baseUrl: "https://llm.wavespeed.ai/v1",
        apiKey: "${WAVESPEED_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "deepseek/deepseek-v4-flash",
            name: "deepseek/deepseek-v4-flash",
            contextWindow: 200000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}

Đừng thay tên biến

WAVESPEED_API_KEY là tên biến môi trường mà agent đọc. Giữ nguyên tên này trong file cấu hình, và đặt API key thật trong shell.

1

Tạm thời cho terminal này

Hoạt động cho đến khi bạn đóng cửa sổ terminal này.

export WAVESPEED_API_KEY="wsk_live_..."
2

Giữ sau khi khởi động lại

Ghi key vào shell profile để terminal mới có thể đọc được.

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

Hướng dẫn tích hợp agent

Dùng OpenClaw với WaveSpeed LLM API

Hướng dẫn này chỉ cách kết nối OpenClaw với WaveSpeed AI bằng ~/.openclaw/openclaw.json, Chat completions tương thích OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 và model mặc định deepseek/deepseek-v4-flash. Copy cấu hình phía trên, export API key, chạy agent, rồi kiểm tra request trong Logs.

1

Tạo access key WaveSpeed

2

Export key cần thiết ở máy local

3

Dán cấu hình vào

~/.openclaw/openclaw.json
4

Chạy openclaw gateway và kiểm tra Logs

Setup OpenClaw này cấu hình gì

Giao thức

Chat completions tương thích OpenAI

Endpoint

/v1/chat/completions

Model

deepseek/deepseek-v4-flash

Cấu hình sẵn để copy ở trên là file OpenClaw duy nhất bạn cần sửa cho setup được khuyến nghị: ~/.openclaw/openclaw.json. Giữ API key trong môi trường shell để không commit vào repository.

Xử lý sự cố

API key không được nhận

Export WAVESPEED_API_KEY trong cùng shell nơi bạn chạy OpenClaw. Nếu dùng shell profile, hãy reload terminal trước khi khởi động agent.

Request lỗi protocol hoặc endpoint

Kiểm tra OpenClaw đang dùng Chat completions tương thích OpenAI và endpoint /v1/chat/completions. Sai protocol là nguyên nhân phổ biến nhất của lỗi 404 hoặc payload.

Model đã chọn không hoạt động

Xác nhận model id tồn tại trong WaveSpeed Models, rồi dán đúng id vào ~/.openclaw/openclaw.json. Bạn có thể bắt đầu với model mặc định hiển thị trên trang này.

Không thấy request trong Logs

Đảm bảo OpenClaw dùng WaveSpeed base URL và API key hiện tại của bạn. Sau đó gửi prompt mới từ agent local và refresh Logs.

Hướng dẫn OpenClaw này có thể xuất hiện trên tìm kiếm không?

Có. Trang này được xây dựng như một hướng dẫn setup có thể index cho người dùng tìm kiếm OpenClaw custom provider, endpoint tương thích OpenAI, base URL và workflow cấu hình agent local.

Xem tất cả hướng dẫn setup agentDuyệt models
Dùng OpenClaw với WaveSpeed LLM API