2026年OpenClaw 在 WSL2 + Docker 中部署完整指南（带 Gateway 版本，支持浏览器对话）

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

# OpenClaw 完整安装部署指南

1. 环境准备与前置条件

1.1 硬件与软件要求

环境类型	最低要求	推荐配置
操作系统	Windows ¹⁰⁄₁₁	Windows 11 或 Ubuntu 22.04+
Node.js	v18.x	v22.22.0+ [ref_5]
*Python*	3.8+	3.11+ [ref_1]
包管理器	npm	pnpm [ref_3]
版本控制	Git	Git 2.30+

1.2 Node.js 环境配置

在 Windows 环境下，推荐使用 nvm（Node Version Manager）管理 Node.js 版本：

# 安装 nvm-windows # 下载地址：https://github.com/coreybutler/nvm-windows/releases # 安装并切换至 Node.js v22.22.0 nvm install 22.22.0 nvm use 22.22.0 # 验证安装 node --version # 应输出 v22.22.0 npm --version # 验证 npm 版本

2. Windows 原生安装方式

2.1 一键安装 OpenClaw

GPT plus 代充 只需 145# 使用 npm 全局安装 OpenClaw npm install -g @openclaw/cli # 或者使用 pnpm（推荐） pnpm install -g @openclaw/cli # 验证安装 openclaw --version

2.2 初始化配置

# 创建项目目录 mkdir openclaw-project && cd openclaw-project # 运行快速开始向导 openclaw quickstart

初始化过程中会引导配置：

大模型 API Key（支持 OpenAI、智谱 GLM、小米 MiMo 等）[ref_6]
服务端口（默认 3000）
数据库配置
插件选择

3. WSL2 Ubuntu 安装方式

3.1 WSL2 环境搭建

GPT plus 代充 只需 145# 以管理员身份打开 PowerShell，启用 WSL wsl --install -d Ubuntu # 更新系统包 sudo apt update && sudo apt upgrade -y

3.2 启用 systemd 支持

WSL2 默认不启用 systemd，需要手动配置：

# 编辑 wsl.conf 文件 sudo nano /etc/wsl.conf # 添加以下内容： [boot] systemd=true # 重启 WSL wsl --shutdown # 重新启动 Ubuntu

对于用户级服务，还需要配置 lingering：

GPT plus 代充 只需 145# 启用用户 lingering sudo loginctl enable-linger $USER # 验证 systemd 用户服务 systemctl --user status

3.3 安装 OpenClaw

# 安装 Node.js（使用 NodeSource 仓库） curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # 安装 pnpm npm install -g pnpm # 克隆 OpenClaw 源码 git clone https://github.com/openclaw/openclaw.git cd openclaw # 安装依赖 pnpm install # 构建项目 pnpm build

4. 服务部署与配置

4.1 Gateway 服务安装

GPT plus 代充 只需 145# 安装 Gateway 服务 pnpm install -g @openclaw/gateway # 启动 Gateway openclaw gateway start # 或者使用 systemd 服务（WSL2 环境） sudo systemctl enable openclaw-gateway sudo systemctl start openclaw-gateway

4.2 端口转发配置（局域网访问）

# Windows 防火墙允许端口 netsh advfirewall firewall add rule name="OpenClaw Gateway" dir=in action=allow protocol=TCP localport=3000 # WSL2 端口转发（在 Windows PowerShell 中执行） netsh interface portproxy add v4tov4 listenport=3000 listenaddress=0.0.0.0 connectport=3000 connectaddress=$(wsl hostname -I)

5. 飞书机器人集成配置

5.1 飞书应用创建

访问飞书开放平台：https://open.feishu.cn/ 2. 创建企业自建应用
启用机器人能力
配置权限：
- 获取用户 user_id
- 获取用户基本信息
- 以应用身份发消息
- 接收消息事件

5.2 事件回调配置

GPT plus 代充 只需 145# openclaw.config.yaml 飞书配置示例 plugins: feishu: app_id: "cli_xxxxxxxx" app_secret: "xxxxxxxxxxxx" encrypt_key: "xxxxxxxxxxxx" verification_token: "xxxxxxxxxxxx" event_url: "https://your-domain.com/webhook/feishu"

5.3 安装飞书插件

# 安装飞书机器人插件 openclaw plugin install @openclaw/feishu # 配置飞书凭据 openclaw config set feishu.app_id "your_app_id" openclaw config set feishu.app_secret "your_app_secret"

6. 大模型集成配置

6.1 支持的主流模型

模型类型	配置示例	API 端点
OpenAI 兼容	`openai://sk-xxx`	`https://api.openai.com/v1`
智谱 GLM	`zhipu://your-api-key`	`https://open.bigmodel.cn/api/paas/v4`
小米 MiMo	`mimo://your-api-key`	`https://api.mimo.ai/v1`

6.2 模型配置方法

GPT plus 代充 只需 145# 通过 CLI 配置默认模型 openclaw config set llm.provider "openai" openclaw config set llm.api_key "sk-xxxxxxxx" # 或者在配置文件中设置 openclaw config edit

7. 验证与测试

7.1 服务状态检查

# 检查 Gateway 服务状态 openclaw gateway status # 检查所有服务健康状态 openclaw health # 测试飞书机器人连接 openclaw plugin test @openclaw/feishu

7.2 Web UI 访问

打开浏览器访问：http://localhost:3000 2. 首次访问会进入配置向导
完成基础配置后即可使用管理界面

7.3 常见问题排查

GPT plus 代充 只需 145# 检查端口占用 netstat -ano | findstr :3000 # 查看服务日志 openclaw gateway logs # 重置配置（如有问题） openclaw config reset

8. 生产环境部署建议

8.1 腾讯云轻量服务器部署

对于生产环境，推荐使用云服务器部署：

# 使用 Docker 部署（推荐） docker run -d --name openclaw -p 3000:3000 -v /path/to/config:/app/config openclaw/openclaw:latest # 使用 PM2 进程管理 pnpm install -g pm2 pm2 start ecosystem.config.js

8.2 安全配置要点

使用 HTTPS：配置 SSL 证书
API Key 保护：使用环境变量存储敏感信息
访问控制：配置防火墙规则
定期备份：备份配置数据和对话记录

通过以上完整的安装部署流程，您可以在 Windows 原生环境或 WSL2 中成功安装并运行 OpenClaw，实现 AI 助手的本地化部署和飞书集成。该方案支持多种大语言模型，具备良好的扩展性和稳定性，适用于企业级 AI 应用场景 [ref1][ref2][ref_4]。