安装部署openclaw并对接QQ机器人教程

openclaw（原ClawdBot）最近实在太火了，我玩了一下感觉确实很强大，本文介绍一下国内环境的安装和对接QQ机器人。

准备工作#

大模型API
2H4G以上的硬件配置
linux/mac/windows都可以
QQ机器人

首先去QQ开放平台注册一个机器人：https://q.qq.com/#/apps

大模型以deepseek为例，官方购买地址：https://platform.deepseek.com

部署环境以windows本地部署为例，其他系统步骤都一样，只是配置目录不一样，openclaw的默认配置路径都是在用户目录，三大系统都一样。

环境安装#

首先安装nodejs环境，需要v22.22.0以上的版本，下载地址：https://nodejs.org/zh-cn/download

其次需要Git，下载地址：https://git-scm.com/install/windows

国内环境配置#

设置npm镜像

npm config set registry https://registry.npmmirror.com

设置Git全局加速（因为安装openclaw的时候会到github拉取依赖）

git config --global url."https://gh-proxy.org/https://github.com/".insteadOf https://github.com/

移除Git全局加速的命令

git config --global --unset url."https://gh-proxy.org/https://github.com/".insteadOf

开始部署#

npm安装openclaw

npm install -g openclaw@latest

初始化配置

openclaw setup

打开配置文件

%USERPROFILE%\.openclaw

修改openclaw.json配置，贴入以下配置并修改对应的字段

{
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "设置一个token令牌"
    }
  },

  "agents": {
    "defaults": {
      "model": {
        "primary": "openai-compat/示例模型名称"
      },
      "elevatedDefault": "full",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4
    }
  },

  "models": {
    "mode": "merge",
    "providers": {
      "openai-compat": {
        "baseUrl": "https://api.example.com/v1",
        "apiKey": "这里填写你的大模型API密钥",
        "api": "openai-completions",
        "models": [
          {
            "id": "示例模型名称",
            "name": "示例模型名称"
          }
        ]
      }
    }
  },

  "tools": {
    "exec": {
      "backgroundMs": 10000,
      "timeoutSec": 1800,
      "cleanupMs": 1800000,
      "notifyOnExit": true
    },
    "elevated": {
      "enabled": true,
      "allowFrom": {}
    },
    "allow": [
      "exec",
      "process",
      "read",
      "write",
      "edit",
      "web_search",
      "web_fetch",
      "cron"
    ]
  },

  "channels": {}
}

安装QQ插件

git clone https://github.com/sliverp/qqbot.git "$env:USERPROFILE\.openclaw\extensions\qqbot"

cd "$env:USERPROFILE\.openclaw\extensions\qqbot"

npm i

添加QQ机器人ID和密钥

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

启动

openclaw gateway start

其他命令

# 查看状态
openclaw gateway status

# 重启
openclaw gateway restart

# 查看日志
openclaw logs

# 停止
openclaw gateway stop

# 删除插件
Remove-Item "$env:USERPROFILE\.openclaw\extensions\qqbot" -Recurse -Force

# 卸载
npm uninstall -g openclaw

至此，全部部署完成，可以向你的QQ机器人对话了。

常见问题#

QQ机器人需要配置IP白名单，并且沙箱环境需要添加管理员或者QQ群。

Linux和mac系统部署都一样，只是配置文件的目录在用户目录下。

web访问需要带上token令牌：http://127.0.0.1:18789/?token=你的网关令牌。

有任何问题先查看日志：openclaw logs，然后问AI。