三平台通用｜OpenClaw 2.6.6 一键安装 + 初始化配置

崔总知道
16 阅读4分钟

​

 本文为 2026 实测版，覆盖 Windows、macOS、Linux 三大系统，从环境准备、一键安装、初始化配置到服务启动、常见问题，全程无夸大、无违规表述，小白按步骤即可完成本地部署。

一、OpenClaw 简介

OpenClaw（业内昵称 “小龙虾”）是一款轻量化、开源的本地 AI Agent 框架，支持一键部署、多渠道集成（飞书 / 微信 / 钉钉）与 AI 内容生成（漫剧 / 短剧 / 文案）。2026 最新版 2.6.6 优化了跨平台兼容性，Windows、macOS、Linux 均可一键部署，小白也能快速搭建本地 AI 服务。

安装包地址：xiake.yun/api/downloa…

二、部署前准备（全平台通用）

2.1 系统与硬件要求

表格

项目最低配置推荐配置
操作系统Windows 10+/macOS 12+/Ubuntu 22.04+同左
处理器x86_64/Apple Silicon（M1/M2/M3/M4）同左
内存≥4GB8GB+，运行更流畅
存储可用空间≥2GB10GB+，预留模型空间
网络稳定联网带宽≥10Mbps，加速依赖下载
权限Windows 需管理员权限；Mac/Linux 需 sudo 权限同左

2.2 工具准备

  • Windows：以管理员身份打开 PowerShell
  • macOS/Linux：打开终端
  • 关闭防火墙 / 杀毒软件，避免拦截安装
  • 所有操作路径使用纯英文、无空格、无特殊符号

三、一键部署（新手首选，5 分钟搞定）

3.1 Windows 系统部署

打开管理员 PowerShell，执行脚本：

powershell

# 常规网络
iwr -useb https://openclaw.ai/install.ps1 | iex

# 国内加速
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

自动完成：系统检测、Node.js≥v22 安装、OpenClaw 2.6.6 部署、环境配置。

验证安装（重启 PowerShell 后）：

powershell

openclaw --version

3.2 macOS 系统部署

打开终端，执行：

bash

运行

# 常规网络
curl -fsSL https://openclaw.ai/install.sh | bash

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

加载环境变量：

bash

运行

source ~/.zshrc
# 旧版 Bash：source ~/.bash_profile

验证：

bash

运行

openclaw --version

3.3 Linux 系统部署（以 Ubuntu 为例）

bash

运行

# 常规网络
curl -fsSL https://openclaw.ai/install.sh | bash

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

加载环境变量：

bash

运行

source ~/.bashrc

验证：

bash

运行

openclaw --version

四、初始化配置（3 分钟完成）

4.1 启动初始化向导

全平台通用命令：

bash

运行

openclaw onboard

4.2 按提示配置（新手直接默认回车）

  • Security warning：输入 Yes 回车
  • Onboarding mode：选择 QuickStart
  • Gateway port：默认 18789 回车
  • Model/auth provider：选择 Skip for now
  • 设置管理员密码（务必记录）

五、启动服务与访问控制台

5.1 启动网关服务

bash

运行

openclaw gateway

显示 Gateway started on port 18789 即为成功。

5.2 访问 Web 控制台

浏览器打开：http://localhost:18789输入管理员密码登录使用。

六、Docker 容器化部署（进阶，环境隔离）

  1. 安装 Docker（已安装可跳过）
  2. 创建目录：

bash

运行

mkdir openclaw-docker && cd openclaw-docker

  1. 新建 docker-compose.yml：

yaml

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

  1. 后台启动：

bash

运行

docker compose up -d

  1. 验证：

bash

运行

docker compose ps

显示 Up 即成功，访问 http://localhost:18789。

七、常见问题解决（全平台通用）

7.1 命令找不到（command not found）

  • Windows：重启 PowerShell
  • macOS：

bash

运行

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

  • Linux：

bash

运行

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

7.2 安装超时 / 下载失败

切换国内加速脚本，关闭代理，切换手机热点。

7.3 端口占用（18789）

  • Windows：

powershell

netstat -ano | findstr "18789"

  • macOS/Linux：

bash

运行

lsof -i :18789

换端口启动：

bash

运行

openclaw gateway --port 18790

7.4 权限不足

  • Windows：管理员身份运行 PowerShell
  • macOS/Linux：命令前加 sudo

7.5 服务启动失败

关闭杀毒、检查内存、查看日志：

bash

运行

openclaw logs

八、总结与后续

本文覆盖 OpenClaw 2.6.6 一键部署、初始化配置、Docker 容器化、常见问题全流程，2026 最新版流程简洁，小白 10 分钟内可完成部署。后续可扩展：

  • 配置本地 / 云端 AI 模型（豆包、GPT、Ollama）
  • 集成飞书 / 微信 / 钉钉渠道
  • 安装 AI 漫剧、短剧、文案生成插件

安装包地址：xiake.yun/api/downloa…

​

avatar
文章
阅读
粉丝