小龙虾OpenClaw本地部署通用教程（Windows ／ macOS ／ Linux）

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

本文是OpenClaw在Windows、MacOS和Linux系统上的部署与配置教程，希望能够让大家都能拥有一个属于自己的智能自动化助手。

操作系统：Windows 10/11、macOS 12+、Ubuntu 20.04+ 等主流64位系统
硬件建议：内存 ≥ 4GB（推荐 8GB），磁盘空间 ≥ 20GB
核心依赖：
- Node.js：版本 ≥ 22（推荐 22.x 或 24.x LTS）
- 包管理器：npm（随 Node.js 安装）或 pnpm（推荐，可避免部分构建错误）
- Git：用于拉取插件（可选）
- Docker：用于容器化部署（可选）
模型 API Key：用于智能问答和任务规划。可选用阿里云百炼、硅基流动、OpenAI 等。新手可先跳过，后续在 WebUI 中配置。

如果你对这些都不甚了解，只想快速的安装部署好龙虾，也可以用【Claw大龙虾本地部署大师】来进行快速安装部署好龙虾，然后再结合下面关于配置大模型API的教程就可以。
具体可以看我这篇文章《OpenClaw本地快速部署指南及主流AI模型API接入方法》

在开始菜单搜索“PowerShell”，右键选择“以管理员身份运行”。

使用 winget 一键安装：

winget install OpenJS.NodeJS.LTS -y winget install Git.Git -y

安装后执行以下命令检查版本：

GPT plus 代充 只需 145node -v npm -v git --version

加速依赖下载：

npm config set registry https://registry.npmmirror.com

执行全局安装：

GPT plus 代充 只需 145npm install -g openclaw@latest

安装完成后检查版本：

openclaw --version

GPT plus 代充 只需 145openclaw onboard

根据提示操作：

若向导未自动启动，可执行以下命令：

# 启动服务 openclaw gateway start # 查看状态 openclaw status # 重启服务 openclaw gateway restart

安装完成后，务必运行诊断命令，确保环境正确：

GPT plus 代充 只需 145openclaw doctor

如果所有检查项均为绿色，说明部署成功。

首次登录 WebUI 可能需要令牌，可通过以下命令生成：

openclaw token generate

Windows 配置文件通常位于：

GPT plus 代充 只需 145C:Users你的用户名.openclawopenclaw.json

若未安装，在终端执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

GPT plus 代充 只需 145brew install node@22 git echo 'export PATH="$(brew --prefix node@22)/bin:$PATH"' >> ~/.zshrc source ~/.zshrc

检查版本：

node -v npm -v git --version

GPT plus 代充 只需 145npm config set registry https://registry.npmmirror.com

npm install -g openclaw@latest

检查版本：

GPT plus 代充 只需 145openclaw --version

openclaw onboard

配置步骤与 Windows 基本一致，最后选择打开 WebUI 即可在 http://localhost:18789 访问。

GPT plus 代充 只需 145# 启动服务 openclaw gateway start # 查看状态 openclaw status # 重启服务 openclaw gateway restart

openclaw doctor

GPT plus 代充 只需 145openclaw token generate

macOS 配置文件通常位于：

~/.openclaw/openclaw.json

GPT plus 代充 只需 145sudo apt update && sudo apt upgrade -y sudo apt install -y curl git

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs

检查版本：

GPT plus 代充 只需 145node -v npm -v

npm config set registry https://registry.npmmirror.com

GPT plus 代充 只需 145sudo npm install -g openclaw@latest

检查版本：

openclaw --version

GPT plus 代充 只需 145openclaw onboard

配置步骤与前述系统一致。

# 启动服务 openclaw gateway start # 查看状态 openclaw status # 重启服务 openclaw gateway restart

运行初始化向导时选择安装守护进程，或执行：

GPT plus 代充 只需 145openclaw gateway enable

openclaw doctor

GPT plus 代充 只需 145openclaw token generate

Linux 配置文件通常位于：

~/.openclaw/openclaw.json

登录阿里云百炼控制台，在“密钥管理”页面创建并复制你的API Key。

避免手动编辑配置文件，使用 openclaw config 命令进行配置：

GPT plus 代充 只需 145# 设置默认模型的提供商为百炼 openclaw config set agents.defaults.model.provider “bailian”

设置模型名称（可根据实际替换）

openclaw config set agents.defaults.model.model_id “qwen-max”

openclaw config set models.providers.bailian.api_key “你的API Key”

openclaw config set models.providers.bailian.base_url “https://dashscope.aliyuncs.com/compatible-mode/v1”

openclaw gateway restart

重启后，即可在 WebUI 中体验完整的 AI 自动化功能。

权限错误：在 Linux/macOS 上，若全局安装失败，可尝试在命令前加 sudo。
安装缓慢或失败：确保已配置 npm 国内镜像源；若仍失败，可改用 pnpm 安装：
```
GPT plus 代充 只需 145npm install -g pnpm pnpm install -g openclaw@latest 
```
端口占用：默认端口为 18789。若被占用，可在配置文件 openclaw.json 中修改 port 字段。
安全警告：OpenClaw 需要文件读写权限。请勿在存有敏感信息的生产环境根目录下运行，建议指定专用工作区。
配置未生效：修改配置文件后，必须执行 openclaw gateway restart 重启服务。
WebUI 无法访问：确认服务已启动（openclaw status），并检查防火墙设置。若提示需要令牌，使用 openclaw token generate 生成。

完成上述步骤后，可以通过以下方式确认部署成功：