从零开始：用 1Panel 一键搭建你的OpenClaw私人 QQ 机器人保姆

前言：为什么你需要一个 AI 保姆？

深夜两点，你辗转反侧，突然想起来一件事：「卧槽，明天早上有个会议！」

这时候，如果你有个 AI 保姆，只需在 QQ 上敲几个字：「8点提醒我开会」，然后安心睡觉——因为你的机器人比你妈还准时。

今天，我带大家用 1Panel（一款超好用的 Linux 服务器管理面板）一键搭建 OpenClaw，然后把 QQ 机器人接进去。全程保姆级教程，保证手残党也能搞定。

✨ 好消息：1Panel 应用商店直接集成 OpenClaw，一行命令就能安装，配置全在图形界面完成，命令行？不存在的！

第一步：准备工作（别急，先看看你的服务器）

在开始之前，你需要：

✅ 一台有公网 IP 的服务器（VPS、NAS、家用服务器都行）

✅ 安装好 1Panel（如果没装，去 https://1panel.cn 看看，两分钟搞定）

✅ 一个 QQ 号（机器人用的，不是你本人的）

✅ 一个 AI 模型的 API Key（比如智谱 GLM、OpenAI、通义千问等）

✅ 一点点的耐心（别急，马上就好）

💡 小贴士：没有公网 IP？可以用内网穿透工具（比如 frp）或者找个有公网 IP 的朋友借一下服务器。

第二步：在 1Panel 应用商店安装 OpenClaw

1Panel 的应用商店直接集成 OpenClaw，安装超简单！

2.1 打开应用商店

进入 1Panel 控制台 → 应用商店，在搜索框输入 OpenClaw，找到官方应用。

2.2 安装 OpenClaw

点击安装按钮，进入配置页面：
应用名称：openclaw（默认即可）
端口：18789（默认即可）
数据持久化：确保勾选（重要！）
点击确定，等待安装完成。
🎉 就这么简单！1Panel 会自动拉取镜像、创建容器、配置网络，你什么都不用管。

2.3 验证安装

安装完成后，在容器页面你会看到两个容器：
openclaw-gateway：核心服务
openclaw-cli：命令行工具
确保两个容器都是运行中状态。

第三步：配置 AI 模型（图形界面操作）

1Panel 提供了超友好的图形配置界面，不用敲命令，点点鼠标就搞定！

3.1 打开配置界面

在 1Panel 的应用商店页面，找到已安装的 OpenClaw，点击设置按钮。

3.2 配置 AI 模型

在配置页面，你会看到「AI 模型设置」区域：
模型提供商：选择你使用的模型（智谱 GLM、OpenAI、通义千问等）
API Key：填入你的 API Key
Base URL：填入模型接口地址（如果有的话）
模型名称：选择具体模型（比如 zai/glm-4.7、gpt-4 等）
💡 示例（使用智谱 GLM）：
模型提供商：智谱 GLM
API Key：your_api_key_here
Base URL：https://open.bigmodel.cn/api/paas/v4
模型名称：glm-4

3.3 保存配置

点击保存按钮，OpenClaw 会自动重新加载配置。

3.4 验证配置

在 1Panel 的应用页面，找到 OpenClaw，点击日志，如果没有报错信息，说明配置成功了！

第四步：安装 QQ Bot 插件(可以让 Open Claw帮你装)

QQ Bot 插件来自开源项目 sliverp/qqbot，支持 C2C 私聊、群聊 @消息、频道消息，功能很强大。
⚠️ 注意：插件安装需要进入 CLI 容器的终端操作，但别担心，只需一条命令！

4.1 进入 CLI 容器

在 1Panel 的容器页面，找到 openclaw-cli 容器，点击终端→连接，进入命令行。

4.2 检查已安装插件

node /app/dist/index.js plugins list
你会看到一堆插件，但没有 QQ Bot。

4.3 安装插件

node /app/dist/index.js plugins install @sliverp/qqbot@latest
等待安装完成（可能需要几分钟，因为要下载依赖）。

4.4 验证安装

再次运行 plugins list，你应该看到：
│ QQ Bot │ qqbot │ loaded │ ~/.openclaw/extensions/qqbot/index.ts │ 1.4.1 │
状态是 loaded 就说明安装成功了！

第五步：配置 QQ 机器人

5.1 申请 QQ 机器人凭证

访问 QQ 开放平台，注册并登录
点击创建应用，选择机器人（注意：不是小程序，不是游戏！）
等待审核（一般很快，几分钟就好）
审核通过后，进入开发管理，获取 AppID 和 AppSecret
访问 https://myip.ipip.net 查看你的公网 IP，添加到IP 白名单
🔥 重点：IP 白名单必须配置，否则 QQ 开放平台连不上你的服务器！

5.2 添加 QQ 通道配置

回到 CLI 容器（和安装插件时一样），运行：
node /app/dist/index.js channels add --channel qqbot --token "你的AppID:你的AppSecret"
例如：
node /app/dist/index.js channels add --channel qqbot --token "102842253:Pbo1FTixDUl3LexHbwHd0Nl9YxNnEf7a"
看到 Added QQ Bot account "default" 就说明配置成功了！

5.3 验证配置

node /app/dist/index.js channels list
你应该看到：
Chat channels:

• QQ Bot default: configured, token=config, enabled

第六步：添加机器人到聊天

回到 QQ 开放平台
进入你的机器人应用
找到沙箱配置，扫描"添加成员"旁边的二维码
用你的 QQ 号（不是机器人号）扫码，把机器人添加到聊天列表
发送一条消息试试：「嗨」
如果机器人回复你了，恭喜你，成功啦！🎉

第七步：测试一下功能

现在你可以试试机器人的各种功能：

7.1 定时提醒

5分钟后提醒我喝水
机器人会在 5 分钟后给你发消息：「💧 该喝水啦！」

7.2 搜索问题

今天北京天气怎么样？
机器人会搜索并回复你。

7.3 聊天

随便聊，机器人很聪明的！

常见问题（踩坑指南）

Q1: 机器人不回复消息？

可能原因：
公网 IP 没添加白名单 → 去开放平台添加
端口 18789 没开放 → 检查防火墙和云服务商的安全组
容器没启动 → 在 1Panel 检查容器状态
AI 模型配置错误 → 检查 API Key 和 Base URL 是否正确

Q2: 插件安装失败？

解决方法：
检查网络连接（如果在国内，可能需要代理）
删除 ~/.openclaw/extensions/qqbot 目录，重新安装
检查容器日志，看具体报错信息

Q3: 如何重启 OpenClaw？

在 1Panel 的应用商店页面，找到 OpenClaw 应用，点击重启按钮即可。

Q4: 如何查看日志？

在 1Panel 的容器页面，点击 openclaw-gateway 的日志按钮。

Q5: 插件安装太慢怎么办？

可以手动下载 sliverp/qqbot 的源码包，解压后放到容器的 data 目录，然后手动安装：
node /app/dist/index.js plugins install /home/node/clawd/qqbot/.
总结

恭喜你，成功搭建了一个属于自己的 AI 机器人！🎉
现在你可以在 QQ 上随时随地跟你的 AI 保姆聊天、设置提醒、搜索信息……感觉就像拥有了个贴心的私人助理。

后续可以玩的：

接入更多渠道（TG、微信、Discord……）
自定义机器人的性格（让它变逗比、变温柔、变专业）
安装更多插件（天气预报、音乐播放、新闻推送……）

想象一下，每天早上机器人给你发：「早上好！今天天气不错，适合出去浪～」
是不是感觉生活瞬间有温度了？

参考资料

OpenClaw 官方文档：https://docs.openclaw.ai
QQ 机器人官方文档：https://q.qq.com
1Panel 官网：https://1panel.cn
QQ Bot 插件项目：https://github.com/sliverp/qqbot
祝玩得开心！有问题评论区见～ 🚀