如果你最近刷到一堆关于 OpenClaw老版本也叫 Clawdbot的讨论却不知道这东西到底能干什么那这篇就是给你准备的。OpenClaw 本质上是一个开源的 AI 智能体运行框架你可以把它理解成一个“长在你自己电脑或服务器上的机器人管家”——它能对接各种大模型帮你完成对话、查资料、写笔记、定时提醒、收发消息等任务而且大部分配置通过网页操作或修改文本文件就能完成全程不需要你亲手写代码。很多人一听“部署”两个字就被劝退了其实我实测下来从零到能用并没有想象中那么吓人。这篇教程面向的是完全没接触过命令行、不想学编程的人。不管你是 Windows、Mac还是手头有一台云服务器只要照着下面的顺序一步步复制粘贴基本都能在半小时内把 OpenClaw 跑起来。如果你之前已经被各种各样的“环境配置”折磨过接下来这套流程的容错率会让你舒服很多。1. 部署前先想清楚三件事平台、环境和模型接口1.1 OpenClaw 到底是什么它跑在哪里OpenClaw 是一个以 Node.js 为基础的智能体运行时。它本身不生产“智能”而是负责把各种大模型的能力包装成可以执行的动作。比如你跟它说“帮我把今天的重要邮件总结成三点发到群里”它就会调用模型理解这句话再通过内置的插件去查邮件、生成摘要、发送消息。这里的关键点在于OpenClaw 自己只负责调度和连接真正干活的“大脑”是背后的大模型。所以你还要准备一个能调用的模型接口云端 API 或者本地跑一个开源模型都行这个后面会详细说。部署本质上是两件事把 OpenClaw 程序装到电脑上再把模型接口的地址和密钥告诉它。这两件事都不需要写代码只是安装软件和填参数。1.2 Windows / Mac / 云服务器选哪个最省事我先说结论如果你手头只有一台日常使用的 Windows 电脑最推荐的方案是在 Windows 里装一个 WSLWindows Subsystem for Linux环境然后在 WSL 里跑 OpenClaw。为什么绕这么一圈因为智能体框架在 Linux 环境下的兼容性最好很多第三方插件和脚本默认就是按 Linux 路径写的直接用 Windows 原生跑容易踩各种路径分隔符和权限的坑。Mac 用户就简单了macOS 本身是类 Unix 系统终端一开就能用不需要额外装子系统。云服务器也一样只要系统是 Ubuntu 或 Debian 等主流 Linux 发行版跑起来非常顺。我把几个平台的差别整理成了表格平台上手难度建议人群备注Windows WSL中只有日常 Windows 电脑的人需要多花 10 分钟装 WSL但后续最稳Windows 原生低不想装任何子系统的人部分插件可能因为权限问题失败macOS低Mac 用户开箱即用几乎零额外配置云服务器低想让机器人 24 小时在线的人适合长期挂机手机随时能远程管理我个人建议如果你只是试玩一下就用 Windows 自带的 WSL如果你希望这个智能体像个真正的“管家”一样持续在线那就买一台便宜的基础款云服务器用 Docker 方式部署。1.3 本地大模型还是云端 API怎么选才不花冤枉钱这是部署前最纠结的问题。OpenClaw 本身不包含模型你必须给它指定一个模型来源。目前主流的做法有两种第一种是本地部署开源模型。比如用 Ollama 在本地跑一个 qwen2.5-3b 这样的小模型OpenClaw 直接连本地的http://localhost:11434。好处是免费、数据不出本机坏处是对电脑配置有要求3B 模型至少需要 8G 内存跑起来虽然能用但速度和云端大模型有明显差距。第二种是接云端 API。现在国内外很多模型服务商都提供 OpenAI 兼容的接口你只需要在配置文件里填一个base_url和api_key就行。好处是你电脑再差也能流畅对话坏处是按量计费重度使用每个月会有一些开销。给小白朋友一个最省心的建议先别折腾本地模型直接在配置里填一个云端 API跑通流程后再研究本地部署不迟。部署一次很轻松换模型也不难改一行配置重启即可。2. 保姆级部署实操三条主线走通安装流程2.1 三分钟环境自检先看看你的电脑适不适合直接跑不管用什么方式部署安装前都要确认两样东西一个是 Node.js一个是终端工具。打开你电脑的命令行窗口——Windows 推荐用 PowerShellMac 和 Linux 用系统自带的终端——然后运行下面这条命令node -v如果系统提示你node不是内部或外部命令说明 Node.js 还没装。去 Node.js 官网下载 LTS 长期支持版本Windows 用户下载.msi安装包直接双击一路下一步就好。安装完记得重新打开终端再跑一次node -v看到类似v20.11.0的输出就说明环境没问题。关于终端的选择有人爱用 cmd有人爱用 PowerShell我还是建议从最开始就用 PowerShell。它的语法更现代而且后面排查 WSL 问题时会用到一些 PowerShell 专属命令。你在开始菜单输入“PowerShell”直接点开就行不用管理员权限。2.2 Windows WSL 路线一次性把 Linux 环境装好这一步是 Windows 用户最头疼的地方但按顺序点下来其实很机械。先用管理员身份打开 PowerShell运行wsl --install这条命令会自动启用需要的 Windows 功能并下载 WSL安装完成后重启电脑。重启后开始菜单会出现 Ubuntu 的图标点开它会出现一个终端窗口让你设置 Linux 用户名和密码——随便设置一个自己能记住的就行别选太复杂的后面每次使用都要用到密码。进入 Ubuntu 终端后先给系统做一次软件源更新复制下面两行命令sudo apt update sudo apt install -y curl git这样系统里的包管理器就准备好了。之后 Node.js 的安装我不建议直接apt install nodejs因为 Ubuntu 官方源里的 Node.js 版本通常比较旧。更稳妥的方式是用 NodeSource 官方脚本安装复制粘贴这两行curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs这里装的是 Node.js 20 LTS目前所有主流智能体框架对这个版本的支持都很好。装完跑一下node -v确认输出的是不是 v20 开头如果是这套环境就算打通了。2.3 一键部署命令不写代码的“秒级启动”是怎么实现的OpenClaw 的安装方式有很多种最省心的是脚本安装。在 Ubuntu 终端或 macOS 终端里执行官网提供的一行命令bash (curl -sL https://get.openclaw.sh/install.sh)如果你因为网络原因拉不下来脚本也可以换成交叉平台通用的 npm 安装方式前提是刚才 Node.js 已经装好了npm install -g openclaw这条命令执行时会在全局目录安装openclaw程序需要几十秒到几分钟不等取决于你的网速。安装完成后在终端输入openclaw initinit命令会引导你完成最基础的初始化包括选择数据目录、生成默认配置、创建当前登录用户。这个过程是交互式的你只需要按几下回车或者用方向键选择全程没有任何代码。初始化完成后就可以启动了openclaw start看到日志里出现listening on port 3000之类的字样就说明服务已经起来了。注意启动后的终端窗口不要关闭服务是挂在这个窗口下的你要是关闭窗口机器人就下线了。后面想让它长期跑再考虑配置服务守护这里先不折腾。2.4 Docker 路线给有服务器的人准备的备用方案如果手头已经有云服务器或者你本身就装了 Docker直接用 Docker 部署会更干净连 Node.js 都不用单独安装。一条命令拉取镜像并启动docker run -d --name openclaw -v ~/openclaw-data:/data -p 3000:3000 openclaw/openclaw解释一下这条命令做了什么-d让容器在后台运行--name给容器起个名字叫 openclaw-v把服务器上的~/openclaw-data目录映射到容器内部用来存数据-p把服务器的 3000 端口映射到容器的 3000 端口。之后所有配置文件的修改都可以在宿主机~/openclaw-data目录里进行。首次启动后镜像拉取比较耗时但之后会非常省心。想查看容器运行日志用docker logs openclaw想停止用docker stop openclaw想重新启动用docker start openclaw。这些命令都是固定格式不需要知道背后的原理。3. 首次启动与基础配置把大脑和躯干接上3.1 一启动就遇到“无法安全验证”别慌这是常见问题热词列表里有一句“OpenClaw 无法安全验证”这不是项目本身的问题而是 Windows 安全机制对未签名脚本或安装包的一种保护。如果你是从官网下载的安装包由于没有商业代码签名证书双击运行时 Edge 或 SmartScreen 会弹出蓝色提示Windows 已保护你的电脑。正确处理方式是确认安装包是从官网或 GitHub 官方仓库下载的然后点击“更多信息”再点“仍要运行”。这一步很考验判断力我的原则是——只要来源确定是官方渠道就点“仍要运行”如果是从某个百度云分享链接里拿的安装包那最好放弃安装。安全永远排在便利前面。还有一种情况是 WSL 初始化时弹出的安全提示要求你检查 WSL 环境。处理办法是回到 PowerShell 里运行wsl --status如果你在系统里同时装了 WSL 1 和 WSL 2这个命令会告诉你当前默认版本是什么。OpenClaw 依赖 WSL 2 的完整内核如果输出显示默认版本是 1需要运行wsl --set-default-version 2然后再重新进入 Ubuntu 终端。这个报错本质上是 Windows 老系统的 WSL 版本太旧导致的不是 OpenClaw 自身问题。3.2 修改配置文件填模型参数不是写代码服务启动后我们面临最重要的一步让 OpenClaw 能用上大脑。在初始化时生成的配置文件夹里有一个文本配置项不同版本文件名可能有差异常见的是config.yaml或claw.yaml。用你电脑上的“记事本”或“文本编辑”打开它你会看到里面已经有很多内容了。我们只需关注模型相关的字段model: provider: openai base_url: https://api.example.com/v1 api_key: sk-xxxxxxxxxxxxxxxx model_name: gpt-4o-mini如果接本地 Ollama改的内容更简单model: provider: ollama base_url: http://localhost:11434 api_key: ollama model_name: qwen2.5-3b你看到这里有英文单词、有:, 可能会觉得这就是代码。其实这就是一份“参数清单”跟填快递单差不多——把模型提供方的地址填到base_url里把密钥填到api_key里把模型名字填到model_name里。改完保存然后重启openclaw start就行了。需要注意的一点是配置文件用的是 YAML 格式它对空格缩进非常敏感。把示例里的内容整体覆盖粘贴到对应位置是最保险的不要手动去调前面的空格有时候看着差不多的缩进程序会不认。3.3 用一句话验证部署是否成功配置完成后重启服务OpenClaw 的日志里通常会自动检测模型连接情况。如果日志显示 401 错误基本可以断定是 API Key 没填对。如果显示连接超时大概率是base_url填错了。最直接的办法是给 OpenClaw 发一条消息。如果它集成了网页管理界面打开浏览器访问http://localhost:3000应该能看到一个对话输入框输入“你好测试一下”并发送。如果它在几秒内给出回应整条链路就通了。很多人会忽略一个细节本地部署的模型第一次加载会慢几十秒看起来像没反应实际是模型正在加载进内存等等就好。用本地方案跑 qwen2.5-3b 这类小模型显存或内存不够时日志会直接报 OOM内存不足。这时候可以换一个更小的模型比如 qwen2.5-1.5b资源占用会明显降下来。4. 接入日常工作流让机器人真正帮你干活4.1 接入 Microsoft Teams团队群里多一个智能助手很多用 OpenClaw 的人不只是想自己玩而是想把它变成一个自动响应的团队成员。热词里经常看到“OpenClaw 如何接入 Microsoft Teams”这里我把思路讲清楚。Teams 接入本质上是让 Teams 平台能够把群聊消息转发给 OpenClaw并把 OpenClaw 的回复转发回群聊。你需要在 Microsoft Azure 门户里创建一个 Bot 资源创建时选择“Single Tenant”类型然后把生成的 App ID 和 Client Secret 填到 OpenClaw 的配置项里。接着在 OpenClaw 的配置中启用 Teams 频道运行一次注册命令把 Teams 应用安装到你的团队里。这个方法听起来需要注册一堆东西但其实整个流程是在微软网页控制台里“点选”真正的配置工作只有填几个字符串。控制台的界面有可能改版但核心逻辑始终是OpenClaw 提供一个回调地址Teams 把消息推送到这个地址。别被英文界面吓到关键的菜单名和按钮位置先截图翻译一下五分钟就能搞定。4.2 让 AI 直接读写 Obsidian 笔记知识管理型用户最常用的组合是 OpenClaw 加 Obsidian。配置非常简单在 OpenClaw 的可视化插件列表里找到 Obsidian 连接器填上你的 Vault 目录绝对路径比如D:/Documents/MyVault之后你可以直接在对话里说“帮我在第二个项目里创建一个今天的工作计划格式参照昨天那份”OpenClaw 就会调用连接器在指定 Vault 下生成对应的 Markdown 文件。对我来说这是一个很实用的功能以前写日记、做会议记录总是断断续续现在只要口头交代一句它就把事情记下来了。这里容易踩的坑是 Windows 路径里的反斜杠。在配置里填路径时尽量用正斜杠/不要用\否则部分程序会把它当转义符处理导致路径解析错误。写D:/Documents/MyVault肯定比D:\Documents\MyVault更稳。4.3 定时任务不写代码也能实现“每天早上九点汇报”OpenClaw 自带一个调度器你可以在配置里写一条cron规则来触发定时任务。这句话听着技术实际非常简单。在配置文件的schedules段里加一个字段schedules: - name: morning_report cron: 0 9 * * * prompt: 把今天的日程安排和昨天未完成的事项整理成一条消息cron表达式里那段0 9 * * *表示每天上午九点整触发。它分为五个字段分钟、小时、日期、月份、星期。0 9 * * *就是第 0 分钟、第 9 小时后面的*代表每天每月每星期。想每天晚上八点执行就写0 20 * * *。这种写法不是代码只是一套约定俗成的计时语法照着模板改数字就行。配好以后重启服务到点它就会自动执行然后把结果通过你已经接入的 Teams、邮件或日志发出来。我用过一段时间后最大的体会是定时任务的价值不在花哨而在于把繁琐的重复操作交给机器自己只留出时间看结果。5. 常见问题与排查技巧实录5.1 热词里的 WSL 报错到底怎么处理很多从 Windows 入门的用户会遇到这样一条提示OpenClaw 无法安全验证然后下面跟了一句和 WSL 环境相关的描述让你在 PowerShell 里运行wsl --status。这其实是初始化脚本检测到了 WSL 状态异常而不是安装包本身有问题。处理办法在本文第三章已经写过这里再补充冷门一点的情况如果你运行wsl --status显示“默认版本1”但你的系统已经装了 WSL 2可以单独为 Ubuntu 发行版指定版本wsl --set-version Ubuntu 2这条命令会把指定发行版从 WSL 1 转换成 WSL 2转换过程会花一两分钟。转换完成后重新运行wsl --status默认版本就会是 2 了。如果转换失败大概率是 Windows 虚拟机平台功能没启用到“控制面板——程序和功能——启用或关闭 Windows 功能”里把“虚拟机平台”和“适用于 Linux 的 Windows 子系统”都勾上重启机器再试。5.2 安装时一直转圈、下载极慢怎么办OpenClaw 本身不大但它要拉取很多依赖包。如果你使用 npm 安装卡了很久先确认是不是网络源的问题。npm 默认源在海外的 CDN国内访问经常不稳定。把 npm 源切换到国内镜像通常能立竿见影npm config set registry https://registry.npmmirror.com设置完成后再次执行npm install -g openclaw你会发现下载速度有一个量级的提升。同样的思路也适用于 Docker如果你在拉镜像时卡住给 Docker 配置一个国内镜像加速地址之后拉取速度会快很多。这些都属于常规的软件源调整不影响项目的安全性和功能性。5.3 机器人能启动但发消息不回如果服务能启动模型也能连上但发消息一直没回应优先去看日志。OpenClaw 在启动窗口或日志文件里会随时打印后台处理进展。没有日志输出先检查你的消息渠道转发配没配好——比如网页端对话不回但 Teams 回那就说明网页入口的问题反过来也是一样。第二个高发原因是模型接口超时。很多免费或低价模型接口对长上下文处理很慢一旦超过 OpenClaw 内部设定的超时阈值消息就会被丢弃。解决办法是在配置里把请求超时时间调大一点比如从 30 秒改成 60 秒。还有一个容易被忽略的点用了本地 Ollama 却忘了启动 Ollama 服务。很多人部署完模型后把 Ollama 窗口关了OpenClaw 当然就连不上了到终端里跑一下ollama serve就能解决。5.4 服务起来了但运行时内存占用过高本地部署模型最头疼的就是资源占用。Qwen 系模型如果在 GPU 不可用的机器上单纯靠 CPU 推理内存占用经常会冲到 10G 以上。这时候不要硬扛先给 OpenClaw 限制并发请求数在配置里把max_concurrent改成 1避免好几个人同时发消息打爆内存。再把模型换成量化版本名字里带q4或gguf的版本也能明显降低占用。如果内存还是不够用最彻底的办法是把模型换成更小参数量比如从 qwen2.5-7b 换到 qwen2.5-3b甚至 1.5b。请记住你的任务是先让它稳定跑起来而不是追求最强的对话效果。稳定运行带来的正反馈比什么参数都重要。这里我把常见问题整理成一张速查表方便你随时对照现象可能原因处理建议启动提示无法安全验证Windows SmartScreen 拦截未签名程序从官网下载则点击“更多信息-仍要运行”提示 WSL 版本不对默认 WSL 1 或未安装wsl --set-default-version 2npm 安装卡住默认源访问慢切换到 npmmirror 镜像源后重装能启动但发消息无回应模型超时或渠道未接通看日志确认模型是否响应日志显示 OOM内存不足换更小模型或限制并发数缺少 msvcp140.dllWindows 原生环境缺少 VC 运行库安装微软官方 VC 运行库后重启6. 从“部署成功”到“真正会用”的进阶建议6.1 别一上来就追求复杂先只跑通一个场景我见过很多人的失败模式部署完就开始研究 Teams、Obsidian、定时任务、多模型切换一堆功能最后配置改得乱七八糟连最开始能用的对话都崩了。正确姿势是“一次只做一件事”。第一天只验证网页聊天能回复第二天把 Teams 接上第三天再试 Obsidian 写入。每增加一个环节就在旧环境可用的前提下做增量修改这样出了问题你永远知道是哪一步引入的。6.2 从社区模板开始改少走弯路OpenClaw 社区里有大量现成的配置模板覆盖了各种使用场景。比如“团队消息摘要”“个人知识库助手”“邮件自动分类”这些模板本质上就是一份写好参数的配置文件。你不用理解每一项设置的意义先把模板文件复制到自己的项目配置目录下替换里面的 API Key 和路径启动后看效果。效果不满意再逐项调整。这就像装修房子时先看样板间再做局部改动比对着空屋子空想省力一百倍。6.3 我踩过的坑缩进、路径和时区最后分享几个我必须强调的细节。第一个是 YAML 配置文件对空格极其敏感很多人喜欢用 Tab 键缩进一保存程序就报错。请在记事本里关闭“自动插入 Tab”选项或者直接用示例贴进去改值。第二个是路径分隔符前面提过用正斜杠/不要用反斜杠。第三个是定时任务的时区OpenClaw 默认按服务器本地时区执行如果你的服务器设在离国外很远的机房可能早上九点变成凌晨一点。配置里如果有时区字段务必显式设置为Asia/Shanghai。这三件事看起来都是小问题但每一个都能让你多花一小时排查。把这些问题提前记在心里在实际使用中会顺畅得多。我个人在实际操作中的体会是OpenClaw 的部署难度被严重夸大了。整个流程里最花时间的并不是安装命令而是决定“我要用它干什么”和“我应该选哪个模型”。只要把这两件事想明白安装环节基本就是复制粘贴的问题。如果你第一次启动失败不用怀疑自己的操作能力大概率是先前的环境问题没有清理干净重新按这篇的顺序走一遍多半能跑通。最后再分享一个小技巧开一个新终端窗口先跑openclaw status看服务状态再跑openclaw start养成这个习惯之后你几乎不会再被“服务没起来”这个问题困扰。
OpenClaw部署实战：零基础接入AI智能体与模型配置指南
如果你最近刷到一堆关于 OpenClaw老版本也叫 Clawdbot的讨论却不知道这东西到底能干什么那这篇就是给你准备的。OpenClaw 本质上是一个开源的 AI 智能体运行框架你可以把它理解成一个“长在你自己电脑或服务器上的机器人管家”——它能对接各种大模型帮你完成对话、查资料、写笔记、定时提醒、收发消息等任务而且大部分配置通过网页操作或修改文本文件就能完成全程不需要你亲手写代码。很多人一听“部署”两个字就被劝退了其实我实测下来从零到能用并没有想象中那么吓人。这篇教程面向的是完全没接触过命令行、不想学编程的人。不管你是 Windows、Mac还是手头有一台云服务器只要照着下面的顺序一步步复制粘贴基本都能在半小时内把 OpenClaw 跑起来。如果你之前已经被各种各样的“环境配置”折磨过接下来这套流程的容错率会让你舒服很多。1. 部署前先想清楚三件事平台、环境和模型接口1.1 OpenClaw 到底是什么它跑在哪里OpenClaw 是一个以 Node.js 为基础的智能体运行时。它本身不生产“智能”而是负责把各种大模型的能力包装成可以执行的动作。比如你跟它说“帮我把今天的重要邮件总结成三点发到群里”它就会调用模型理解这句话再通过内置的插件去查邮件、生成摘要、发送消息。这里的关键点在于OpenClaw 自己只负责调度和连接真正干活的“大脑”是背后的大模型。所以你还要准备一个能调用的模型接口云端 API 或者本地跑一个开源模型都行这个后面会详细说。部署本质上是两件事把 OpenClaw 程序装到电脑上再把模型接口的地址和密钥告诉它。这两件事都不需要写代码只是安装软件和填参数。1.2 Windows / Mac / 云服务器选哪个最省事我先说结论如果你手头只有一台日常使用的 Windows 电脑最推荐的方案是在 Windows 里装一个 WSLWindows Subsystem for Linux环境然后在 WSL 里跑 OpenClaw。为什么绕这么一圈因为智能体框架在 Linux 环境下的兼容性最好很多第三方插件和脚本默认就是按 Linux 路径写的直接用 Windows 原生跑容易踩各种路径分隔符和权限的坑。Mac 用户就简单了macOS 本身是类 Unix 系统终端一开就能用不需要额外装子系统。云服务器也一样只要系统是 Ubuntu 或 Debian 等主流 Linux 发行版跑起来非常顺。我把几个平台的差别整理成了表格平台上手难度建议人群备注Windows WSL中只有日常 Windows 电脑的人需要多花 10 分钟装 WSL但后续最稳Windows 原生低不想装任何子系统的人部分插件可能因为权限问题失败macOS低Mac 用户开箱即用几乎零额外配置云服务器低想让机器人 24 小时在线的人适合长期挂机手机随时能远程管理我个人建议如果你只是试玩一下就用 Windows 自带的 WSL如果你希望这个智能体像个真正的“管家”一样持续在线那就买一台便宜的基础款云服务器用 Docker 方式部署。1.3 本地大模型还是云端 API怎么选才不花冤枉钱这是部署前最纠结的问题。OpenClaw 本身不包含模型你必须给它指定一个模型来源。目前主流的做法有两种第一种是本地部署开源模型。比如用 Ollama 在本地跑一个 qwen2.5-3b 这样的小模型OpenClaw 直接连本地的http://localhost:11434。好处是免费、数据不出本机坏处是对电脑配置有要求3B 模型至少需要 8G 内存跑起来虽然能用但速度和云端大模型有明显差距。第二种是接云端 API。现在国内外很多模型服务商都提供 OpenAI 兼容的接口你只需要在配置文件里填一个base_url和api_key就行。好处是你电脑再差也能流畅对话坏处是按量计费重度使用每个月会有一些开销。给小白朋友一个最省心的建议先别折腾本地模型直接在配置里填一个云端 API跑通流程后再研究本地部署不迟。部署一次很轻松换模型也不难改一行配置重启即可。2. 保姆级部署实操三条主线走通安装流程2.1 三分钟环境自检先看看你的电脑适不适合直接跑不管用什么方式部署安装前都要确认两样东西一个是 Node.js一个是终端工具。打开你电脑的命令行窗口——Windows 推荐用 PowerShellMac 和 Linux 用系统自带的终端——然后运行下面这条命令node -v如果系统提示你node不是内部或外部命令说明 Node.js 还没装。去 Node.js 官网下载 LTS 长期支持版本Windows 用户下载.msi安装包直接双击一路下一步就好。安装完记得重新打开终端再跑一次node -v看到类似v20.11.0的输出就说明环境没问题。关于终端的选择有人爱用 cmd有人爱用 PowerShell我还是建议从最开始就用 PowerShell。它的语法更现代而且后面排查 WSL 问题时会用到一些 PowerShell 专属命令。你在开始菜单输入“PowerShell”直接点开就行不用管理员权限。2.2 Windows WSL 路线一次性把 Linux 环境装好这一步是 Windows 用户最头疼的地方但按顺序点下来其实很机械。先用管理员身份打开 PowerShell运行wsl --install这条命令会自动启用需要的 Windows 功能并下载 WSL安装完成后重启电脑。重启后开始菜单会出现 Ubuntu 的图标点开它会出现一个终端窗口让你设置 Linux 用户名和密码——随便设置一个自己能记住的就行别选太复杂的后面每次使用都要用到密码。进入 Ubuntu 终端后先给系统做一次软件源更新复制下面两行命令sudo apt update sudo apt install -y curl git这样系统里的包管理器就准备好了。之后 Node.js 的安装我不建议直接apt install nodejs因为 Ubuntu 官方源里的 Node.js 版本通常比较旧。更稳妥的方式是用 NodeSource 官方脚本安装复制粘贴这两行curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs这里装的是 Node.js 20 LTS目前所有主流智能体框架对这个版本的支持都很好。装完跑一下node -v确认输出的是不是 v20 开头如果是这套环境就算打通了。2.3 一键部署命令不写代码的“秒级启动”是怎么实现的OpenClaw 的安装方式有很多种最省心的是脚本安装。在 Ubuntu 终端或 macOS 终端里执行官网提供的一行命令bash (curl -sL https://get.openclaw.sh/install.sh)如果你因为网络原因拉不下来脚本也可以换成交叉平台通用的 npm 安装方式前提是刚才 Node.js 已经装好了npm install -g openclaw这条命令执行时会在全局目录安装openclaw程序需要几十秒到几分钟不等取决于你的网速。安装完成后在终端输入openclaw initinit命令会引导你完成最基础的初始化包括选择数据目录、生成默认配置、创建当前登录用户。这个过程是交互式的你只需要按几下回车或者用方向键选择全程没有任何代码。初始化完成后就可以启动了openclaw start看到日志里出现listening on port 3000之类的字样就说明服务已经起来了。注意启动后的终端窗口不要关闭服务是挂在这个窗口下的你要是关闭窗口机器人就下线了。后面想让它长期跑再考虑配置服务守护这里先不折腾。2.4 Docker 路线给有服务器的人准备的备用方案如果手头已经有云服务器或者你本身就装了 Docker直接用 Docker 部署会更干净连 Node.js 都不用单独安装。一条命令拉取镜像并启动docker run -d --name openclaw -v ~/openclaw-data:/data -p 3000:3000 openclaw/openclaw解释一下这条命令做了什么-d让容器在后台运行--name给容器起个名字叫 openclaw-v把服务器上的~/openclaw-data目录映射到容器内部用来存数据-p把服务器的 3000 端口映射到容器的 3000 端口。之后所有配置文件的修改都可以在宿主机~/openclaw-data目录里进行。首次启动后镜像拉取比较耗时但之后会非常省心。想查看容器运行日志用docker logs openclaw想停止用docker stop openclaw想重新启动用docker start openclaw。这些命令都是固定格式不需要知道背后的原理。3. 首次启动与基础配置把大脑和躯干接上3.1 一启动就遇到“无法安全验证”别慌这是常见问题热词列表里有一句“OpenClaw 无法安全验证”这不是项目本身的问题而是 Windows 安全机制对未签名脚本或安装包的一种保护。如果你是从官网下载的安装包由于没有商业代码签名证书双击运行时 Edge 或 SmartScreen 会弹出蓝色提示Windows 已保护你的电脑。正确处理方式是确认安装包是从官网或 GitHub 官方仓库下载的然后点击“更多信息”再点“仍要运行”。这一步很考验判断力我的原则是——只要来源确定是官方渠道就点“仍要运行”如果是从某个百度云分享链接里拿的安装包那最好放弃安装。安全永远排在便利前面。还有一种情况是 WSL 初始化时弹出的安全提示要求你检查 WSL 环境。处理办法是回到 PowerShell 里运行wsl --status如果你在系统里同时装了 WSL 1 和 WSL 2这个命令会告诉你当前默认版本是什么。OpenClaw 依赖 WSL 2 的完整内核如果输出显示默认版本是 1需要运行wsl --set-default-version 2然后再重新进入 Ubuntu 终端。这个报错本质上是 Windows 老系统的 WSL 版本太旧导致的不是 OpenClaw 自身问题。3.2 修改配置文件填模型参数不是写代码服务启动后我们面临最重要的一步让 OpenClaw 能用上大脑。在初始化时生成的配置文件夹里有一个文本配置项不同版本文件名可能有差异常见的是config.yaml或claw.yaml。用你电脑上的“记事本”或“文本编辑”打开它你会看到里面已经有很多内容了。我们只需关注模型相关的字段model: provider: openai base_url: https://api.example.com/v1 api_key: sk-xxxxxxxxxxxxxxxx model_name: gpt-4o-mini如果接本地 Ollama改的内容更简单model: provider: ollama base_url: http://localhost:11434 api_key: ollama model_name: qwen2.5-3b你看到这里有英文单词、有:, 可能会觉得这就是代码。其实这就是一份“参数清单”跟填快递单差不多——把模型提供方的地址填到base_url里把密钥填到api_key里把模型名字填到model_name里。改完保存然后重启openclaw start就行了。需要注意的一点是配置文件用的是 YAML 格式它对空格缩进非常敏感。把示例里的内容整体覆盖粘贴到对应位置是最保险的不要手动去调前面的空格有时候看着差不多的缩进程序会不认。3.3 用一句话验证部署是否成功配置完成后重启服务OpenClaw 的日志里通常会自动检测模型连接情况。如果日志显示 401 错误基本可以断定是 API Key 没填对。如果显示连接超时大概率是base_url填错了。最直接的办法是给 OpenClaw 发一条消息。如果它集成了网页管理界面打开浏览器访问http://localhost:3000应该能看到一个对话输入框输入“你好测试一下”并发送。如果它在几秒内给出回应整条链路就通了。很多人会忽略一个细节本地部署的模型第一次加载会慢几十秒看起来像没反应实际是模型正在加载进内存等等就好。用本地方案跑 qwen2.5-3b 这类小模型显存或内存不够时日志会直接报 OOM内存不足。这时候可以换一个更小的模型比如 qwen2.5-1.5b资源占用会明显降下来。4. 接入日常工作流让机器人真正帮你干活4.1 接入 Microsoft Teams团队群里多一个智能助手很多用 OpenClaw 的人不只是想自己玩而是想把它变成一个自动响应的团队成员。热词里经常看到“OpenClaw 如何接入 Microsoft Teams”这里我把思路讲清楚。Teams 接入本质上是让 Teams 平台能够把群聊消息转发给 OpenClaw并把 OpenClaw 的回复转发回群聊。你需要在 Microsoft Azure 门户里创建一个 Bot 资源创建时选择“Single Tenant”类型然后把生成的 App ID 和 Client Secret 填到 OpenClaw 的配置项里。接着在 OpenClaw 的配置中启用 Teams 频道运行一次注册命令把 Teams 应用安装到你的团队里。这个方法听起来需要注册一堆东西但其实整个流程是在微软网页控制台里“点选”真正的配置工作只有填几个字符串。控制台的界面有可能改版但核心逻辑始终是OpenClaw 提供一个回调地址Teams 把消息推送到这个地址。别被英文界面吓到关键的菜单名和按钮位置先截图翻译一下五分钟就能搞定。4.2 让 AI 直接读写 Obsidian 笔记知识管理型用户最常用的组合是 OpenClaw 加 Obsidian。配置非常简单在 OpenClaw 的可视化插件列表里找到 Obsidian 连接器填上你的 Vault 目录绝对路径比如D:/Documents/MyVault之后你可以直接在对话里说“帮我在第二个项目里创建一个今天的工作计划格式参照昨天那份”OpenClaw 就会调用连接器在指定 Vault 下生成对应的 Markdown 文件。对我来说这是一个很实用的功能以前写日记、做会议记录总是断断续续现在只要口头交代一句它就把事情记下来了。这里容易踩的坑是 Windows 路径里的反斜杠。在配置里填路径时尽量用正斜杠/不要用\否则部分程序会把它当转义符处理导致路径解析错误。写D:/Documents/MyVault肯定比D:\Documents\MyVault更稳。4.3 定时任务不写代码也能实现“每天早上九点汇报”OpenClaw 自带一个调度器你可以在配置里写一条cron规则来触发定时任务。这句话听着技术实际非常简单。在配置文件的schedules段里加一个字段schedules: - name: morning_report cron: 0 9 * * * prompt: 把今天的日程安排和昨天未完成的事项整理成一条消息cron表达式里那段0 9 * * *表示每天上午九点整触发。它分为五个字段分钟、小时、日期、月份、星期。0 9 * * *就是第 0 分钟、第 9 小时后面的*代表每天每月每星期。想每天晚上八点执行就写0 20 * * *。这种写法不是代码只是一套约定俗成的计时语法照着模板改数字就行。配好以后重启服务到点它就会自动执行然后把结果通过你已经接入的 Teams、邮件或日志发出来。我用过一段时间后最大的体会是定时任务的价值不在花哨而在于把繁琐的重复操作交给机器自己只留出时间看结果。5. 常见问题与排查技巧实录5.1 热词里的 WSL 报错到底怎么处理很多从 Windows 入门的用户会遇到这样一条提示OpenClaw 无法安全验证然后下面跟了一句和 WSL 环境相关的描述让你在 PowerShell 里运行wsl --status。这其实是初始化脚本检测到了 WSL 状态异常而不是安装包本身有问题。处理办法在本文第三章已经写过这里再补充冷门一点的情况如果你运行wsl --status显示“默认版本1”但你的系统已经装了 WSL 2可以单独为 Ubuntu 发行版指定版本wsl --set-version Ubuntu 2这条命令会把指定发行版从 WSL 1 转换成 WSL 2转换过程会花一两分钟。转换完成后重新运行wsl --status默认版本就会是 2 了。如果转换失败大概率是 Windows 虚拟机平台功能没启用到“控制面板——程序和功能——启用或关闭 Windows 功能”里把“虚拟机平台”和“适用于 Linux 的 Windows 子系统”都勾上重启机器再试。5.2 安装时一直转圈、下载极慢怎么办OpenClaw 本身不大但它要拉取很多依赖包。如果你使用 npm 安装卡了很久先确认是不是网络源的问题。npm 默认源在海外的 CDN国内访问经常不稳定。把 npm 源切换到国内镜像通常能立竿见影npm config set registry https://registry.npmmirror.com设置完成后再次执行npm install -g openclaw你会发现下载速度有一个量级的提升。同样的思路也适用于 Docker如果你在拉镜像时卡住给 Docker 配置一个国内镜像加速地址之后拉取速度会快很多。这些都属于常规的软件源调整不影响项目的安全性和功能性。5.3 机器人能启动但发消息不回如果服务能启动模型也能连上但发消息一直没回应优先去看日志。OpenClaw 在启动窗口或日志文件里会随时打印后台处理进展。没有日志输出先检查你的消息渠道转发配没配好——比如网页端对话不回但 Teams 回那就说明网页入口的问题反过来也是一样。第二个高发原因是模型接口超时。很多免费或低价模型接口对长上下文处理很慢一旦超过 OpenClaw 内部设定的超时阈值消息就会被丢弃。解决办法是在配置里把请求超时时间调大一点比如从 30 秒改成 60 秒。还有一个容易被忽略的点用了本地 Ollama 却忘了启动 Ollama 服务。很多人部署完模型后把 Ollama 窗口关了OpenClaw 当然就连不上了到终端里跑一下ollama serve就能解决。5.4 服务起来了但运行时内存占用过高本地部署模型最头疼的就是资源占用。Qwen 系模型如果在 GPU 不可用的机器上单纯靠 CPU 推理内存占用经常会冲到 10G 以上。这时候不要硬扛先给 OpenClaw 限制并发请求数在配置里把max_concurrent改成 1避免好几个人同时发消息打爆内存。再把模型换成量化版本名字里带q4或gguf的版本也能明显降低占用。如果内存还是不够用最彻底的办法是把模型换成更小参数量比如从 qwen2.5-7b 换到 qwen2.5-3b甚至 1.5b。请记住你的任务是先让它稳定跑起来而不是追求最强的对话效果。稳定运行带来的正反馈比什么参数都重要。这里我把常见问题整理成一张速查表方便你随时对照现象可能原因处理建议启动提示无法安全验证Windows SmartScreen 拦截未签名程序从官网下载则点击“更多信息-仍要运行”提示 WSL 版本不对默认 WSL 1 或未安装wsl --set-default-version 2npm 安装卡住默认源访问慢切换到 npmmirror 镜像源后重装能启动但发消息无回应模型超时或渠道未接通看日志确认模型是否响应日志显示 OOM内存不足换更小模型或限制并发数缺少 msvcp140.dllWindows 原生环境缺少 VC 运行库安装微软官方 VC 运行库后重启6. 从“部署成功”到“真正会用”的进阶建议6.1 别一上来就追求复杂先只跑通一个场景我见过很多人的失败模式部署完就开始研究 Teams、Obsidian、定时任务、多模型切换一堆功能最后配置改得乱七八糟连最开始能用的对话都崩了。正确姿势是“一次只做一件事”。第一天只验证网页聊天能回复第二天把 Teams 接上第三天再试 Obsidian 写入。每增加一个环节就在旧环境可用的前提下做增量修改这样出了问题你永远知道是哪一步引入的。6.2 从社区模板开始改少走弯路OpenClaw 社区里有大量现成的配置模板覆盖了各种使用场景。比如“团队消息摘要”“个人知识库助手”“邮件自动分类”这些模板本质上就是一份写好参数的配置文件。你不用理解每一项设置的意义先把模板文件复制到自己的项目配置目录下替换里面的 API Key 和路径启动后看效果。效果不满意再逐项调整。这就像装修房子时先看样板间再做局部改动比对着空屋子空想省力一百倍。6.3 我踩过的坑缩进、路径和时区最后分享几个我必须强调的细节。第一个是 YAML 配置文件对空格极其敏感很多人喜欢用 Tab 键缩进一保存程序就报错。请在记事本里关闭“自动插入 Tab”选项或者直接用示例贴进去改值。第二个是路径分隔符前面提过用正斜杠/不要用反斜杠。第三个是定时任务的时区OpenClaw 默认按服务器本地时区执行如果你的服务器设在离国外很远的机房可能早上九点变成凌晨一点。配置里如果有时区字段务必显式设置为Asia/Shanghai。这三件事看起来都是小问题但每一个都能让你多花一小时排查。把这些问题提前记在心里在实际使用中会顺畅得多。我个人在实际操作中的体会是OpenClaw 的部署难度被严重夸大了。整个流程里最花时间的并不是安装命令而是决定“我要用它干什么”和“我应该选哪个模型”。只要把这两件事想明白安装环节基本就是复制粘贴的问题。如果你第一次启动失败不用怀疑自己的操作能力大概率是先前的环境问题没有清理干净重新按这篇的顺序走一遍多半能跑通。最后再分享一个小技巧开一个新终端窗口先跑openclaw status看服务状态再跑openclaw start养成这个习惯之后你几乎不会再被“服务没起来”这个问题困扰。
