> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # CLI suy luận `openclaw infer` là bề mặt headless chính thức cho các quy trình suy luận có nhà cung cấp hỗ trợ. Lệnh này chủ động phơi bày các nhóm năng lực, không phải tên RPC Gateway thô và cũng không phải id công cụ tác tử thô. ## Biến infer thành một skill Sao chép và dán nội dung này vào một tác tử: ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} Đọc https://docs.openclaw.ai/cli/infer, sau đó tạo một skill định tuyến các quy trình thường dùng của tôi đến `openclaw infer`. Tập trung vào chạy mô hình, tạo ảnh, tạo video, phiên âm âm thanh, TTS, tìm kiếm web và embedding. ``` Một skill dựa trên infer tốt nên: * ánh xạ các ý định người dùng phổ biến đến đúng lệnh con infer * bao gồm một vài ví dụ infer chính thức cho các quy trình mà skill bao phủ * ưu tiên `openclaw infer ...` trong ví dụ và đề xuất * tránh ghi lại toàn bộ bề mặt infer trong phần thân skill Phạm vi điển hình của skill tập trung vào infer: * `openclaw infer model run` * `openclaw infer image generate` * `openclaw infer audio transcribe` * `openclaw infer tts convert` * `openclaw infer web search` * `openclaw infer embedding create` ## Vì sao dùng infer `openclaw infer` cung cấp một CLI nhất quán cho các tác vụ suy luận có nhà cung cấp hỗ trợ bên trong OpenClaw. Lợi ích: * Dùng các nhà cung cấp và mô hình đã được cấu hình trong OpenClaw thay vì nối các wrapper dùng một lần cho từng backend. * Giữ các quy trình về mô hình, ảnh, phiên âm âm thanh, TTS, video, web và embedding trong một cây lệnh. * Dùng dạng đầu ra `--json` ổn định cho script, tự động hóa và quy trình do tác tử điều khiển. * Ưu tiên bề mặt OpenClaw chính chủ khi tác vụ về bản chất là "chạy suy luận." * Dùng đường dẫn cục bộ thông thường mà không yêu cầu gateway cho hầu hết lệnh infer. Đối với các kiểm tra nhà cung cấp từ đầu đến cuối, ưu tiên `openclaw infer ...` sau khi các kiểm thử nhà cung cấp cấp thấp hơn đã xanh. Lệnh này thực thi CLI đã phát hành, quá trình tải cấu hình, phân giải tác tử mặc định, kích hoạt Plugin đóng gói và runtime năng lực dùng chung trước khi yêu cầu nhà cung cấp được gửi đi. ## Cây lệnh ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer list inspect model run list inspect providers auth login auth logout auth status image generate edit describe describe-many providers audio transcribe providers tts convert voices providers status enable disable set-provider video generate describe providers web search fetch providers embedding create providers ``` ## Tác vụ thường gặp Bảng này ánh xạ các tác vụ suy luận phổ biến đến lệnh infer tương ứng. | Tác vụ | Lệnh | Ghi chú | | ---------------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------- | | Chạy prompt văn bản/mô hình | `openclaw infer model run --prompt "..." --json` | Mặc định dùng đường dẫn cục bộ thông thường | | Chạy prompt mô hình trên ảnh | `openclaw infer model run --prompt "Describe this" --file ./image.png --model provider/model` | Lặp lại `--file` cho nhiều đầu vào ảnh | | Tạo ảnh | `openclaw infer image generate --prompt "..." --json` | Dùng `image edit` khi bắt đầu từ một tệp có sẵn | | Mô tả tệp ảnh hoặc URL | `openclaw infer image describe --file ./image.png --prompt "..." --json` | `--model` phải là `` hỗ trợ ảnh | | Phiên âm âm thanh | `openclaw infer audio transcribe --file ./memo.m4a --json` | `--model` phải là `` | | Tổng hợp giọng nói | `openclaw infer tts convert --text "..." --output ./speech.mp3 --json` | `tts status` hướng đến gateway | | Tạo video | `openclaw infer video generate --prompt "..." --json` | Hỗ trợ gợi ý nhà cung cấp như `--resolution` | | Mô tả tệp video | `openclaw infer video describe --file ./clip.mp4 --json` | `--model` phải là `` | | Tìm kiếm web | `openclaw infer web search --query "..." --json` | | | Tải một trang web | `openclaw infer web fetch --url https://example.com --json` | | | Tạo embedding | `openclaw infer embedding create --text "..." --json` | | ## Hành vi * `openclaw infer ...` là bề mặt CLI chính cho các quy trình này. * Dùng `--json` khi đầu ra sẽ được một lệnh hoặc script khác tiêu thụ. * Dùng `--provider` hoặc `--model provider/model` khi cần một backend cụ thể. * Dùng `model run --thinking ` để truyền mức thinking/reasoning một lần (`off`, `minimal`, `low`, `medium`, `high`, `adaptive`, `xhigh`, hoặc `max`) trong khi vẫn giữ lượt chạy ở dạng thô. * Đối với `image describe`, `audio transcribe` và `video describe`, `--model` phải dùng dạng ``. * Đối với `image describe`, `--file` chấp nhận đường dẫn cục bộ và URL ảnh HTTP(S). URL từ xa dùng chính sách SSRF tải phương tiện thông thường. * Đối với `image describe`, `--model` tường minh chạy provider/model đó trước, rồi thử `agents.defaults.imageModel.fallbacks` đã cấu hình khi lệnh gọi mô hình thất bại. Lỗi chuẩn bị đầu vào, như thiếu tệp hoặc URL không được hỗ trợ, thất bại trước các lần thử fallback. Mô hình phải hỗ trợ ảnh trong danh mục mô hình hoặc cấu hình nhà cung cấp. `codex/` chạy một lượt hiểu ảnh qua app-server Codex có giới hạn; `openai/` dùng đường dẫn nhà cung cấp OpenAI với xác thực bằng API-key hoặc OAuth ChatGPT/Codex. * Các lệnh thực thi không trạng thái mặc định dùng cục bộ. * Các lệnh trạng thái do Gateway quản lý mặc định dùng gateway. * Đường dẫn cục bộ thông thường không yêu cầu gateway đang chạy. * `model run` cục bộ là một lượt hoàn tất nhà cung cấp gọn nhẹ, một lần. Nó phân giải mô hình và xác thực tác tử đã cấu hình, nhưng không bắt đầu lượt chat-agent, tải công cụ hoặc mở máy chủ MCP đóng gói. * `model run --file` chấp nhận tệp ảnh, phát hiện loại MIME của chúng và gửi chúng cùng prompt đã cung cấp đến mô hình đã chọn. Lặp lại `--file` cho nhiều ảnh. * `model run --file` từ chối đầu vào không phải ảnh. Dùng `infer audio transcribe` cho tệp âm thanh và `infer video describe` cho tệp video. * `model run --gateway` thực thi định tuyến Gateway, xác thực đã lưu, lựa chọn nhà cung cấp và runtime nhúng, nhưng vẫn chạy như một phép dò mô hình thô: nó gửi prompt đã cung cấp và mọi tệp đính kèm ảnh mà không có bản ghi phiên trước đó, ngữ cảnh bootstrap/AGENTS, lắp ráp context-engine, công cụ hoặc máy chủ MCP đóng gói. * `model run --gateway --model ` yêu cầu thông tin xác thực gateway của toán tử đáng tin cậy vì yêu cầu đề nghị Gateway chạy một override provider/model dùng một lần. * `model run --thinking` cục bộ dùng đường dẫn hoàn tất nhà cung cấp gọn nhẹ; các mức dành riêng cho nhà cung cấp như `adaptive` và `max` được ánh xạ đến mức hoàn tất đơn giản có tính di động gần nhất. ## Mô hình Dùng `model` cho suy luận văn bản có nhà cung cấp hỗ trợ và kiểm tra mô hình/nhà cung cấp. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer model run --prompt "Reply with exactly: smoke-ok" --json openclaw infer model run --prompt "Summarize this changelog entry" --model openai/gpt-5.4 --json openclaw infer model run --prompt "Describe this image in one sentence" --file ./photo.jpg --model google/gemini-2.5-flash --json openclaw infer model run --prompt "Use more reasoning here" --thinking high --json openclaw infer model providers --json openclaw infer model inspect --name gpt-5.5 --json ``` Dùng tham chiếu `` đầy đủ để smoke-test một nhà cung cấp cụ thể mà không khởi động Gateway hoặc tải toàn bộ bề mặt công cụ tác tử: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer model run --local --model anthropic/claude-sonnet-4-6 --prompt "Reply with exactly: pong" --json openclaw infer model run --local --model cerebras/zai-glm-4.7 --prompt "Reply with exactly: pong" --json openclaw infer model run --local --model google/gemini-2.5-flash --prompt "Reply with exactly: pong" --json openclaw infer model run --local --model groq/llama-3.1-8b-instant --prompt "Reply with exactly: pong" --json openclaw infer model run --local --model mistral/mistral-medium-3-5 --prompt "Reply with exactly: pong" --json openclaw infer model run --local --model mistral/mistral-small-latest --prompt "Reply with exactly: pong" --json openclaw infer model run --local --model openai/gpt-5.5 --prompt "Reply with exactly: pong" --json openclaw infer model run --local --model ollama/qwen2.5vl:7b --prompt "Describe this image." --file ./photo.jpg --json ``` Ghi chú: * `model run` cục bộ là phép smoke CLI hẹp nhất cho tình trạng nhà cung cấp/mô hình/xác thực vì, với các nhà cung cấp không phải Codex, nó chỉ gửi prompt đã cung cấp đến mô hình đã chọn. * `model run --model ` cục bộ có thể dùng chính xác các dòng danh mục tĩnh đóng gói từ `models list --all` trước khi nhà cung cấp đó được ghi vào cấu hình. Xác thực nhà cung cấp vẫn bắt buộc; thiếu thông tin xác thực sẽ thất bại dưới dạng lỗi xác thực, không phải `Unknown model`. * Với các phép dò reasoning Mistral Medium 3.5, để temperature chưa đặt/mặc định. Mistral từ chối `reasoning_effort="high"` cộng với `temperature: 0`; dùng `mistral/mistral-medium-3-5` với temperature mặc định hoặc một giá trị chế độ reasoning khác không bằng 0, chẳng hạn `0.7`. * Các phép dò cục bộ Codex Responses là ngoại lệ hẹp: OpenClaw thêm một chỉ thị hệ thống tối thiểu để transport có thể điền trường `instructions` bắt buộc, mà không thêm đầy đủ ngữ cảnh tác tử, công cụ, bộ nhớ hoặc bản ghi phiên. * `model run --file` cục bộ giữ đường dẫn gọn nhẹ đó và đính kèm trực tiếp nội dung ảnh vào một tin nhắn người dùng duy nhất. Các tệp ảnh phổ biến như PNG, JPEG và WebP hoạt động khi loại MIME của chúng được phát hiện là `image/*`; tệp không được hỗ trợ hoặc không nhận diện được sẽ thất bại trước khi nhà cung cấp được gọi. * `model run --file` phù hợp nhất khi bạn muốn kiểm thử trực tiếp mô hình văn bản đa phương thức đã chọn. Dùng `infer image describe` khi bạn muốn lựa chọn nhà cung cấp hiểu ảnh của OpenClaw và định tuyến mô hình ảnh mặc định. * Mô hình đã chọn phải hỗ trợ đầu vào ảnh; mô hình chỉ văn bản có thể từ chối yêu cầu ở tầng nhà cung cấp. * `model run --prompt` phải chứa văn bản không chỉ gồm khoảng trắng; prompt rỗng bị từ chối trước khi nhà cung cấp cục bộ hoặc Gateway được gọi. * `model run` cục bộ thoát khác 0 khi nhà cung cấp không trả về đầu ra văn bản, vì vậy nhà cung cấp cục bộ không truy cập được và các hoàn tất rỗng sẽ không trông như phép dò thành công. * Dùng `model run --gateway` khi bạn cần kiểm thử định tuyến Gateway, thiết lập agent-runtime hoặc trạng thái nhà cung cấp do Gateway quản lý trong khi giữ đầu vào mô hình ở dạng thô. Dùng `openclaw agent` hoặc các bề mặt chat khi bạn muốn đầy đủ ngữ cảnh tác tử, công cụ, bộ nhớ và bản ghi phiên. * `model auth login`, `model auth logout` và `model auth status` quản lý trạng thái xác thực nhà cung cấp đã lưu. ## Ảnh Dùng `image` để tạo, chỉnh sửa và mô tả. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer image generate --prompt "friendly lobster illustration" --json openclaw infer image generate --prompt "cinematic product photo of headphones" --json openclaw infer image generate --model openai/gpt-image-1.5 --output-format png --background transparent --prompt "simple red circle sticker on a transparent background" --json openclaw infer image generate --model openai/gpt-image-2 --quality low --openai-moderation low --prompt "low-cost draft poster" --json openclaw infer image generate --prompt "slow image backend" --timeout-ms 180000 --json openclaw infer image edit --file ./logo.png --model openai/gpt-image-1.5 --output-format png --background transparent --prompt "keep the logo, remove the background" --json openclaw infer image edit --file ./poster.png --prompt "make this a vertical story ad" --size 2160x3840 --aspect-ratio 9:16 --resolution 4K --json openclaw infer image describe --file ./photo.jpg --json openclaw infer image describe --file https://example.com/photo.png --json openclaw infer image describe --file ./receipt.jpg --prompt "Extract the merchant, date, and total" --json openclaw infer image describe-many --file ./before.png --file ./after.png --prompt "Compare the screenshots and list visible UI changes" --json openclaw infer image describe --file ./ui-screenshot.png --model openai/gpt-5.4-mini --json openclaw infer image describe --file ./photo.jpg --model ollama/qwen2.5vl:7b --prompt "Describe the image in one sentence" --timeout-ms 300000 --json ``` Ghi chú: * Dùng `image edit` khi bắt đầu từ các tệp đầu vào hiện có. * Dùng `--size`, `--aspect-ratio`, hoặc `--resolution` với `image edit` cho các nhà cung cấp/mô hình hỗ trợ gợi ý hình học trên các chỉnh sửa ảnh tham chiếu. * Dùng `--output-format png --background transparent` với `--model openai/gpt-image-1.5` cho đầu ra PNG nền trong suốt của OpenAI; `--openai-background` vẫn có sẵn như một bí danh dành riêng cho OpenAI. Các nhà cung cấp không khai báo hỗ trợ nền sẽ báo cáo gợi ý này là một ghi đè bị bỏ qua. * Dùng `--quality low|medium|high|auto` cho các nhà cung cấp hỗ trợ gợi ý chất lượng hình ảnh, bao gồm OpenAI. OpenAI cũng chấp nhận `--openai-moderation low|auto` cho gợi ý kiểm duyệt dành riêng cho nhà cung cấp. * Dùng `image providers --json` để xác minh các nhà cung cấp hình ảnh được đóng gói kèm nào có thể được phát hiện, đã được cấu hình, được chọn, và các năng lực tạo/chỉnh sửa mà mỗi nhà cung cấp cung cấp. * Dùng `image generate --model --json` làm phép kiểm thử nhanh CLI trực tiếp hẹp nhất cho các thay đổi về tạo hình ảnh. Ví dụ: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer image providers --json openclaw infer image generate \ --model google/gemini-3.1-flash-image-preview \ --prompt "Minimal flat test image: one blue square on a white background, no text." \ --output ./openclaw-infer-image-smoke.png \ --json ``` Phản hồi JSON báo cáo `ok`, `provider`, `model`, `attempts`, và các đường dẫn đầu ra đã ghi. Khi đặt `--output`, phần mở rộng cuối cùng có thể theo loại MIME mà nhà cung cấp trả về. * Với `image describe` và `image describe-many`, dùng `--prompt` để cung cấp cho mô hình thị giác một chỉ dẫn theo tác vụ cụ thể, chẳng hạn OCR, so sánh, kiểm tra UI, hoặc tạo chú thích ngắn gọn. * Dùng `--timeout-ms` với các mô hình thị giác cục bộ chậm hoặc các lần khởi động Ollama nguội. * Với `image describe`, `--model` phải là một `` có khả năng xử lý hình ảnh. Khi được đặt, OpenClaw thử mô hình rõ ràng đó trước rồi đến các phương án dự phòng mô hình hình ảnh đã cấu hình nếu lệnh gọi mô hình thất bại. * Với các mô hình thị giác Ollama cục bộ, hãy kéo mô hình trước và đặt `OLLAMA_API_KEY` thành bất kỳ giá trị giữ chỗ nào, ví dụ `ollama-local`. Xem [Ollama](/vi/providers/ollama#vision-and-image-description). ## Âm thanh Dùng `audio` để phiên âm tệp. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer audio transcribe --file ./memo.m4a --json openclaw infer audio transcribe --file ./team-sync.m4a --language en --prompt "Focus on names and action items" --json openclaw infer audio transcribe --file ./memo.m4a --model openai/whisper-1 --json ``` Ghi chú: * `audio transcribe` dùng để phiên âm tệp, không phải để quản lý phiên thời gian thực. * `--model` phải là ``. ## TTS Dùng `tts` để tổng hợp giọng nói và trạng thái nhà cung cấp TTS. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer tts convert --text "hello from openclaw" --output ./hello.mp3 --json openclaw infer tts convert --text "Your build is complete" --output ./build-complete.mp3 --json openclaw infer tts providers --json openclaw infer tts status --json ``` Ghi chú: * `tts status` mặc định dùng gateway vì nó phản ánh trạng thái TTS do gateway quản lý. * Dùng `tts providers`, `tts voices`, và `tts set-provider` để kiểm tra và cấu hình hành vi TTS. ## Video Dùng `video` để tạo và mô tả. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer video generate --prompt "cinematic sunset over the ocean" --json openclaw infer video generate --prompt "slow drone shot over a forest lake" --resolution 768P --duration 6 --json openclaw infer video describe --file ./clip.mp4 --json openclaw infer video describe --file ./clip.mp4 --model openai/gpt-5.4-mini --json ``` Ghi chú: * `video generate` chấp nhận `--size`, `--aspect-ratio`, `--resolution`, `--duration`, `--audio`, `--watermark`, và `--timeout-ms` rồi chuyển tiếp chúng đến runtime tạo video. * `--model` phải là `` cho `video describe`. ## Web Dùng `web` cho các quy trình tìm kiếm và lấy nội dung. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer web search --query "OpenClaw docs" --json openclaw infer web search --query "OpenClaw infer web providers" --json openclaw infer web fetch --url https://docs.openclaw.ai/cli/infer --json openclaw infer web providers --json ``` Ghi chú: * Dùng `web providers` để kiểm tra các nhà cung cấp khả dụng, đã cấu hình, và được chọn. ## Embedding Dùng `embedding` để tạo vector và kiểm tra nhà cung cấp embedding. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer embedding create --text "friendly lobster" --json openclaw infer embedding create --text "customer support ticket: delayed shipment" --model openai/text-embedding-3-large --json openclaw infer embedding providers --json ``` ## Đầu ra JSON Các lệnh infer chuẩn hóa đầu ra JSON trong một phong bì dùng chung: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "ok": true, "capability": "image.generate", "transport": "local", "provider": "openai", "model": "gpt-image-2", "attempts": [], "outputs": [] } ``` Các trường cấp cao nhất ổn định: * `ok` * `capability` * `transport` * `provider` * `model` * `attempts` * `outputs` * `error` Đối với các lệnh tạo phương tiện, `outputs` chứa các tệp do OpenClaw ghi. Dùng `path`, `mimeType`, `size`, và mọi kích thước riêng theo phương tiện trong mảng đó cho tự động hóa thay vì phân tích stdout dạng dễ đọc cho con người. ## Lỗi thường gặp ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Bad openclaw infer media image generate --prompt "friendly lobster" # Good openclaw infer image generate --prompt "friendly lobster" ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Bad openclaw infer audio transcribe --file ./memo.m4a --model whisper-1 --json # Good openclaw infer audio transcribe --file ./memo.m4a --model openai/whisper-1 --json ``` ## Ghi chú * `openclaw capability ...` là một bí danh của `openclaw infer ...`. ## Liên quan * [Tham chiếu CLI](/vi/cli) * [Mô hình](/vi/concepts/models)