Chuyển đến nội dung chính
DeepSeek cung cấp các mô hình AI mạnh mẽ với API tương thích với OpenAI.
Thuộc tínhGiá trị
Nhà cung cấpdeepseek
Xác thựcDEEPSEEK_API_KEY
APITương thích với OpenAI
URL cơ sởhttps://api.deepseek.com

Cài đặt Plugin

Cài đặt Plugin chính thức, sau đó khởi động lại Gateway:
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart

Bắt đầu

1

Get your API key

Tạo khóa API tại platform.deepseek.com.
2

Run onboarding

openclaw onboard --auth-choice deepseek-api-key
Lệnh này sẽ nhắc bạn nhập khóa API và đặt deepseek/deepseek-v4-flash làm mô hình mặc định.
3

Verify models are available

openclaw models list --provider deepseek
Để kiểm tra danh mục tĩnh của Plugin mà không cần Gateway đang chạy, hãy dùng:
openclaw models list --all --provider deepseek
Với các bản cài đặt theo kịch bản hoặc không có giao diện, truyền trực tiếp tất cả các cờ:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk
Nếu Gateway chạy dưới dạng daemon (launchd/systemd), hãy đảm bảo DEEPSEEK_API_KEY khả dụng cho tiến trình đó (ví dụ, trong ~/.openclaw/.env hoặc thông qua env.shellEnv).

Danh mục tích hợp sẵn

Tham chiếu mô hìnhTênĐầu vàoNgữ cảnhĐầu ra tối đaGhi chú
deepseek/deepseek-v4-flashDeepSeek V4 Flashvăn bản1,000,000384,000Mô hình mặc định; bề mặt V4 có khả năng suy luận
deepseek/deepseek-v4-proDeepSeek V4 Provăn bản1,000,000384,000Bề mặt V4 có khả năng suy luận
deepseek/deepseek-chatDeepSeek Chatvăn bản131,0728,192Bề mặt V3.2 không suy luận của DeepSeek
deepseek/deepseek-reasonerDeepSeek Reasonervăn bản131,07265,536Bề mặt V3.2 có bật suy luận
Các mô hình V4 hỗ trợ điều khiển thinking của DeepSeek. OpenClaw cũng phát lại reasoning_content của DeepSeek trong các lượt tiếp theo để các phiên suy luận có lệnh gọi công cụ có thể tiếp tục. Dùng /think xhigh hoặc /think max với các mô hình DeepSeek V4 để yêu cầu reasoning_effort tối đa của DeepSeek.

Suy luận và công cụ

Các phiên suy luận DeepSeek V4 có hợp đồng phát lại nghiêm ngặt hơn hầu hết các nhà cung cấp tương thích với OpenAI: sau khi một lượt có bật suy luận sử dụng công cụ, DeepSeek kỳ vọng các tin nhắn trợ lý được phát lại từ lượt đó bao gồm reasoning_content trong các yêu cầu tiếp theo. OpenClaw xử lý việc này bên trong Plugin DeepSeek, nên việc sử dụng công cụ qua nhiều lượt bình thường hoạt động với deepseek/deepseek-v4-flashdeepseek/deepseek-v4-pro. Nếu bạn chuyển một phiên hiện có từ một nhà cung cấp tương thích với OpenAI khác sang mô hình DeepSeek V4, các lượt gọi công cụ của trợ lý cũ hơn có thể không có reasoning_content gốc của DeepSeek. OpenClaw điền trường còn thiếu đó trên các tin nhắn trợ lý được phát lại cho các yêu cầu suy luận DeepSeek V4 để nhà cung cấp có thể chấp nhận lịch sử mà không cần /new. Khi suy luận bị tắt trong OpenClaw (bao gồm lựa chọn None trong giao diện), OpenClaw gửi DeepSeek thinking: { type: "disabled" } và loại bỏ reasoning_content được phát lại khỏi lịch sử gửi đi. Điều này giữ các phiên tắt suy luận trên đường dẫn DeepSeek không suy luận. Dùng deepseek/deepseek-v4-flash cho đường dẫn nhanh mặc định. Dùng deepseek/deepseek-v4-pro khi bạn muốn mô hình V4 mạnh hơn và có thể chấp nhận chi phí hoặc độ trễ cao hơn.

Kiểm thử trực tiếp

Bộ kiểm thử mô hình trực tiếp bao gồm DeepSeek V4 trong tập mô hình hiện đại. Để chỉ chạy các kiểm tra mô hình trực tiếp DeepSeek V4:
OPENCLAW_LIVE_PROVIDERS=deepseek \
OPENCLAW_LIVE_MODELS="deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro" \
pnpm test:live src/agents/models.profiles.live.test.ts
Kiểm tra trực tiếp đó xác minh cả hai mô hình V4 đều có thể hoàn tất và các lượt tiếp theo về suy luận/công cụ giữ nguyên tải phát lại mà DeepSeek yêu cầu.

Ví dụ cấu hình

{
  env: { DEEPSEEK_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-flash" },
    },
  },
}

Liên quan

Model selection

Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.

Configuration reference

Tham chiếu cấu hình đầy đủ cho tác nhân, mô hình và nhà cung cấp.