前言

最近想在手机上跑一个 QQ 机器人，选了个看起来挺灵活的框架 OpenClaw。本以为按文档几分钟就能搞定，结果断断续续折腾了一晚上。这里记一下过程，给同样在 Termux 上折腾的人省点时间。

为什么选 OpenClaw

主要看中它支持多平台（QQ、微信、Telegram 等），还能接各种大模型。我想把智谱的免费模型 glm-4.7-flash 接上 QQ，手机上跑着省电。

第一个坑：插件找不到

装完 OpenClaw 后，配置文件里加了 openclaw-qqbot，结果启动报错：

1

plugins.allow: plugin not found: openclaw-qqbot

官方的安装命令跑了一遍，又说找不到 openclaw/dist/plugins-sdk/index_js/core。搜了一下，大概是版本不匹配——OpenClaw 核心和 QQ 插件各说各话。

第二个坑：Node.js 编译失败

升级 Node.js 到 v24 后，npm install -g openclaw@latest 直接挂掉，卡在 tree-sitter-bash 的编译上：

1

gyp: Undefined variable android_ndk_path in binding.gyp

这是 Termux 环境的老毛病了——Android 的 C 库（Bionic）和很多 npm 原生模块不对付。折腾半天无解，决定换路子。

终极方案：Ubuntu 容器

Termux 里有个 proot-distro 可以跑完整 Linux 发行版。既然原生环境不行，就在容器里装。

在开发QQ频道机器人和UniApp应用的过程中，可能会遇到一些常见的错误和坑。本文将总结这些容易出错的地方，并提供解决方案，帮助你更顺利地完成开发。

QQ频道机器人 Android客户端

一个用于管理和操作QQ频道机器人的Android客户端应用，基于uniapp开发，提供了直观的用户界面和丰富的功能特性。

客户端界面预览

功能特性

1. 账号管理

• App ID和Token登录
• 记住登录状态
• 自动登录选项
• 沙盒/正式环境切换
• 多账号管理
• 账号安全保护

2. 频道管理

• 频道列表显示
  • 分组展示
  • 在线人数显示
  • 频道类型图标
  • 频道状态标识
• 未读消息统计
  • 普通消息计数
  • @消息特别标记
  • 按频道分类统计
• 频道权限管理
  • 自动识别管理员权限
  • 权限值实时计算
  • 权限检查功能

3. 消息功能

• 实时消息接收

本文档将指导您如何为QQ频道机器人客户端开发插件。

插件结构

每个插件都是一个标准的 JavaScript 文件，需要导出一个包含以下字段的对象:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

// 插件对象
const plugin = {
  // 基本信息(必需)
  id: 'plugin-id',          // 插件ID,只能包含小写字母、数字、下划线和横线
  name: '插件名称',         // 插件显示名称
  description: '插件描述',  // 插件功能描述
  command: '/命令',         // 触发命令,必须以/开头
  
  // 基本信息(可选)
  version: '1.0.0',        // 插件版本号
  author: '作者名称',      // 插件作者
  enabled: true,           // 插件是否启用
  
  // 配置项(可选)
  config: {
    // 插件的配置项
    minPoints: 10,         // 示例:最小积分
    maxPoints: 100,        // 示例:最大积分
  },
  
  // 数据存储(可选)
  storage: {
    // 插件的数据存储
    records: new Map()     // 示例:记录存储
  },
  
  // 消息处理函数(必需)
  handler: async (message, channel, context) => {
    // 返回值:
    // - 字符串: 要发送的回复消息
    // - null/undefined: 不发送回复
    // - Promise<string>: 异步返回回复消息
    return '回复消息'
  }
}

// 导出插件
module.exports = plugin

API 说明

1. 消息对象(message)