OpenClaw本地部署 + QQ接入无需WSL, Windows轻松部署指南

OpenClaw本地部署 + QQ接入

无需WSL，Windows轻松部署指南

OpenClaw是一款强大的AI智能体框架，可以让AI助手直接操作你的电脑。

本文将详细介绍如何在Windows本地部署OpenClaw，并接入QQ实现24小时智能助手功能。

第一部分：环境准备

部署环境要求：

Windows 10 及以上系统
无需科学上网
无需WSL环境
至少1核2GB内存配置

1.1 安装Node.js

访问官网：https://nodejs.org
下载Windows 64位安装包（.msi文件）
双击安装文件，一直点击Next即可完成

1.2 安装Git

使用Windows包管理工具winget一键安装（推荐）：

winget install --id Git.Git -e --source winget

安装时选择 Use Windows default console window 选项

1.3 安装Visual Studio

访问官网：https://visualstudio.microsoft.com
下载并运行安装器
【关键】务必勾选"使用C++的桌面开发"选项
完成安装

1.4 验证环境安装

以管理员身份运行PowerShell，依次执行：

node -v

npm -v

git -v

验证通过后，设置国内镜像源加速下载：

npm config set registry https://registry.npmmirror.com/

第二部分：安装与配置OpenClaw

2.1 全局安装OpenClaw

在PowerShell中执行：

npm install -g openclaw@latest

2.2 初始化配置

执行初始化命令开始交互式配置：

openclaw onboard

按提示依次选择：

部署风险提示：选择 YES
配置模式：选择 QuickStart
模型供应商：选择火山引擎/阿里云等
输入API Key（从供应商平台获取）
选择模型版本
对话工具：选择 skip for now
日志与记录：建议全部勾选

配置完成后，系统会自动安装Gateway组件并打开浏览器控制台。

第三部分：接入QQ机器人

3.1 前置准备

确保已具备以下条件：

完成实名认证的QQ账号
OpenClaw服务已正常运行
服务器具备公网IP（或配置内网穿透）
18789端口已开放（OpenClaw默认端口）

3.2 注册QQ开放平台

访问 https://q.qq.com（QQ开放平台）
使用手机QQ扫码注册/登录（无法直接用QQ号登录）
完成开发者实名认证（填写姓名、身份证、人脸识别）

3.3 创建QQ机器人

进入控制台首页，点击"机器人"标签页
点击"创建机器人"按钮
填写机器人名称（4-30个字符）、上传头像、填写描述
提交创建申请

3.4 获取机器人凭证

关键参数（务必妥善保存）：AppID - 机器人的唯一标识符AppSecret - 机器人密钥，首次查看需扫码验证

3.5 配置IP白名单

在开发管理页面找到"IP白名单"选项
添加服务器公网IP地址
保存配置

提示：如果对话提示"该机器人去火星了"，请优先检查IP白名单配置。

3.6 配置沙箱环境

进入沙箱配置页面
选择"在消息列表配置"（私聊）
点击"添加成员"，输入测试用QQ号
使用QQ扫码添加机器人好友

3.7 安装QQ渠道插件

Windows用户推荐源码安装：

git clone https://github.com/BytePioneer-AI/openclaw-china.git

cd openclaw-china

pnpm install

pnpm build

openclaw plugins install -l ./packages/channels

3.8 配置机器人参数

编辑 ~/.openclaw/config.json 文件，添加QQ渠道配置：

{  "channels": {    "qq": {      "app_id": "你的QQ机器人AppID",      "app_secret": "你的QQ机器人AppSecret",      "token": "你的Token",      "sandbox": false    }  }}

第四部分：测试与验证

4.1 启动QQ渠道

openclaw plugins enable qq

openclaw gateway restart

4.2 验证连接

在手机QQ中给机器人发送消息
检查日志确认消息是否转发到OpenClaw
查看AI是否能够正常回复

第五部分：设置开机自启动

5.1 Windows系统自启动配置

将OpenClaw添加到Windows服务，实现开机自动启动：

nssm install OpenClawService

nssm set OpenClawService Application "C:\Program Files\nodejs\node.exe"

nssm set OpenClawService AppDirectory "C:\Users\用户名"

nssm set OpenClawService AppParameters "gateway --port 18789"

常见问题与解决方案

Q1: 安装失败提示权限不足

解决方案：以管理员身份运行PowerShell，右键PowerShell选择"以管理员身份运行"。

Q2: QQ机器人无法连接

解决方案：检查IP白名单配置，确保服务器公网IP已添加；检查18789端口是否开放。

Q3: AI无响应或回复缓慢

解决方案：检查API Key是否有效；查看模型供应商控制台是否有余额；检查网络连接。

结语

现在你已经成功在Windows本地部署了OpenClaw并接入了QQ机器人！你可以：

通过QQ与AI助手进行自然对话
让AI帮助执行桌面操作和管理文件
在QQ群中实现24小时智能助手
配置定时任务自动化提醒

OpenClaw还支持接入其他平台（钉钉、飞书、企业微信等），可以继续探索更多可能性！