乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 完整安装教程及 QQ 接入指南:从零到一打造你的个人 AI 代理

OpenClaw 完整安装教程及 QQ 接入指南:从零到一打造你的个人 AI 代理

当前时间： 2026-03-14 22:02:30 分类：办公文件 评论(0)
OpenClaw 完整安装教程及 QQ 接入指南:从零到一打造你的个人 AI 代理

大家好，今天，我们来聊聊一个在 2026 年年初就火爆全球的开源 AI 项目——OpenClaw（前身是 Clawdbot 和 Moltbot）。这个项目由奥地利开发者 Peter Steinberger 创建，自从 1 月底开源以来，GitHub 星标数迅速突破 6 万，成为 AI 代理领域的现象级工具。

OpenClaw 不是一个简单的聊天机器人，它是一个真正的自治 AI 代理，能帮你处理邮箱、发送邮件、管理日历、浏览器自动化，甚至执行 shell 命令。它可以运行在你的本地电脑或服务器上，通过 WhatsApp、Telegram、Discord 等聊天 App 与你互动，让 AI 真正“做事”。

如果你是 AI 爱好者、开发者或企业用户，想自建一个安全、私密的 AI 助手，这篇文章就是为你准备的。我们将从 OpenClaw 的完整安装教程入手，详细补充安装过程中的各种细节和坑点，然后重点讲解如何使用官方 QQ 插件接入 QQ（腾讯的即时通讯工具），让你的 AI 代理无缝融入中国用户的生态。

全文约 4000 字，分为引言、安装篇、配置篇、QQ 接入篇、常见问题篇和结语。建议收藏后慢慢阅读，如果有疑问，欢迎在评论区留言！

一、OpenClaw 是什么？为什么值得安装？

在深入教程前，先简单科普一下 OpenClaw。它是一个开源的 AI 代理框架，核心理念是**“AI that actually does things”**（真正做事的 AI）。不同于 ChatGPT 或 Claude 这样的纯聊天模型，OpenClaw 是一个“代理层”，它连接大型语言模型（LLM，如 OpenAI 的 GPT、Anthropic 的 Claude 或开源的 Llama），并赋予它们行动能力。

通过插件和技能（skills），OpenClaw 可以：

  • • 自动化任务：清空收件箱、预约会议、检查航班、生成报告
  • • 多渠道互动：支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等聊天平台，用户可以通过手机或电脑随时指挥 AI
  • • 本地运行：完全自托管，数据不上传云端，隐私安全
  • • 扩展性强：社区贡献了上百个技能插件，从浏览器控制到文件管理，应有尽有
  • • 自治模式：通过“心跳”（heartbeat）机制，AI 可以定时醒来执行任务，无需用户手动触发

根据 GitHub 数据，OpenClaw 在开源后短短一周就吸引了数万开发者贡献代码。它被誉为“个人 AGI”（人工通用智能）的雏形，因为 AI 可以自我改进——例如，通过编写代码来创建新技能。

为什么安装 OpenClaw？

在 2026 年，AI 代理已成为生产力工具的标配。企业可以用它自动化客服，个人可以用它管理生活。但市面上的商用 AI（如 Groq 或 Devon）往往收费高昂或隐私泄露风险大。OpenClaw 免费开源，只需你的 API 密钥（如 OpenAI 的），就能跑起来。安装门槛不高，新手也能上手。

注意：OpenClaw 不是零基础工具，需要基本命令行知识。如果你完全不懂编程，建议先学点 Terminal 基础。

二、安装前提：准备你的环境

安装 OpenClaw 前，确保你的系统满足要求。这一步很重要，能避免 90% 的报错。OpenClaw 支持 Windows、macOS 和 Linux（推荐 Ubuntu），但最佳运行环境是VPS（虚拟私人服务器），因为它能 24/7 在线。

2.1 系统要求

组件
要求
说明
操作系统
macOS 10.15+ / Windows 10+（需 WSL2）/ Ubuntu 20.04+
Linux 推荐 Ubuntu
Node.js
版本 22 或更高
依赖现代 JavaScript 特性，如原生 WebSocket
Git
最新版
用于克隆仓库
Python
3.8+（可选）
部分技能需要，如浏览器自动化
硬件
4GB RAM / 2 核 CPU
本地跑小模型够用，大模型建议云服务器
API 密钥
OpenAI/Anthropic/Groq等
OpenClaw 不自带模型，需要外部 LLM

Node.js 安装建议：用 nvm（Node Version Manager）安装更方便：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22

免费 LLM 选项：用开源模型如 Llama via Ollama，无需 API 费用。

2.2 选择部署方式

方式
适用场景
特点
本地安装
测试开发
电脑关机 AI 就停
VPS 部署
生产环境
24/7在线，推荐 Hostinger、DigitalOcean 或腾讯云 Lighthouse
Docker
高级用户
容器化隔离环境，官方有镜像

为什么推荐 VPS？ OpenClaw 的自治模式需要常驻后台，VPS 能确保 AI 随时待命。

2.3 安全提醒

OpenClaw 能执行 shell 命令，潜在风险高。安装前请注意：

  • • 创建非 root 用户运行
  • • 设置防火墙，只开必要端口（如 8080）
  • • 别用生产环境测试，避免 AI 误删文件
  • • 始终更新到最新版本（openclaw update）

三、OpenClaw 安装教程：从零到运行

OpenClaw 的安装超级简单，官方 CLI 一键搞定。

预计时间：本地 10 分钟，VPS 30 分钟。

3.1 步骤 1：安装 CLI

macOS/Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

iwr-useb https://openclaw.ai/install.ps1 | iex

这会下载并安装 OpenClaw 到~/.openclaw。

验证安装：

openclaw --version

常见问题：如果报错“command not found”，重启 Terminal 或添加 PATH：

export PATH="$HOME/.openclaw/bin:$PATH"

国内用户提示：如果网络慢，用代理或镜像源。

3.2 步骤 2：运行引导向导

openclaw onboard --install-daemon

这是一个交互式向导，会询问：

  • • Gateway 类型：选 Local（本地）或 Remote（VPS）
  • • Runtime：选 Node.js（默认）
  • • Auth Token：生成一个，用于 Web 面板安全访问
  • • Channels：可选，先跳过，后续添加

向导结束后，OpenClaw 会启动 Daemon（后台服务）。

检查状态：

openclaw gateway status

输出应显示“Running”。

3.3 步骤 3：配置模型和 API

编辑配置文件 ~/.openclaw/config.yaml：

OpenAI 配置：

providers:
openai:
apiKey:"你的 OpenAI Key"
model:"gpt-4o"

Anthropic 配置：

anthropic:
apiKey:"你的 Claude Key"
model:"claude-3-5-sonnet-20240620"

测试连接：

openclaw test-provider openai

成功会输出模型响应。

成本优化建议：

  • • 用 Groq 免费 API（速度快）
  • • 本地 Ollama（ollama install llama3）
  • • 多模型切换：在 config 中添加多个，AI 会自动选

3.4 步骤 4：首次运行和 Web 面板

启动 Dashboard：

openclaw dashboard

浏览器打开 http://localhost:18790/?token=fjLzmjT0a5vaJBMEUCDQLJGp6FXNcIgu Token 登录。

创建第一个代理：

  1. 1. 面板中点击“Hatch Agent”
  2. 2. 命名如“MyAI”
  3. 3. 选模型
  4. 4. 发消息测试：在面板聊天框输入“Hi”，AI 应回复

3.5 更新和备份

定期更新：

openclaw update

备份配置： 复制 ~/.openclaw 文件夹即可。

四、接入 QQ：使用官方插件（推荐）

OpenClaw 官方提供了 QQ 机器人插件，安装配置非常简单，只需几步即可完成。

4.1 安装官方 QQ 插件

执行以下命令安装官方 QQ 插件：

openclaw plugins install @sliverp/qqbot@latest

安装完成后，插件会自动集成到 OpenClaw 中。

4.2 获取 QQ 机器人密钥

  1. 1. 访问 QQ 机器人开放平台：https://q.qq.com/qqbot/openclaw/index.html
  2. 2. 使用实名 QQ 号登录
  3. 3. 创建机器人应用，获取 AppID 和 AppSecret
  4. 4. 这两个密钥将用于配置 OpenClaw 连接 QQ

提示：个人号最多可创建 5 个机器人。建议使用小号测试，避免风控。

4.3 配置 QQ 通道

使用以下命令添加 QQ 通道，填入你从开放平台获取的密钥：

openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"

示例：

openclaw channels add --channel qqbot --token "102854638:ziSCxjVI6ujYOF6yrkeZUQMJHFEDDEFH"

4.4 重启 OpenClaw 网关

配置完成后，需要重启 OpenClaw 网关使配置生效：

openclaw gateway restart

或者使用：

openclaw gateway stop
openclaw gateway start

4.5 扫码绑定 QQ

  1. 1. 再次访问 https://q.qq.com/qqbot/openclaw/index.html
  2. 2. 在页面中找到你的机器人，点击“扫码登录”
  3. 3. 使用 QQ 手机客户端扫描二维码
  4. 4. 扫码成功后，机器人即与你的 QQ 账号绑定

4.6 测试对话

完成以上步骤后：

  1. 1. 在手机 QQ 中搜索你的机器人名称
  2. 2. 添加机器人为好友（或邀请入群）
  3. 3. 发送消息如“你好”或“Hi”
  4. 4. OpenClaw AI 代理会立即回复！

五、常见问题及排查

问题
解决方案
安装失败
检查 Node 版本（需 22+），防火墙。日志：openclaw logs
模型无响应
API Key 过期或无效，换 Groq 免费 API 测试
QQ 插件安装失败
检查网络连接，尝试使用代理
QQ 扫码无反应
确保网关已重启，检查 token 格式是否正确（AppID:AppSecret）
QQ 消息无回复
检查网关状态 openclaw gateway status，确认模型配置正确
性能慢
用 VPS，优化模型（选 gpt-4o-mini）
安全问题
别给 AI root 权限，config 中设 allowShell: false

更多资源：

  • • OpenClaw 官方文档：https://docs.openclaw.ai/
  • • QQ 机器人开放平台：https://q.qq.com/

六、结语：开启你的 AI 代理之旅

恭喜！通过这篇教程，你已掌握 OpenClaw 从安装到 QQ 接入的全流程。使用官方 QQ 插件，整个过程变得非常简洁：

  1. 1. 安装插件：openclaw plugins install @sliverp/qqbot@latest
  2. 2. 获取密钥：访问 https://q.qq.com/qqbot/openclaw/index.html
  3. 3. 配置通道：openclaw channels add --channel qqbot --token "AppID:AppSecret"
  4. 4. 重启网关：openclaw gateway restart
  5. 5. 扫码绑定：在开放平台页面扫码登录

OpenClaw 代表 AI 未来的方向——自治、隐私、可扩展。配合 QQ 这个国民级通讯工具，你的 AI 助手可以随时随地为你服务。试试吧，或许它会改变你的工作生活！

欢迎关注AI 科技前沿站，更多 AI 教程等你！如果有用，点个赞分享哦～