OpenClaw 完整安装教程（2026 全平台通用版）
OpenClaw 完整安装教程2026 全平台通用版从环境准备到 GLM-4.6 模型接入1. OpenClaw 是什么 环境要求OpenClaw 是一款功能强大的 AI 助手工具支持本地部署可以接入 GLM-4.6、Claude 等多种大模型实现代码辅助、自动化工作流等核心能力。它最大的特点是部署在自己的机器上数据可控、模型可选。支持平台macOS 12LinuxUbuntu 20.04、Debian 11、Fedora 38Windows 10 / 11硬性要求Node.js v20推荐 v22 LTS。安装前先确认自己的系统满足这些条件否则后续步骤可能失败。2. 安装 Node.js全平台macOSbrewinstallnode22LinuxUbuntu / Debiancurl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejsWindows到 Node.js 官网下载安装包一路下一步即可https://nodejs.org/zh-cn/download/验证安装node-vnpm-v两个命令都能输出版本号说明 Node.js 安装成功。3. 三种安装方式按需选一种方式一一键安装新手首选macOS / Linuxcurl-fsSLhttps://openclaw.ai/install.sh|bashWindows管理员 PowerShell以管理员身份运行 PowerShell按 Win 键 → 搜索 PowerShell → 右键选择以管理员身份运行 → 点击是确认。先执行两条命令设置执行策略Set-ExecutionPolicyRemoteSigned-Scope CurrentUserSet-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass这两条命令的作用都是允许当前用户运行本地和下载的脚本。它们只影响你自己的账户不会影响系统安全或其他用户。然后执行安装命令iwr-useb https://openclaw.ai/install.ps1|iex方式二npm 手动安装macOS / Linuxsudonpminstall-gopenclawlatestWindowsnpminstall-gopenclawlatestmacOS 常见坑sharp 安装失败如果你在 macOS 上安装时遇到 sharp 相关的报错可以加一个环境变量绕过全局的 libvips 依赖SHARP_IGNORE_GLOBAL_LIBVIPS1npminstall-gopenclawlatest验证安装openclaw--version方式三Docker 部署如果你机器上装了 Docker也可以用容器方式运行环境隔离最干净dockerrun-d\--nameopenclaw\-p3000:3000\-v~/.openclaw:/root/.openclaw\openclaw/openclaw:latest这条命令的含义启动名为 openclaw 的容器把宿主机的 3000 端口映射到容器同时把本地的~/.openclaw数据目录挂载进容器这样数据不会随容器销毁而丢失。4. 初始化配置必做安装完成后第一次使用必须执行初始化向导openclaw onboard按提示一步步配置风险告知向导会提示使用 OpenClaw 可能存在风险。按左方向键选择 Yes按 Enter 确认。选择配置模式选择 QuickStart 模式配置 AI 模型 API Key。配置 GLM-4.6/4.7重点步骤输入智谱 AI 的 API Key。需要先到智谱开放平台注册登录进入 API 密钥管理创建一个密钥然后填入这里。连接通讯平台向导会询问要连接哪个通讯平台如 Slack、Discord 等暂时跳过选择 skip for now。Skills 选择选择 NO暂时不启用。Hooks选择 skip for now跳过。配置完成后启动服务并打开 UI 界面就大功告成了。5. 启动与使用OpenClaw 运行需要两个窗口配合窗口 A执行openclaw gateway启动网关保持这个窗口打开窗口 B执行openclaw dashboard启动控制台会自动打开网页Web 控制台地址http://localhost:3000为了方便这里提供一个 Windows 一键启动脚本。桌面新建一个 txt 文件复制下面的代码然后把后缀名改成OpenClaw 网关启动.bat双击运行即可echo off echo Using Node v22.12.0 via nvm... nvm use 22.12.0 nul echo Starting OpenClaw Gateway... openclaw gateway start6. 常见问题排查权限不足macOS / Linux在命令前面加 sudoWindows用管理员终端运行sharp 安装失败macOS先安装系统级的 vips 依赖再重新安装 OpenClawbrewinstallvipsnpminstall-gopenclawlatest模型调用失败检查 API Key、Base URL、模型名是否配置正确执行openclaw restart重启服务7. 总结到这里一个可用的 OpenClaw 就装好了。完整链路是装 Node.js → 选一种方式装 OpenClaw → 执行 onboard 配置 GLM-4.6 → 启动 gateway dashboard → 在 Web 控制台使用。配置完成后你就可以在本地 Web 控制台或 VS Code 中调用 GLM-4.6 等模型实现 AI 辅助开发、自动化工作流等场景。遇到问题先按第六章排查大多数问题都是权限、依赖或 API Key 配置引起的。