OpenClaw 本地极简部署与 QQ 机器人接入教程
简介
什么是 OpenClaw？
OpenClaw 是一个强大的本地化 AI Agent 网关与编排框架。它将大语言模型（如 Qwen、DeepSeek）作为 AI 的'大脑'，通过可视化的 Web 控制台管理模型接入，并连接外部社交平台（QQ、Telegram 等），赋予 AI 读取本地文件、调用外部工具的能力。
为什么选择 OpenClaw？
- 告别底层造轮子：封装了智能体最复杂的工具调用和记忆管理机制，无需手写底层 ReAct 架构逻辑。
- 多平台一键分发：核心业务逻辑不变，安装对应轻量级插件即可接入 QQ、微信或个人网站。
- 数据隐私与安全：支持在本地 Windows 环境下运行 Node.js 服务，完全掌控数据流向。
基础环境准备
OpenClaw 对底层环境有两个硬性要求：Node.js 版本必须 >= 22，并且电脑里必须装有 Git。
1. 安装 Node.js (v22 及以上)
访问 Node.js 官网下载最新的 LTS 版本 Windows 安装程序 (.msi)。
注：根据电脑版本自行选择合适版本安装！在安装过程中，如果遇到提示 'Automatically install the necessary tools…'（自动安装必要的工具，如 Python 和 C++ 编译环境），建议勾选它，这能省去未来 80% 的编译报错烦恼。
2. 安装 Git
npm 拉取依赖时必须调用本地 Git 工具。
方案 A：使用 winget 命令行一键安装 右键以'管理员身份'打开 PowerShell，输入以下命令并回车：
winget install Git.Git
若遇到报错，建议使用方案 B。
方案 B：官网下载安装包 直接访问 Git 官网下载 64-bit 的 .exe 安装包，双击运行后一路点击 'Next' 即可完成。
注：Git 安装完成后，务必关闭所有黑窗口（PowerShell/CMD），重新打开新窗口输入 git -v 验证是否识别到。
3. 解决 npm 被拦截
Windows PowerShell 默认的安全策略可能拦截 npm 脚本执行。
解决办法：
- 关闭当前终端。
- 右键选择'以管理员身份运行'PowerShell。
- 复制并运行以下放行命令：
Set-ExecutionPolicy RemoteSigned
按下回车后，系统会弹出警告，输入大写字母 Y 确认。
完成这一步后，再次输入 npm -v 验证。
一键部署与唤醒
保持刚才那个'以管理员身份运行'的 PowerShell 窗口处于打开状态。
1. 全自动拉取与组装
输入核心指令，将 OpenClaw 安装到本地：
npm install -g openclaw@latest
等待进度条结束，看到类似 added 673 packages 的提示即代表安装成功。期间出现的 warn deprecated 或 不影响运行。
