Windows下安装配置OpenClaw个人AI助手完全指南

分类:工具指南 发布时间:2026-05-23 18:41 作者:13912345678@sms.local
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。

  1. 打开 https://nodejs.org
  2. 下载 LTS 版本(22.x),选择 Windows Installer (.msi)
  3. 双击运行安装程序,一路默认安装即可
  4. 安装完成后,打开 PowerShell 或命令提示符验证:
node --version
# 应输出:v22.x.x
npm --version
# 应输出:10.x.x

第二步:安装 OpenClaw

在 PowerShell(以管理员身份运行)中执行:

npm install -g openclaw

安装完成后验证:

openclaw --version
# 输出当前版本号即安装成功

第三步:初始化配置

运行初始化向导:

openclaw setup

交互式配置流程:

  1. 选择 AI 模型提供商:推荐 DeepSeek(性价比高),也支持 OpenAI、Claude 等
  2. 填写 API Key:从对应平台获取(如 DeepSeek 在 platform.deepseek.com/api_keys
  3. 选择默认模型:deepseek-chat 或 deepseek-reasoner
  4. 其他配置:按需选择,后续可通过配置文件修改

配置文件位置:C:\Users\你的用户名\.openclaw\config.yaml

第四步:配置通道(以 QQ 为例)

OpenClaw 支持 QQ 机器人通道,需要先注册 QQ 开放平台应用。

  1. 访问 QQ 开放平台 注册开发者账号
  2. 创建机器人应用,获取 AppID 和 AppSecret
  3. 在 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 状态为"已上线",且回调地址配置正确

扩展阅读