乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > 你还不会部署OpenClaw?部署OpenClaw的详细教程来了

你还不会部署OpenClaw?部署OpenClaw的详细教程来了

当前时间： 2026-08-17 01:03:03 分类：办公文件 评论(0)
你还不会部署OpenClaw?部署OpenClaw的详细教程来了

OpenClaw那么火，你养虾了没有？如果你还没有自己的虾，想要自己拥有一只帮你打工的虾，就来看看吧。

OpenClaw（原ClawdBot）是一款开源的AI智能体平台，支持Windows、macOS、Linux全系统本地和务器私有化部署。以下是2026年最新、最详细的部署教程，涵盖**一键脚本、Docker、源码构建等三种方式感觉收藏起来吧。

首先是系统要求，想要在自己电脑上部署养虾，其他都是小问题，电脑配置够不够才是最重要的， 

OpenClaw对系统最低要求如下：

操作系统：Windows 10+/macOS 10.15+/Linux (Ubuntu/Debian/CentOS等) 运行环境：Node.js 22.x LTS 或 24.x（安装脚本会自动安装）硬件配置：最低 1GB 内存，推荐 4GB以上体验是最好的网络环境：可访问外网（用于下载依赖与连接AI模型）端口：默认使用 18789 端口（WebUI与API服务） 

OpenClaw有两种安装方式，第一种是利用一键脚本部署（推荐，新手首选），可以自动检测环境、安装依赖、配置服务等，全程自动化。 Windows 系统的话 以管理员身份打开 PowerShell，执行官方一键安装脚本：

# 官方源（推荐）iwr -useb https://openclaw.ai/install.ps1 | iex# 国内加速源（网络超时/下载慢时使用）    iwr -useb https://clawd.org.cn/install.ps1 | iex 

等待 3-8 分钟，出现 “OpenClaw installed successfully”即完成，

验证安装：关闭当前PowerShell，重新打开普通权限终端执行

powershell    openclaw --version

输出版本号（如 `v0.8.0`）即成功。

macOS / Linux / WSL2 系统的话打开终端，执行一键脚本：

# 官方源curl -fsSL https://openclaw.ai/install.sh | bash# 国内加速源curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

输入系统密码（输入时不显示），等待安装完成后验证安装

openclaw --version

初始化配置（Onboarding）安装成功后，脚本会自动启动配置向导。如未自动启动，手动执行

# macOS/Linux openclaw onboard  # Windows openclaw onboard

按向导指引完成：

  1. 选择网关模式：`local`（仅本地）或 `remote`（支持远程访问） 

  2. 绑定地址：默认 `0.0.0.0:18789`（允许所有IP访问） 

  3. 配置AI模型：输入OpenAI/Claude等API Key，或选择本地Ollama模型 

  4. 生成访问令牌：务必保存，用于登录WebUI 

  5. 安装系统服务：选择 `Y`，设置开机自启 

第二种安装方式是Docker 部署。推荐服务器/进阶用户使用， 优点是环境隔离、易于管理、支持7×24小时运行不间断。 

1. 安装 Docker & Docker Compose（已安装可跳过）

# Ubuntu/Debian 系统   sudo apt update && sudo apt install -y docker.io docker-compose        # CentOS/RHEL 系统   sudo yum install -y docker docker-compose    sudo systemctl enable --now docker

2. Docker 单命令启动

docker run -d \      --name openclaw \--restart unless-stopped \-p 18789:18789 \-v ~/.openclaw:/root/.openclaw \openclaw/openclaw:latest    ``` 

3. Docker Compose 部署（推荐管理）新建 ：docker-compose.yml    

version: "3.8"services:  openclaw:    image: openclaw/openclaw:latest    container_name: openclaw    restart: unless-stopped    ports:      - "18789:18789"    volumes:      - ~/.openclaw:/root/.openclaw

启动服务：

docker-compose up -d

4. 初始化配置

#bash    #进入容器执行初始化    docker exec -it openclaw openclaw onboard

5. 验证服务    

#bash# 查看容器状态    docker ps        # 健康检查    curl http://127.0.0.1:18789/api/v1/health    # 返回 {"status":"healthy"} 即正常

 第三种方式就是从源码构建（开发者/二次开发）， 需手动安装依赖，适合定制开发。 

1. 安装依赖

#bash# 安装Node.js 22+/pnpm    curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | tar -xJf - -C /usr/local --strip-components=1    npm install -g pnpm    ``` 
2.克隆仓库 & 构建
#bashgit clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm ui:build  # 构建前端pnpm build     # 构建核心pnpm link --global  # 全局注册命令
3.初始化 & 启动
#bashopenclaw onboard --install-daemonopenclaw gateway start

安装完成后就可以访问与使用属于你自己的龙虾了

本地访问浏览器打开：

http://localhost:18789
远程访问（服务器）浏览器打开：
http://你的服务器公网IP:18789
  1. 登录粘贴初始化时生成的访问令牌，进入 Web 控制台
  2. 服务管理（开机自启 / 状态 / 日志）方式：
  3. Linux/macOS（systemd）
# 查看状态systemctl status --user openclaw# 开机自启systemctl enable --user --now openclaw# 手动启动/停止openclaw gateway startopenclaw gateway stop# 查看日志journalctl --user -u openclaw -f
  1. Windows
# 启动服务openclaw gateway start# 设置开机自启openclaw gateway install

  1. 常见问题与避坑

    1. Windows 脚本禁止运行
    1. 以管理员 PowerShell 执行：
      #powershellSet-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

      端口 18789 被占用

初始化时修改端口，或编辑
~/.openclaw/config.yml
国内网络下载失败必须使用国内镜像脚本（见方式一）
  1. 模型 API 连接失败
    • 检查 API Key 正确性
    • 确保网络可访问 OpenAI/Claude 等服务（可能需要代理）
    • 本地模型检查 Ollama 是否正常运行

卸载方法

#bash # macOS/Linux openclaw gateway uninstall rm -rf ~/.openclaw  # Windows openclaw gateway uninstall 删除 C:\Users\你的用户名\.openclaw 文件夹 ```  

部署完成后，你就拥有了一个完全可控、可自主执行任务的本地AI智能体了

教程不易，如果对你有帮助，可以帮忙点个关注点个赞吗？

#OpenClaw  #Openclaw部署教程