乐于分享
好东西不私藏

AI辅助科研系列(三):OpenClaw 安装配置与 QQ 机器人接入指南

AI辅助科研系列(三):OpenClaw 安装配置与 QQ 机器人接入指南

想要一个 24 小时待命、能读文件、执行命令、还能操作浏览器的 AI 智能体吗?

今天给大家带来 OpenClaw(俗称“小龙虾”🦞) 的保姆级安装教程!它不仅能本地自托管,还能直接接入 QQ 机器人,让你在手机上随时随地召唤 AI!

废话不多说,我们直接开始!👇


📝 一、 前置准备

在开始之前,请确认你的电脑满足以下基础条件:

💻 系统要求

  • 操作系统
    :Windows 10+ / macOS 12+ / Linux(推荐 Ubuntu 22.04+)
  • 运行环境
    :Node.js v22+(一键脚本会自动安装,无需手动操心)
  • 硬件配置
    :内存 ≥2GB(推荐 4GB+ 体验更佳)
  • 网络环境
    :需正常联网

🔑 必备账号

  1. 大模型 API Key
    :推荐国内模型(如 Moonshot AI/Kimi、DeepSeek、智谱 AI),注册方便且价格实惠。
  2. 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 小时后台运行

🗺️ 向导关键步骤指南:

  1. 安全提示
    :选择 Yes,确认理解风险。
  2. 配置模式
    :选择 QuickStart(快速启动,新手首选)。
  3. 选择 AI 模型
    :国内用户推荐选择 Moonshot AI(Kimi K2.5),也可选 DeepSeek 等。
  4. 输入 API Key
    :去对应平台(如 Kimi 开放平台)获取 Key,粘贴到终端并回车。
  5. 选择默认模型
    :确认具体使用的模型版本。
  6. 聊天渠道
    :选择 Skip for now(先跳过,后面单独配 QQ)。
  7. 技能与 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,向机器人发消息测试吧!

🛠️ 方式二:手动配置(通用备选)

如果快捷通道不可用,可按以下步骤手动配置:

  1. 获取凭证
    :访问 QQ 开放平台 扫码登录,创建 Bot 并获取 AppID 和 AppSecret(Secret 只显示一次,务必保存!)。
  2. 安装插件
openclaw plugins install @sliverp/qqbot@latest
  1. 添加频道
    (替换为你自己的凭证):
openclaw channels add --channel qqbot --token ”你的AppID:你的AppSecret”
  1. 重启服务
openclaw gateway restart

📋 六、 常用命令速查表

建议收藏本文,忘记命令时随时查阅:

命令
作用说明
openclaw --version
查看当前版本
openclaw onboard
重新初始化配置
openclaw gateway start
启动 Gateway 服务
openclaw gateway stop
停止 Gateway 服务
openclaw gateway restart
重启 Gateway 服务
openclaw gateway status
查看服务运行状态
openclaw dashboard
打开 Web 可视化控制台
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 里帮你做什么?
欢迎在评论区留言交流!👇

如果这篇教程对你有帮助,别忘了点个 「赞」 和 「在看」,分享给更多需要的朋友!我们下期见~ 👋