1. 为什么要在腾讯云 Lighthouse 上跑 OpenClaw 并接入 QQOpenClaw 是一个可以跑在自己服务器里的开源 AI 助理框架它能通过聊天软件跟你对话也能调用模型完成写作、整理、答疑这类任务。适合谁适合想拥有一个私有 AI 助理、又不想把数据交给第三方托管平台的个人开发者。你可能会问为什么不直接跑在本地电脑上因为 OpenClaw 需要长期在线本地电脑关机它就断了而且它权限较高跑在主力机上存在数据风险。放到腾讯云 Lighthouse 轻量服务器上隔离性好、7×24 小时在线、成本几十块就能起步这才是比较稳妥的落地方式。这篇教程聚焦一条完整路径在腾讯云 Lighthouse 上部署 OpenClaw再把它接入 QQ让你打开 QQ 就能跟自己的 AI 助理聊天。我会给出可复制的服务器初始化命令、OpenClaw 配置文件骨架、QQ 机器人对接参数以及验证消息收发是否成功的具体动作。整个过程不需要你精通云计算跟着做就行。需要提前说明一点OpenClaw 对 Windows 支持较弱建议用 Linux 环境Lighthouse 默认就是 Linux正好合适。另外接入 QQ 推荐用国内地域的服务器搭配国内模型网络延迟更低体验更顺。2. 前置准备TaoToken 账号与 API Key 获取OpenClaw 本身只是“壳”它需要接入一个大模型才能真正对话。这里我用 TaoToken 来提供模型能力它兼容主流模型调用方式配置起来比较直接。第一步打开 TaoToken 官网注册账号https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册完成后进入控制台找到 API Keys 管理页面。第二步创建一个新的 API Key。建议给它起个能认出来的名字比如openclaw-qq方便以后区分用途。创建后立刻复制保存因为部分平台出于安全考虑不会再次明文展示。第三步记下两个关键信息API Base URL 和刚才生成的 Key。TaoToken 的 API 地址是 https://taotoken.net/api 注意这个地址后面不加任何多余参数。OpenClaw 配置里会用到它作为模型请求的入口。如果你还没想好先用哪个模型可以先去模型对话页面体验一下不同模型的表现再决定给 OpenClaw 配哪个。模型对话入口在这里https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。注意API Key 等同于你的调用凭证不要写进公开的代码仓库也不要截图发到群里。泄露后请立刻在控制台删除重建。3. 在腾讯云 Lighthouse 部署 OpenClaw3.1 创建服务器实例登录腾讯云 Lighthouse 控制台新建一台轻量应用服务器。关键配置如下应用创建方式选择“应用模板”分类里找到 AI 智能体选中 OpenClaw 模板。这个模板预置了 OpenClaw 运行所需的基础环境省去手动装依赖的麻烦。地域选择上如果你打算接入 QQ选国内地域套餐推荐 2 核 4G 内存起步2 核 2G 可以简单体验但跑模型对话和多个通道时容易吃紧。锐驰型套餐性能更好预算允许可以选它。支付完成后大约 30 秒服务器就创建好了。推荐用控制台自带的 OrcaTerm 终端登录不用额外配 SSH 客户端。3.2 服务器初始化命令登录服务器后先做几件基础的事更新系统、确认 OpenClaw 服务状态、开放必要端口。下面这组命令可以直接复制执行。# 更新软件包索引 sudo apt update sudo apt upgrade -y # 查看 OpenClaw 相关服务是否在运行 systemctl status openclaw --no-pager # 如果服务没起来尝试启动 sudo systemctl start openclaw sudo systemctl enable openclaw # 查看监听端口确认 Web 面板端口 sudo ss -tlnp | grep -E 3000|8080|8000执行完systemctl status后如果看到active (running)说明 OpenClaw 主进程已经跑起来了。如果显示inactive先看日志定位问题journalctl -u openclaw -n 50 --no-pager日志里常见的报错是配置文件缺失或端口被占用这两种情况在下一节的配置骨架里都会覆盖到。3.3 OpenClaw 配置文件骨架OpenClaw 的核心配置通常放在/etc/openclaw/config.yaml或应用目录下的config.yaml。具体路径以你服务器上模板生成的为准可以用下面命令找一下find / -name config.yaml -path *openclaw* 2/dev/null找到后参考这个骨架来填。注意 YAML 对缩进敏感统一用两个空格不要用 Tab。# OpenClaw 主配置骨架 server: host: 0.0.0.0 port: 3000 # 模型接入配置 model: provider: openai-compatible base_url: https://taotoken.net/api api_key: 你的_TaoToken_API_Key model_name: deepseek-chat # 按你实际选用的模型名填写 max_tokens: 4096 temperature: 0.7 # 通道配置QQ 部分在下一节补全 channels: qq: enabled: false app_id: app_secret: # 日志 logging: level: info file: /var/log/openclaw/openclaw.log改完配置后重启服务让改动生效sudo systemctl restart openclaw重启后再次用systemctl status openclaw确认状态同时tail -f /var/log/openclaw/openclaw.log观察有没有报错。4. 接入 QQ创建机器人并打通通道4.1 注册 QQ 开放平台并创建机器人打开 QQ 开放平台官网注意这里不能用 QQ 号直接登录需要单独注册开放平台账号。注册后按引导设置超级管理员用手机 QQ 扫码填写个人主体信息并完成人脸认证。审核通过后就能登录了。进入“QQ 机器人”页面点击创建机器人。创建完成后进入机器人管理页找到 AppID 和 AppSecret 两个值复制保存好。AppSecret 不支持明文再次查看忘记只能重新生成所以务必当场备份。4.2 沙箱配置与测试用户在机器人的“开发管理”页面找到“沙箱配置”。个人私用场景不需要发布上架沙箱模式完全够用。如果只想私聊选择“在消息列表配置”先添加成员再用该成员的 QQ 扫码添加机器人。添加后跟机器人对话可能会提示“该机器人去火星了”这是正常的因为通道还没打通。如果想把机器人拉进群在“沙箱配置”里找到“在 QQ 群配置”选择目标群然后在群管理的“群机器人”里选择“其他”找到刚创建的机器人添加即可。目前 QQ 群对机器人支持还不完善私聊体验更好。4.3 在 OpenClaw 中填入 QQ 通道参数回到服务器编辑刚才的配置文件把 QQ 通道部分补全channels: qq: enabled: true app_id: 你的_AppID app_secret: 你的_AppSecret sandbox: true # 沙箱模式个人私用保持 true intents: # 需要接收的事件类型 - group_at_message - private_message保存后重启服务sudo systemctl restart openclaw再观察日志如果出现类似QQ channel connected或bot login success的字样说明通道已经建立。5. 验证消息收发是否成功配置完成后最关键的验证动作就是发一条消息看能不能收到回复。打开手机 QQ 或电脑 QQ找到你的机器人发送一句简单的话比如“你好帮我列三个待办”。如果几秒内收到 AI 回复说明整条链路通了QQ 消息 → OpenClaw 通道 → TaoToken 模型 → 回复返回 QQ。如果没回复按下面顺序排查先看服务器日志有没有收到消息事件tail -f /var/log/openclaw/openclaw.log | grep -i qq如果日志里完全没有 QQ 相关记录说明 QQ 开放平台那边的事件推送没到检查 AppID 和 AppSecret 是否填错、沙箱成员是否扫码添加成功。如果日志显示收到消息但报模型错误多半是 API Key 或 base_url 有问题。可以单独测一下模型接口是否通curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的_TaoToken_API_Key \ -H Content-Type: application/json \ -d {model:deepseek-chat,messages:[{role:user,content:ping}]}返回里有正常的choices字段说明 Key 和地址没问题问题就在 OpenClaw 配置侧。6. 本篇常见错误排查报错一config.yaml解析失败服务起不来。九成是缩进问题。YAML 不允许 Tab全部换成空格冒号后面要有一个空格。可以用python3 -c import yaml;yaml.safe_load(open(config.yaml))快速校验语法。报错二QQ 对话一直提示“去火星了”。这是通道没打通的典型表现。依次确认AppID/AppSecret 是否与开放平台一致、enabled是否为 true、沙箱成员是否已扫码添加、服务是否重启过。报错三模型返回 401 或 403。API Key 错误或已失效。去 TaoToken 控制台重新生成一个替换配置里的api_key后重启服务。接入文档里有更细的参数说明遇到鉴权问题可以对照看https://taotoken.net/docs?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。报错四端口被占用Web 面板打不开。用ss -tlnp | grep 3000看是谁占了端口改配置里的server.port换一个或者停掉冲突进程。报错五服务器能收到消息但回复超时。多半是模型请求慢或网络抖动。国内地域配国内模型通常没问题如果用的是海外模型延迟会明显一些。可以适当调大max_tokens之外的超时参数或在配置里加timeout: 60。如果你打算长期跑编码类、Agent 类任务调用量会比较大可以了解一下 Coding Plan按需选择更划算的额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。日常只是聊天问答普通 API Key 就够用。最后提醒一句AppSecret 和 API Key 都属于敏感凭证服务器上的配置文件权限建议设成600只让属主可读sudo chmod 600 /etc/openclaw/config.yaml这样即使服务器上有其他账号也读不到你的密钥。配置改完、服务重启、QQ 里发条消息能收到回复这套私有 AI 助理就算真正跑起来了。