LM Studio

LM Studio 可在本機執行 llama.cpp（GGUF）或 MLX 模型，形式可以是 GUI 應用程式或無介面的 llmster 常駐程式。如需安裝與產品文件，請參閱 lmstudio.ai。

快速開始

lms server start --port 1234

lms daemon up

export LM_API_TOKEN="your-lm-studio-api-token"

openclaw onboard

之後若要變更預設模型：

openclaw models set lmstudio/qwen/qwen3.5-9b

LM Studio 模型金鑰使用 author/model-name 格式（例如 qwen/qwen3.5-9b）；OpenClaw 模型參照 會在前方加上提供者：lmstudio/qwen/qwen3.5-9b。若要尋找模型的確切金鑰，請執行下方 命令並查看 key 欄位：

curl http://localhost:1234/api/v1/models

非互動式初始設定

openclaw onboard --non-interactive --accept-risk --auth-choice lmstudio

或明確指定基礎 URL、模型及 API 金鑰：

openclaw onboard \  --non-interactive \  --accept-risk \  --auth-choice lmstudio \  --custom-base-url http://localhost:1234/v1 \  --lmstudio-api-key "$LM_API_TOKEN" \  --custom-model-id qwen/qwen3.5-9b

--custom-model-id 接受 LM Studio 所傳回的模型金鑰（例如 qwen/qwen3.5-9b），不含 lmstudio/ 提供者前綴。對於需要驗證的伺服器，請傳入 --lmstudio-api-key（或設定 LM_API_TOKEN）； 對於不需要驗證的伺服器，請省略此項，OpenClaw 會改為儲存本機的非機密標記。 為維持相容性，仍接受 --custom-api-key，但建議使用 --lmstudio-api-key。

這會寫入 models.providers.lmstudio，並將預設模型設為 lmstudio/<custom-model-id>。 提供 API 金鑰也會寫入 lmstudio:default 驗證設定檔。

互動式設定還可以提示選擇偏好的載入上下文長度，並將其套用至儲存在設定中的所有已探索模型。

設定

串流用量相容性

LM Studio 不一定會在串流回應中發出符合 OpenAI 格式的 usage 物件。OpenClaw 會改從 llama.cpp 樣式的 timings.prompt_n／timings.predicted_n 中繼資料 復原權杖計數。任何解析為本機端點（回送主機）的 OpenAI 相容端點都會使用相同的 備援機制，因此也涵蓋 vLLM、SGLang、llama.cpp、LocalAI、Jan、TabbyAPI 及 text-generation-webui 等其他本機後端。

思考相容性

當 LM Studio 的 /api/v1/models 探索結果回報模型專屬的推理選項時，OpenClaw 會在模型相容性中繼資料中公開對應的 reasoning_effort 值（none、minimal、low、medium、high、xhigh）。 某些 LM Studio 組建版本會公告二元 UI 選項（allowed_options: ["off", "on"]），卻在 /v1/chat/completions 上拒絕這些常值； OpenClaw 會先將該二元形式正規化為六級尺度，再傳送要求，這也適用於仍含有 off／on 推理對應表的舊版已儲存設定。

明確設定

{  models: {    providers: {      lmstudio: {        baseUrl: "http://localhost:1234/v1",        apiKey: "${LM_API_TOKEN}",        api: "openai-completions",        models: [          {            id: "qwen/qwen3-coder-next",            name: "Qwen 3 Coder Next",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 128000,            maxTokens: 8192,          },        ],      },    },  },}

停用預先載入

LM Studio 支援即時（JIT）模型載入，可在首次要求時載入模型。OpenClaw 預設會透過 LM Studio 的原生載入端點預先載入模型，這在停用 JIT 時很有幫助。 若要改由 LM Studio 的 JIT、閒置 TTL 及自動逐出行為管理模型生命週期， 請停用 OpenClaw 的預先載入步驟：

{  models: {    providers: {      lmstudio: {        baseUrl: "http://localhost:1234/v1",        api: "openai-completions",        params: { preload: false },        models: [{ id: "qwen/qwen3.5-9b" }],      },    },  },}

區域網路或 tailnet 主機

使用可連線至 LM Studio 主機的位址、保留 /v1，並確認該機器上的 LM Studio 不只繫結至回送介面：

{  models: {    providers: {      lmstudio: {        baseUrl: "http://gpu-box.local:1234/v1",        apiKey: "lmstudio",        api: "openai-completions",        models: [{ id: "qwen/qwen3.5-9b" }],      },    },  },}

lmstudio 會自動信任其已設定的端點以傳送模型要求，包括回送、區域網路及 tailnet 主機 （中繼資料／鏈路本機來源除外）。任何自訂／本機 OpenAI 相容提供者項目都會獲得相同的精確來源信任。 傳送至其他私人主機或連接埠的要求仍需使用 models.providers.<id>.request.allowPrivateNetwork: true；將其設為 false 即可選擇停用預設信任。

疑難排解

未偵測到 LM Studio

確認 LM Studio 正在執行：

lms server start --port 1234

如果已啟用驗證，也請設定 LM_API_TOKEN。確認 API 可連線：

curl http://localhost:1234/api/v1/models

驗證錯誤（HTTP 401）

• 確認 LM_API_TOKEN 與 LM Studio 中設定的金鑰相符。
• 請參閱 LM Studio 驗證。
• 如果伺服器不需要驗證，請在設定期間將金鑰留空。

相關內容

• 模型選擇
• Ollama
• 本機模型