本文专为技术新手与开发者打造从环境准备、分系统安装、核心配置、首次运行、问题排查五大维度带你一步步从零搭建私人 AI 执行助理全程无复杂操作跟着做就能成功一、环境准备硬件与依赖全梳理先确认你的设备满足最低条件避免踩坑1.1 硬件要求CPUi5 / R5 及以上多核更好内存≥4GB推荐8GB运行更流畅存储剩余空间 ≥5GB1.2 软件依赖Node.js ≥ v22.14推荐 v24docs.openclaw.aiGit源码安装需要curl / PowerShell执行一键脚本二、三种安装方式OpenClaw 提供三种安装路径按你的需求选择2.1 一键脚本安装官方推荐3 分钟搞定适合新手、不想折腾、要最快部署1. WindowsPowerShell 管理员右键开始菜单 → 打开Windows PowerShell (管理员)/终端 (管理员)可选解决权限问题先执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force执行一键安装国内网络可用镜像# 官方原版 iwr -useb https://openclaw.ai/install.ps1 | iex # 国内镜像网络差推荐 iwr -useb https://gitee.com/openclaw/install/raw/main/install.ps1 | iex2. macOS / Linux / WSL2打开终端直接运行# 官方 curl -fsSL https://openclaw.ai/install.sh | bash # 国内镜像 curl -fsSL https://open-claw.org.cn/install-cn.sh | bash脚本会自动检测并安装 Node.js全局安装 OpenClaw自动启动初始化引导onboarddocs.openclaw.ai2.2 npm 全局安装适合已装 Node、想手动控制版本确认 Node 版本node --version # 必须 ≥v22.14.0可选切换国内 npm 镜像加速npm config set registry https://registry.npmmirror.com全局安装npm install -g openclawlatest2.3 源码安装适合想改代码、参与开发、自定义编。本篇博客面向新手源码安装可自行参考网上教程。三、安装验证安装完成后在终端输入openclaw --version # 或简写 openclaw -v出现版本号如v2026.3.8即安装成功。四、初始化配置安装成功后脚本会自动进入onboard 初始化向导若没自动启动手动运行openclaw onboard跟着终端提示一步步配置新手推荐Quick Start风险提示输入yes确认模式选择quick start填入你的LLM API Key如 OpenAI、DeepSeek、通义千问等连接通讯平台如 Slack、Discord新手可skip for now开启 Skills插件新手选no或skip完成后服务自动启动五、启动与访问 Web 面板配置完成后OpenClaw 默认在18789端口启动 Web 管理界面。启动服务如未自动启动openclaw start停止服务openclaw stop浏览器访问http://localhost:18789进入后就能看到 OpenClaw 控制台开始用自然语言指挥你的 AI 助理了。六、常见问题与避坑Windows 权限报错务必用管理员身份运行 PowerShell先执行Set-ExecutionPolicy RemoteSigned ...解锁策略Node 版本过低 / 安装失败升级Nodejs或重新官网下载安装国内网络下载超时一律用国内镜像脚本 /npm 镜像sharp 模块编译失败macOS 常见SHARP_IGNORE_GLOBAL_LIBVIPS1 npm install -g openclawlatest {insert\_element\_4\_}端口 18789 被占用# 修改端口 openclaw config set gateway.port 18789 openclaw restart七、下一步让 OpenClaw 真正干活安装完成只是开始你可以接入更多模型Claude、Gemini、本地 Ollama 等开启官方 / 社区 Skills文件管理、浏览器、代码执行、邮件等接入微信、钉钉、Slack 等平台让 AI 在聊天里帮你办事八、总结OpenClaw 把 “只能聊天” 的 AI变成了 “能干活” 的本地私人助理。安装非常友好 ——新手用一键脚本3 分钟就能跑起来有经验的用户可以 npm 或源码定制。核心亮点✅ 完全开源、本地运行、数据隐私✅ 跨平台Windows/macOS/Linux✅ 支持几乎所有主流大模型✅ 真正能操作文件、执行命令、调用工具现在就动手装一个体验 “AI 替你干活” 的快乐吧