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 或 notice 不影响运行。
2. 配置'大脑'与初始化
输入启动初始化向导的指令：
openclaw onboard
- 阅读安全提示，选择 Yes 继续。
- 选择 Onboarding 模式（QuickStart）。
- 选择 AI 模型提供商并输入 API Key。
| 提供商 | 获取 API Key | 备注 |
|---|---|---|
| Anthropic Claude | https://console.anthropic.com | 需国际信用卡 |
| OpenAI GPT | https://platform.openai.com | 需国际信用卡 |
| OpenRouter | https://openrouter.ai | 聚合多家模型 |
| Qwen（推荐） | https://bailian.console.aliyun.com | 中国大陆服务商，支持国内支付 |
| DeepSeek | https://platform.deepseek.com | 中国大陆服务商，支持支付宝充值 |
| Moonshot / Kimi | https://platform.moonshot.cn | 中国大陆服务商，支持国内支付 |
| 本地模型 | 支持 Ollama 等 | 免费，需本地算力 |
新手推荐使用 Qwen，支持 OAuth 授权登录，有免费额度。 4. 完成认证后，选择模型（默认第一个即可）。 5. 询问是否连接 Telegram/iMessage 时，选择 Skip for now。 6. 安装 Skills（技能包），建议至少添加 ClawHub（官方技能市场）。
# 安装 ClawHub
npm install clawhub
- 额外服务配置全部选 No。
- 启动成功后，Windows 可能会弹出防火墙提示，允许公共网络和专用网络访问。
- 选择 Web UI 网页中使用，浏览器会自动打开控制面板。
注意：如果出现 token 问题，可直接复制 token 拼接进浏览器访问：
http://localhost:18789/?token=一长串字母和数字
接入 QQ 机器人
得益于腾讯 QQ 开放平台的原生支持及 OpenClaw 插件系统，可快速获得官方机器人通道。
1. 领取官方机器人的'身份证'
- 浏览器访问 QQ 开放平台，使用手机 QQ 扫码登录。
- 创建机器人，设置名字和头像。
- 进入开发设置页面，记录 AppID 和 AppSecret。
2. 本地安装专属通信插件
重新打开一个新的 PowerShell 窗口（建议依然是'以管理员身份运行'），输入以下指令，一键安装官方维护的 QQ 插件：
npm install -g @openclaw/plugin-qq
回到 QQ 软件，新建的机器人将被添加至消息列表，并可尝试发送指令测试功能。
总结
本文介绍了在 Windows 本地部署 OpenClaw 并接入 QQ 机器人的完整流程。通过配置 Node.js 环境和 Git，利用 onboard 向导完成模型认证，最后通过插件实现 QQ 消息收发。该方案实现了本地 AI 智能体的快速搭建与多平台扩展能力，后续可进一步挂载 Python 脚本等专属工具，实现自动化数据处理或行情分析等功能。
