OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Ollama Cloud

Ollama Cloud là API mô hình được lưu trữ của Ollama. Nhà cung cấp ollama-cloud gọi trực tiếp API này tại https://ollama.com qua API /api/chat gốc của Ollama, không cần máy chủ Ollama cục bộ và không cần ứng dụng Ollama cục bộ đăng nhập ở chế độ đám mây. Hãy sử dụng các tham chiếu mô hình như ollama-cloud/kimi-k2.6.

OpenClaw đăng ký ollama-cloud làm mã định danh nhà cung cấp riêng để thông tin xác thực chỉ dành cho đám mây, tính năng khám phá danh mục trực tiếp và việc lựa chọn mô hình không bị trộn lẫn với máy chủ ollama cục bộ. Để biết thông tin về Ollama cục bộ, định tuyến kết hợp đám mây và cục bộ, embedding cũng như chi tiết máy chủ tùy chỉnh, hãy xem Ollama.

Thiết lập

Tạo khóa API Ollama Cloud tại ollama.com/settings/keys, sau đó chạy:

bash
openclaw onboard --auth-choice ollama-cloud

Hoặc đặt:

bash
export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

Quy trình thiết lập ban đầu không tương tác chấp nhận trực tiếp khóa:

bash
openclaw onboard --auth-choice ollama-cloud --ollama-cloud-api-key "<key>"

Quy trình thiết lập ban đầu đặt mô hình mặc định thành ollama-cloud/kimi-k2.5:cloud.

Giá trị mặc định

  • Nhà cung cấp: ollama-cloud
  • URL cơ sở: https://ollama.com
  • Biến môi trường: OLLAMA_API_KEY
  • Kiểu API: /api/chat gốc của Ollama
  • Mô hình mặc định khi thiết lập ban đầu: ollama-cloud/kimi-k2.5:cloud

Khi nào nên chọn Ollama Cloud

  • Bạn muốn sử dụng các mô hình Ollama được lưu trữ mà không cần chạy ollama serve cục bộ.
  • Bạn muốn sử dụng cùng cấu trúc API trò chuyện gốc của Ollama mà OpenClaw dùng cho Ollama cục bộ, nhưng trỏ đến https://ollama.com.
  • Bạn muốn một phương thức đám mây đơn giản dành cho các mô hình đã có trong danh mục được lưu trữ của Ollama.
  • Bạn không cần tải mô hình xuống cục bộ, kiểm soát GPU cục bộ hoặc suy luận chỉ trong mạng LAN.

Thay vào đó, hãy sử dụng Ollama khi bạn muốn định tuyến chỉ cục bộ hoặc kết hợp đám mây và cục bộ thông qua một máy chủ Ollama đã đăng nhập. Hãy sử dụng nhà cung cấp tương thích với OpenAI khi bạn cần ngữ nghĩa /v1/chat/completions hoặc các tính năng theo phong cách OpenAI dành riêng cho nhà cung cấp.

Mô hình

Nhà cung cấp yêu cầu khóa API; nếu không có khóa, nhà cung cấp sẽ không hoạt động. Khi có khóa, OpenClaw khám phá trực tiếp các mô hình Ollama Cloud từ danh mục được lưu trữ:

bash
openclaw models list --provider ollama-cloudopenclaw models set ollama-cloud/kimi-k2.6

Các mã định danh được lưu trữ trong danh mục trực tiếp bao gồm deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 và minimax-m2.7. Khi tính năng khám phá trực tiếp không trả về kết quả nào, OpenClaw dùng các mục đi kèm kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud và glm-5.2:cloud làm phương án dự phòng.

Mã định danh mô hình là mã định danh trong danh mục đám mây, không phải tên dùng để tải xuống cục bộ. Nếu tên mô hình hoạt động trên máy chủ Ollama cục bộ nhưng không có trong danh mục được lưu trữ, hãy sử dụng nhà cung cấp ollama với máy chủ cục bộ đó.

Kiểm thử trực tiếp

Đối với các kiểm thử nhanh bằng khóa API Ollama Cloud, hãy trỏ kiểm thử trực tiếp của Ollama đến điểm cuối được lưu trữ và chọn một mô hình từ danh mục hiện tại của bạn:

bash
export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret OPENCLAW_LIVE_TEST=1 \OPENCLAW_LIVE_OLLAMA=1 \OPENCLAW_LIVE_OLLAMA_BASE_URL=https://ollama.com \OPENCLAW_LIVE_OLLAMA_MODEL=kimi-k2.6 \pnpm test:live -- extensions/ollama/ollama.live.test.ts

Kiểm thử nhanh trên đám mây chạy văn bản, luồng gốc và tìm kiếm trên web; đặt OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 để bỏ qua tìm kiếm trên web. Theo mặc định, kiểm thử bỏ qua embedding đối với https://ollama.com vì khóa API Ollama Cloud có thể không cấp quyền truy cập /api/embed; buộc chạy kiểm thử embedding bằng OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1.

Khắc phục sự cố

  • Lỗi Ollama Cloud requires an API key / Set OLLAMA_API_KEY: cung cấp khóa API đám mây thực. Dấu hiệu ollama-local chỉ dành cho máy chủ Ollama cục bộ hoặc riêng tư.
  • Lỗi mô hình không xác định: chạy openclaw models list --provider ollama-cloud và sao chép chính xác mã định danh mô hình được lưu trữ.
  • Sự cố gọi công cụ hoặc JSON thô trên máy chủ Ollama tùy chỉnh: kiểm tra xem bạn có vô tình sử dụng URL /v1 tương thích với OpenAI hay không. Các tuyến Ollama phải sử dụng URL cơ sở gốc không có hậu tố /v1.

Nội dung liên quan

Was this useful?
On this page

On this page