2026年（龙虾）OpenClaw（原 Clawdbot ／ Moltbot）常见部署方式介绍（Linux部署、Windows桌面部署）

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

# OpenClaw 跨平台一键本地部署完整指南

本文将详细解析在 Windows、macOS 和 Linux 系统上实现 OpenClaw 一键本地部署的全流程，涵盖环境准备、安装方法、配置验证和常见问题解决方案。

🛠️ 环境准备与系统要求

在开始部署前，请确保您的设备满足以下基础要求：

组件	要求规格	验证命令	说明
操作系统	Windows 10/11、macOS 12+、Ubuntu 20.04+	`systeminfo`(Win) / `sw_vers`(mac) / `lsb_release -a`(Linux)	推荐在 WSL2 环境中运行 Windows 版本 [ref_1]
Node.js	≥ v22（推荐 v24 LTS）	`node --version`	这是最常见的报错原因，请务必检查版本 [ref_1][ref_5]
Git	最新稳定版	`git --version`	用于拉取项目代码和依赖 [ref_1]
Python	3.10+（可选）	`python --version`	部分插件依赖 [ref_1]

环境验证步骤

# 检查 Node.js 版本（关键步骤） node --version # 预期输出：v22.x.x 或更高 # 检查 Git 安装 git --version # 预期输出：git version 2.x.x # 检查系统架构（可选） uname -m # 确保与安装包架构匹配

🚀 一键部署实施方案

根据不同的操作系统，选择对应的安装方案：

方案 A：Windows 一键安装（PowerShell）

步骤 1：解锁脚本执行权限

# 以管理员身份打开 PowerShell，执行以下命令 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

系统会提示确认，输入 Y 并回车 [ref_1][ref_4]。

步骤 2：执行安装脚本

# 在 PowerShell 中执行一键安装命令 iwr -useb https://openclaw.ai/install.ps1 | iex

等待终端显示 "OpenClaw installed successfully" 即表示安装成功 [ref_1][ref_4]。

方案 B：macOS / Linux 一键安装

# 在终端中执行以下命令 curl -fsSL https://openclaw.ai/install.sh | bash

该脚本会自动检测环境、安装依赖并配置路径，适用于大多数 Linux 发行版和 macOS 系统 [ref_1][ref_2]。

方案 C：通用 NPM 安装（适用于已配置 Node.js 的环境）

# 通过 npm 全局安装最新版本 npm install -g openclaw@latest # 验证安装是否成功 openclaw --version

此方案适合已有 Node.js 开发环境的用户，安装过程更加透明可控 [ref_1][ref_4]。

⚙️ 初始化配置流程

安装完成后，必须运行初始化向导完成基础配置：

# 启动初始化向导 openclaw onboard

配置流程详细说明：

配置步骤	推荐选择	说明
安全风险确认	`Yes`	系统提示 AI 具有文件读写权限，确认继续 [ref_1]
模式选择	`QuickStart`	新手推荐快速启动模式 [ref_1]
模型提供商	`Qwen` 或 `Ollama`	国内用户推荐，网络稳定成本低 [ref_1][ref_3]
通信渠道	`Skip for now`	暂不接入 IM 工具，后续可配置 [ref_1]
技能安装	`No`	避免依赖冲突，按需安装 [ref_1]

🔍 部署验证与基础使用

服务启动与状态检查

# 启动网关服务（如果向导未自动启动） openclaw gateway start # 检查服务运行状态 openclaw status # 系统健康检查（排查问题必用） openclaw doctor

Web 界面访问验证

打开浏览器访问 http://127.0.0.1:18789
获取 Token：首次访问需要 Token，位于：
- 终端输出日志中
- 配置文件 ~/.openclaw/openclaw.json 中
登录验证：输入 Token 后应能看到 OpenClaw 控制面板 [ref_1][ref_3]

常用管理命令汇总

# 查看运行状态 openclaw status # 直接打开 Web 控制面板 openclaw dashboard # 重启服务（配置变更后） openclaw gateway restart # 停止服务 openclaw gateway stop

🎯 进阶配置选项

接入本地大模型（Ollama）

如需完全离线运行，可配置 Ollama 本地模型：

# 安装 Ollama（如尚未安装） curl -fsSL https://ollama.ai/install.sh | sh # 下载模型（示例） ollama run qwen2.5:7b # 在 OpenClaw 中配置 Provider 为 Ollama # 通过 openclaw onboard 重新配置或手动修改配置文件

开启局域网访问

默认情况下仅本机可访问，如需局域网共享：

# 修改绑定配置为局域网 openclaw config set bind lan # 重启服务生效 openclaw gateway restart

修改后可通过 http://[你的IP]:18789 在其他设备访问 [ref_1][ref_4]。

❗ 注意事项与故障排查

安全注意事项

工作目录隔离：OpenClaw 拥有文件系统操作权限，建议设置专门的工作目录，避免在生产环境根目录运行 [ref_1]
网络访问控制：开启局域网访问前确保网络环境安全 [ref_4]
定期更新：关注官方更新，及时获取安全补丁 [ref_3]

常见问题解决方案

问题现象	可能原因	解决方案
命令未找到	Node.js 未正确安装或 PATH 配置问题	重新安装 Node.js ≥ v22，验证 `node --version` [ref_1]
安装脚本执行失败	系统权限限制或网络问题	Windows：以管理员运行 PowerShell；检查网络连接 [ref_1][ref_4]
服务启动失败	端口冲突或依赖缺失	使用 `openclaw doctor` 诊断；检查 18789 端口占用 [ref_1][ref_6]
Web 界面无法访问	Token 错误或服务未正常运行	确认服务状态，检查配置文件中的 Token [ref_1]

通过以上完整的部署指南，您可以在任一主流操作系统上快速完成 OpenClaw 的一键本地部署，并根据实际需求进行个性化配置。整个安装过程通常可在 3-5 分钟内完成，即使是初学者也能轻松上手 [ref_4]。