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

安装方法：纯'傻瓜式'操作，双击运行后不需要修改任何默认配置，一路点击 '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. 全自动拉取与组装

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

npm install -g openclaw@latest

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

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

2. 启动与配置'大脑'

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

openclaw onboard

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

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

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

默认选择第一个就行。

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

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

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

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

7. 完成上面步骤后，程序会自动安装并启动网关服务，这时候 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 大脑的 OpenClaw 顺利养在了本地，并且无缝接入了 QQ。

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

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

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