开始前先说明一下我这几台设备上的 OpenClaw 版本都固定在 2026.3.1所以这篇安装指南里凡是出现语义分歧、命令报错、配置键名对不上的问题都以这个版本的实际行为为准。如果你手头是最新 nightly个别命令可能略有出入但整体思路完全通用。1. OpenClaw 2026.3.1 到底解决什么问题以及你为什么需要先想清楚再装1.1 它是什么一个把本地模型、云端 API、自动化任务串起来的代理框架OpenClaw 不是传统意义上的聊天软件它更像是一个跑在终端里的自动化代理框架装了一个大脑。你可以用自然语言或预设指令让它去读取任务、写文件、调用工具、执行脚本也可以给它挂上不同的算力来源——比如本地 Ollama 跑的 qwen2.5-3b或者 OpenAI 兼容的云端 API。它的核心价值在于把大模型对话能力和本机操作系统执行能力打通模型负责理解你想干什么Claw 负责真的去执行执行完再把结果喂回模型。2026.3.1 这个版本我拿到手之后的第一感受是配置文件格式更统一了skill 插件的安装机制比旧版本清晰不少Windows 下的 companion 进程也终于有了比较明确的配置入口。之前我看网上很多人在问workbuddy 这种是不是参考了 openclaw 搞出来的——时间线上确实对得上2026.1 之后 openclaw 的 skill 体系基本成熟后续同类工具多多少少借鉴了这套角色指令 技能包 工具调用的模式。当然这只是我个人的观察不具备什么权威性。1.2 安装前先回答三个问题平台、算力接入、运行时空我在群里看到最多的安装失败案例几乎都栽在使用者没想清楚我要在哪跑、用什么模型、装完干什么这三个问题上。这里我给出一个简单的决策思路平台日常在 Windows 上办公优先走WSL2 Windows 终端方案纯服务器环境直接 Ubuntu 22.04/24.04 跑只有一台旧手机想试试水再考虑 Termux。算力接入只求开箱即用直接接 OpenAI 兼容 API想要离线、免费、不泄露数据先装 Ollama 再拉一个 3B 左右的量化模型要是你想跑更重的本地模型先确认自己的显存和内存够不够。运行时空OpenClaw 需要 Node.js 18 以上的环境它本身是一个 npm 全局包。意味着你的终端要有网络能下载依赖同时也意味着卸载时不能只删文件夹这点放到最后一部分细说。想清楚这三个问题再动手能省掉后面至少两三个小时的排错时间。不要一上来就抄命令环境不一样抄了也白抄。2. Windows 环境准备WSL2 状态、Node.js 版本与 PowerShell 权限2.1 著名报错无法安全验证 sl2 环境是怎么来的Windows 上安装 OpenClaw 2026.3.1 最常撞到的坑就是打开安装脚本后弹出这样一段话OpenClaw 无法安全验证 sl2 环境。 请在 powershell 中运行 wsl -- status我第一次看到这个报错时还很困惑因为 OpenClaw 命令行本身并不强制依赖 WSL2。翻了一下安装日志才发现2026.3.1 在 Windows 上默认会做一轮宿主环境健康检查它要确认两件事系统是否启用了适用于 Linux 的 Windows 子系统功能以及默认的 WSL 版本是否为 2。如果检查结果不合格安装脚本会拒绝继续于是就有了那句听起来很吓人的提示。解决办法其实不复杂。在管理员权限的 PowerShell 里依次执行以下命令wsl --status wsl --update wsl --set-default-version 2其中wsl --status会显示当前 WSL 内核版本和默认版本。如果显示Default Version: 1说明系统还在用旧版的 WSL1很多工具在文件系统性能上会非常痛苦。wsl --update是为了把内核更新到最新老版本 Windows 10 用户如果执行wsl --update报错需要先去启用或关闭 Windows 功能里勾选虚拟机平台重启后再来一次。提示如果你根本不想用 WSL纯在 Windows 原生环境跑 OpenClaw 也不是不行但 2026.3.1 的安装脚本默认会检查 WSL2所以至少要先把 WSL2 基础环境搭好。装完 openclaw 之后WSL2 里的发行版可以闲置在那里不会占太多资源。2.2 Node.js 官网下载版本选择和 npm 环境安装 OpenClaw 之前你需要一个可用的 Node.js 运行时。网上很多人搜node.js 官网下载 openclaw这个理解其实反了——你要去官网下载的是 Node.js不是 OpenClawOpenClaw 是装在 Node.js 之上的 npm 包。我建议安装 Node.js 20 LTS 或 22 LTS 版本避免用奇数版本号比如 23、25——这些版本不是长期维护部分原生依赖编译时容易出兼容问题。下载时选 Windows Installer (.msi) 版本安装时一路下一步即可注意勾选Add to PATH。装完在 PowerShell 里验证node -v npm -v如果你之前装过旧版 Node建议先卸载干净再装新的否则npm -v可能指向旧版残留路径。另外把 npm 的全局安装路径记住后面排查命令找不到时会用到npm config get prefix默认情况下这个路径是C:\Users\你的用户名\AppData\Roaming\npm如果之后踩到OpenClaw 不是内部或外部命令的报错九成是这个目录没有加进系统 PATH。2.3 PowerShell 执行策略为什么脚本被禁止运行Windows 上安装 openclaw 时install 脚本需要拥有执行权限。PowerShell 默认的Restricted策略会拦截所有 ps1 脚本表现为报错无法加载文件 ... 因为在此系统上禁止运行脚本用管理员身份打开 PowerShell执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser然后输入A确认。RemoteSigned表示本地创建的脚本可以运行从网络下载的脚本必须带有效签名才能运行安全性上比Unrestricted更稳。接下来就可以执行全局安装了npm install -g openclaw2026.3.1装完运行openclaw --version如果能输出版本号说明主体安装成功了。注意2026.3.1是版本限定符如果你直接npm install -g openclawnpm 默认装的是 latest可能和我这篇指南描述的版本行为不一致。3. 三套主流安装通道对比Windows 原生、Linux/macOS、Termux 手机版3.1 Windows 上搭建 openclaw 的两种姿势搜openclaw windows 搭建会出来一堆教程但核心差别只有一个你打算不打算重度使用本地 Docker 能力。姿势 A纯命令行 WSL2 就绪。这是最简洁的路线上面第 2 节已经走完了。Windows 终端里跑openclaw代理的自动执行进程跑在 Windows 侧。优点是启动快缺点是 Linux 专属的 skill 可能会因为命令不存在而失败。姿势 BWSL2 里装 Ubuntu再装 OpenClaw。在 WSL2 里执行后续 Linux 安装流程这样 openclaw 的所有子进程都跑在 Linux 环境Docker 技能包、shell 脚本技能包的兼容性最好。缺点是文件访问速度会让 Windows 和 Linux 之间跨文件系统操作略有延迟。我自己的选择是姿势 B 为主因为我要把 OpenClaw 和 Docker 里的 MySQL 8.0 之类的服务放在同一个网络域里避免 localhost 指向错乱。如果你只是轻量试用姿势 A 完全够用。3.2 Linux 与 macOSnpm 全局安装的标准路线在 Ubuntu 22.04 或更新版本上先装 Node.js。从 NodeSource 安装比较直接curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs git然后同样是全局安装sudo npm install -g openclaw2026.3.1 openclaw --versionmacOS 用户如果装了 Homebrew先brew install node再执行同一个 npm 命令即可。注意 macOS 上如果遇到EACCES权限报错说明 npm 的全局目录归属不对请用npm config get prefix查看并修改目录权限而不是直接sudo npm——sudo 装的全局包后续升级和卸载经常会碰到权限纠缠。安装完成后建议花两分钟跑一下环境自检openclaw doctor这个命令会检查 Node 版本、配置文件是否存在、skill 目录是否可写、Ollama 或 API 端点是否能连通算是一个比较友好的体检工具。很多你搞不清楚的环境问题openclaw doctor会直接给你列出原因。3.3 手机装 OpenClawTermux 的可行性到底有多高老看到有人搜如何用 termux 安装 openclaw 手机版下载步骤我得诚实说Termux 可以装但不适合当成主力环境。我手上的测试机是一部 Android 11 的旧手机装完跑了基本对话任务确实能出结果但有两个硬性限制一是 Termux 没有 systemd很多依赖 WSL/Docker 进程管理的 skill 无法运行二是手机后台容易被系统杀掉长时间挂机任务经常莫名中断。如果你想在手机上试一下步骤也很简单pkg update pkg install nodejs git npm install -g openclaw2026.3.1首次运行前还要执行termux-setup-storage授权存储权限否则 OpenClaw 读写外部文件时会报权限错误。手机版的体验结论是可以做轻量对话实验和简单文本任务做不了正经的自动化工作了。3.4 安装通道对照速查表部署方式推荐环境安装命令适合场景需要注意Windows 原生Win10/11 WSL2npm install -g openclaw日常试用、Windows 办公自动化需要 PowerShell 执行策略放行WSL2 UbuntuUbuntu 22.04sudo npm install -g openclaw生产级任务、Docker 协同跨文件系统 IO 略慢Linux 服务器Ubuntu 22.04sudo npm install -g openclaw7x24 常驻任务配置 systemd 守护进程macOSApple Silicon / Intelbrew install node npm install -g openclaw本地开发调试注意 npm 目录权限TermuxAndroid 11pkg install nodejs npm install -g openclaw轻量测试后台易被中断DockerLinux/群晖等见第 6.3 节干净隔离需要自己管理数据卷4. 第一次启动、配置文件与算力接入Ollama 本地模型和 API 的取舍4.1 启动后需要改的那个配置文件安装完成后第一次运行openclaw会自动进入初始化引导并生成一个主配置文件。在 2026.3.1 版本里配置文件的位置如下系统路径Windows%USERPROFILE%\.openclaw\config.yamlLinux/macOS~/.openclaw/config.yamlTermux~/storage/shared/.openclaw/config.yaml按实际授权路径这个 yaml 是整个 OpenClaw 的中枢神经。你不需要把所有字段都填完只需要关注三块模型来源、skill 目录、companion 开关。一个最小可用的配置长这样model: provider: ollama endpoint: http://localhost:11434 name: qwen2.5-3b skill: dir: ~/.openclaw/skills auto_install: true companion: enabled: false改完配置后重启openclaw让它重新加载。这里有个容易犯的错改了 yaml 后直接在同一个会话里继续对话很多配置不会热生效必须完全退出进程再启动。4.2 把 qwen2.5-3b 关联到 OpenClawOllama 部署路线很多人问OpenClaw 只能用接入 API 的方式使用算力吗这是个误会。它支持好几种 provider其中本地部署的路径就是通过 Ollama 把开源模型跑起来。流程分三步。先在终端装 OllamaWindows 和 macOS 有桌面安装包Linux 终端执行官方脚本然后拉取模型ollama pull qwen2.5-3b第二步验证 Ollama 服务是否正常ollama list curl http://localhost:11434/api/tags如果curl返回一个 JSON 列表说明服务正常。第三步重新加载 OpenClaw配置里选ollama模型名填qwen2.5-3b。启动后让它随便做一个小任务比如帮我在当前目录创建一个 notes.md 并写入今天的日期如果它真的执行了说明模型理解 工具执行的链路已经打通。这里我要提醒一个容易让人误判的问题3B 模型在复杂指令上的理解力有限同一个任务换 API 模型能一步完成本地小模型可能要拆成两步。不是 OpenClaw 出了问题是模型能力边界的问题。想本地体验完整效果至少上 7B 或 14B 的量化版本。4.3 云端 API 接入OpenAI 兼容接口的配置思路如果选择云端 API配置里把 provider 换成 openai-compatible并填写 base_url 和 api_key。以最常见的 OpenAI 兼容接口为例model: provider: openai-compatible base_url: https://api.example.com/v1 api_key: sk-xxx name: gpt-4o-mini需要注意2026.3.1 对 API 的鉴权字段名做了一次统一旧的api_key配置方式仍然有效但更推荐用环境变量OPENCLAW_API_KEY来传递密钥避免明文写在 yaml 里。配置完成后同样要重启进程。关于算力接入这个问题我最后给个明确回答OpenClaw 本身不提供算力它只负责对接算力。官方安装包不内置模型也不附带任何 GPU 加速能力你在网上看到的那些OpenClaw 怎么接入 xxx 模型的教程本质都是在它的 provider 配置层做文章。想免费接 Ollama想省事接 API两者可以共存在对话中按需切换 provider。5. Skills 与 Windows Companion装好之后真正拉开差距的部分5.1 openclaw skill 是怎么工作的Skill技能包是 OpenClaw 2026.3.1 最核心的扩展机制。简单说它就是一组指令描述 可执行脚本的打包文件让模型在遇到特定任务时知道调用哪个工具、传递什么参数。安装一个 skill 的通用命令openclaw skill install skill-name比如常见的文件处理类、网页抓取类、定时任务类 skill都可以用这条命令装。安装后可以在~/.openclaw/skills目录里看到对应的文件夹这个目录在配置文件的skill.dir里指定。如果你愿意自己写一个最简单的 skill 只需要一个 descriptor 文件和一段可执行脚本。descriptor 用 yaml 描述这个技能是干什么的、需要哪些参数、执行哪个命令脚本可以是 python、node、shell。模型在规划任务时会先看 descriptor 里的触发关键词和说明再决定要不要调用。5.2 Windows Companion 的配置如果你在 Windows 桌面上使用 OpenClaw会想要它像一个后台助手一样常驻而不是每次都得开终端。2026.3.1 提供的 Windows Companion 就是干这个的。配置步骤我实测下来的顺序是在主配置文件中把companion.enabled改为true并设置一个本地鉴权 token。运行openclaw companion start进程会以托盘方式常驻。打开 Companion 的配置面板填入 token与 CLI 完成配对。openclaw companion enable openclaw companion startCompanion 配好之后你可以把 OpenClaw 的最小化窗口常驻系统托盘任务触发时它会推送通知点击通知会唤起 CLI 界面查看执行日志。我在实际使用中感觉最舒服的点是它把常驻后台和手动交互分离开了临时想中断任务不用去杀进程。提示Companion 和 CLI 共用同一份配置和同一套 skill 目录但日志文件会分开存放。如果遇到Companion 收不到通知的问题先检查 Windows 通知设置里有没有把对应应用设为允许而不是急着重装。5.3 一条顺手的工作流示例光说不练没用我说一条我每天都在用的工作流用skill install daily-report安装日报生成技能配置好让它每天定时读取工作目录下当天新增的文档调用 Ollama 本地模型总结成要点再通过 Companion 推送到桌面。整个链条不需要我手动打开终端执行任何命令。这套工作流的调度逻辑其实很朴素OpenClaw 的 agent 在长期运行中按配置规则轮询任务队列匹配到定时任务后把任务描述交给模型模型根据 skill 描述选择并执行对应脚本最后把结果写回日志。你可以把过程理解为一个会读说明书、会调工具、会自动汇报的实习生——只不过它不睡觉。6. 卸载与善后怎么卸载 OpenClaw 才算干净6.1 卸载前必须先做的数据备份网上有人问怎么卸载 openclaw我想先说一个很多人忽略的点直接删安装目录会留下三样垃圾——全局命令软链、配置文件、skill 代码包。正确的卸载顺序是# 1. 停掉所有守护进程 openclaw daemon stop openclaw companion stop # 2. 导出你的配置和 skill 列表 openclaw export --output backup.tar.gz # 3. 卸载全局包 npm uninstall -g openclaw如果你在 Linux 或 macOS 上用了 pnpm 安装卸载命令相应换成pnpm remove -g openclaw。6.2 需要手动清掉的目录和残留npm 的卸载命令通常不会删除用户目录下的运行时数据。2026.3.1 会在以下几个位置留下东西按你的需要手动清理系统残留位置Windows%USERPROFILE%\.openclaw、%APPDATA%\openclaw、npm 全局目录中的 openclaw 相关文件Linux/macOS~/.openclaw、~/.config/openclaw、~/.cache/openclawTermux$PREFIX/../home/.openclaw其中~/.openclaw保存的是配置和 skill如果你打算换个环境继续用应该保留这份目录而不是删除。真正需要删干净的是 npm 全局痕迹和缓存目录。如果你在安装时曾让 OpenClaw 在 Windows 服务列表里注册过计划任务还需要手动打开任务计划程序检查是否有OpenClaw*命名的任务并删除。6.3 另一种卸载思路改用 Docker 部署之前先想清楚有人为了干净会直接改用 Docker 部署 OpenClaw思路是容器天生隔离卸载时docker rm -f就完事了。这个想法不坏但 Docker 部署 OpenClaw 有一个绕不开的问题模型推理本身不打包在 OpenClaw 里你仍然要额外拉一个 Ollama 镜像或者让容器连宿主机上的 Ollama 服务。相当于从两个进程互相依赖变成了两个容器互相依赖数据卷照样要管理卸载时多了一层网络清理。如果你执意走 Docker 路线一个参考命令是docker run -d --name openclaw \ -v $HOME/.openclaw:/root/.openclaw \ -p 127.0.0.1:8080:8080 \ openclaw/server:2026.3.1卸载时执行docker stop openclaw docker rm openclaw然后删除$HOME/.openclaw即可。7. 最后再分享几个折腾 2026.3.1 时总结出来的小习惯如果你准备长期用 OpenClaw这几件事越早养成习惯越好。第一固定 Node 版本。我在 2026.3.1 上踩过一次升级 Node 之后 openclaw 命令直接消失的坑。原因不是软件坏了而是 npm 全局包在 Node 版本变化后没有被重新链接。解决方案很简单升级 Node 之后重新执行一次npm install -g openclaw2026.3.1覆盖安装。第二改配置前先备份。OpenClaw 的 yaml 字段不算多但改错了启动时会直接拒绝加载。我建议每次改动前执行openclaw export --output backup-$(date %F).tar.gz比手动拷贝文件夹靠谱因为导出包会把 skill 的依赖关系一块整理好。第三勤看openclaw doctor。遇到任何诡异行为先跑一遍这个命令。它能查出 90% 以上的环境级问题包括端口占用、配置文件格式错误、本地模型服务未启动。省下来的时间远多于执行命令的那十几秒。这篇文章不是官方教程的复读机它是我在 Windows、Ubuntu、macOS、Termux 四条路线上各自走了一遍之后得出的实际操作记录。OpenClaw 2026.3.1 的安装门槛不算低但只要把这几个环节踩顺——WSL2 状态查清楚、Node 版本选对、配置文件一次写对、skill 按需安装——后面用起来会省心很多。你也别指望一晚上就把它全部搞明白先跑通最简单的对话任务再一点点加 skill焦虑感会少很多。