提供 OpenClaw 在 Windows、MacOS 和 Linux 系统上的本地部署完整指南。内容包括环境准备、各平台安装步骤、配置阿里云百炼或本地 Ollama 模型、安装功能插件（Skill）以及常见故障排查。旨在帮助用户实现数据隐私可控、零成本及离线可用的本地 AI 助手。
在动手之前，我们先花 3 分钟搞清楚一个问题：为什么要把 OpenClaw 装在本地，而不是直接用云端版？
你的聊天记录、文件内容、API 密钥全都留在自己电脑里，不用上传任何第三方服务器。这对处理敏感数据的人来说，是刚需。
云端部署虽然方便，但 Token 消耗起来成本高——重度用户一天烧掉上百万 Token，长期下来不是小数目。本地部署搭配 Ollama 本地模型，等于一次性投入，终身免费。
哪怕家里断网、出差飞机上，只要你电脑有电，OpenClaw 就能干活。
不管你是哪个系统，下面这几样东西必须先准备好：
核心凭证：
辅助工具：
网络要求： 确保网络通畅，能正常下载依赖包（建议提前配好国内镜像，后面有命令）
右键点击开始菜单 → 选择'Windows PowerShell（管理员）'，这一步很重要，否则后面会权限报错。
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
输入这行命令，回车，看到没有任何报错就行。
# 安装 Node.js 22+（OpenClaw 运行必须）
winget install OpenJS.NodeJS.LTS --version 22.2.0
# 安装 Python 3.9（部分 Skill 依赖）
winget install Python.Python.3.9
# 安装 Git（拉取代码用）
winget install Git.Git
如果 winget 命令报错，可以去官网手动下载安装： Node.js 官网：https://nodejs.org（选 LTS 版，安装时勾选'Add to PATH'） Python 官网：https://python.org（选 3.9+，安装时勾选'Add Python.exe to PATH'）
node --version # 应显示 v22.x.x
npm --version # 应显示 10.x.x
python --version # 应显示 Python 3.9.x
如果版本都对，继续下一步。
npm config set registry https://registry.npmmirror.com
这步能让你后面安装快 3 倍以上。
npm install -g openclaw@latest
等进度条跑完，出现绿色的'added xxx packages'就成功了。
openclaw init
系统会进入交互式配置界面，按提示操作： · 选择模型提供商：选'Custom Provider' · 输入 API Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1（阿里云百炼地址） · 输入 API Key：粘贴你刚才保存的百炼 API-Key · 其他选项全部回车默认
openclaw start
看到'Server running on port 18789'的提示，说明启动成功。
openclaw token generate
复制输出的那串长字符串（以 oc_开头），保存好。
打开浏览器，输入： http://localhost:18789/?token=刚才复制的 Token 看到 OpenClaw 的对话界面，恭喜你，Windows 版 OpenClaw 部署成功！
在'启动台'搜索'终端'，打开。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
如果已经装过，这步可以跳过。
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
M 芯片的 Mac 会自动安装 ARM 版本，不用担心兼容性。
node --version
npm --version
应该看到 v22.x.x 和 10.x.x。
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest
openclaw init
交互步骤和 Windows 完全一样，按提示输入阿里云百炼 API-Key 即可。
openclaw start
openclaw token generate
浏览器输入 http://localhost:18789/?token=你的 Token，搞定！
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs git
node --version
npm --version
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest
openclaw init
同样是交互式配置，输入阿里云百炼 API-Key。
sudo openclaw start
Linux 下可能需要 sudo 权限。
openclaw token generate
浏览器访问 http://你的本地 IP:18789/?token=你的 Token。
如果你不想用云端 API，想完全本地运行，可以搭配 Ollama 使用。
访问 Ollama 官网（ollama.com）下载对应系统的安装包，一路下一步。
# Windows/Mac/Linux 通用
ollama pull qwen2.5:7b
这个模型约 4.7GB，显存 4GB 以上的显卡都能跑。
OpenClaw 要求上下文窗口≥16000 tokens，默认模型只有 4096，需要手动定制：
# 创建 Modelfile 配置文件
echo "FROM qwen2.5:7b PARAMETER num_ctx 32768" > Modelfile
# 创建自定义模型
ollama create qwen2.5:7b-32k -f Modelfile
openclaw config wizard
这次选择： · 模型提供商：Custom Provider · API Base URL：http://127.0.0.1:11434/v1 · API Key：任意输入（比如'ollama'） · Model ID：qwen2.5:7b-32k
部署只是第一步，装 Skill 才是让 OpenClaw 真正干活的关键。
# 安装安全扫描工具
clawhub install skill-vetting
这个工具能从源头拦截恶意插件，强烈建议第一个装。
# 文件管理器
clawhub install file-manager
# 内容摘要
clawhub install summary
# 邮件处理
clawhub install email
# 定时任务
clawhub install scheduler
# 网页自动化
clawhub install web-automation
# 数据抓取
clawhub install scraper
安装完成后重启服务生效。
clawhub list
根据上百位读者的反馈，我整理了最常见的几个坑：
症状：安装报错'requires Node.js >=22.0.0' 解决：去官网重装最新版，或者用 n 升级：sudo n 22.0.0
症状：启动时提示'port 18789 already in use' 解决：关掉其他占用程序，或者改端口：openclaw config set server.port 18790
症状：调用时报错'Model context window too small' 解决：按 06 部分定制模型，或者修改配置文件增加 num_ctx 参数
症状：发现陌生 IP 访问你的控制台 解决：立即重新生成 Token：openclaw token generate --admin，不要把 Token 截图发群里
症状：clawhub install 卡住或报错 解决：检查网络，或从 GitHub 直接拉取：git clone 技能地址
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online