本文作者：猫猫摸大鱼 原文地址：[https://iloli.love/archives/1772284805466](https://iloli.love/archives/1772284805466)

## 1\. 前言

本文隶属于 OpenClaw 龙虾系列教程文章，建议按顺序阅读，可以访问OpenClaw龙虾系列教程文章目录 [https://iloli.love/archives/1766849996690](https://iloli.love/archives/1766849996690) 查看其它文章

本文基于 OpenClaw 2026.2.26 版本

本文中安装的是官方一键脚本直装版本

本系列教程全程使用腾讯云轻量应用服务器，可以参加腾讯云OpenClaw专属活动进行购买，新客68/年起，老客99/年起

活动链接 [https://cloud.tencent.com/act/pro/lighthouse-moltbot](https://cloud.tencent.com/act/pro/lighthouse-moltbot) （无AFF） [http://to.iloli.love/openclaw](http://to.iloli.love/openclaw) （有AFF）

**就算不买也强烈推荐使用有 快照 功能的厂商的服务器进行搭建，并且一定要经常打快照，不要问为什么，血的教训，血的教训，血的教训**

![](https://developer.qcloudimg.com/http-save/yehe-6836203/09216f8a6e63410ac899878209bd9301.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/40ec4badae57786e0d90cd94cfbe7ad6.png)

## 2.搭建并配置

首先使用SSH连接服务器（如果是腾讯云服务器可以在控制台直接点击 登录 使用腾讯云OrcaTerm免密连接服务器）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/be32c37670f7149533b6e5ceb714fd36.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/b33a551118b598fd9daba5684dafa8e1.png)

运行下方一键脚本

`curl -fsSL https://openclaw.ai/install.sh | bash`

可以看到，开始了安装流程，稍作等待

![](https://developer.qcloudimg.com/http-save/yehe-6836203/1a67f9b909d4b37ce1d20055f1c57aaa.png)

等待了一会，出现了安全警示，使用键盘的方向键调整到 Yes ，点击回车

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6cc8048762d64245345bc766685a5098.png)

选择引导模式，直接回车

![](https://developer.qcloudimg.com/http-save/yehe-6836203/e9b6e42807a0b2b4619f18d2bb7901b8.png)

接下来要接入大语言模型，选择 `Custom Provider` ，回车（这里我要使用的是前面教程反代出来的自建 API，如果你有其他官方 API，也可以在此处接入，这里不做赘述）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/66183a4931095f3df057cdb399cc19cc.png)

删除默认内容，填写base\_url，值为自建项目的 服务器IP:端口 或是为项目反代的 域名（结尾一定要带 `/v1` ）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/2e3f84048999387826c7629fee1b0e5a.png)

询问如何保存API Key，出于安全考虑，**建议使用下面的** `Use secret reference` **，而不是直接明文保存到配置文件**，但这里为了方便，我选择直接回车

![](https://developer.qcloudimg.com/http-save/yehe-6836203/87d3a96539972782c66a81654e6c0242.png)

输入你在自建项目里创建的 API Key ，回车

![](https://developer.qcloudimg.com/http-save/yehe-6836203/155ab38af454dbf0dc71beb4b8be3161.png)

询问API类型，直接回车

![](https://developer.qcloudimg.com/http-save/yehe-6836203/3e527440d815c637ed90723c8eec2a2d.png)

找到你在自建项目里获取到的模型名称，选择其中一个，填入，回车（可以通过 `模型1, 模型2, 模型3` 的形式接入多个模型，本文只接入一个我自己的）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/da41f8a8c66bd55871d4f79c67697b82.png)

确认完成后，让我们填写 Endpoint ID，这个直接默认回车即可

![](https://developer.qcloudimg.com/http-save/yehe-6836203/c13244b756c0bfd6d00c131170d3e08e.png)

填写模型别名，这个直接回车跳过即可

![](https://developer.qcloudimg.com/http-save/yehe-6836203/5db1177ee116cb5a30aeb739278885a5.png)

接下来让我们对接通道，可以看到有很多种通道可以用来对接（如果会的话在这里可以自行对接），不过本文中我们选择跳过，回车，直接复用前面文章里写过的QQ对接 ~~（懒）~~

![](https://developer.qcloudimg.com/http-save/yehe-6836203/12a4d1018ce80d4e7cc31e43cf1c8141.png)

询问我们是否要确认技能，回车，可以看到有很多 skills ，可以挑选自己觉得有用的使用空格键启用（本文也直接跳过），选择完成后 回车 以提交

![](https://developer.qcloudimg.com/http-save/yehe-6836203/00265cb9581ae10081bd69b94860c210.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/1fffae923aefb56dfbcc3b1ee1d74dca.png)

接下来这一串也直接全NO

![](https://developer.qcloudimg.com/http-save/yehe-6836203/3c8662cf61e3dbc99eb1654957031245.png)

接下来选择钩子，按需勾选，然后回车

![](https://developer.qcloudimg.com/http-save/yehe-6836203/909ff397f20671ec0eb672c61e50ed3d.png)

可以看到尝试创建 systemd 服务失败了，并且健康检查也失败了，**这是正常现象，是因为在无头服务器**（可以理解为没有桌面环境的服务器）**上，用户级 systemd 默认不可用导致的**，（~~狗屎项目，将近一个月之前~~[~~就有人发现了~~](https://github.com/openclaw/openclaw/issues/11805)~~，并且最近也有人提了PR，还是有这个问题~~），需要曲线救国来解决，后面给出方法（本文是写于OpenClaw2026.2.26版本，如果你安装时的版本解决了这个问题则可以无视）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/51bf64747c3470b23a38abda99b886eb.png)

接下来就是输出一些信息了，无需理会，此时 OpenClaw 已经安装和配置完成了

![](https://developer.qcloudimg.com/http-save/yehe-6836203/649609138eec21c430af1da5043dec0c.png)

但因为上面的问题（本文是写于OpenClaw2026.2.26版本，如果你安装时的版本解决了这个问题则可以无视），OpenClaw 现在还是没有运行的，接下来解决这个问题

首先运行这个命令，启用用户 linger (确保退出登录后进程不被杀掉)

    sudo loginctl enable-linger $(whoami)

因为需要 sudo ，所以视操作系统不同可能会需要你输入ssh密码，我这里使用Debian是不需要输入密码的

然后运行下列命令，如果输出了类似 `/run/user/*` 的路径，说明成功了

    # 1. 将 XDG_RUNTIME_DIR 写入 ~/.bashrc (如果已存在则跳过，避免重复)
    grep -q "XDG_RUNTIME_DIR" ~/.bashrc || echo 'export XDG_RUNTIME_DIR=/run/user/$(id -u)' >> ~/.bashrc
    # 2. 立即在当前窗口生效
    source ~/.bashrc
    # 3. 验证检查
    echo $XDG_RUNTIME_DIR

![](https://developer.qcloudimg.com/http-save/yehe-6836203/9d262febdb993250ca5f44a0ea29b4ca.png)

最后运行这个命令，重新安装 OpenClaw 网关，如下图即为成功

    openclaw gateway install --force

![](https://developer.qcloudimg.com/http-save/yehe-6836203/d7d1ece8cd3d44d1a3e0282c6be02ab2.png)

此时 OpenClaw 已经启动了，我们开始安装 QQ 通道

运行下面的命令，安装 QQ 通道插件

    openclaw plugins install @sliverp/qqbot@latest

然后创建 QQ 机器人，访问 QQ 开放平台 [https://q.qq.com/](https://q.qq.com/) ，如果你尚未注册过，需要先注册账号（需要实名信息，扫脸，以及一个 QQ 号作为管理员 QQ 号），非常简单，这里就不赘述了

![](https://developer.qcloudimg.com/http-save/yehe-6836203/65d2b4cba2b67bac10d5fca1ce0629f0.png)

登录你的 QQ 开放平台账号，进入后台后，点击机器人，点击创建机器人

![](https://developer.qcloudimg.com/http-save/yehe-6836203/725cb3ac0d497997979cc51a95374771.png)

填写机器人名称，上传机器人头像，填写机器人描述，点击确认

![](https://developer.qcloudimg.com/http-save/yehe-6836203/469b272eca1265137a3fdf02cede250f.png)

点击提交创建

![](https://developer.qcloudimg.com/http-save/yehe-6836203/b3c1021a3b24045985cc19acc88d4f82.png)

点击刚刚创建的机器人

![](https://developer.qcloudimg.com/http-save/yehe-6836203/bd1cb00d52d2e7e419b0fdaaf08bb2e8.png)

点击开发管理，复制 App ID，生成 App Secret

![](https://developer.qcloudimg.com/http-save/yehe-6836203/07d73b486bf9710c1e1df2c7e57c5542.png)

扫码认证后，复制 App Secret，勾选，点击关闭

![](https://developer.qcloudimg.com/http-save/yehe-6836203/2883e27267e3e661df7c73f40c252096.png)

点击沙箱配置，点击添加成员，把自己勾选上，点击确认

![](https://developer.qcloudimg.com/http-save/yehe-6836203/a0ccf05f80e55aaa0f9457ad9ab046b2.png)

点击这个二维码的图标，使用自己的 QQ 扫描弹出的二维码，在手机上添加使用

![](https://developer.qcloudimg.com/http-save/yehe-6836203/edefe3792b1ada9c31732432afa088d9.png)

在创建 QQ 机器人的这一段时间，QQ 渠道插件也应该安装好了

![](https://developer.qcloudimg.com/http-save/yehe-6836203/bf34e4508a402748676447a5d4a55e85.png)

接下来运行以下命令对接 QQ 渠道（将其中的 App ID 和 App Secret 更改为你刚刚创建的 App ID 和 App Secret ），如下图

    openclaw channels add --channel qqbot --token "AppID:AppSecret"

![](https://developer.qcloudimg.com/http-save/yehe-6836203/d968e0f35cee92393bf1fd76de9d4058.png)

**然后，踩坑，我实在忍不住吐槽：我真的不理解为什么向导里选择自定义API接口，会给我默认配置仅仅 4096 的上下文窗口和最大Token，这是人能干出来的事****😅****？**

![](https://developer.qcloudimg.com/http-save/yehe-6836203/08e061bfa207d3d173734e090a83c7b3.png)

所以接下来做两件重要的事：添加插件信任白名单，以及修改模型上下文窗口和最大Token

打开 `/root/.openclaw/openclaw.json` 文件，进行修改

找到 plugins ，添加以下代码，如图

    "allow": ["qqbot"],

![](https://developer.qcloudimg.com/http-save/yehe-6836203/bb16d0efeefdcd68cfcadf16c06cccb1.png)

然后找到 models ，修改 `contextWindow` 和 `maxTokens`

![](https://developer.qcloudimg.com/http-save/yehe-6836203/20c983c3f7855728a45b3c6bd395ccd1.png)

我这里使用的 gemini-3-flash 理论上支持 100 万的上下文窗口和 6.4 万的最大输出，但是稳妥起见，我们在这里设置 128K 的上下文窗口和 8192 的最大输出

![](https://developer.qcloudimg.com/http-save/yehe-6836203/3e8d31b30da0fbbfd67bcd75edf3e1f5.png)

都修改完了以后，不要忘记保存，然后运行以下命令，重启网关

    openclaw gateway restart

![](https://developer.qcloudimg.com/http-save/yehe-6836203/a757d0ba8a0e3cc6594aca3bd3538b7b.png)

## 3\. 开始使用

到此就已经搭建并初步配置完成了，现在去 QQ 对话，验证一下，可以看到已经成功了

![](https://developer.qcloudimg.com/http-save/yehe-6836203/9b323243d2eb3b2d3b50d08f1618132b.png)

本文作者：猫猫摸大鱼 原文地址：https://iloli.love/archives/1772284805466

使用官方一键脚本搭建OpenClaw图文教程

本教程详细介绍了使用官方一键脚本 curl 搭建 OpenClaw 的全过程。

腾云先锋（TDP）成员

其他

OpenClaw2026.2.26版本安装教程，详细讲解一键脚本安装、API对接、QQ机器人配置及常见问题解决方法。包含腾讯云服务器推荐、系统配置优化、模型参数调整等实用技巧，帮助用户快速搭建AI对话系统。适合开发者参考，解决实际部署中的各种疑难问题。

轻量应用服务器

云服务器

服务器

Debian

4核4G3M云服务器 新用户低至38元/年！

lighthouse

2026新春采购季

domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

使用官方一键脚本搭建OpenClaw图文教程-腾讯云开发者社区-腾讯云

使用官方一键脚本搭建OpenClaw图文教程

使用官方一键脚本搭建OpenClaw图文教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐