一、系统准备1.1 更新系统软件包sudo apt update sudo apt upgrade -y确保系统处于最新状态避免后续因依赖版本过旧导致安装失败。二、安装 Node.js 环境推荐使用 NVMOpenClaw 依赖 Node.js 22推荐通过 NVMNode Version Manager进行管理方便后续切换版本。2.1 安装 curlsudo apt install curl2.2 安装 NVMcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash2.3 使 NVM 生效source ~/.bashrc2.4 安装 Node.js 22nvm install 222.5 验证安装结果node -v # 应显示 v22.x.x npm -v三、安装 Gitsudo apt install git四、安装 OpenClaw4.1 执行官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装脚本将自动拉取并部署 OpenClaw 相关组件。五、Onboarding 模式选择强烈建议选 Manual安装完成后系统会提示选择Onboarding 模式onboarding mode: [1] quickstart [2] manual⚠️ 为什么不推荐 Quickstartquickstart模式会自动完成一系列配置操作但这正是坑所在如果在配置过程中意外中断例如强制退出某个配置步骤极易导致Gateway 未完全安装或初始化。一旦 Gateway 初始化不完整后续将无法正常进入 Dashboard整个安装过程前功尽弃需要重来。真实踩坑案例在配置飞书 IM 集成时由于一直配置不成功想跳过该步骤但配置流程不允许退出。无奈之下强制终止了进程。此后执行openclaw dashboard命令因 Gateway 根本未完成初始化导致完全无法进入后台。✅ 推荐选择 Manual 模式manual模式会优先引导完成 Gateway 的安装与初始化这是整个系统能否正常运行的关键步骤。确保 Gateway 正确完成初始化。后续的其他配置如 IM 集成、大模型调用等随时可以独立进行不会影响核心功能。即使某项配置暂时跳过也不会影响进入 Dashboard。安装完毕可在终端键入openclaw onboard即可重新配置OpenClaw包括IM 即时通讯工具的绑定一句话总结先保证能进 Dashboard其他配置随后再说。六、验证 OpenClaw 安装openclaw --version openclaw --help七、使用注意事项⚠️ 不要让 OpenClaw 自动修改大模型配置在已正常运行的环境中若通过 OpenClaw 自带功能自动修改大模型调用配置存在一定风险有概率影响 Dashboard 的正常启动。建议在修改此类配置前手动备份相关配置文件并在熟悉配置结构后再进行操作。八、部署流程总览系统更新 ↓ 安装 curl / git ↓ 安装 NVM → 安装 Node.js 22 ↓ 执行 OpenClaw 安装脚本 ↓ Onboarding 模式选择 → 选 manual重要 ↓ 完成 Gateway 初始化 ↓ 验证进入 Dashboard ↓ 其他配置IM、大模型等按需配置九、快速命令速查操作命令更新系统sudo apt update sudo apt upgrade -y安装 NVMcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash加载 NVMsource ~/.bashrc安装 Node 22nvm install 22安装 Gitsudo apt install git安装 OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash查看版本openclaw --version查看帮助openclaw --help