1.快速注册创建QQ机器人

2.登录后,点击“创建机器人”选项,点击一次即可快速生成一个新的机器人账号

3.创建机器人后,QQ 开放平台会直接提供 3 条预设指令,用户只需在安装了 OpenClaw 的设备上执行这些指令,即可完成机器人与 OpenClaw 的对接。整个过程可在 1 分钟内实现。

openclaw plugins install @sliverp/qqbot@latest
openclaw channels add --channel qqbot --token "123456AbCD:aBcdEfG"(改成你自己的)
openclaw gateway restart

4.绑定至 OpenClaw 环境后即可通过 QQ 机器人给 OpenClaw 下达指令;支持 Markdown、图片、语音、文件等多媒体消息收发,手机端 QQ、桌面端 QQ 均可使用。

OpenClaw(小龙虾)官方给出的内存要求如下:

  • 最低内存2GB(仅满足基础运行)
  • 推荐内存4GB(日常使用更流畅)

不同场景的内存建议

  • 仅基础网关 / 云 API 模式:最低 4GB 即可。
  • 日常使用 + 多插件:推荐 16GB,多任务与 Docker 环境更稳定。
  • 本地大模型 + 复杂自动化:建议 32GB+,运行更流畅。
  • 手机端部署:建议 4GB+ 内存。

OpenClaw(小龙虾)提供三种主流安装方式,按 “新手友好度” 排序:一键脚本(最快)、Docker 容器(最稳,适合生产 / 隔离)、源码编译(适合开发定制)。结合你的技术背景(本地部署、Docker 经验),优先推荐 Docker 部署;新手则选一键脚本。


前置准备(所有方式必做)

依赖项 版本要求 验证命令 安装要点
Node.js ≥ v22.0.0(LTS) node -v 安装时勾选 Add to PATH;Windows 建议用 WSL2
内存 最低 4GB,推荐 16GB+ 本地大模型需 32GB+
硬盘 ≥ 10GB 空闲 容器 / 源码需额外空间
Docker Engine ≥ 20.10(仅 Docker 方式) docker -v Windows 用 Docker Desktop,启用 WSL2 后端

方式一:一键脚本(新手 / 快速试用,5 分钟搞定)

Windows(PowerShell 管理员)

  1. 安装 Node.js v22 LTS(https://nodejs.org/),勾选 Add to PATH。
  2. 管理员打开 PowerShell,执行:
    iwr -useb https://openclaw.ai/install.ps1 | iex
    
  3. 安装完成后,启动初始化向导:
    openclaw onboard --install-daemon
    
  4. 启动服务:
    openclaw start
    

macOS / Linux(终端)

  1. 安装 Node.js v22(macOS 用 brew install node,Linux 用 Nodesource 脚本)。
  2. 执行一键安装:
    curl -fsSL https://openclaw.ai/install.sh | bash
    
  3. 初始化并启动:
    openclaw onboard --install-daemon && openclaw start
    

方式二:Docker 部署(推荐生产 / 隔离,环境干净)

1. 安装 Docker 环境

  • Windows:安装 Docker Desktop,在设置中启用 WSL2 后端
  • Linux
    curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
    systemctl start docker && systemctl enable docker
    
  • macOS:用 Homebrew 安装 brew install --cask docker,启动并登录。

2. 快速启动(单容器)

# 拉取最新镜像
docker pull openclaw/openclaw:latest

# 启动容器(持久化配置,映射 3000 端口)
docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  --restart unless-stopped \
  openclaw/openclaw:latest

3. 进阶:Docker Compose(推荐,便于管理)

  1. 创建目录并进入:
    mkdir -p ~/openclaw && cd ~/openclaw
    
  2. 创建 docker-compose.yml
    version: '3.8'
    services:
      openclaw:
        image: openclaw/openclaw:latest
        container_name: openclaw
        ports:
          - "18789:18789"  # 管理面板端口
          - "3000:3000"    # 网关端口
        volumes:
          - ./data:/app/data
          - ./config:/app/config
          - ~/.openclaw:/root/.openclaw
        environment:
          - NODE_ENV=production
          - TZ=Asia/Shanghai
        restart: unless-stopped
    
  3. 启动并验证:
    docker-compose up -d
    docker-compose ps  # 状态为 Up 即成功
    docker logs -f openclaw  # 查看日志排查问题
    

方式三:源码编译(开发者 / 二次开发)

  1. 安装依赖:
    npm install -g pnpm  # 强制推荐 pnpm,避免 npm 依赖问题
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm config set registry https://registry.npmmirror.com  # 国内加速
    
  2. 安装并构建:
    pnpm install
    pnpm ui:build  # 编译前端 UI
    pnpm build     # 编译后端
    
  3. 初始化并启动:
    pnpm openclaw onboard --install-daemon
    pnpm gateway:watch  # 开发模式,自动重载
    

核心配置与启动验证

1. 初始化向导(openclaw onboard)关键选项

  • 模型提供商:新手选 “云端体验”(如 Kimi、OpenAI),本地部署选 “本地模型”(需 LM Studio 配合)。
  • 端口设置:默认 3000(网关)、18789(管理面板),确保防火墙放行。
  • 登录密码:设置强密码,防止未授权访问。

2. 验证服务

  • 浏览器访问:http://localhost:3000http://服务器IP:18789
  • 终端执行:curl http://localhost:3000/api/v1/health,输出 {"status":"healthy"} 即正常。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐