OpenClaw（小龙虾 AI）本地部署

本文覆盖 Windows(WSL2)、macOS、Linux(Ubuntu) 三套部署方案含一键脚本快速部署、源码编译部署、Docker 容器部署三种方式配套图文标注、报错解决、初始化配置全流程。一、前置硬件 软件环境必看一、环境最低要求内存≥4GB推荐 8GB 以上磁盘空闲≥10GBNode.js 固定 22.x LTSWindows 必须 WSL2 Ubuntu22.04原生 CMD/PowerShell 不兼容。二、Windows 前置安装 WSL2管理员 PowerShell 执行开启 WSL 并自动安装 Ubuntu wsl --install重启电脑打开 Ubuntu 设置用户名、密码校验 WSL 版本 wsl --list --verbose 输出 VERSION2 即正常三、通用基础依赖安装macOS/Linux/WSL Ubuntu 终端安装 Git sudo apt update sudo apt install git -ymacOS 替换brew install git使用 nvm 安装 Node22 LTS curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 nvm alias default 22 node -v输出 v22.x.x 代表成功设置国内 npm 镜像加速 npm config set registry https://registry.npmmirror.com四、三种部署方式任选其一方式 1国内一键脚本新手推荐macOS/Linux/WSL 终端 curl -fsSL https://open-claw.org.cn/install-cn.sh | bashWindows 管理员 PowerShell iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex 执行完成自动进入初始化配置向导方式 2npm 手动全局安装已有 Node 环境npm install -g openclawlatest openclaw --version openclaw doctor openclaw onboard方式 3Docker 容器部署隔离环境安装 Docker Desktop创建 docker-compose.yml 文件内容 version: 3 services: openclaw: image: ghcr.io/openclaw/openclaw:latest ports:18789:18789 volumes:./.openclaw:/root/.openclaw restart: always extra_hosts:host.docker.internal:host-gateway启动容器 docker compose up -d进入容器初始化 docker exec -it openclaw bash openclaw onboard五、初始化向导统一配置流程网关设置 默认 Local Gateway 直接回车端口默认 18789占用则更换 18790后台守护进程输入 y。模型二选一 方案 A云端 API 模型 选择对应厂商粘贴 API 密钥填写模型名称qwen-turbo/gpt-3.5-turbo。 方案 B本地 Ollama 模型免费无密钥 选择 Ollama Local Model本地部署地址默认http://127.0.0.1:11434Docker 部署填写http://host.docker.internal:11434输入本地模型名qwen2:7b、llama3:8b温度、上下文窗口默认回车。技能安装 输入 y空格勾选 koluhab回车自动安装依赖。保存自动生成管理员 Token用于网页登录。六、Ollama 本地模型前置操作官网下载安装 Ollama 客户端启动后台服务终端拉取开源模型示例 ollama pull qwen2:7b查看本地模型列表 ollama list七、服务启停与访问常用运维命令openclaw gateway start -d 后台启动 openclaw gateway status 查看运行状态 openclaw logs 实时日志 openclaw gateway stop 停止服务 openclaw gateway restart 重启服务 openclaw onboard 重新配置 openclaw doctor 环境自检修复 npm update -g openclaw 升级程序 npm uninstall -g openclaw rm -rf ~/.openclaw 完整卸载Web 访问地址浏览器打开 http://localhost:18789粘贴初始化 Token 登录后台面板。八、常见报错解决Node 版本过低使用 nvm 切换至 Node22 LTS18789 端口占用初始化阶段更换端口号Ollama 连接超时本地确认 Ollama 客户端已启动Docker 部署使用 host.docker.internal 地址依赖下载超时切换淘宝 npm 镜像、使用国内一键安装脚本Windows 网页打不开必须使用 WSL2 Ubuntu 环境禁止原生 PowerShell 运行权限不足Ubuntu 执行命令前加 sudoPowerShell 全程管理员身份运行