目录1.为什么要本地部署先搞懂这三点1.数据隐私可控2.长期零成本3.断网也能用2.部署前的“全家桶”准备3.Windows 11本地部署最全版本第一步以管理员身份打开PowerShell第二步解锁执行策略第三步一键安装核心依赖第四步验证安装第五步配置国内镜像加速下载第六步全局安装OpenClaw第七步初始化配置第八步启动服务第九步生成访问Token第十步访问Web控制台4.MacOS本地部署Intel芯片/M芯片通用第一步打开终端第二步安装Homebrew包管理工具第三步安装Node.js 22第四步验证安装第五步配置国内镜像可选但推荐第六步全局安装OpenClaw第七步初始化配置第八步启动服务第九步生成Token并访问5.Linux本地部署Ubuntu 20.04第一步打开终端第二步安装Node.js 22和Git第三步验证安装第四步配置国内镜像可选第五步全局安装OpenClaw第六步初始化配置第七步启动服务第八步生成Token并访问6.进阶玩法对接本地大模型OllamaQwen第一步安装Ollama第二步拉取本地模型推荐Qwen2.5 7B第三步定制模型扩展上下文窗口第四步重新配置OpenClaw对接本地模型7.Skill安装给“龙虾”装技能核心安全原则先装安全工具再装功能插件常用必备Skill一键安装查看已安装Skill8.避坑指南新手必看坑1Node.js版本过低坑2端口被占用坑3模型上下文窗口过小坑4Token泄露坑5Skill安装失败1.为什么要本地部署先搞懂这三点在动手之前咱们先花3分钟搞清楚一个问题为什么要把OpenClaw装在本地而不是直接用云端版1.数据隐私可控你的聊天记录、文件内容、API密钥全都留在自己电脑里不用上传任何第三方服务器。这对处理敏感数据的人来说是刚需。2.长期零成本云端部署虽然方便但Token消耗起来是真的肉疼——重度用户一天烧掉上百万Token长期下来不是小数目。本地部署搭配Ollama本地模型等于一次性投入终身免费。3.断网也能用哪怕家里断网、出差飞机上只要你电脑有电OpenClaw就能干活。2.部署前的“全家桶”准备不管你是哪个系统下面这几样东西必须先准备好核心凭证1.阿里云百炼API-Key用于调用大模型能力新用户有免费额度2.获取路径登录阿里云百炼大模型服务平台 → 密钥管理 → 创建API-Key生成后立即复制保存关掉页面就看不到了辅助工具1.浏览器Chrome/Edge都行2.文本编辑器VS Code或记事本都够用3.一个加密记事本专门存API-Key和Token网络要求确保网络通畅能正常下载依赖包建议提前配好国内镜像后面有命令3.Windows 11本地部署最全版本第一步以管理员身份打开PowerShell右键点击开始菜单 → 选择“Windows PowerShell管理员”这一步很重要否则后面会权限报错。第二步解锁执行策略powershell Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force输入这行命令回车看到没有任何报错就行。第三步一键安装核心依赖powershell # 安装Node.js 22OpenClaw运行必须 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”第四步验证安装powershell node --version # 应显示v22.x.x npm --version # 应显示10.x.x python --version # 应显示Python 3.9.x如果版本都对继续下一步。第五步配置国内镜像加速下载powershell npm config set registry https://registry.npmmirror.com这步能让你后面安装快3倍以上。第六步全局安装OpenClawpowershell npm install -g openclawlatest等进度条跑完出现绿色的“added xxx packages”就成功了。第七步初始化配置powershell openclaw init系统会进入交互式配置界面按提示操作· 选择模型提供商选“Custom Provider”· 输入API Base URLhttps://dashscope.aliyuncs.com/compatible-mode/v1阿里云百炼地址· 输入API Key粘贴你刚才保存的百炼API-Key· 其他选项全部回车默认第八步启动服务powershell openclaw start看到“Server running on port 18789”的提示说明启动成功。第九步生成访问Tokenpowershell openclaw start复制输出的那串长字符串以oc_开头保存好。第十步访问Web控制台打开浏览器输入http://localhost:18789/?token刚才复制的Token看到OpenClaw的对话界面恭喜你Windows版“龙虾”养成功4.MacOS本地部署Intel芯片/M芯片通用第一步打开终端在“启动台”搜索“终端”打开。第二步安装Homebrew包管理工具bash /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)如果已经装过这步可以跳过。第三步安装Node.js 22bash brew install node22 echo export PATH/usr/local/opt/node22/bin:$PATH ~/.zshrc source ~/.zshrcM芯片的Mac会自动安装ARM版本不用担心兼容性。第四步验证安装bash node --version npm --version应该看到v22.x.x和10.x.x。第五步配置国内镜像可选但推荐bash npm config set registry https://registry.npmmirror.com第六步全局安装OpenClawbash npm install -g openclawlatest第七步初始化配置bash openclaw init交互步骤和Windows完全一样按提示输入阿里云百炼API-Key即可。第八步启动服务bash openclaw start第九步生成Token并访问bash openclaw token generate浏览器输入http://localhost:18789/?token你的Token搞定5.Linux本地部署Ubuntu 20.04第一步打开终端第二步安装Node.js 22和Gitbash curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash sudo apt install -y nodejs git第三步验证安装bash node --version npm --version第四步配置国内镜像可选​bash npm config set registry https://registry.npmmirror.com ​第五步全局安装OpenClawbash npm install -g openclawlatest第六步初始化配置bash openclaw init同样是交互式配置输入阿里云百炼API-Key。第七步启动服务bash sudo openclaw startLinux下可能需要sudo权限。第八步生成Token并访问bash openclaw token generate浏览器访问http://你的本地IP:18789/?token你的Token。6.进阶玩法对接本地大模型OllamaQwen如果你不想用云端API想完全本地运行可以搭配Ollama使用。第一步安装Ollama访问Ollama官网ollama.com下载对应系统的安装包一路下一步。第二步拉取本地模型推荐Qwen2.5 7Bbash # Windows/Mac/Linux通用 ollama pull qwen2.5:7b这个模型约4.7GB显存4GB以上的显卡都能跑。第三步定制模型扩展上下文窗口OpenClaw要求上下文窗口≥16000 tokens默认模型只有4096需要手动定制bash # 创建Modelfile配置文件 echo FROM qwen2.5:7b PARAMETER num_ctx 32768 Modelfile # 创建自定义模型 ollama create qwen2.5:7b-32k -f Modelfile第四步重新配置OpenClaw对接本地模型bash openclaw config wizard这次选择· 模型提供商Custom Provider· API Base URLhttp://127.0.0.1:11434/v1· API Key任意输入比如“ollama”· Model IDqwen2.5:7b-32k7.Skill安装给“龙虾”装技能部署只是第一步装Skill才是让“龙虾”真正干活的关键。核心安全原则先装安全工具再装功能插件bash # 安装安全扫描工具 clawhub install skill-vetting这个工具能从源头拦截恶意插件强烈建议第一个装。常用必备Skill一键安装bash # 文件管理器 clawhub install file-manager # 内容摘要 clawhub install summary # 邮件处理 clawhub install email # 定时任务 clawhub install scheduler # 网页自动化 clawhub install web-automation # 数据抓取 clawhub install scraper安装完成后重启服务生效。查看已安装Skillbash clawhub list8.避坑指南新手必看根据上百位读者的反馈我整理了最常见的几个坑坑1Node.js版本过低症状安装报错“requires Node.js 22.0.0”解决去官网重装最新版或者用n升级sudo n 22.0.0坑2端口被占用症状启动时提示“port 18789 already in use”解决关掉其他占用程序或者改端口openclaw config set server.port 18790坑3模型上下文窗口过小症状调用时报错“Model context window too small”解决按06部分定制模型或者修改配置文件增加num_ctx参数坑4Token泄露症状发现陌生IP访问你的控制台解决立即重新生成Tokenopenclaw token generate --admin不要把Token截图发群里坑5Skill安装失败症状clawhub install卡住或报错解决检查网络或从GitHub直接拉取git clone 技能地址