OpenClaw 部署与 QQ 机器人接入指南

2. 环境变量管理

编辑 .env 文件存放敏感信息：

nano ~/.openclaw/.env

添加内容：

PERPLEXITY_API_KEY=your_api_key_here
OPENCLAW_LOG_LEVEL=info

3. 浏览器依赖安装

使用 Browser 工具需要 Chrome 支持。以 Ubuntu 为例：

sudo apt-get update
sudo apt-get install -y wget gnupg ca-certificates
wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/google-chrome.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome.gpg] http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list
sudo apt-get update
sudo apt-get install -y google-chrome-stable
google-chrome --version

同时安装必要的运行时依赖：

sudo apt-get install -y libnss3 libxss1 libasound2 libatk-bridge2.0-0 libgtk-3-0 libdrm2 libgbm1

QQ 机器人接入方案

根据现有环境，可选择集成方式。

方案一：使用内置扩展

检查已安装的扩展：

ls -la ~/.openclaw/extensions/

编辑配置文件：

nano ~/.openclaw/extensions/qqbot/config.yaml

配置示例：

qqbot:
  enabled: true
  account:
    uin: "你的 QQ 号"
    password: "你的 QQ 密码"
  server:
    host: 127.0.0.1
    port: 8080
  features:
    autoReply: true
    imageDownload: true
    voiceUpload: true

修改后重启 Gateway 生效：openclaw gateway restart

方案二：使用 NapCat 框架

NapCat 是基于 NTQQ 的第三方框架，适合更复杂的场景。

1. 安装与配置

cd ~
git clone https://github.com/NapNeko/NapCatQQ.git
cd NapCatQQ
npm install
cp config.example.json config.json
nano config.json

2. NapCat 配置示例

{
  "qq": { "account": "你的 QQ 号", "password": "你的 QQ 密码" },
  "server": { "host": "127.0.0.1", "port": 3000, "httpApi": true, "wsApi": true },
  "message": { "ignoreSelf": true, "enableGroupMessage": true }
}

启动服务：npm start

3. 连接 OpenClaw 在 OpenClaw 配置文件中指定 NapCat 端点：

channels:
  qqbot:
    enabled: true
    type: napcat
    endpoint:
      host: 127.0.0.1
      port: 3000
    account:
      uin: "YOUR_QQ_NUMBER"

验证与测试

1. 检查网关状态

openclaw gateway status
# 预期输出包含 Version 和 Runtime 信息

2. 查看日志确认连接

openclaw gateway logs
# 查找类似 [INFO] QQBot connected: account=xxxxx 的记录

3. 功能测试

向机器人发送消息、图片或使用 /help、/status 命令。观察回复是否符合预期。

常见问题排查

Gateway 无法启动 检查端口占用：lsof -i :8765。查看详细日志：openclaw gateway logs --tail=100。

QQBot 连接失败

1. 核对账号密码是否正确。
2. 确认网络连接正常。
3. 测试 API 连通性：curl http://127.0.0.1:8080/status

Browser 工具报错 No supported browser found 确认 Chrome 已安装且依赖完整：which google-chrome。缺失依赖时重新执行安装脚本。

权限错误 (EACCES) 尝试使用 sudo 安装全局包，或修复 npm 权限配置：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

常用命令速查

# 网关控制
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status
openclaw gateway logs

# 技能管理
clawhub search <keyword>
clawhub install <package-name>
clawhub update

# 会话管理
openclaw sessions list
openclaw session status

# 帮助
openclaw help
openclaw --version

参考资源

• OpenClaw 官方文档
• OpenClaw GitHub
• ClawHub 技能市场
• NapCat GitHub
• Go-CQHTTP
• OneBot v11 标准