本地模型
本地部署是可行的,但 OpenClaw 需要大 Context 窗口和强大的 Prompt 注入防护。小显存会截断 Context 并降低安全性。建议配置:≥2 台顶配 Mac Studio 或同等 GPU 设备(约 $30k+)。单张 24 GB 显卡只能处理较轻的 Prompt,且延迟更高。使用你能运行的最大/完整版本模型;过度量化或”小型”版本会增加 Prompt 注入风险(参见安全)。
推荐方案:LM Studio + MiniMax M2.1(Responses API,完整版)
目前最佳的本地方案。在 LM Studio 中加载 MiniMax M2.1,启用本地服务器(默认 http://127.0.0.1:1234),使用 Responses API 将推理过程与最终文本分离。
{
agents: {
defaults: {
model: { primary: "lmstudio/minimax-m2.1-gs32" },
models: {
"anthropic/claude-opus-4-5": { alias: "Opus" },
"lmstudio/minimax-m2.1-gs32": { alias: "Minimax" },
},
},
},
models: {
mode: "merge",
providers: {
lmstudio: {
baseUrl: "http://127.0.0.1:1234/v1",
apiKey: "lmstudio",
api: "openai-responses",
models: [
{
id: "minimax-m2.1-gs32",
name: "MiniMax M2.1 GS32",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 196608,
maxTokens: 8192,
},
],
},
},
},
}
配置清单
- 安装 LM Studio:https://lmstudio.ai
- 在 LM Studio 中下载最大的 MiniMax M2.1 版本(避免”小型”/重度量化版本),启动服务器,确认
http://127.0.0.1:1234/v1/models能列出模型。 - 保持模型加载状态;冷启动会增加延迟。
- 如果你的 LM Studio 版本不同,调整
contextWindow/maxTokens。 - 对于 WhatsApp,使用 Responses API 以便只发送最终文本。
即使运行本地模型,也要保留云端模型配置;使用 models.mode: "merge" 让备用模型保持可用。
混合配置:云端主力,本地备用
{
agents: {
defaults: {
model: {
primary: "anthropic/claude-sonnet-4-5",
fallbacks: ["lmstudio/minimax-m2.1-gs32", "anthropic/claude-opus-4-5"],
},
models: {
"anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
"lmstudio/minimax-m2.1-gs32": { alias: "MiniMax Local" },
"anthropic/claude-opus-4-5": { alias: "Opus" },
},
},
},
models: {
mode: "merge",
providers: {
lmstudio: {
baseUrl: "http://127.0.0.1:1234/v1",
apiKey: "lmstudio",
api: "openai-responses",
models: [
{
id: "minimax-m2.1-gs32",
name: "MiniMax M2.1 GS32",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 196608,
maxTokens: 8192,
},
],
},
},
},
}
本地优先,云端兜底
交换主力和备用的顺序;保持相同的 providers 配置和 models.mode: "merge",这样本地服务器宕机时可以回退到 Sonnet 或 Opus。
区域托管 / 数据路由
- OpenRouter 上也有托管的 MiniMax/Kimi/GLM 版本,提供区域固定端点(如美国托管)。选择区域版本可以让流量留在你选择的管辖区,同时仍可使用
models.mode: "merge"回退到 Anthropic/OpenAI。 - 纯本地部署是最强的隐私方案;托管区域路由是需要 Provider 功能但想控制数据流向时的折中方案。
其他兼容 OpenAI 的本地代理
vLLM、LiteLLM、OAI-proxy 或自定义 Gateway 都可以,只要它们提供 OpenAI 风格的 /v1 端点。用你的端点和模型 ID 替换上面的 provider 配置:
{
models: {
mode: "merge",
providers: {
local: {
baseUrl: "http://127.0.0.1:8000/v1",
apiKey: "sk-local",
api: "openai-responses",
models: [
{
id: "my-local-model",
name: "Local Model",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 120000,
maxTokens: 8192,
},
],
},
},
},
}
保持 models.mode: "merge" 让云端模型作为备用保持可用。
故障排除
- Gateway 能访问代理吗?运行
curl http://127.0.0.1:1234/v1/models。 - LM Studio 模型卸载了?重新加载;冷启动是常见的”卡住”原因。
- Context 错误?降低
contextWindow或提高服务器限制。 - 安全:本地模型跳过 Provider 侧的过滤;保持 Agent 范围窄小并开启 Compaction 以限制 Prompt 注入的影响范围。