LM Studio 是本地模型运行工具,提供 OpenAI 兼容 API,适合在本机运行开源模型。

默认端口:http://127.0.0.1:1234

快速启动

  1. 下载并安装 LM Studio
  2. 在 LM Studio 中下载模型并启动本地服务器
  3. 在 OpenClaw 中配置:
model: lmstudio/your-model-name

非交互式配置

适合 CI/脚本场景,跳过交互式选择:

providers:
  lmstudio:
    url: http://127.0.0.1:1234
    model: lmstudio/llama-3.2-3b-instruct

流式兼容性

LM Studio 支持流式输出,与 OpenClaw 的流式模式兼容:

stream: true

部分旧版本模型可能存在流式兼容问题,建议升级 LM Studio 到最新版本。

思考(Thinking)兼容性

支持带思考过程的推理模型(如 QwQ、DeepSeek-R1 本地版):

model: lmstudio/qwq-32b
thinking: true

显式配置

providers:
  lmstudio:
    url: http://127.0.0.1:1234
    api_key: lm-studio  # LM Studio 不校验 key,填任意值即可

故障排除

问题解决方案
连接失败确认 LM Studio 服务器已启动,端口 1234 可访问
模型未找到检查模型名称与 LM Studio 中显示的一致
流式中断尝试关闭流式模式 stream: false
响应慢检查上下文窗口设置,适当减小 context_window

相关链接