AI辅助科研系列(三):OpenClaw 安装配置与 QQ 机器人接入指南
想要一个 24 小时待命、能读文件、执行命令、还能操作浏览器的 AI 智能体吗?
今天给大家带来 OpenClaw(俗称“小龙虾”🦞) 的保姆级安装教程!它不仅能本地自托管,还能直接接入 QQ 机器人,让你在手机上随时随地召唤 AI!
废话不多说,我们直接开始!👇
📝 一、 前置准备
在开始之前,请确认你的电脑满足以下基础条件:
💻 系统要求
- 操作系统
:Windows 10+ / macOS 12+ / Linux(推荐 Ubuntu 22.04+) - 运行环境
:Node.js v22+(一键脚本会自动安装,无需手动操心) - 硬件配置
:内存 ≥2GB(推荐 4GB+ 体验更佳) - 网络环境
:需正常联网
🔑 必备账号
- 大模型 API Key
:推荐国内模型(如 Moonshot AI/Kimi、DeepSeek、智谱 AI),注册方便且价格实惠。 - QQ 账号
:用于扫码登录和接入 QQ 机器人。
🚀 二、 安装 OpenClaw
我们提供两种安装方式,新手强烈推荐方式一!
方式一:一键安装脚本(🌟 强烈推荐)
官方最推荐的方式,自动检测并安装 Node.js 和所有依赖,全程无需手动干预。
🪟 Windows 用户(请以管理员身份打开 PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
💡 网络不佳? 可使用国内镜像加速:
irm https://codefather.cn/openclaw_install/install-openclaw.ps1 | iex
🍎 macOS / 🐧 Linux 用户(打开终端):
curl -fsSL https://openclaw.ai/install.sh | bash
方式二:npm 全局安装(适合已有 Node.js 环境的老手)
npm install -g openclaw@latest
✅ 验证安装:
安装完成后,在终端输入以下命令,若显示版本号(如 2026.5.21)即代表安装成功:
openclaw --version
⚙️ 三、 初始化配置(Onboarding)
安装完成后,运行初始化向导:
openclaw onboard --install-daemon
💡 核心提示:
--install-daemon参数非常关键!它会将 Gateway 注册为系统服务,实现开机自启和 7×24 小时后台运行。
🗺️ 向导关键步骤指南:
- 安全提示
:选择 Yes,确认理解风险。 - 配置模式
:选择 QuickStart(快速启动,新手首选)。 - 选择 AI 模型
:国内用户推荐选择 Moonshot AI(Kimi K2.5),也可选 DeepSeek 等。 - 输入 API Key
:去对应平台(如 Kimi 开放平台)获取 Key,粘贴到终端并回车。 - 选择默认模型
:确认具体使用的模型版本。 - 聊天渠道
:选择 Skip for now(先跳过,后面单独配 QQ)。 - 技能与 Hooks
:均选择 Skip for now或No。
配置完成后,系统会自动启动 Gateway 服务,监听端口 18789。
🔍 四、 验证安装是否成功
1. 检查服务状态
openclaw gateway status
应显示 Gateway 正在监听 127.0.0.1:18789。
2. 打开 Web 控制台
openclaw dashboard
浏览器会自动打开 http://127.0.0.1:18789。在控制台给 AI 发一条消息,如果能收到回复,恭喜,你的小龙虾已经活过来了! 🎉
🤖 五、 接入 QQ 机器人(核心亮点)
接入 QQ 有两种方式,强烈推荐方式一,腾讯官方提供的快捷通道,3 分钟搞定!
🌟 方式一:腾讯官方快捷通道(极简版)
Step 1:访问接入页面
浏览器打开:https://q.qq.com/qqbot/openclaw/index.html
Step 2:扫码登录并创建
用手机 QQ 扫描页面二维码登录,点击「创建机器人」。创建成功后,你的手机 QQ 会立刻收到机器人的打招呼消息。
Step 3:执行配置命令
页面上会显示三条配置命令,依次复制到终端(PowerShell)中执行。
⚠️ 避坑警告:命令中包含你的专属密钥信息,千万不要截图泄露给他人!
Step 4:验证接入
在 OpenClaw 网页控制台的「Channels」板块确认 QQ 渠道已接入。打开手机 QQ,向机器人发消息测试吧!
🛠️ 方式二:手动配置(通用备选)
如果快捷通道不可用,可按以下步骤手动配置:
- 获取凭证
:访问 QQ 开放平台 扫码登录,创建 Bot 并获取 AppID 和 AppSecret(Secret 只显示一次,务必保存!)。 - 安装插件
:
openclaw plugins install @sliverp/qqbot@latest
- 添加频道
(替换为你自己的凭证):
openclaw channels add --channel qqbot --token ”你的AppID:你的AppSecret”
- 重启服务
:
openclaw gateway restart
📋 六、 常用命令速查表
建议收藏本文,忘记命令时随时查阅:
|
|
|
|---|---|
openclaw --version |
|
openclaw onboard |
|
openclaw gateway start |
|
openclaw gateway stop |
|
openclaw gateway restart |
|
openclaw gateway status |
|
openclaw dashboard |
|
openclaw plugins list |
|
🩺 七、 常见问题排查 (FAQ)
Q1:安装后提示找不到 openclaw 命令?
检查 Node 全局路径是否在系统 PATH 中。可通过 npm prefix -g 查看路径,并手动添加到环境变量。
Q2:Dashboard 网页打不开?
先运行 openclaw gateway status 检查服务是否正常运行。如果没启动,执行 openclaw gateway start。
Q3:QQ 机器人发消息不回复?
-
检查 API Key 是否配置正确且余额充足。 -
检查 QQ 授权是否过期。 -
运行 openclaw configure重新配置模型和通道。
🎉 八、 总结
至此,你的专属 AI 助手已经 24 小时在线了!简单回顾一下核心流程:
✅ 安装:一键脚本,一条命令搞定
✅ 初始化:openclaw onboard --install-daemon
✅ 访问:浏览器打开 http://127.0.0.1:18789
✅ QQ 接入:访问 https://q.qq.com/qqbot/openclaw/index.html 扫码配置
现在,掏出手机打开 QQ,随时向你的“小龙虾”下达任务吧!🦞
💬 互动时间
你在部署 OpenClaw 时遇到了什么问题?或者你想让 AI 机器人在 QQ 里帮你做什么?
欢迎在评论区留言交流!👇
如果这篇教程对你有帮助,别忘了点个 「赞」 和 「在看」,分享给更多需要的朋友!我们下期见~ 👋
夜雨聆风