OpenClaw本地云端Agent落地踩坑全记录

笔记本电脑

Windows

一、前言

这是一份从「完全跑不通」到「对话 + 工具调用全流程跑通」的实战踩坑记录，专门写给想体验 OpenClaw 的新手。我会把所有踩过的坑、关键结论、正确操作和避坑指南一次性说透，帮你省下几天的试错时间。

二、整体流程概览

我这次的核心目标是：

让 OpenClaw 正常跑通「对话 + 工具调用」的完整 Agent 功能。

踩坑过程分为 3 个阶段：

本地 Ollama 模型兼容踩坑（qwen2.5:3b/7b/14b 系列）

云端免费模型申请与配置（Qwen）

配置文件修复与 Bootstrap 引导流程落地

三、阶段 1：本地 Ollama 模型踩坑（最大的误区）

1. 核心误区：不是硬件不行，是模型和 OpenClaw 不兼容

很多人会误以为 “本地跑不动就是电脑配置差”，但实际核心原因是：

普通 qwen2.5-instruct 模型原生不支持 OpenClaw 的thinking和工具调用协议

OpenClaw 默认会给所有模型开启 thinking: true，不兼容的模型会直接报 does not support thinking，导致对话流程中断

就算强行关闭功能，图形化部署工具会自动回滚配置，修改永远不生效

2. 关键踩坑记录

操作	现象	结论
`qwen2.5:3b/7b` 配置后 OpenClaw 不回复	日志报 `does not support thinking`，超时重试	普通 `instruct` 模型不兼容 OpenClaw 的高级功能
手动修改 `openclaw.json` 加 `capabilities`	配置自动回滚，重启后依然报错	服务锁定了配置文件，不允许手动修改
拉取 `qwen2.5:7b-tool` 模型	Ollama 提示 `file does not exist`	官方没有这个标签，正确的模型标签不支持工具调用
`qwen2.5:14b` 模型配置后超时	日志报 `llm-idle-timeout`，CMD 里却秒回	OpenClaw 的 Agent 请求太重，14B 模型在 CPU 上推理超时

3. 本地模型的正确结论

仅支持 Ollama 原生兼容工具调用的模型（如 deepseek-r1 部分版本），但这类模型在 CPU 上也容易超时

想要在 OpenClaw 里正常对话，本地模型必须满足两个条件：

新手不建议直接上本地模型，先跑通云端模型验证流程，再回头折腾本地模型更高效

四、阶段 2：云端免费模型申请与配置（零成本快速跑通）

1. 为什么优先选云端模型？

不用折腾本地模型兼容问题，只要配置正确就能直接跑通

响应速度不受本地硬件限制，不会出现超时

免费额度足够日常使用，适合新手体验完整 Agent 功能

2. 推荐方案：阿里Qwen

配置步骤如下：

申请 API Key：注册后即可创建免费 API Key

在 OpenClaw 自动部署工具图形界面选择「国内 → Qwen / 百练」，填写 API Key 即可添加

配置后重启网关，直接就能使用

看一下我的阿里模型

看一下openclaw的模型配置，我用的是qwen3.6-plus

五、阶段 3：配置文件修复与 Bootstrap 引导流程

1. 配置文件自动回滚问题

这是新手最容易遇到的坑：坚决不在豆包的指引下去直接改后台配置文件，用自动部署工具去改。避免引入其它错误。

2. Bootstrap 引导流程卡住

现象：聊天窗口一直提示 Bootstrap pending，无法正常对话

原因：配置文件错误导致初始化流程无法完成，OpenClaw 会一直停留在引导阶段

解决方法：

六、最终跑通的关键步骤（按顺序执行）

根据自动部署工具提供的厂商清单申请API（之前也试过好几个，Deepseek的提示要收费）。

自动部署工具配置，对应位置填写 API Key。

重启 OpenClaw 网关，确认日志无报错

测试对话和工具调用功能，验证全流程跑通

电脑版对话效果展示

手机版对话效果展示

七、给新手的避坑指南

先云端，后本地

不要一开始就折腾本地模型，先跑通云端模型验证流程，再回头优化本地配置。

图形化部署工具

一键部署工具配置、看日志、重启服务等操作。

超时问题优先看请求，不是硬件

OpenClaw 的 Agent 请求比普通对话重很多，超时大多是配置或模型兼容问题，不是电脑性能问题

八、结语

OpenClaw 是一个功能强大的本地 / 云端 Agent 框架，但新手很容易在模型兼容、配置文件和引导流程上踩坑。这份记录希望能帮你避开这些误区，快速跑通完整的 Agent 功能。如果你也在折腾 OpenClaw，欢迎参考这份经验，少走弯路。