OpenClaw với DeepSeek: Thiết lập, Model ID và chi phí API

OpenClaw truy cập DeepSeek thông qua một plugin nhà cung cấp chính thức được cài đặt riêng — openclaw plugins install @openclaw/deepseek-provider — với ID nhà cung cấp deepseek, khóa DEEPSEEK_API_KEY, API tương thích với OpenAI và URL cơ sở https://api.deepseek.com không có /v1. Hai sự thật quyết định liệu lần chạy đầu tiên của bạn có hoạt động hay không. Catalog hiện hành của DeepSeek có hai ID, deepseek-flash và deepseek-v4-pro; các tên deepseek-chat và deepseek-reasoner mà những hướng dẫn cũ sử dụng đã bị ngừng vào ngày 24 tháng 7 năm 2026. Quy trình khởi tạo của OpenClaw đặt deepseek/deepseek-v4-pro làm mặc định, đây là mô hình duy nhất mà các trang riêng của DeepSeek có mức thanh toán hiện tại không thống nhất.

Một điểm phân biệt trước khi cấu hình, vì kết quả tìm kiếm trộn lẫn chúng. Một OpenClaw khác trên GitHub tự mô tả là "a multiplatform C++ reimplementation of original Captain Claw (1997) platformer game"; không nội dung nào từ dự án đó áp dụng ở đây. Agent là dự án tại openclaw.ai, được ghi lại tại docs.openclaw.ai — hãy liên kết đến máy chủ đó, vì documentation.openclaw.ai chỉ chuyển hướng đến đó.

Cài đặt và cấu hình theo tài liệu của cả hai dự án

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

Khi đã cài plugin, bạn không cung cấp URL cơ sở: plugin tự công bố catalog riêng và hành vi tương thích riêng. Cấu hình tối thiểu là khóa và mô hình, ở định dạng JSON5.

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

OpenClaw phân giải khóa nhà cung cấp từ bốn dạng biến môi trường theo thứ tự ưu tiên được ghi lại: OPENCLAW_LIVE_DEEPSEEK_KEY dưới dạng một tùy chọn ghi đè trực tiếp có ưu tiên cao nhất, tiếp theo là DEEPSEEK_API_KEYS dưới dạng danh sách phân tách bằng dấu phẩy hoặc dấu chấm phẩy, sau đó là DEEPSEEK_API_KEY dưới dạng khóa chính, rồi các mục được đánh số DEEPSEEK_API_KEY_* (Giao diện điều khiển và khóa, kiểm tra ngày 21 tháng 9 năm 2026). Settings rồi Models trong Giao diện điều khiển sẽ thêm hoặc thay thế khóa mà không cần chỉnh sửa tệp, và dữ liệu khóa vẫn nằm trong kho xác thực. Cạm bẫy khi cài đặt trên máy chủ là phạm vi chứ không phải cách viết: trang riêng của OpenClaw cảnh báo rằng nếu Gateway chạy như một daemon dưới launchd hoặc systemd, khóa phải hiển thị với tiến trình đó, chẳng hạn trong ~/.openclaw/.env hoặc thông qua env.shellEnv.

Những ID mô hình DeepSeek nào thực sự còn hoạt động

Các dòng dưới đây có ba trạng thái khác nhau chứ không phải một. Phản hồi mẫu trong tài liệu tham khảo list-models của DeepSeek hiển thị đúng hai ID, deepseek-flash và deepseek-v4-pro, trong khi catalog đi kèm OpenClaw vẫn cung cấp bốn tham chiếu.

Hãy tách riêng hai tuyên bố về việc ngừng sử dụng, vì chúng có vẻ mâu thuẫn nhưng thực ra không phải vậy. OpenClaw nêu rằng DeepSeek đã ngừng deepseek-chat và deepseek-reasoner, đồng thời "those model IDs are no longer accessible". DeepSeek thì nêu riêng rằng "the legacy names deepseek-v4-flash and deepseek-v4-flash-vision-exp are still accepted, but the corresponding models have been retired". Đây là hai cặp tên khác nhau với hai kết quả khác nhau. Trang Models & Pricing của DeepSeek cho cả hai ID đang hoạt động độ dài ngữ cảnh 1M và đầu ra tối đa 384K, còn bảng catalog của OpenClaw mang cùng cặp 1.000.000 / 384.000 trên cả bốn tham chiếu.

Mô hình còn chưa rõ. Thông báo ngày 10 tháng 9 năm 2026 của DeepSeek cho biết "Chúng tôi đang từng bước ngừng cung cấp V4-Pro" và rằng "bắt đầu từ 04:00 UTC ngày 14 tháng 9 năm 2026, mọi yêu cầu deepseek-v4-pro sẽ được chuyển đến V4.1-Flash với mức giá của V4.1-Flash". Nhật ký thay đổi của cùng bản phát hành lại nói ngược lại: "để đáp ứng nhu cầu của người dùng, chúng tôi đã quyết định tiếp tục cung cấp dịch vụ API cho DeepSeek V4 Pro sau ngày 14 tháng 9 năm 2026, với phương thức tính phí không thay đổi". Trang Models & Pricing vẫn liệt kê V4 Pro với mức giá riêng cao hơn và không có thông báo ngừng cung cấp. Cả hai nguồn đều được đọc vào ngày 21 tháng 9 năm 2026, một tuần sau ngày đang được đề cập. Trang này sẽ không cho bạn biết bạn sẽ bị tính phí theo mô hình nào — hãy xác nhận trong chính tài khoản DeepSeek của bạn trước khi giữ nguyên mô hình mặc định được đặt trong quy trình khởi tạo, đồng thời lưu ý rằng mô hình mặc định chính là mô hình có cách tính phí đang gây tranh cãi.

Chi phí token và lý do thời gian là một phần của giá

DeepSeek công bố mức giá giờ cao điểm và ngoài cao điểm, trong đó ngoài cao điểm bằng một nửa giờ cao điểm. Khung giờ này khá hẹp: "giờ cao điểm là 01:00 - 04:00 và 06:00 - 10:00 UTC, từ thứ Hai đến thứ Sáu, không bao gồm các ngày nghỉ lễ công cộng của Trung Quốc. Tất cả các giờ còn lại đều là ngoài cao điểm, bao gồm toàn bộ cuối tuần và các ngày nghỉ lễ công cộng của Trung Quốc." Bảy giờ trong ngày làm việc là giờ cao điểm, còn mọi thời điểm khác thì không, vì vậy một ước tính âm thầm giả định toàn bộ là giờ cao điểm sẽ thổi phồng hóa đơn thông thường.

Được đọc từ trang Models & Pricing của DeepSeek vào ngày 21 tháng 9 năm 2026. Dòng Flash được trang nhà cung cấp của OpenClaw xác nhận độc lập, với mức "$0,30 cho mỗi triệu token đầu vào, $1,20 cho mỗi triệu token đầu ra và $0,006 cho mỗi triệu token đầu vào được lưu trong bộ nhớ đệm". Các dòng V4 Pro chỉ dựa trên trang Models & Pricing và nằm dưới mâu thuẫn nêu trên, vì vậy hãy xem chúng là mức giá được trích dẫn chứ chưa phải thông tin đã được xác lập.

Cột bộ nhớ đệm là yếu tố làm thay đổi hóa đơn của tác nhân, và tỷ lệ của nó khá bất thường. Một lượt truy cập bộ nhớ đệm trên deepseek-flash có giá $0,006 cho mỗi triệu token, so với $0,30 khi không truy cập — xấp xỉ một phần năm mươi mức giá khi không truy cập, thấp hơn nhiều so với tỷ lệ một phần mười thường thấy ở nơi khác, vì vậy đừng áp dụng giả định từ một nhà cung cấp khác. Hướng dẫn bộ nhớ đệm của DeepSeek cho biết tính năng này "được bật theo mặc định cho tất cả người dùng mà không cần sửa đổi mã", một lượt truy cập thành công yêu cầu tiền tố khớp hoàn toàn, và bộ nhớ đệm không được sử dụng sẽ bị xóa "thường trong vòng vài giờ đến vài ngày". Các lượt truy cập và không truy cập được trả về trong các trường sử dụng prompt_cache_hit_tokens và prompt_cache_miss_tokens. DeepSeek không công bố giá ghi vào bộ nhớ đệm và bảng giá không có cột ghi vào bộ nhớ đệm; đây là khoản phí chưa được công bố, không phải tuyên bố rằng việc ghi là miễn phí.

Một phiên minh họa trên deepseek-flash, theo mức giá DeepSeek đã công bố. Giả sử một lần chạy OpenClaw gửi 600.000 token đầu vào, trong đó 450.000 token khớp với bộ nhớ đệm tiền tố và 150.000 token không khớp, đồng thời nhận 40.000 token đầu ra. Ở giờ cao điểm, chi phí là $0,045 cộng $0,0027 cộng $0,048, tức $0,096; cùng phiên đó ngoài giờ cao điểm là $0,048. Nếu hoàn toàn không có lượt truy cập bộ nhớ đệm, cùng lần chạy sẽ có giá $0,228 ở giờ cao điểm. Đây là phép tính token dựa trên các giả định đã nêu, không phải chi phí tác vụ đo được và cũng không phải hạn mức chi tiêu — tỷ lệ lượt truy cập bộ nhớ đệm thực tế của bạn mới là biến số quan trọng nhất, và con số trong ứng dụng OpenClaw sẽ không giải quyết được điều đó, vì OpenClaw nói rằng chi phí cục bộ của họ chỉ là ước tính và dẫn đến trang giá của DeepSeek là nguồn có thẩm quyền để tính phí.

Khả năng của mô hình và hỗ trợ công cụ của ứng dụng khách là hai câu hỏi khác nhau

Đây là phần mà bảng giá không thể cho bạn biết, đồng thời là lý do thực tế để sử dụng plugin thay vì tự tạo mục nhà cung cấp. Các phiên suy luận DeepSeek V4 yêu cầu phát lại các tin nhắn assistant từ một lượt có bật suy luận để truyền reasoning_content trong các yêu cầu tiếp theo. Plugin DeepSeek của OpenClaw tự động bổ sung trường đó, vì vậy việc sử dụng công cụ nhiều lượt vẫn hoạt động "ngay cả khi lịch sử đến từ một nhà cung cấp tương thích OpenAI khác (không có reasoning_content gốc) hoặc từ một tin nhắn assistant thông thường", không cần /new sau khi chuyển đổi nhà cung cấp giữa phiên. Khi tắt suy luận, bao gồm cả lựa chọn None trong giao diện, OpenClaw gửi thinking: { type: "disabled" } và loại bỏ reasoning_content được phát lại khỏi lịch sử gửi đi. OpenClaw cũng ánh xạ cả /think xhigh và /think max tới mức tối đa của DeepSeek là reasoning_effort.

Một nhà cung cấp tùy chỉnh openai-completions thông thường trỏ tới một endpoint tương thích với DeepSeek sẽ không có cơ chế bổ sung lại nào trong số đó, cũng không có định dạng suy luận DeepSeek trừ khi bạn tự khai báo khối tương thích — trang ds4 của OpenClaw cho thấy cấu trúc này, bao gồm thinkingFormat: "deepseek" và supportsReasoningEffort. Khoảng thiếu đó thường là nguyên nhân khiến một lượt dùng công cụ thành công một lần rồi thất bại ở lượt tiếp theo.

Hai giới hạn phía DeepSeek cần được xem xét trong cùng một quyết định. Việc gọi công cụ ở chế độ nghiêm ngặt nằm trên một URL cơ sở khác, https://api.deepseek.com/beta, và yêu cầu "strict": true trên mỗi hàm cùng với "additionalProperties": false; đây không phải endpoint mà plugin trỏ tới theo mặc định. Ngoài ra, hướng dẫn gọi công cụ của DeepSeek nêu rằng "Chat Completion API không hỗ trợ chèn các lệnh gọi công cụ ở giữa cuộc trò chuyện nhưng hỗ trợ chèn các tin nhắn system ở giữa cuộc trò chuyện; để chèn lệnh gọi công cụ, hãy sử dụng Anthropic API hoặc Responses API" — đây là giới hạn của endpoint mà plugin OpenClaw sử dụng, với hai phương án thay thế được tài liệu hóa chứ không phải giới hạn của mô hình.

Về khả năng hỗ trợ mô hình, hai nguồn thống nhất với nhau. Cột FEATURES trên trang Models & Pricing của DeepSeek đánh dấu Tool Calls, JSON Output, Responses API và Anthropic API là được hỗ trợ trên cả deepseek-flash và deepseek-v4-pro, đồng thời phân biệt chúng ở khả năng xử lý hình ảnh — được hỗ trợ trên deepseek-flash, không được hỗ trợ trên deepseek-v4-pro. OpenClaw cho biết việc sử dụng công cụ nhiều lượt hoạt động trên cả bốn tham chiếu của họ. Không bên nào ghi nhận lệnh gọi công cụ song song, vì vậy điểm này thực sự vẫn bỏ ngỏ chứ chưa được khẳng định theo hướng nào.

Xác minh theo ba bước, sau đó là những lỗi đáng nêu tên

Hãy kiểm tra các lớp theo đúng thứ tự, vì mỗi lớp thất bại theo một cách khác nhau. Trước hết là danh mục: openclaw models list --provider deepseek, hoặc openclaw models list --all --provider deepseek để kiểm tra danh mục tĩnh của plugin mà không cần Gateway đang chạy, sau đó openclaw models set deepseek/deepseek-flash nếu bạn muốn dùng mô hình không có tranh cãi thay vì mô hình mặc định khi làm quen. Thứ hai, gửi một prompt ngắn không truyền phát rồi một prompt truyền phát, đây là lúc vấn đề xác thực hoặc URL cơ sở sẽ biểu hiện rõ ràng. Thứ ba — và chỉ ở bước thứ ba — là một lệnh gọi công cụ rồi đến lượt thứ hai trong cùng phiên, đây là bước duy nhất kiểm tra việc phát lại reasoning_content được mô tả ở trên.

Dòng 404 xứng đáng có một câu riêng, vì đây là trường hợp mà tài liệu không thể giải thích thay bạn. Bảng mã lỗi của DeepSeek liệt kê 400, 401, 402, 422, 429, 500 và 503 nhưng không có 404, vì vậy 404 ở đây là bằng chứng về việc định tuyến của bạn chứ không phải về DeepSeek. Những gì DeepSeek thực sự trả về đối với một model id không xác định chưa được tài liệu hóa và chưa được kiểm thử ở đây. Tham chiếu lỗi bao quát các mã trạng thái tương đương trên endpoint riêng của Kunavo.

Trực tiếp, gateway, cục bộ: tuyến nào được ưu tiên

Kunavo không cung cấp mô hình DeepSeek. Các mô hình văn bản của Kunavo thuộc các dòng Claude và OpenAI, vì vậy không có tuyến Kunavo nào đến mô hình DeepSeek và trang này không cung cấp tuyến đó. Điều có thể áp dụng là cơ chế, điều đáng biết nếu lý do bạn đọc trang thiết lập DeepSeek là muốn dùng một key cho nhiều dòng mô hình thay vì riêng DeepSeek.

Đối với dòng gateway, cấu hình sử dụng cùng hai cần gạt. Bạn có thể khai báo models.providers.<id> với baseUrl, apiKey, api: "openai-completions" và một mảng models[] liệt kê ít nhất từng id, hoặc làm quen với endpoint bằng --auth-choice custom-api-key, --custom-base-url và --custom-model-id. Các tham chiếu mô hình luôn có dạng provider/model, và lỗi âm thầm là đặt bí danh cho một mô hình dưới agents.defaults.models mà không đăng ký nó trong models.providers.<provider>.models[] — tham chiếu nhà cung cấp tùy chỉnh của OpenClaw nêu rằng bí danh "tự nó không hạn chế việc ghi đè cũng không đăng ký một mô hình runtime mới". URL cơ sở của Kunavo cho tuyến đó là https://api.kunavo.com/v1, với đúng một /v1 — trái ngược với quy ước không có hậu tố của DeepSeek, và là nguồn có khả năng cao nhất gây ra lỗi 404 khi ai đó sao chép giá trị của trường này từ trang này sang trang kia.

Để hình dung quy mô của phương án thay thế đó, đây là cùng dạng phiên đã giả định — 600.000 token đầu vào và 40.000 token đầu ra, không giả định bộ nhớ đệm — được tính theo mức giá trực tiếp trong danh mục Kunavo. Đây là các mô hình khác trên một endpoint khác, vì vậy đây là phép so sánh về dạng thức và không phải phép so sánh chi phí cho cùng một tác vụ với các con số DeepSeek ở trên; mức giá được liệt kê thấp nhất và chi phí hoàn thành tác vụ thấp nhất là hai tuyên bố riêng biệt, và chỉ lần chạy của chính bạn mới xác định được tuyên bố thứ hai.

Phép tính token minh họa dựa trên các giả định đã nêu, không phải chi phí tác vụ đo được và không phải trần hóa đơn. Số tiền trong danh mục của Kunavo là mức sàn tính phí chứ không phải mức trần: khi upstream báo khoản phí của mình, hóa đơn sẽ là giá trị lớn hơn giữa chi phí trong danh mục và chi phí upstream nhân với mức cộng giá áp dụng. Phí bộ nhớ đệm và các công cụ bên ngoài nằm ngoài ví dụ này. Mức nạp tối thiểu là $10 tín dụng trả trước — một mức tối thiểu để nạp tiền, không phải phí tác vụ hay gói thuê bao. Xem chi tiết tính phí và bộ nhớ đệm.

Nếu tuyến liền kề đó mới là điều bạn thực sự muốn, hãy bắt đầu từ tổng quan về tích hợp để xem URL cơ sở và cách thiết lập key, sau đó đến hướng dẫn bắt đầu nhanh cho lệnh gọi đầu tiên, và tạo tài khoản Kunavo khi bạn sẵn sàng nạp tiền cho một key. Hãy xem đây là tài liệu tham chiếu cấu hình đã công bố chứ không phải kết quả tương thích: OpenClaw chưa được kiểm thử khi chạy với endpoint của Kunavo. Vẫn muốn ở lại OpenClaw và chọn một mô hình? Giá OpenClaw tách phần mềm miễn phí khỏi hóa đơn tính theo lượng dùng, API tốt nhất cho OpenClaw so sánh các tuyến theo tác vụ, còn API tương thích với OpenAI trình bày các quy ước URL cơ sở mà trang này liên tục cảnh báo.

Câu hỏi thường gặp

Mọi tuyên bố về OpenClaw và DeepSeek ở trên đều được đọc từ tài liệu và registry của chính các dự án đó vào ngày 21 tháng 9 năm 2026, đối chiếu với OpenClaw v2026.9.5; trang nhà cung cấp, trang giá, nhật ký thay đổi, thông báo ngày 10 tháng 9, tài liệu tham chiếu liệt kê mô hình, bảng mã lỗi, trang giới hạn tốc độ và các quy tắc về nhà cung cấp tùy chỉnh đều được tải lại trực tiếp cho trang này. Không có gì được cài đặt, thiết lập ban đầu hoặc gọi: không chạy OpenClaw, không gửi yêu cầu đến api.deepseek.com và không kiểm thử runtime với Kunavo. Mức giá token của Kunavo lấy từ danh mục trực tiếp, và mọi con số đô la đều là phép tính token minh họa chứ không phải chi phí đo được.