# OpenClaw QQ 机器人接入完整指南

作者: 星期五助手
创建时间: 2026-03-05
适用版本: OpenClaw 2026.2.26+


📖 目录

  1. 项目概述
  2. 环境准备
  3. 安装 NapCat QQ 机器人
  4. 配置 OpenClaw QQ 插件
  5. 网络配置(关键)
  6. 测试与验证
  7. 常见问题

项目概述

本指南介绍如何将 OpenClaw 接入 QQ,实现通过 QQ 与 OpenClaw 智能助手对话。

架构说明

┌─────────────┐ ┌──────────────┐ ┌─────────────┐ │ QQ 用户 │ ──→ │ NapCat │ ──→ │ OpenClaw │ │ (发消息) │ │ (QQ 机器人) │ │ (星期五) │ └─────────────┘ └──────────────┘ └─────────────┘ ↓ (OneBot WebSocket) 

技术栈

  • NapCat: QQ 机器人框架(基于 OneBot v11 协议)
  • OpenClaw QQ 插件: OpenClaw 官方 QQ 频道插件
  • Docker: NapCat 容器化部署
  • Host 网络模式: 解决 WSL2 与 Docker 网络互通问题

环境准备

系统要求

  • ✅ Linux / WSL2 (Windows Subsystem for Linux)
  • ✅ Docker 20.10+
  • ✅ Docker Compose 2.0+
  • ✅ OpenClaw 2026.2.26+
  • ✅ Node.js 18+ (OpenClaw 运行环境)

检查环境

# 检查 Dockerdocker--versiondocker compose version # 检查 OpenClaw openclaw --version# 检查 Node.jsnode--version

安装 NapCat QQ 机器人

步骤 1: 创建部署目录

mkdir-p /home/gaof/.openclaw/extensions/qq/deploy/napcat cd /home/gaof/.openclaw/extensions/qq/deploy/napcat 

步骤 2: 创建 Docker Compose 配置

创建 docker-compose.yml

version:"3"services:napcat:environment:- NAPCAT_UID=${ NAPCAT_UID}- NAPCAT_GID=${ NAPCAT_GID}container_name: napcat network_mode: host # ⚠️ 关键:使用 host 网络模式restart: always image: mlikiowa/napcat-docker:latest 

重要:必须使用 network_mode: host,否则 WSL2 无法访问容器!

步骤 3: 启动 NapCat

cd /home/gaof/.openclaw/extensions/qq/deploy/napcat docker compose up -d

步骤 4: 扫码登录 QQ

查看日志获取二维码:

docker logs napcat 2>&1|tail

Read more

AI 研发提效指南:Copilot与Cursor在敏捷开发中的实战技巧

1. 敏捷开发新搭档:Copilot与Cursor的定位与分工 在敏捷开发的快节奏世界里,每个迭代周期都像是一场与时间的赛跑。需求变更频繁,交付压力巨大,传统的开发工具和流程有时会显得力不从心。我自己在团队里就经历过无数次这样的场景:为了赶一个功能上线,加班加点写代码、做测试,最后发现还是漏掉了一些边界情况。直到我开始系统性地使用 GitHub Copilot 和 Cursor,整个开发体验才发生了质的变化。 简单来说,你可以把 Copilot 看作是你 IDE 里一个经验丰富的“结对编程”伙伴。它深度集成在 Visual Studio Code、IntelliJ IDEA 这些你熟悉的编辑器里,能根据你写的注释或者已有的代码上下文,实时给出下一行甚至下一段代码的建议。我实测下来,在编写一些模板化的代码,比如工具函数、DTO对象、枚举类时,效率提升非常明显,基本上敲完注释,按一下 Tab 键,完整的代码就出来了。它的核心优势在于 “实时、无缝、

AIGC浪潮下,图文内容社区数据指标体系如何构建?

AIGC浪潮下,图文内容社区数据指标体系如何构建?

文章目录 * 01 案例:以图文内容社区为例实践数据指标体构建 * 02 4个步骤实现数据指标体系构建 * 1. 明确业务目标,梳理北极星指标 * 2. 梳理业务流程,明确过程指标 * 3. 指标下钻分级,构建多层级数据指标体系 * 4. 添加分析维度,构建完整的数据指标体系 * 03 构建数据指标体系的过程总结 * 作者简介 * 目 录 数据指标体系构建是数据分析师的日常工作之一,常见的指标体系方法论包括根据业务发展进程选取由合成略旦易于拆解的指标作为北极星指标。但在实际业务场景中如何运用方法论构建数据指标体系,以监控业务发展呢? 互联网产品按照用户需求进行分类,可以分为工具类、内容类、社交类、交易类以及游戏类。当然,每一个互联网产品并不一定属于单一的某一类别,其类别可能是交叉的。 那各种不同类型的互联网产品都有什么特点?它们对应的北极星指标又分别是什么呢?各类型互联网产品的特点以及北极星指标总结如表1所示。 表 1 各类型互联网产品的特点以及北极星指标 表1 各类型互联网产品的特点以及北极星指标 表1各类型互联网产品的特点以及

三菱R系列PLC高端应用案例:远程IO与机器人通信、触摸屏配方及多屏操作

三菱R系列PLC高端应用案例:远程IO与机器人通信、触摸屏配方及多屏操作

三菱R系列PLC案例程序 三菱R系列ST、RD77MS定位以及三菱触摸屏配方功能,此案例还提供两个触摸屏实现异地操作,使操作更加方便快捷。 此案例还通过CClink远程连接远程IO站以及机器人,将机器人作为远程设备站,实现跟机器人的快速通信。 本案例知识点: 1.三菱高端大型R系列PLC应用 2.CClink通信应用与配置,CClink连接发那科机器人应用。 3.ST编程以及LD编程程序框架 4.RD77MS定位模式使用 5.三菱GT2710高端触摸屏应用以及画面设计 6.三菱触摸屏配方功能应用 7.多屏幕连接PLC,实现多地操作 8.EPLAN电气原理图设计 本案例提供PLC程序、伺服参数、两套触摸屏程序、IO分配、EPLAN原版图纸 在自动化产线调试现场摸爬滚打过的工程师都懂,能把三菱R系列全家桶玩转的项目绝对够硬核。这次分享的案例堪称PLC界的满汉全席——从ST编程到机器人联机,从双屏配方向到EPLAN图纸,完整展示了一套高端设备的控制逻辑。咱们直接上干货,边拆代码边唠实战经验。 ST编程里的结构体艺术 玩过三菱R系列的都知道,ST语言的结构体操作是真香。项目中用到的轴控制

OpenDroneMap终极指南:从无人机影像到专业级地理数据

OpenDroneMap终极指南:从无人机影像到专业级地理数据 【免费下载链接】ODMA command line toolkit to generate maps, point clouds, 3D models and DEMs from drone, balloon or kite images. 📷 项目地址: https://gitcode.com/gh_mirrors/od/ODM OpenDroneMap(ODM)是一个革命性的开源工具包,专门将无人机、气球或风筝拍摄的航空影像转化为精确的地理空间数据产品。通过先进的计算机视觉算法,ODM能够生成分类点云、三维纹理模型、地理参考正射影像和数字高程模型等专业成果。 项目核心价值与用户故事 想象一下,你是一名城市规划师,需要快速获取某个区域的精确三维模型;或者是一名农业专家,希望分析作物健康状况。传统方法需要昂贵的专业软件和复杂的操作流程,而ODM让这一切变得简单高效。无论你是科研人员、工程师还是爱好者,都能通过这个工具将普通的航拍照片转化为有价值的地理信息。