OpenClaw 本地极简部署与 QQ 机器人接入教程

引言

什么是 OpenClaw？

OpenClaw 是一个强大的本地化 AI Agent 网关与编排框架。如果把各种大语言模型（如 Qwen、DeepSeek）比作 AI 的'大脑'，那么 OpenClaw 就是为这个大脑量身定制的'躯干和神经系统'。它不仅能管理这些大模型的接入，还自带可视化的 Web 控制台，能够轻松连接各种外部社交平台（QQ、Telegram 等），并赋予 AI 读取本地文件、调用外部工具的能力。

为什么选择 OpenClaw？

从零手搓一个带有记忆功能、能调用工具的 QQ 机器人工作量庞大。OpenClaw 的价值在于开箱即用和极高的工程实用性，解决了以下核心痛点：

告别底层造轮子：将智能体最复杂的工具调用和记忆管理机制全部封装好。
多平台一键分发：支持接入 QQ、微信或个人网站，只需安装对应的轻量级插件，核心业务逻辑无需修改。
数据隐私与安全：作为可跑在本地 Windows 环境下的 Node.js 服务，完全掌控数据流向，随时监控健康状态。

本文介绍如何在 Windows 本地部署 OpenClaw，并实战演示如何将其无缝接入官方 QQ 机器人。

一、基础环境准备

OpenClaw 对底层环境有两个硬性要求：Node.js 版本必须 >= 22，并且电脑里必须装有 Git。

1. 安装 Node.js (v22 及以上)

OpenClaw 基于 Node.js 运行。需去官网下载最新的 LTS（长期支持）版本。操作步骤：访问 Node.js 官网，直接点击绿色的 Windows 安装程序 (.msi) 进行下载。

Node.js 安装界面

注：请根据电脑版本自行选择合适版本安装！

Node.js 安装选项

注：在安装过程中，如果遇到提示 'Automatically install the necessary tools…'（自动安装必要的工具，如 Python 和 C++ 编译环境），建议勾选。很多 AI 相关的 Node.js 项目在底层需要编译 C++ 依赖，勾选此选项能省去未来大部分编译报错烦恼。

2. 安装 Git

npm 拉取 OpenClaw 的某些开源依赖时，必须调用本地的 Git 工具，否则会报 ENOENT (找不到文件) 错误。提供两种常用安装方式：

方案 A：使用 winget 命令行一键安装 操作步骤：右键以'管理员身份'打开 PowerShell，输入以下命令并回车：

winget install Git.Git

如果输入指令时报错 "0x8a15000f :Data required by the source is missing"，建议使用方案 B。

Winget 安装报错

方案 B：官网下载安装包 操作步骤：直接访问 Git 官网，下载 64-bit 的 .exe 安装包。

Git 官网下载

安装方法：纯'傻瓜式'操作，双击运行后不需要修改任何默认配置，一路点击 'Next' 到底即可完成。

注：Git 安装完成后，请务必把当前打开的所有黑窗口（PowerShell/CMD）全部关掉，然后重新打开一个新的窗口，输入 git -v。如果能输出类似 git version 2.x.x.windows.x 的提示，才说明系统真正识别到了它。

3. 解决 npm 被拦截（没报错跳过）

环境装好后，验证一下。打开 PowerShell，输入 node -v，应能顺利看到刚刚安装的 Node.js 版本号。如果出现报错，这通常是因为 Windows PowerShell 默认有一个非常严格的安全策略，把 npm 底层的执行脚本当成危险动作给拦截了。

解决办法：

关闭当前报错的终端。
重新找到 PowerShell 图标，右键选择'以管理员身份运行'（这一步非常关键，普通窗口没有修改权限）。
复制并运行以下这行放行命令：

Set-ExecutionPolicy RemoteSigned

按下回车后，系统会弹出一大段黄色的警告文字，问你是否要更改执行策略，输入大写字母 Y，然后回车确认。完成这一步后，再次输入 npm -v。

NPM 验证成功

二、一键部署与唤醒'龙虾'

保持刚才那个'以管理员身份运行'的 PowerShell 窗口处于打开状态，我们接下来所有的操作都在这里完成。

1. 全自动拉取与组装

在命令行中，输入我们今天的第一条核心指令，把 OpenClaw 接回本地：

npm install -g openclaw@latest

敲下回车后，npm 会自动去云端把 OpenClaw 的所有零部件下载并拼装到你的电脑里。这个过程根据网速可能需要一两分钟。

注：在跑进度条的时候，终端里可能会弹出一堆黄色的 warn deprecated（警告老旧依赖）或者蓝色的 notice（提示 npm 有新版本）。不要慌，也不用管它们！这些都不会对程序运行产生任何影响。只要你最后看到类似 added 673 packages in 2m 这样的提示字样，就代表核心组件已经完美安装成功！

2. 启动与配置'大脑'

接下来，我们需要给它通电开机，并给它装上一个大模型（这里我们以接入通义千问 Qwen 为例）。继续在终端中输入启动初始化向导的指令：

openclaw onboard

安全提示（首先会显示安全警告，阅读后选择 Yes 继续。）
选择 Onboarding 模式（QuickStart）
选择 AI 模型提供商并输入 API Key：

提供商	获取 API Key	备注
Anthropic Claude	https://console.anthropic.com → 创建账号 → API Keys → Create Key	需国际信用卡
OpenAI GPT	https://platform.openai.com → API Keys → Create new secret key	需国际信用卡
OpenRouter	https://openrouter.ai → 注册 → Keys → Create Key	支持多种支付方式，聚合多家模型
Qwen（推荐）	https://bailian.console.aliyun.com → 登录 → API-KEY 管理 → 创建新 API-KEY	中国大陆服务商，支持国内支付
DeepSeek	https://platform.deepseek.com → 注册 → API Keys → 创建	中国大陆服务商，支持支付宝充值
Moonshot / Kimi	https://platform.moonshot.cn → 注册 → API Key 管理 → 新建	中国大陆服务商，支持国内支付
本地模型	支持 Ollama 等，无需 API Key	免费，但需本地算力