1. 部署前环境准备在开始之前请确保您的设备满足以下基础要求这是安装成功的关键操作系统WindowsWindows 10/11推荐使用WSL2环境以获得最佳稳定性或直接使用 PowerShell〔1〕〔31〕。macOSmacOS 12 (Monterey) 及以上版本〔20〕。LinuxUbuntu 20.04、Debian 11 等发行版〔24〕。核心依赖软件Node.js必须版本 ≥ v22推荐 v24 LTS。这是最常见的报错原因请务必检查版本〔5〕〔32〕。Git用于拉取项目代码和依赖〔13〕。Python建议 Python 3.10部分插件依赖〔1〕。2. OpenClaw 安装步骤根据您的操作系统选择以下一种方式进行安装。方案 AWindows 一键安装PowerShell解锁脚本权限以管理员身份打开 PowerShell执行以下命令并输入Y确认以允许运行脚本powershell复制Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser〔15〕执行安装脚本在 PowerShell 中粘贴并运行以下命令powershell复制iwr -useb https://openclaw.ai/install.ps1 | iex等待终端显示 “OpenClaw installed successfully” 即表示安装成功〔13〕〔31〕。方案 BmacOS / Linux 一键安装在终端Terminal中执行以下命令bash复制curl -fsSL https://openclaw.ai/install.sh | bash该脚本会自动检测环境、安装依赖并配置路径〔15〕〔26〕。方案 C通用 NPM 安装适用于已安装 Node.js 的环境如果您熟悉前端开发环境可以直接通过 npm 全局安装bash复制npm install -g openclawlatest安装完成后可通过openclaw --version验证是否成功〔5〕〔25〕。3. 初始化配置 (Onboarding)安装完成后必须运行初始化向导来生成密钥和配置文件。启动向导在终端输入以下命令bash复制openclaw onboard〔12〕〔33〕配置流程指引安全风险确认系统会提示 AI 具有文件读写权限选择Yes确认继续〔28〕。模式选择新手推荐选择QuickStart快速启动模式〔12〕。选择模型提供商 (Provider)国内用户推荐选择Qwen(通义千问) 或Ollama(本地模型)网络连接更稳定且成本较低〔12〕〔32〕。海外用户可选择 OpenAI、Anthropic 等。通信渠道 (Channels)如果暂不需要接入 Telegram 或飞书选择Skip for now稍后可在配置文件中修改〔12〕。技能安装 (Skills)建议选择No跳过后续按需安装避免依赖冲突〔28〕。启动服务配置完成后向导通常会自动启动服务。如果未启动可手动运行bash复制openclaw gateway start〔10〕4. 验证与使用访问 Web 界面打开浏览器访问http://127.0.0.1:18789。首次访问可能需要 TokenToken 位于终端输出日志或配置文件~/.openclaw/openclaw.json中〔10〕〔37〕。常用管理命令openclaw status查看运行状态。openclaw doctor系统健康检查排查问题必用。openclaw dashboard直接打开 Web 控制面板。openclaw gateway restart重启服务。〔26〕〔6〕5. 进阶配置可选接入本地大模型 (Ollama)如果您希望完全离线运行可以安装 Ollama 并下载模型如ollama run glm-4.7-flash然后在 OpenClaw 中配置 Provider 为 Ollama〔32〕。接入飞书/钉钉OpenClaw 支持接入飞书等企业通讯工具。需在飞书开放平台创建应用获取 App ID 和 App Secret然后通过命令openclaw config set channels.feishu...进行配置〔5〕〔14〕。开启局域网访问默认情况下仅本机可访问Bind: Loopback。如需局域网其他设备访问需修改配置将 Bind 改为lan〔37〕。注意事项OpenClaw 拥有对您电脑文件系统的操作权限请勿在生产环境的根目录运行建议为其设置专门的工作目录Workspace以确保安全〔5〕。