一、前置环境准备1.1 安装 Node.js版本≥22Windows下载官方 64 位 .msi 安装包安装时务必勾选“Add Node.js to PATH”自动配置环境变量〔1〕验证重启终端后执行node -v需显示 v22.x.x 或更高版本〔1〕〔4〕1.2 安装 GitWindows下载 64 位安装包全程保持默认选项自动配置环境变量〔1〕验证执行git --version确认版本号正常返回〔1〕1.3 Windows 额外配置PowerShell 权限以管理员身份打开 PowerShell执行以下命令解除脚本执行限制powershell复制Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入Y确认〔1〕〔20〕二、核心程序安装方案 A官方一键安装推荐根据操作系统选择对应命令WindowsPowerShell 管理员powershell复制iwr -useb https://openclaw.ai/install.ps1 | iex等待终端显示 “Clawdbot installed successfully” 即完成〔1〕〔7〕Linux/macOSbash复制curl -fsSL https://openclaw.ai/install.sh | bash或使用国内加速镜像bash复制curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/openclawchinesetranslationmain/install.sh | bash〔7〕〔23〕方案 Bnpm 全局安装若已配置 Node.js 环境可直接使用包管理器bash复制npm install -g openclawlatest如遇权限不足Linux/macOS在命令前添加sudo〔7〕方案 C源码编译开发者适用于需要二次开发或自定义构建的场景bash复制git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # 构建前端 UI首次需要 pnpm build # 构建整个项目〔3〕〔5〕三、初始化配置向导执行以下命令启动交互式配置bash复制openclaw onboard或同时安装后台守护进程实现开机自启bash复制openclaw onboard --install-daemon〔1〕〔7〕关键配置项说明表格复制配置步骤选项说明推荐选择ModeQuickStart自动配置/ Advanced自定义QuickStart新手友好〔1〕ProviderAI 模型平台Qwen/OpenAI 等Qwen国内可直接访问有免费额度〔1〕〔4〕Default model默认使用的 AI 模型保持默认qwen-portal/coder-model〔1〕Channels聊天平台Telegram/WhatsApp/飞书等国内用户先选Skip for now后续手动配置飞书〔1〕Skills功能模块文件操作、代码执行等选择Yes启用基础技能〔1〕Skill install包管理器选择npm兼容性最好国内可镜像加速〔1〕API 密钥第三方服务密钥谷歌地图等国内无法使用这些服务选No〔1〕四、启动服务与验证4.1 启动网关配置完成后执行bash复制openclaw gateway start或后台运行Linux/macOSbash复制openclaw gateway start --daemon〔1〕〔3〕4.2 访问管理界面在浏览器中打开text复制http://127.0.0.1:18789进入 OpenClaw Web 控制面板〔1〕〔3〕4.3 验证安装状态bash复制openclaw --version # 查看版本号 openclaw gateway health # 检查网关健康状态 openclaw dashboard # 打开 Web 面板〔12〕〔15〕五、国内适配飞书通道配置可选飞书是国内官方支持的平台配置步骤如下飞书开放平台创建企业自建应用获取App ID和App Secret〔1〕〔9〕编辑配置文件修改C:\Users\你的用户名\.openclaw\openclaw.jsonWindows或~/.openclaw/openclaw.jsonLinux/Mac添加json复制channels: { feishu: { enabled: true, appId: 你的App ID, appSecret: 你的App Secret, connectionMode: websocket } }〔1〕3.重启网关bash复制openclaw gateway restart〔1〕六、常见问题解决表格复制问题现象解决方案code 128 错误网络波动或 SSH 访问失败执行npm cache clean --force后重试〔24〕4048 错误权限不足以管理员身份运行终端或检查文件夹权限〔24〕无法加载脚本执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser并输入Y〔27〕网络失败关闭电脑管家、360 等安全软件后重试或配置 npm 国内镜像源〔24〕〔27〕构建报错强制使用预编译二进制SHARP_IGNORE_GLOBAL_LIBVIPS1 npm install -g openclawlatest〔2〕七、后续操作查看日志openclaw logs --follow实时跟踪〔2〕停止服务openclaw gateway stop完全卸载删除安装目录及~/.openclaw或%USERPROFILE%\.openclaw配置文件夹〔16〕