1. 为什么要在本地跑 OpenClaw第一次看到 OpenClaw 这个名字很多人会愣一下——它之前叫 Clawdbot后来又改叫 Moltbot几经更名但核心定位一直没变一个跑在自己机器上的 AI 助手网关。你可以把它理解成一个“中转站”一边连着各种聊天平台比如微信、Telegram、Discord另一边连着你自己的大模型服务本地 Ollama、LM Studio或者云端 API中间的消息路由、会话管理、工具调用全由它来协调。那为什么不直接用网页版原因很实在。第一数据不出本机。你和大模型的每一句对话、每一个上传的文件都留在自己的硬盘上不经过任何第三方服务器。第二可控。模型想换就换提示词想改就改工具想加就加不用看别人脸色。第三离线可用。断网了照样能跑只要模型在本地。第四成本可控。本地跑开源模型电费就是全部开销不像 API 那样按 token 计费用多了心疼。这篇指南面向的是想在自己电脑上把 OpenClaw 跑起来的人。不管你用的是 Windows、macOS 还是 Linux不管你之前有没有部署过类似的东西只要跟着步骤走半小时内应该能看到它跑起来。我会把踩过的坑、绕过的弯都写清楚尤其是 WSL2 环境检测失败、Node.js 版本不匹配这两个高频问题会重点展开。提示OpenClaw 本身不包含大模型它只是个“壳”。你需要额外准备一个模型服务本地 Ollama 是最省事的选择后面会详细讲怎么对接。2. 部署前的环境准备与选型思路2.1 硬件与操作系统的实际门槛OpenClaw 本身对硬件要求不高它是个 Node.js 应用内存占用通常在几百 MB 级别。真正吃资源的是背后的大模型。如果你打算本地跑模型显存或内存至少要 8GB 起步跑 7B 参数的量化模型勉强够用16GB 以上会舒服很多能跑 13B 甚至更大的模型。如果只是把 OpenClaw 当网关模型走云端 API那老笔记本也能跑。操作系统方面三个平台都支持但体验有差异。macOS 最省心Node.js 装好基本就能跑。Linux 次之依赖管理清晰。Windows 最麻烦因为 OpenClaw 的某些依赖在纯 Windows 环境下会有兼容问题官方推荐用 WSL2Windows Subsystem for Linux 2。这就引出了后面要重点讲的 WSL2 环境检测问题。我个人的建议是如果你用 Windows别折腾纯 Windows 部署直接上 WSL2。虽然多一层但省去的麻烦远大于多出来的那点配置成本。如果你用 macOS注意芯片架构M 系列芯片和 Intel 芯片在装某些依赖时命令不一样。Linux 用户基本无障碍注意发行版差异即可。2.2 Node.js 版本选择为什么必须是 18 以上OpenClaw 明确要求 Node.js 18。这不是随便定的因为它的代码里用到了node:util模块的一些新导出这些导出在 Node.js 16 及以下版本里不存在。如果你硬用低版本跑会直接报错SyntaxError: The requested module node:util does not provide an export named xxx这个报错很典型看到它基本就是 Node.js 版本太低。解决办法只有一个升级到 18 或更高。目前 Node.js 的 LTS 版本是 20 和 22建议直接装 20 或 22别装奇数版本如 21、23奇数版本是非 LTS稳定性差一些。那要不要装最新的 24可以但没必要。Node.js 24 目前还在早期阶段某些 npm 包可能还没适配。稳妥起见20 LTS 或 22 LTS 是最佳选择。安装方式后面会分平台讲。注意如果你机器上已经装了旧版 Node.js别直接覆盖安装先用node -v确认当前版本再用版本管理工具如 nvm切换避免把系统里其他依赖 Node.js 的项目搞崩。2.3 模型服务的选型Ollama 还是 LM StudioOpenClaw 需要对接一个模型服务。常见的选择有两个Ollama 和 LM Studio。Ollama 的优势是命令行友好安装后一条命令就能拉模型、跑服务适合喜欢终端操作的人。它默认监听http://localhost:11434OpenClaw 配置里填这个地址就行。LM Studio 的优势是图形界面模型管理直观适合不习惯命令行的人。它默认监听http://localhost:1234同样在 OpenClaw 里配置即可。两者都支持 OpenAI 兼容的 API 格式所以 OpenClaw 对接起来没区别。我的建议是如果你只是想让 OpenClaw 跑起来选 Ollama因为它更轻量启动更快。如果你打算频繁切换模型、对比效果LM Studio 的界面会更方便。至于跑哪个模型7B 级别的量化模型如 Qwen2.5 7B、Llama 3.1 8B在 8GB 显存上能跑13B 需要 12GB 以上30B 以上基本要 24GB 显存或更多内存。如果硬件不够就别硬撑直接走云端 APIOpenClaw 同样支持。3. 分平台安装 Node.js 与依赖3.1 macOS 下的安装步骤macOS 装 Node.js 最推荐的方式是用 Homebrew。如果你还没装 Homebrew先装它/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)装完 Homebrew 后装 Node.jsbrew install node22这里指定node22是为了装 LTS 版本。装完后验证node -v npm -v如果显示v22.x.x和对应的 npm 版本就成功了。如果显示的是旧版本可能是 PATH 没更新执行brew link node22 --force再试。M 系列芯片和 Intel 芯片在 Homebrew 上没区别Homebrew 会自动处理架构。但如果你之前用 Rosetta 装过 x86 版本的 Homebrew可能会有冲突建议统一用原生版本。3.2 Windows 下的 WSL2 环境搭建Windows 用户请直接上 WSL2。步骤分三步启用 WSL2、装 Ubuntu、在 Ubuntu 里装 Node.js。第一步以管理员身份打开 PowerShell执行wsl --install这条命令会自动启用 WSL2 并安装 Ubuntu。执行完重启电脑。重启后 Ubuntu 会自动启动让你设置用户名和密码。第二步进入 Ubuntu 后先更新包列表sudo apt update sudo apt upgrade -y第三步装 Node.js。别用apt install nodejs那个版本太旧。用 NodeSource 的源curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs装完验证node -v应该显示v22.x.x。这里有个高频坑OpenClaw 启动时会检测 WSL2 环境如果检测失败会报could not safely verify the wsl2 environment。这个报错通常是因为 WSL2 的某些系统文件权限不对或者/proc/version里的信息不符合预期。解决办法后面在问题排查章节详细讲。3.3 Linux 下的安装与权限处理Linux 发行版太多这里以 Ubuntu/Debian 为例。和 WSL2 里一样用 NodeSource 源curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejsCentOS/RHEL 系用curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash - sudo yum install -y nodejsLinux 下装全局 npm 包时可能会遇到权限问题因为默认全局目录在/usr/lib/node_modules普通用户没写权限。解决办法有两个一是用sudo但不推荐容易搞乱权限二是改 npm 全局目录到用户目录mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc这样以后npm install -g就不需要 sudo 了。4. 安装与配置 OpenClaw4.1 安装 OpenClaw 的两种方式OpenClaw 的安装有两种方式全局 npm 安装和源码安装。全局安装最省事npm install -g openclaw装完后openclaw命令就能直接用了。但这种方式装的是发布版可能不是最新的。如果你想用最新代码用源码安装git clone https://github.com/openclaw/openclaw.git cd openclaw npm install npm run build源码安装的好处是能自己改代码、能第一时间用上新功能坏处是每次更新都要手动 pull 再 build。我个人的习惯是日常用全局安装想折腾新功能时再切源码。安装过程中如果卡在某个包下载不动大概率是网络问题。可以换 npm 源npm config set registry https://registry.npmmirror.com换完再装速度会快很多。4.2 初始化配置与模型对接装完后第一次运行OpenClaw 会引导你做初始化配置。执行openclaw init它会问你几个问题用什么模型服务、API 地址是什么、要不要启用某些工具。如果你用 Ollama模型服务选ollama地址填http://localhost:11434。如果你用 LM Studio选openai-compatible地址填http://localhost:1234/v1。配置会写到一个配置文件里通常在~/.openclaw/config.json。你也可以手动改这个文件。一个典型的配置长这样{ model: { provider: ollama, baseUrl: http://localhost:11434, modelName: qwen2.5:7b }, channels: { telegram: { enabled: false } } }改完配置后启动 OpenClawopenclaw start如果一切正常你会看到它输出监听地址和端口默认是http://localhost:3000。打开浏览器访问这个地址就能看到 Web 界面。4.3 对接聊天平台的注意事项OpenClaw 支持对接多个聊天平台但每个平台的配置方式不一样。以 Telegram 为例你需要在 Telegram 里找 BotFather 创建一个 bot拿到 token填到配置里。微信的对接更复杂因为微信没有官方 bot API通常需要借助一些第三方方案稳定性参差不齐。这里要提醒一句对接聊天平台时注意隐私边界。虽然 OpenClaw 跑在本地但消息要经过平台服务器转发。如果你对隐私要求极高建议只用 Web 界面别对接外部平台。另外OpenClaw 的二维码功能用于某些平台的扫码登录在本地部署时可能会因为网络问题加载不出来。如果遇到检查一下是否能正常访问外网或者手动输入 token 代替扫码。5. 高频问题排查与避坑实录5.1 WSL2 环境检测失败的三种解法could not safely verify the wsl2 environment这个报错在 Windows 用户里出现频率极高。根本原因是 OpenClaw 启动时会读/proc/version和/proc/sys/kernel/osrelease来判断是不是 WSL2 环境如果读不到或者内容不符合预期就报这个错。解法一确认你确实在 WSL2 里而不是 WSL1。在 PowerShell 里执行wsl -l -v看 VERSION 列是不是 2。如果是 1执行wsl --set-version Ubuntu 2升级。解法二检查/proc/version是否可读。在 WSL2 里执行cat /proc/version如果报权限错误说明挂载有问题。执行sudo mount -t proc proc /proc重新挂载。解法三如果前两个都没问题可能是 OpenClaw 的检测逻辑太严格。可以临时跳过检测在启动命令前加环境变量OPENCLAW_SKIP_WSL_CHECK1 openclaw start这个变量不是官方文档里的是我在实际排查时发现的能绕过检测。但要注意跳过检测后某些依赖 WSL2 特性的功能可能不正常比如文件监听。5.2 Node.js 版本报错的识别与处理前面提过node:util的报错这里再补充几个常见的 Node.js 版本相关问题。报错node.js v24.21.0 is not yet released or is not available这通常是你用了 nvm 之类的版本管理工具但指定的版本号不存在。检查一下版本号有没有打错或者用nvm ls-remote看看有哪些可用版本。报错Cannot find module xxx可能是 npm 包没装全。在 OpenClaw 目录下执行npm install重新装依赖。如果还不行删掉node_modules和package-lock.json再装。报错EACCES: permission denied这是权限问题参考前面 Linux 章节改 npm 全局目录。5.3 模型连接失败与超时排查OpenClaw 启动后如果连不上模型界面会一直转圈或者报超时。排查步骤第一步确认模型服务在跑。Ollama 的话执行ollama list看模型在不在curl http://localhost:11434/api/tags看服务通不通。LM Studio 的话看界面里服务有没有启动。第二步确认地址填对了。Ollama 默认11434LM Studio 默认1234别填混。如果模型服务和 OpenClaw 不在同一台机器地址要填局域网 IP不是localhost。第三步确认模型名对得上。Ollama 里模型名是qwen2.5:7b这种格式LM Studio 里是模型文件的名字别写错。第四步如果都对了还连不上看防火墙。Windows 防火墙可能拦了11434端口在防火墙里放行即可。5.4 常见问题速查表报错信息可能原因解决办法could not safely verify the wsl2 environmentWSL2 检测失败确认 WSL2 版本、检查 /proc 挂载、或跳过检测node:util does not provide an export namedNode.js 版本低于 18升级到 Node.js 20 或 22 LTSEACCES: permission deniednpm 全局目录权限不足改 npm prefix 到用户目录模型连接超时地址或端口填错、服务未启动检查模型服务状态和配置地址二维码加载不出来网络问题或平台限制检查外网访问或手动输入 tokenCannot find module依赖未装全删 node_modules 重装提示遇到报错先看完整错误信息别只看最后一行。Node.js 的报错堆栈里最上面几行往往才是根因。6. 跑起来之后能做什么OpenClaw 跑起来后最直接的用法是在 Web 界面里和大模型对话。但它的价值不止于此。你可以配置多个模型让不同的对话走不同的模型可以启用工具调用让模型能查天气、算数学、读文件可以对接聊天平台把 AI 助手变成随时能聊的伙伴。如果你打算长期用建议做几件事一是把配置备份好尤其是 API key 和平台 token二是定期更新 OpenClawnpm update -g openclaw就行三是关注日志OpenClaw 的日志在~/.openclaw/logs下出问题时先看日志。最后分享一个小技巧如果你觉得本地模型响应慢可以在配置里调maxTokens和temperature降低生成长度、调低随机性响应会快不少。这个参数在 Ollama 和 LM Studio 里都支持OpenClaw 配置里透传即可。
OpenClaw本地部署指南：环境配置、模型对接与高频问题排查
1. 为什么要在本地跑 OpenClaw第一次看到 OpenClaw 这个名字很多人会愣一下——它之前叫 Clawdbot后来又改叫 Moltbot几经更名但核心定位一直没变一个跑在自己机器上的 AI 助手网关。你可以把它理解成一个“中转站”一边连着各种聊天平台比如微信、Telegram、Discord另一边连着你自己的大模型服务本地 Ollama、LM Studio或者云端 API中间的消息路由、会话管理、工具调用全由它来协调。那为什么不直接用网页版原因很实在。第一数据不出本机。你和大模型的每一句对话、每一个上传的文件都留在自己的硬盘上不经过任何第三方服务器。第二可控。模型想换就换提示词想改就改工具想加就加不用看别人脸色。第三离线可用。断网了照样能跑只要模型在本地。第四成本可控。本地跑开源模型电费就是全部开销不像 API 那样按 token 计费用多了心疼。这篇指南面向的是想在自己电脑上把 OpenClaw 跑起来的人。不管你用的是 Windows、macOS 还是 Linux不管你之前有没有部署过类似的东西只要跟着步骤走半小时内应该能看到它跑起来。我会把踩过的坑、绕过的弯都写清楚尤其是 WSL2 环境检测失败、Node.js 版本不匹配这两个高频问题会重点展开。提示OpenClaw 本身不包含大模型它只是个“壳”。你需要额外准备一个模型服务本地 Ollama 是最省事的选择后面会详细讲怎么对接。2. 部署前的环境准备与选型思路2.1 硬件与操作系统的实际门槛OpenClaw 本身对硬件要求不高它是个 Node.js 应用内存占用通常在几百 MB 级别。真正吃资源的是背后的大模型。如果你打算本地跑模型显存或内存至少要 8GB 起步跑 7B 参数的量化模型勉强够用16GB 以上会舒服很多能跑 13B 甚至更大的模型。如果只是把 OpenClaw 当网关模型走云端 API那老笔记本也能跑。操作系统方面三个平台都支持但体验有差异。macOS 最省心Node.js 装好基本就能跑。Linux 次之依赖管理清晰。Windows 最麻烦因为 OpenClaw 的某些依赖在纯 Windows 环境下会有兼容问题官方推荐用 WSL2Windows Subsystem for Linux 2。这就引出了后面要重点讲的 WSL2 环境检测问题。我个人的建议是如果你用 Windows别折腾纯 Windows 部署直接上 WSL2。虽然多一层但省去的麻烦远大于多出来的那点配置成本。如果你用 macOS注意芯片架构M 系列芯片和 Intel 芯片在装某些依赖时命令不一样。Linux 用户基本无障碍注意发行版差异即可。2.2 Node.js 版本选择为什么必须是 18 以上OpenClaw 明确要求 Node.js 18。这不是随便定的因为它的代码里用到了node:util模块的一些新导出这些导出在 Node.js 16 及以下版本里不存在。如果你硬用低版本跑会直接报错SyntaxError: The requested module node:util does not provide an export named xxx这个报错很典型看到它基本就是 Node.js 版本太低。解决办法只有一个升级到 18 或更高。目前 Node.js 的 LTS 版本是 20 和 22建议直接装 20 或 22别装奇数版本如 21、23奇数版本是非 LTS稳定性差一些。那要不要装最新的 24可以但没必要。Node.js 24 目前还在早期阶段某些 npm 包可能还没适配。稳妥起见20 LTS 或 22 LTS 是最佳选择。安装方式后面会分平台讲。注意如果你机器上已经装了旧版 Node.js别直接覆盖安装先用node -v确认当前版本再用版本管理工具如 nvm切换避免把系统里其他依赖 Node.js 的项目搞崩。2.3 模型服务的选型Ollama 还是 LM StudioOpenClaw 需要对接一个模型服务。常见的选择有两个Ollama 和 LM Studio。Ollama 的优势是命令行友好安装后一条命令就能拉模型、跑服务适合喜欢终端操作的人。它默认监听http://localhost:11434OpenClaw 配置里填这个地址就行。LM Studio 的优势是图形界面模型管理直观适合不习惯命令行的人。它默认监听http://localhost:1234同样在 OpenClaw 里配置即可。两者都支持 OpenAI 兼容的 API 格式所以 OpenClaw 对接起来没区别。我的建议是如果你只是想让 OpenClaw 跑起来选 Ollama因为它更轻量启动更快。如果你打算频繁切换模型、对比效果LM Studio 的界面会更方便。至于跑哪个模型7B 级别的量化模型如 Qwen2.5 7B、Llama 3.1 8B在 8GB 显存上能跑13B 需要 12GB 以上30B 以上基本要 24GB 显存或更多内存。如果硬件不够就别硬撑直接走云端 APIOpenClaw 同样支持。3. 分平台安装 Node.js 与依赖3.1 macOS 下的安装步骤macOS 装 Node.js 最推荐的方式是用 Homebrew。如果你还没装 Homebrew先装它/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)装完 Homebrew 后装 Node.jsbrew install node22这里指定node22是为了装 LTS 版本。装完后验证node -v npm -v如果显示v22.x.x和对应的 npm 版本就成功了。如果显示的是旧版本可能是 PATH 没更新执行brew link node22 --force再试。M 系列芯片和 Intel 芯片在 Homebrew 上没区别Homebrew 会自动处理架构。但如果你之前用 Rosetta 装过 x86 版本的 Homebrew可能会有冲突建议统一用原生版本。3.2 Windows 下的 WSL2 环境搭建Windows 用户请直接上 WSL2。步骤分三步启用 WSL2、装 Ubuntu、在 Ubuntu 里装 Node.js。第一步以管理员身份打开 PowerShell执行wsl --install这条命令会自动启用 WSL2 并安装 Ubuntu。执行完重启电脑。重启后 Ubuntu 会自动启动让你设置用户名和密码。第二步进入 Ubuntu 后先更新包列表sudo apt update sudo apt upgrade -y第三步装 Node.js。别用apt install nodejs那个版本太旧。用 NodeSource 的源curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs装完验证node -v应该显示v22.x.x。这里有个高频坑OpenClaw 启动时会检测 WSL2 环境如果检测失败会报could not safely verify the wsl2 environment。这个报错通常是因为 WSL2 的某些系统文件权限不对或者/proc/version里的信息不符合预期。解决办法后面在问题排查章节详细讲。3.3 Linux 下的安装与权限处理Linux 发行版太多这里以 Ubuntu/Debian 为例。和 WSL2 里一样用 NodeSource 源curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejsCentOS/RHEL 系用curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash - sudo yum install -y nodejsLinux 下装全局 npm 包时可能会遇到权限问题因为默认全局目录在/usr/lib/node_modules普通用户没写权限。解决办法有两个一是用sudo但不推荐容易搞乱权限二是改 npm 全局目录到用户目录mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc这样以后npm install -g就不需要 sudo 了。4. 安装与配置 OpenClaw4.1 安装 OpenClaw 的两种方式OpenClaw 的安装有两种方式全局 npm 安装和源码安装。全局安装最省事npm install -g openclaw装完后openclaw命令就能直接用了。但这种方式装的是发布版可能不是最新的。如果你想用最新代码用源码安装git clone https://github.com/openclaw/openclaw.git cd openclaw npm install npm run build源码安装的好处是能自己改代码、能第一时间用上新功能坏处是每次更新都要手动 pull 再 build。我个人的习惯是日常用全局安装想折腾新功能时再切源码。安装过程中如果卡在某个包下载不动大概率是网络问题。可以换 npm 源npm config set registry https://registry.npmmirror.com换完再装速度会快很多。4.2 初始化配置与模型对接装完后第一次运行OpenClaw 会引导你做初始化配置。执行openclaw init它会问你几个问题用什么模型服务、API 地址是什么、要不要启用某些工具。如果你用 Ollama模型服务选ollama地址填http://localhost:11434。如果你用 LM Studio选openai-compatible地址填http://localhost:1234/v1。配置会写到一个配置文件里通常在~/.openclaw/config.json。你也可以手动改这个文件。一个典型的配置长这样{ model: { provider: ollama, baseUrl: http://localhost:11434, modelName: qwen2.5:7b }, channels: { telegram: { enabled: false } } }改完配置后启动 OpenClawopenclaw start如果一切正常你会看到它输出监听地址和端口默认是http://localhost:3000。打开浏览器访问这个地址就能看到 Web 界面。4.3 对接聊天平台的注意事项OpenClaw 支持对接多个聊天平台但每个平台的配置方式不一样。以 Telegram 为例你需要在 Telegram 里找 BotFather 创建一个 bot拿到 token填到配置里。微信的对接更复杂因为微信没有官方 bot API通常需要借助一些第三方方案稳定性参差不齐。这里要提醒一句对接聊天平台时注意隐私边界。虽然 OpenClaw 跑在本地但消息要经过平台服务器转发。如果你对隐私要求极高建议只用 Web 界面别对接外部平台。另外OpenClaw 的二维码功能用于某些平台的扫码登录在本地部署时可能会因为网络问题加载不出来。如果遇到检查一下是否能正常访问外网或者手动输入 token 代替扫码。5. 高频问题排查与避坑实录5.1 WSL2 环境检测失败的三种解法could not safely verify the wsl2 environment这个报错在 Windows 用户里出现频率极高。根本原因是 OpenClaw 启动时会读/proc/version和/proc/sys/kernel/osrelease来判断是不是 WSL2 环境如果读不到或者内容不符合预期就报这个错。解法一确认你确实在 WSL2 里而不是 WSL1。在 PowerShell 里执行wsl -l -v看 VERSION 列是不是 2。如果是 1执行wsl --set-version Ubuntu 2升级。解法二检查/proc/version是否可读。在 WSL2 里执行cat /proc/version如果报权限错误说明挂载有问题。执行sudo mount -t proc proc /proc重新挂载。解法三如果前两个都没问题可能是 OpenClaw 的检测逻辑太严格。可以临时跳过检测在启动命令前加环境变量OPENCLAW_SKIP_WSL_CHECK1 openclaw start这个变量不是官方文档里的是我在实际排查时发现的能绕过检测。但要注意跳过检测后某些依赖 WSL2 特性的功能可能不正常比如文件监听。5.2 Node.js 版本报错的识别与处理前面提过node:util的报错这里再补充几个常见的 Node.js 版本相关问题。报错node.js v24.21.0 is not yet released or is not available这通常是你用了 nvm 之类的版本管理工具但指定的版本号不存在。检查一下版本号有没有打错或者用nvm ls-remote看看有哪些可用版本。报错Cannot find module xxx可能是 npm 包没装全。在 OpenClaw 目录下执行npm install重新装依赖。如果还不行删掉node_modules和package-lock.json再装。报错EACCES: permission denied这是权限问题参考前面 Linux 章节改 npm 全局目录。5.3 模型连接失败与超时排查OpenClaw 启动后如果连不上模型界面会一直转圈或者报超时。排查步骤第一步确认模型服务在跑。Ollama 的话执行ollama list看模型在不在curl http://localhost:11434/api/tags看服务通不通。LM Studio 的话看界面里服务有没有启动。第二步确认地址填对了。Ollama 默认11434LM Studio 默认1234别填混。如果模型服务和 OpenClaw 不在同一台机器地址要填局域网 IP不是localhost。第三步确认模型名对得上。Ollama 里模型名是qwen2.5:7b这种格式LM Studio 里是模型文件的名字别写错。第四步如果都对了还连不上看防火墙。Windows 防火墙可能拦了11434端口在防火墙里放行即可。5.4 常见问题速查表报错信息可能原因解决办法could not safely verify the wsl2 environmentWSL2 检测失败确认 WSL2 版本、检查 /proc 挂载、或跳过检测node:util does not provide an export namedNode.js 版本低于 18升级到 Node.js 20 或 22 LTSEACCES: permission deniednpm 全局目录权限不足改 npm prefix 到用户目录模型连接超时地址或端口填错、服务未启动检查模型服务状态和配置地址二维码加载不出来网络问题或平台限制检查外网访问或手动输入 tokenCannot find module依赖未装全删 node_modules 重装提示遇到报错先看完整错误信息别只看最后一行。Node.js 的报错堆栈里最上面几行往往才是根因。6. 跑起来之后能做什么OpenClaw 跑起来后最直接的用法是在 Web 界面里和大模型对话。但它的价值不止于此。你可以配置多个模型让不同的对话走不同的模型可以启用工具调用让模型能查天气、算数学、读文件可以对接聊天平台把 AI 助手变成随时能聊的伙伴。如果你打算长期用建议做几件事一是把配置备份好尤其是 API key 和平台 token二是定期更新 OpenClawnpm update -g openclaw就行三是关注日志OpenClaw 的日志在~/.openclaw/logs下出问题时先看日志。最后分享一个小技巧如果你觉得本地模型响应慢可以在配置里调maxTokens和temperature降低生成长度、调低随机性响应会快不少。这个参数在 Ollama 和 LM Studio 里都支持OpenClaw 配置里透传即可。
