从零开始“养龙虾”：OpenClaw 本地极简部署与 QQ 机器人接入全保姆级教程

Ne0inhk

— 14 min read
从零开始“养龙虾”：OpenClaw 本地极简部署与 QQ 机器人接入全保姆级教程

文章目录

引言

什么是 OpenClaw？

最近开源界有一只“红皮小龙虾”非常火，它就是 OpenClaw。
简单来说，OpenClaw 是一个极其强大的本地化 AI Agent 网关与编排框架。

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

为什么选择 OpenClaw？

很多接触过 AI 开发的朋友都知道，如果我们想自己从零手搓一个带有记忆功能、能调用工具的 QQ 机器人，工作量是非常庞大的。你需要自己处理平台接口的对接、手写底层 ReAct 架构的逻辑、维护上下文记忆流、甚至还要自己写一个前端来监控它的运行状态。

而 OpenClaw 最大的价值就在于它的开箱即用和极高的工程实用性。它解决了以下几个核心痛点：
1.告别底层造轮子： 它把智能体最复杂的工具调用和记忆管理机制全部封装好了。你只需要点点鼠标，就能让 AI 拥有处理复杂任务的能力。
2.多平台一键分发： 就像一个万能插座。今天你想把它接入 QQ，明天想接入微信或个人网站，只需要安装对应的轻量级插件即可，核心业务逻辑完全不用改。
3.数据隐私与安全： 作为一个可以跑在本地 Windows 环境下的 Node.js 服务，你可以完全掌控自己的数据流向，随时在本地监控它的健康状态，这也是本地化部署最让人安心的地方。

今天这篇文章，我就带大家在 Windows 本地部署一下 OpenClaw ，并实战演示如何将它零基础无缝接入官方的 QQ 机器人！

一、基础环境准备

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

如果你缺少这两样，或者 Windows 权限没配好，后面的报错会让你怀疑人生。完成以下三步，确保安装一次过。

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

OpenClaw 是基于 Node.js 运行的。我们需要去官网下载最新的 LTS（长期支持）版本。

操作步骤： 访问 Node.js 官网（https://nodejs.org/zh-cn/download），直接点击绿色的 Windows 安装程序 (.msi) 进行下载。

在这里插入图片描述


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

在这里插入图片描述

注：在双击安装、一路狂点“下一步”的过程中，如果遇到一个界面提示 “Automatically install the necessary tools…”（自动安装必要的工具，如 Python 和 C++ 编译环境），最好勾选它。很多 AI 相关的 Node.js 项目在底层需要编译 C++ 依赖，勾选这个能帮你省去未来 80% 的编译报错烦恼。

2.安装 Git

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

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

winget install Git.Git

但是我在输入这条指令的时候出现报错，弹出一堆红字，报 "0x8a15000f :Data required by the source is missing” 的错误。

在这里插入图片描述


如果你也遇到同样问题，建议使用方案B

方案 B：官网下载安装包
操作步骤： 直接访问Git官网（https://git-scm.com/install/windows） ，下载 64-bit 的 .exe 安装包。

在这里插入图片描述


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

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

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

环境装好后，按理说我们应该验证一下。打开你的 PowerShell，输入 node -v，你应该能顺利看到刚刚安装的 Node.js 版本号。

但是我这里又出现一个报错

在这里插入图片描述


为什么会这样？
别慌，这绝对不是你没装好，也不是下载包坏了。这仅仅是因为 Windows PowerShell 默认有一个非常严格的安全策略，它把 npm 底层的执行脚本当成危险动作给拦截了。

解决办法：
我们只需要稍微放宽一点本地脚本的运行权限即可。
1.关闭当前报错的终端。
2.重新找到 PowerShell 图标，右键选择“以管理员身份运行”（这一步非常关键，普通窗口没有修改权限）。
3.复制并运行以下这行放行命令：

Set-ExecutionPolicy RemoteSigned

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

完成这一步后，再次输入 npm -v

在这里插入图片描述


大功告成！

二、一键部署与唤醒“龙虾”

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

1.全自动拉取与组装

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

npm install -g openclaw@latest

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

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

2.醒龙虾与配置“大脑”

接下来，我们需要给它通电开机，并给它装上一个大模型（这里我们以接入强大的通义千问 Qwen 为例）。

继续在终端中输入启动初始化向导的指令：

openclaw onboard

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

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

这里有很多模型，作者推荐新手先使用qwen，因为它支持OAuth授权登录，可以直接在网页上登录账号进行认证，而且qwen有免费额度，方便快速上手使用。
选择qwen后，程序会给你一个认证连接，只需要复制粘贴到浏览器即可进入认证界面，登陆账号后即可认证成功

在这里插入图片描述

4.完成认证后，我们继续接下来的操作，这里会让你选择模型

在这里插入图片描述


默认选择第一个就行

5.接下来引导程序会询问要不要连接到Telegram、iMessage等社媒软件，我们先全部选Skip for now

在这里插入图片描述

6.安装skills
skills是给AI装技能包，让他能解锁各种能力，因为openclaw只是一个基本框架，只有安装了各种skills包，它才能成为你的好帮手

在这里插入图片描述


接着程序会推荐一些技能包，建议至少添加ClawHub，这是官方的技能市场，安装了之后，就能在社区市场上随时搜索和安装对应的技能包。

选择好之后，我们选择用npm安装即可：

在这里插入图片描述

安装完成之后，程序还会询问一堆额外的服务配置，直接全部No

在这里插入图片描述

6.完成上面步骤后，程序会自动安装并启动网关服务，这时候Windows 可能会弹出防火墙提示，问你是否允许公共网络和专用网络访问，一定要点允许！否则网关服务无法正常工作。

在这里插入图片描述


启动成功后，引导程序会问你是在终端界面（TUI）还是网页浏览器中使用OpenClaw。

TUI 就是直接在命令行里跟 AI 聊天，适合喜欢敲命令、有一定编程基础的同学。新手当然选 Web UI 网页中使用：

在这里插入图片描述

选择之后，浏览器会自动打开 OpenClaw 的网页控制面板。到此，恭喜你的第一只龙虾已经成功诞生！

在这里插入图片描述

注意：如果出现以下问题，请在直接将token一起复制进浏览器

http://localhost:18789/?token=一长串字母和数字
在这里插入图片描述

三、接入官方 QQ 机器人（可选）

得益于腾讯 QQ 开放平台最近的原生支持，以及 OpenClaw 极其方便的插件系统，我们现在完全不需要手写任何复杂的收发消息接口，只需简单配置即可免费获得官方的机器人通道。

1. 领取官方机器人的“身份证”

首先，我们需要去腾讯那边建立一个机器人的空壳，并拿到它的专属凭证。

操作步骤：
1.浏览器访问 QQ 开放平台 (https://q.qq.com/qqbot/openclaw/index.html)，使用你的手机 QQ 扫码登录。
2.找到并点击 “创建机器人”，为你的智能体起个名字，并上传一个头像。
3.创建成功后，进入机器人的开发设置页面，你会看到两个至关重要的参数：AppID 和 AppSecret。

在这里插入图片描述
在这里插入图片描述


在手机QQ扫码后选择同意，即完成注册，进入QQ机器人配置页。

在这里插入图片描述

在QQ开放平台的QQ机器人页面，可以单击创建机器人，即可直接新建一个QQ机器人。

在这里插入图片描述


机器人创建完成后，在页面中找到 “AppID” 和 “AppSecret” 两个参数，分别点击右侧 “复制” 按钮，将其保存到个人记事本或备忘录中（请妥善保存勿泄露，注意数据安全），后续步骤中需要使用。

2. 本地安装专属通信插件

拿到身份证后，我们要让本地的“龙虾”学会 QQ 的通信协议。

重新打开一个新的 PowerShell 窗口（建议依然是“以管理员身份运行”），输入以下指令，一键安装官方维护的 QQ 插件：

在这里插入图片描述
在这里插入图片描述

回到QQ软件，可以看到新建的QQ机器人已经被添加至您的消息列表中，并将会发送第一条消息。

在这里插入图片描述

我们可以尝试让他完成一些任务。

在这里插入图片描述

3. 结果展示

在这里插入图片描述
在这里插入图片描述


在这里插入图片描述

看来结果还是比较让人满意，大功告成！

总结

到这里，我们已经成功避开了 Windows 环境配置的各种大坑，把带有 Qwen 大脑的“龙虾”顺利养在了本地，并且无缝接入了 QQ。

但这仅仅是个开始。OpenClaw 最大的价值不在于陪聊，而在于它极强的本地工具调用能力。

现在你拥有了一个跑在本地的智能中枢，接下来最务实的玩法就是给它写点专属的工具。比如，你可以把以前写的 Python 脚本挂载给它，以后只需在 QQ 里发句指令，它就能自动帮你跑脚本，比如自动合并处理本地的一大堆 Excel 数据表，或者去抓取实时的金融行情数据做快速分析。

万事开头难，最折磨人的环境部署既然已经搞定，剩下的就是尽情发挥你的创意了！

如果你在实操中还遇到了其他奇葩报错，或者给这只龙虾开发了什么好玩的本地小工具，欢迎在评论区留言交流！

Read more

【C++】深入拆解二叉搜索树：从递归与非递归双视角，彻底掌握STL容器的基石

【C++】深入拆解二叉搜索树：从递归与非递归双视角，彻底掌握STL容器的基石

【C++】深入拆解二叉搜索树：从递归与非递归双视角，彻底掌握STL容器的基石 * 摘要 * 目录 * 一、概念 * 二、 性能分析 * 三、key结构非递归模拟实现 * 1. 二叉搜索树的插入 * 2. 二叉搜索树的查找 * 3. 二叉搜索树的删除 * 4. 二叉搜索树的中序遍历 * 四、key结构递归的模拟实现 * 1. 递归与非递归二叉搜索树核心操作的对比 * 2. 递归插入 * 3. 递归查找 * 4. 递归删除 * 总结 摘要 二叉搜索树（BST）是一种重要的数据结构，它通过"左子树所有节点值小于根节点，右子树所有节点值大于根节点"的特性实现高效的元素组织。本文详细解析了BST的核心概念、性能特点，并分别通过非递归和递归两种方式完整实现了插入、查找、删除等关键操作，深入探讨了指针引用在递归实现中的巧妙应用，以及两种实现方式在时间复杂度、空间复杂度和适用场景上的差异。 目录

By Ne0inhk
【C++】 —— 笔试刷题day_28

【C++】 —— 笔试刷题day_28

一、游游的重组偶数 题目解析 这道题，有q组数据，每一次输入一个正整数x，让我们将这个数进行重排，变成一个偶数，然后返回（如果x本身就是一个偶数那可以直接返回x)； 如果不存在合法解，就是x通过重排后，无法变成一个偶数，就输出-1； 算法思路 这道题，总体来说还是比较简单的； 对于正整数x，我们可以把它当作一个字符串进行输入；（如果按照整数输入，我们还要将这个数x的每一位变换成对应数组） 我们知道，如果一个数是偶数，那最低位一定是一个偶数，这样我们只需判断字符串的最后一位即可知道这个数是否是偶数；如果这个数是偶数，那就直接输出即可；如果最后一位不是偶数，那就从第一位开始向后找，找到一位是偶数，然后把它交换到最后一位；然后输出即可；如果遍历完这个字符串，还没找到一位是偶数的，那就表示这个数x通过重拍无法变成偶数，输出-1即可。 题目解析 #include<iostream>usingnamespace std; string func(){ string str; cin >>

By Ne0inhk
C++ 多线程同步之互斥锁（mutex）实战

C++ 多线程同步之互斥锁（mutex）实战

C++ 多线程同步之互斥锁（mutex）实战 💡 学习目标：掌握 C++ 标准库中互斥锁的基本用法，理解多线程同步的核心原理，能够解决多线程环境下的资源竞争问题。 💡 学习重点：std::mutex 与 std::lock_guard 的使用、死锁的产生原因及规避方法、实际场景中的同步案例实现。 48.1 多线程同步的必要性 在多线程编程中，当多个线程同时访问共享资源时，会出现资源竞争问题。 例如两个线程同时对同一个变量进行读写操作，会导致最终结果与预期不符。 这种问题被称为线程安全问题，而解决该问题的核心就是线程同步。 ⚠️ 注意事项：线程不同步会引发数据竞争，造成程序运行结果不可预测，甚至导致程序崩溃。 举个简单的反例，两个线程同时对全局变量 count 进行自增操作： #include<iostream>#include<thread>usingnamespace std;int count

By Ne0inhk
（最新原创毕设）Java上门帮厨管理系统/03.01白嫖源码+演示录像）|可做计算机毕设Java、Python、PHP、小程序APP、C#、爬虫大数据、单片机、文案

（最新原创毕设）Java上门帮厨管理系统/03.01白嫖源码+演示录像）|可做计算机毕设Java、Python、PHP、小程序APP、C#、爬虫大数据、单片机、文案

摘  要 随着现代生活节奏的加快和人们对便捷、高质量餐饮服务需求的增加，上门帮厨作为一种新兴的服务模式逐渐受到欢迎。然而，传统的上门帮厨管理方式依赖于电话预约和手工记录，不仅效率低下，而且难以满足用户对服务质量透明度和个性化的需求。为此，本文提出了一个基于Spring Boot框架的临沂上门帮厨管理系统。该系统旨在通过信息化手段优化厨师与用户之间的互动流程，提高服务效率，增强用户体验，并为管理者提供有效的运营支持。 基于Spring Boot的临沂上门帮厨管理系统集成了多种功能模块，以满足不同用户群体的需求。普通用户可以通过注册登录进入系统，浏览首页展示的轮播图、菜品资讯、菜品信息推荐等信息，并进行相关操作。系统提供了菜品资讯的查看、点赞、收藏和评论功能，以及菜品信息的详情查看、评分、预约等功能。用户还可以在线提交问题反馈，查看个人账户信息并进行修改。 厨师用户可以查看订单详情，进行订单审核和回复，提交佣金提现申请，并查看提现记录。这些功能模块的设计充分考虑了厨师的实际需求，旨在帮助他们更好地管理和提升自己的服务水平。 管理员负责整个系统的运维工作，包括新注册用户的审核、菜品信

By Ne0inhk