OpenClaw,AI助手,Windows,QQ机器人,教程,Node.js
前言
OpenClaw 是一个开源的 AI 个人助手平台,可以部署在自己的服务器上,通过 QQ、微信、Discord、Telegram 等多渠道与 AI 交互。本文带你从零开始在 Windows 上安装配置 OpenClaw。
系统要求
- Windows 10/11 64位
- 至少 4GB 内存(推荐 8GB+)
- 一个可用的 API Key(DeepSeek、OpenAI、Claude 等均可)
第一步:安装 Node.js
OpenClaw 基于 Node.js 运行,需要先安装 Node.js 22.x。
- 打开 https://nodejs.org
- 下载 LTS 版本(22.x),选择 Windows Installer (.msi)
- 双击运行安装程序,一路默认安装即可
- 安装完成后,打开 PowerShell 或命令提示符验证:
node --version
# 应输出:v22.x.x
npm --version
# 应输出:10.x.x
第二步:安装 OpenClaw
在 PowerShell(以管理员身份运行)中执行:
npm install -g openclaw
安装完成后验证:
openclaw --version
# 输出当前版本号即安装成功
第三步:初始化配置
运行初始化向导:
openclaw setup
交互式配置流程:
- 选择 AI 模型提供商:推荐 DeepSeek(性价比高),也支持 OpenAI、Claude 等
- 填写 API Key:从对应平台获取(如 DeepSeek 在 platform.deepseek.com/api_keys)
- 选择默认模型:deepseek-chat 或 deepseek-reasoner
- 其他配置:按需选择,后续可通过配置文件修改
配置文件位置:C:\Users\你的用户名\.openclaw\config.yaml
第四步:配置通道(以 QQ 为例)
OpenClaw 支持 QQ 机器人通道,需要先注册 QQ 开放平台应用。
- 访问 QQ 开放平台 注册开发者账号
- 创建机器人应用,获取 AppID 和 AppSecret
- 在 OpenClaw 配置中添加 QQ 通道:
openclaw channel add qqbot
按提示填入 AppID 和 AppSecret 即可。
第五步:启动与使用
# 启动 OpenClaw Gateway
openclaw gateway start
# 查看状态
openclaw status
启动后,你就可以在配置好的通道(如 QQ)中与你的 AI 助手对话了!
进阶:安装技能插件
OpenClaw 拥有丰富的技能生态(Skills),可以为 AI 助手增加专业能力:
# 搜索技能
openclaw skill search weather
# 安装技能
openclaw skill install weather
推荐安装的实用技能:weather(天气查询)、web-search(网络搜索)、tencent-docs(腾讯文档)
常见问题
Q: 启动报错 "port already in use"
修改配置文件中的端口号,或关闭占用端口的程序
Q: 连接不上 AI API
检查 API Key 是否正确,网络是否需要代理。国内用户访问 OpenAI 可能需要配置代理
Q: QQ 机器人收不到消息
确认 QQ 开放平台应用审核通过,Bot 状态为"已上线",且回调地址配置正确
扩展阅读
- OpenClaw 官方文档:docs.openclaw.ai
- OpenClaw GitHub:github.com/openclaw/openclaw
- 技能市场 ClawHub:clawhub.ai