PAYATHON 2026

PolarClaw 能否通过 Ollama 使用本地模型？

架构老王

结论

可以尝试通过自定义模型接口，让 PolarClaw 调用 Ollama 运行的本地模型。PolarClaw 需要能够访问模型服务，接口协议和模型能力也要满足要求。

PolarDB 的 CreateApplication 文档列出了 ModelFrom=custom、ModelBaseUrl、ModelApiKey、ModelApi 和 ModelName 等参数，说明 PolarClaw 提供自定义模型接入入口。这些参数不能证明托管环境允许直接安装 Ollama，也不能保证所有 Ollama 模型都能完整支持 Agent 功能。结合 Ollama 的接口能力，可以先将模型服务部署在外部，再验证能否接入。PolarDB CreateApplication 文档

先确定模型运行在哪里

可以先在自己的电脑或服务器上安装 Ollama，下载模型并启动服务，再让 PolarClaw 访问该服务。

如果 PolarClaw 运行在云端，配置中的 localhost 或 127.0.0.1 指向 PolarClaw 自己的运行环境，而不是你的电脑。只有两者共享同一网络命名空间时，环回地址才适用。

Ollama 默认监听 127.0.0.1:11434。跨机器访问需要调整监听地址，并建立 PolarClaw 到模型主机的网络通路。具体环境变量设置方式见 Ollama FAQ。如果模型运行在家用电脑上，仅填写局域网地址通常无法让云端应用访问，还需要额外的网络连接方案。

先独立验证 Ollama 接口

以下示例用于测试 OpenAI 兼容的 Chat Completions 接口。将 YOUR_LOCAL_MODEL 替换为准备使用的实际模型名称及标签：

ollama pull YOUR_LOCAL_MODEL
ollama list

确认 Ollama 服务已启动后，在模型主机上测试：

curl http://127.0.0.1:11434/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_LOCAL_MODEL",
    "messages": [
      {"role": "user", "content": "请回复：连接成功"}
    ],
    "stream": false
  }'

Ollama 提供部分 OpenAI API 兼容能力，本地接口的基础地址为 http://localhost:11434/v1/。上述请求可以验证模型服务，但不能单独证明 PolarClaw 已完成接入。Ollama OpenAI compatibility 文档

配置 PolarClaw 的自定义模型

如果当前配置入口使用 OpenAI 兼容协议，可以参考下表填写模型相关参数。这里不是完整的创建应用请求：

参数配置思路
ModelFromcustom
ModelBaseUrlhttp://模型主机地址:11434/v1，地址必须能从 PolarClaw 运行环境访问
ModelApiopenai-completions，需确认当前入口支持该值
ModelName与 Ollama 中实际存在的模型名称及标签一致
ModelApiKey直连无鉴权的本地 Ollama 时，可在必填入口尝试使用 ollama 占位；经鉴权代理访问时填写代理要求的真实凭据

这些字段来自 PolarDB CreateApplication 文档，控制台的显示名称可能不同。Ollama 官方示例中的本地 api_key='ollama' 是客户端所需的占位值，Ollama 本身会忽略它；这不代表 PolarClaw 的所有配置入口都会接受任意值。Ollama 本地调用示例

Agent 功能还需要单独验证

普通对话成功后，还要测试工具调用、流式输出和实际任务所需的上下文长度。模型能够生成文本，并不意味着它能正确完成工具调用。

OpenClaw 当前的 Ollama 文档推荐使用原生 api: "ollama" 接口，其 baseUrl 不带 /v1。文档也提示，OpenAI 兼容模式下的工具调用存在限制。如果 PolarClaw 当前版本开放了原生 Ollama provider，可以优先核对该路径；如果只开放 OpenAI 兼容入口，就按对应协议配置并验证所需功能。不能仅凭“兼容 OpenClaw 生态”推断托管版本开放了全部 provider 配置。OpenClaw Ollama 文档

接入失败时，先检查运行环境能否访问模型地址，再检查 URL 路径、接口类型和模型名称。跨机器开放 Ollama 服务时，应限制访问来源；需要公网访问时，通过带鉴权的受控入口连接。

备注：内容仅供参考。