跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 本地化部署及 QQ 机器人接入教程

OpenClaw 是本地化 AI Agent 网关框架,支持多模型接入与工具调用。详述在 Windows 环境下基于 Node.js 安装 OpenClaw 的步骤,包括环境配置、API Key 设置及技能包安装。通过官方插件系统,可实现与 QQ 机器人的无缝对接,无需手写底层通信代码,适合希望快速构建本地智能助手的开发者。

SparkGeek发布于 2026/3/22更新于 2026/10/22107 浏览
OpenClaw 本地化部署及 QQ 机器人接入教程

简介

OpenClaw 是一个强大的本地化 AI Agent 网关与编排框架。它支持管理大语言模型(如 Qwen、DeepSeek)的接入,提供可视化的 Web 控制台,并能连接外部社交平台(QQ、Telegram 等),赋予 AI 读取本地文件、调用外部工具的能力。

其核心价值在于开箱即用和工程实用性,解决了智能体开发中底层造轮子、多平台分发及数据隐私控制等痛点。

环境准备

OpenClaw 基于 Node.js 运行,要求 Node.js 版本 >= 22,并需安装 Git。

Node.js 安装

访问 Node.js 官网下载最新的 LTS 版本 Windows 安装程序 (.msi)。

安装过程中,若遇到提示 "Automatically install the necessary tools…"(自动安装必要的工具,如 Python 和 C++ 编译环境),建议勾选。这有助于避免后续编译依赖时的报错。

Git 安装

npm 拉取依赖时需要调用 Git 工具。

方案 A:使用 winget 命令行一键安装 在 PowerShell 中输入以下命令:

winget install Git.Git

若出现错误,建议使用方案 B。

方案 B:官网下载安装包 访问 Git 官网下载 64-bit 的 .exe 安装包,双击运行后保持默认配置一路 Next 完成。

安装完成后,关闭所有终端窗口,重新打开新的 PowerShell 输入 git -v 验证是否识别到 Git。

解决 npm 被拦截

Windows PowerShell 默认安全策略可能拦截 npm 脚本执行。

  1. 关闭当前终端。
  2. 以管理员身份重新打开 PowerShell。
  3. 运行以下命令放行权限:
Set-ExecutionPolicy RemoteSigned
  1. 输入 Y 确认更改。
  2. 再次输入 npm -v 验证。

部署步骤

拉取与组装

在 PowerShell 中输入以下指令安装 OpenClaw:

npm install -g openclaw@latest

等待安装完成,看到类似 added 673 packages 的提示即表示核心组件安装成功。过程中出现的 warn deprecated 或 notice 警告可忽略。

初始化配置

启动初始化向导:

openclaw onboard

按提示操作:

  1. 阅读安全提示选择 Yes。
  2. 选择 Onboarding 模式 (QuickStart)。
  3. 选择 AI 模型提供商并输入 API Key。
提供商获取 API Key备注
Anthropic Claudehttps://console.anthropic.com需国际信用卡
OpenAI GPT
https://platform.openai.com
需国际信用卡
OpenRouterhttps://openrouter.ai支持多种支付方式
Qwen(推荐)https://bailian.console.aliyun.com中国大陆服务商
DeepSeekhttps://platform.deepseek.com中国大陆服务商
Moonshot / Kimihttps://platform.moonshot.cn中国大陆服务商
本地模型支持 Ollama 等免费,需本地算力

推荐使用 Qwen,支持 OAuth 授权登录,有免费额度。选择后复制认证链接至浏览器登录账号。

  1. 选择具体模型,默认第一个即可。
  2. 社媒软件连接选项选择 Skip for now。
  3. 安装 Skills(技能包)。建议添加 ClawHub 官方技能市场,使用 npm 安装。
  4. 额外服务配置选择 No。
  5. 防火墙提示允许公共网络和专用网络访问。
  6. 选择 Web UI 网页中使用。

启动成功后,浏览器将自动打开控制面板。若 Token 未自动跳转,可手动拼接 URL:http://localhost:18789/?token=一长串字母和数字。

[图片]

QQ 机器人接入

获取凭证

  1. 访问 QQ 开放平台,使用手机 QQ 扫码登录。
  2. 点击'创建机器人',设置名称和头像。
  3. 进入开发设置页面,记录 AppID 和 AppSecret。

[图片]

[图片]

安装插件

重新打开 PowerShell(建议管理员身份),安装官方 QQ 插件:

[图片]

[图片]

运行结果

返回 QQ 软件,新建的机器人应已出现在消息列表中并发送第一条消息。尝试发送指令测试功能。

[图片]

[图片]

[图片]

结语

至此,已成功在本地部署带有 Qwen 大脑的 OpenClaw 并接入 QQ 机器人。OpenClaw 的核心价值在于本地工具调用能力,开发者可将 Python 脚本挂载给它,实现自动化处理 Excel、抓取金融数据等任务。

环境部署完成后,即可根据需求扩展更多功能。

目录

  1. 简介
  2. 环境准备
  3. Node.js 安装
  4. Git 安装
  5. 解决 npm 被拦截
  6. 部署步骤
  7. 拉取与组装
  8. 初始化配置
  9. QQ 机器人接入
  10. 获取凭证
  11. 安装插件
  12. 运行结果
  13. 结语

更多推荐文章

查看全部
  • 5 个适用于生活与工作的 Python 自动化项目
  • 深度学习模型优化策略与实战调参
  • SQL 常用数据类型详解
  • CPU+GPU+FPGA 异构计算 AI 系统调优:协同计算资源调度策略
  • Linux 通过 NFS 挂载群晖 NAS 共享文件夹
  • Ollama:一条命令在本地运行 Llama2 等大模型
  • 爬虫开发:Cookies 模拟浏览器登录技术详解
  • 开源知识库 RAGFlow 从部署到实战操作详解
  • Web 聊天室消息加解密方案详解
  • 用 Leaflet 和百度天气接口展示湖南省空气质量
  • AI Agent 新范式:FastGPT 集成 MCP 协议构建工具增强智能体
  • AIGC 时代的网络安全威胁与应急响应机制构建
  • 阿里开源 iFlow CLI:终端级 AI 智能体初探
  • 适配 imToken DApp 浏览器的区块链小游戏开发实战
  • 前缀和与二维前缀和算法模板详解
  • MyBatisPlus 与 Thymeleaf 全栈分页实战
  • 数据中台血缘可视化实践:基于 Neo4j 的图数据库方案
  • AI 辅助钱包开发:智能生成合约交互与监控脚本
  • Visual Studio Code + Continue + Ollama 实现本地 AI 代码助手
  • 链表数据结构基础与经典算法实现

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online