1. 小龙虾安装手册概述OpenClaw小龙虾是一款功能强大的开源自动化工具平台能够帮助开发者快速构建和部署各类自动化工作流。这份安装手册将详细介绍在不同操作系统环境下安装OpenClaw的完整流程包括Windows PowerShell和Linux/macOS的bash环境下的安装方法。作为一个长期使用各类开发工具的老手我发现OpenClaw的安装过程虽然简单但其中有不少值得注意的细节。特别是对于刚接触命令行工具的新手来说可能会遇到一些意想不到的问题。接下来我将结合自己多次安装OpenClaw的经验为大家提供一份详尽的安装指南。2. 系统环境准备2.1 操作系统要求OpenClaw支持三大主流操作系统平台Windows 10/11推荐使用PowerShell 5.1或更高版本macOS 10.15及以上版本主流Linux发行版Ubuntu/Debian/CentOS等注意Windows用户如果遇到安装问题可以考虑使用WSL2作为替代方案这通常能解决大多数兼容性问题。2.2 必备软件检查在开始安装前请确保系统中已安装以下基础软件Node.js建议版本v16.x或更高检查命令node -v若未安装可从 nodejs.org 下载LTS版本包管理工具npm随Node.js自动安装可选pnpm或bun性能更优的替代方案命令行工具WindowsPowerShell 5.1macOS/Linuxbash或zsh3. 主要安装方法详解3.1 推荐安装方式一键脚本这是最快捷的安装方法安装脚本会自动检测系统环境并完成所有必要配置。3.1.1 macOS/Linux/WSL2安装curl -fsSL https://openclaw.ai/install.sh | bash这个命令会下载官方安装脚本自动检测并安装必要的依赖如Node.js完成OpenClaw核心组件的安装启动新手引导流程如果不想自动运行新手引导可以使用curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard3.1.2 Windows PowerShell安装iwr -useb https://openclaw.ai/install.ps1 | iex等效的不运行新手引导的版本 ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard3.2 替代安装方案3.2.1 本地前缀安装不污染系统环境适合希望将OpenClaw安装在用户目录下的用户curl -fsSL https://openclaw.ai/install-cli.sh | bash这种方式会将所有文件安装在~/.openclaw目录下不会影响系统全局环境。3.2.2 使用包管理器安装如果已经配置好Node.js环境可以直接通过npm安装npm install -g openclawlatest openclaw onboard --install-daemon使用pnpm的用户pnpm add -g openclawlatest pnpm approve-builds -g openclaw onboard --install-daemon使用bun的用户bun add -g openclawlatest openclaw onboard --install-daemon3.2.3 从源代码构建适合开发者或需要自定义构建的用户git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm build pnpm ui:build pnpm link --global openclaw onboard --install-daemon4. 安装后配置与验证4.1 基本功能验证安装完成后执行以下命令验证安装是否成功openclaw --version # 查看版本号 openclaw doctor # 检查系统配置 openclaw gateway status # 检查网关服务状态4.2 后台服务配置为了让OpenClaw在后台持续运行需要配置守护进程macOS:openclaw onboard --install-daemon或openclaw gateway installLinux/WSL2: 同样使用上述命令会自动配置systemd用户服务Windows: 会尝试创建计划任务如果失败则使用启动文件夹方式4.3 更新与维护保持OpenClaw更新的方法openclaw update --channel dev # 开发版 openclaw update --channel stable # 稳定版5. 常见问题排查5.1 命令未找到command not found这通常是PATH环境变量问题解决方法确认Node.js已正确安装node -v查找npm全局安装路径npm prefix -g将该路径添加到PATH环境变量中5.2 SSL证书问题如果遇到SSL证书错误可以尝试curl -kfsSL https://openclaw.ai/install.sh | bash不推荐长期使用-k参数建议修复系统证书5.3 Windows特定问题PowerShell执行策略限制 以管理员身份运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser防病毒软件拦截 临时禁用防病毒软件或添加例外规则6. 高级部署方案6.1 Docker容器部署docker run -d --name openclaw -p 3000:3000 openclaw/openclaw:latest6.2 Kubernetes部署参考官方提供的Helm charthelm repo add openclaw https://charts.openclaw.ai helm install my-openclaw openclaw/openclaw6.3 云服务器部署各大云平台推荐配置最低配置1核CPU2GB内存推荐配置2核CPU4GB内存存储至少20GB SSD7. 使用建议与技巧多环境管理 使用openclaw env命令管理不同环境配置插件系统 OpenClaw有丰富的插件生态安装方法openclaw plugin install plugin-name性能调优调整网关线程数openclaw config set gateway.threads4增加内存限制openclaw config set gateway.memory2048日志查看openclaw logs --follow # 实时查看日志 openclaw logs --error # 只看错误日志在实际使用中我发现OpenClaw的配置灵活性很高但这也意味着新手可能需要一些时间来熟悉各种配置选项。建议初次使用时先保持默认配置等熟悉基本功能后再逐步调整高级参数。
