NPM安装OpenClaw并配置qqbot

2026-03-21 约 1195 字预计阅读 3 分钟次阅读

OpenClaw 是一个功能强大的多 Agent 框架，支持插件扩展和多种模型接入，能够快速搭建个人 AI 助手或企业级 AI 客服系统。本文将手把手教你如何通过 NPM 在本地快速部署 OpenClaw 并配置qqbot，让你能够通过 QQ 轻松养虾。

环境准备

在开始之前，请确认你的环境满足以下条件：

Node.js ≥ 22.16（推荐 Node 24）
操作系统：macOS、Linux 或 Windows（推荐 WSL2）
网络：能够访问 npm 仓库

可以用下面命令检查版本：

node -v

如果显示版本号低于 22.16，需要升级 Node.js。推荐使用 nvm 或 fnm 来管理 Node 版本，或者直接去官网下载安装包。

配置npm国内源（可选）

如果你在国内访问 npm 仓库速度较慢，可以切换为国内镜像源，加快下载速度：

        
# 使用淘宝镜像源
npm config set registry https://registry.npmmirror.com

# 恢复官方源
# npm config set registry https://registry.npmjs.org/

验证配置是否成功：

npm config get registry

除了npm，其他包管理器也可以配置国内源：

        
# pnpm
pnpm config set registry https://registry.npmmirror.com

# yarn
yarn config set registry https://registry.npmmirror.com

如果你使用 cnpm，可以直接安装：

npm install -g cnpm --registry=https://registry.npmmirror.com

安装 OpenClaw

OpenClaw 提供了 NPM 包，可以直接全局安装：

        
# 使用 npm
npm install -g openclaw@latest

# 或者使用 pnpm（推荐）
pnpm add -g openclaw@latest

验证是否安装成功：

openclaw --version

如果能输出版本号（如 openclaw@2026.3.13），说明安装成功。

初始化 OpenClaw

安装完成后，需要初始化 OpenClaw。运行下面命令：

openclaw onboard --install-daemon

OpenClaw 会引导你完成初始配置。

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? Yes
Onboarding mode: QuickStart
Model/auth provider: OpenRouter
Default model: Keep current
Select channel (QuickStart): Skip for now
Search provider: Skip for now
Configure skills now? (recommended): No
Enable hooks?: Skip for now

这些选项能跳过的都可以先跳过，后续都可以手动配置。初始化后会在用户目录下生成 .openclaw 目录，主要配置文件是 openclaw.json，所有模型、Agent、插件的配置都在这里进行。

访问控制面板

初始化完成后，会自动调用浏览器打开 http://localhost:18789。第一次访问需要输入 token，可以在配置文件中找到：

        
        
        
    
{
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "your-token-here"
    }
  }
}

也可以通过以下命令直接查看：

openclaw config get gateway.auth.token

配置 QQ 通道

OpenClaw 支持 QQ 作为消息通道，让你能够通过 QQ 发送和接收消息。

插件安装

首先需要安装 qqbot 插件：

openclaw plugins install @tencent-connect/openclaw-qqbot@latest

后续如果有更新，可以使用以下命令：

openclaw plugins update qqbot

创建 QQ 机器人

打开页面，手机 QQ 扫码登录。点击创建机器人，完成后把AppID和AppSecret记录下来。

添加 QQ 通道

使用以下命令添加 openclaw 的 qqbot 通道，添加完成后会自动修改openclaw.json配置文件：

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

其中 AppID:AppSecret 替换为你创建的 QQ 机器人的 AppID 和 AppSecret。

重启 gateway

配置完成后重启 OpenClaw 的 gateway使其生效：

openclaw gateway restart

现在你的 AI 助手就可以通过 QQ 与你聊天了！🎉

常见问题

命令找不到？

如果提示 openclaw: command not found，需要将 npm 全局 bin 目录添加到 PATH：

        
# macOS / Linux
export PATH="$(npm prefix -g)/bin:$PATH"

# Windows
# 在系统环境变量中添加 npm prefix -g 的输出路径

安装失败？

如果遇到权限问题（Linux/macOS），可以尝试：

        
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

总结

本文介绍了通过 NPM 安装 OpenClaw 并配置 qqbot 的完整步骤。完成这些后，你即可在 QQ 中与 AI 助手对话。后续可以根据需要进一步接入模型、配置其他通道或安装插件，详情请参考官方文档。