通过OpenCodeBridge实现OpenCode接入QQ
2026/5/30 3:40:19 网站建设 项目流程

需要通过QQ来控制OpenCode为你写代码吗?参考本文步骤操作试试吧!

概述

目前网络上介绍的有三种方式:

1、独立的桥接服务:OpenCode Bridge

2、NapCat

3、opencode-qq-bot

本文介绍在Windows开发环境中通过OpenCode Bridge方式来实现接入的步骤。

QQ机器人创建

访问QQ开发平台的机器人创建页面:https://q.qq.com/qqbot/openclaw/login.html

通过自己的QQ登录后,按照页面指引创建一个QQ机器人,记录AppID和AppSecret。

此时你的QQ中就会出现这个机器人给你打招呼:Hello,我已被你创建成功,等你进一步开发部署我的“灵魂”。此时给它发消息,会提示该机器人的“灵魂”不在线。

启动OpenCode服务器

cmd进入命令行,执行:

opencode serve

此时opencode服务正常监听,不要关闭。通过http://127.0.0.1:4096可以访问其Web UI,但是也用不到。

OpenCode Bridge启动与配置

代码获取

直接从国内的码云代码托管平台下载:

https://gitee.com/yu-shuang22/opencode-bridge

部署与启动

以PowerShell模式启动命令行,进入代码目录,执行如下命令分别执行部署与启动:

.\scripts\deploy.ps1

.\scripts\start.ps1

根据提示引导选择部署、启动等操作,预期可以成功启动桥接服务。

这是项目的README文档中介绍的步骤,我本地环境执行遇到了问题,没有成功启动,大家可以尝试,如果也失败了可以寻找方法解决。

如果与我一样没有成功启动并且自行解决失败,也可以直接按下面的开发模式启动。

在代码根目录中执行如下命令:

npm install --registry=https://registry.npmmirror.com

npm run build:all

npm run dev

如果遇到下面的错误提示:

不要忽略,按最后一行提示执行:

pnpm approve-builds

根据其提示引导,通过方向键+空格把esbuild和vue-demi都选择上,回车后按y完成处理后,再次执行上面的启动命令。

最终启动成功后提示如下:

图中部分信息是我在已经成功接入QQ之后的输出信息,在未接入之前输出会有所不同。

考虑到大家在此过程中都会因环境不同而遭遇各种不同的问题,所以本文未能尽述我在启动过程中的所有问题。如果命令执行失败,可把错误信息发给DeepSeek等协助诊断。

QQ接入配置

桥接器启动成功后会提示可视化地址,其端口是4098。

访问地址:http://127.0.0.1:4098,首次访问会要求设置管理员密码。

左侧导航进入“平台接入”,有很多接入渠道,大家可根据需要接入飞书、QQ、微信、钉钉等消息平台。本文按QQ接入来说明。

未接入前的初始界面状态如下:

启用后,把协议类型切换为“官方API”方式(NapCat方式大家可以根据需要研究配置),输入前面记录的QQ机器人的AppID和AppSecret:

然后需要点击一下页面上的“保存配置”按钮才可生效。

配置后的界面如下:

在QQ中与QQ机器人对话

此时QQ机器人所需要的“灵魂”(OpenCode服务 + OpenCodeBridge服务)已部署并就绪了,现在再在QQ中给它打招呼,它就会回复你啦,这是来自OpenCode的回复。接下来我们就可以给它下指令写代码了,通过手机QQ与之沟通,方便很多,不用一直操作电脑了。PS:我的使用场景是开发微信小程序,让它写完代码后,执行一个命令生成二维码图片文件,把图片直接发过来,就可以在手机上验证了,验证有问题再让它修改。大家看各自的使用场景判断是否适合直接在手机上与之沟通。

另外一点要说明的是,之前我们使用OpenCode的姿势是:进入命令行,切换到具体要开发代码的项目目录,然后执行opencode命令,它会自动基于当前目录来进行读取写入操作。而现在我们通过QQ机器人与OpenCode对话的模式,它是没有具体的目录的,需要我们明确告诉它项目目录位置。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询