# 腾讯云 × OpenClaw：手把手搭建你“能干活”的AI Agent

*jasonruan 2026.02.24*

## 1 前言

`OpenClaw` 是一个能**真正动手干活的开源 AI Agent**——不仅能聊天，还能执行终端命令、读写文件、调用各种服务。要让它 7×24 小时在线，你需要一台稳定的云服务器。

**为什么选腾讯云轻量应用服务器？** 相比传统云服务器（CVM），轻量云最大的优势是**简单和省心**：开箱自带公网 IP、预置防火墙规则、控制台操作直观，不需要单独折腾 VPC、安全组策略、弹性 IP 这些概念，非常适合个人开发者用来跑 AI Agent、Bot 这类轻量级但需要长期在线的服务。价格上，入门套餐也比同规格 CVM 更友好。

关于在轻量云上**开箱即用** `OpenClaw`，已经有不少文章了（[《🔥🔥🔥玩转OpenClaw｜云上OpenClaw(Clawdbot)最全实践教程合辑》](https://cloud.tencent.com/developer/article/2624973)）。一键镜像虽然方便，但对开发人员而言可能缺少了**折腾**的乐趣。 因此，本文选择另一条路：**从一台干净的轻量云服务器开始，手动完成整个 `OpenClaw` 的搭建**。每一步做了什么、为什么这么做，都会讲清楚。折腾一遍之后，当你后续需要排查问题、更换模型、接入新渠道时，也能真正做到心里有数。

**本文环境信息**：

| 项目             | 版本 / 规格                  |
| ---------------- | ---------------------------- |
| **操作系统**     | Ubuntu 24.04 LTS             |
| **Node.js**      | >= 22（本文使用 v25.6.1）    |
| **OpenClaw**     | 2026.2.22-2                  |

## 2 购买轻量应用服务器

### 2.1 选购服务器

前往腾讯云轻量应用服务器购买页：https://buy.cloud.tencent.com/lighthouse

推荐配置如下：

| 配置项       | 推荐选择                                                     |
| ------------ | ------------------------------------------------------------ |
| **地域**     | 根据实际需要选择，国内地域延迟更低                           |
| **镜像**     | 系统镜像 → Ubuntu 24.04 LTS                                 |
| **套餐**     | 建议至少 2核4G 及以上，`OpenClaw` 运行时需要一定的内存空间  |
| **购买时长** | 按需选择                                                     |

### 2.2 安全组配置

购买完成后，进入服务器管理控制台，在「防火墙」中确认以下端口已放行：

| 端口  | 用途                        |
| ----- | --------------------------- |
| 22    | SSH 远程连接                |
| 18789 | OpenClaw 控制台（可选放行） |

> **提示**：`OpenClaw`控制台默认绑定`127.0.0.1`，不会直接对外暴露。本文推荐使用 SSH 端口转发的方式在本机访问，无需在防火墙中放行`18789`端口，更加安全。

### 2.3 连接服务器

通过 SSH 连接到你的轻量云服务器：

```bash
ssh root@[你的轻量云服务器IP]
```

## 3 安装依赖

`OpenClaw` 要求 Node.js 版本 >= 22，我们使用 `nvm`（Node Version Manager）来安装和管理 Node.js 版本。

### 3.1 安装 nvm

- **安装命令**

```bash
# 下载并安装 nvm
root@RUAN:~ curl -so- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
=> nvm is already installed in /root/.nvm, trying to update using git
=> => Compressing and cleaning up git repository

=> nvm source string already in /root/.bashrc
=> bash_completion source string already in /root/.bashrc
=> Close and reopen your terminal to start using nvm or run the following to use it now:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

# 使配置生效
root@RUAN:~ . ~/.bashrc 
```

### 3.2 安装 Node.js

- **安装命令**

```bash
# 安装 Node.js（要求 >= 22）
root@RUAN:~ nvm install 25
Downloading and installing node v25.6.1...
Downloading https://nodejs.org/dist/v25.6.1/node-v25.6.1-linux-x64.tar.xz...
Computing checksum with sha256sum
Checksums matched!
Now using node v25.6.1 (npm v11.9.0)

# 验证安装
root@RUAN:~ node -v
v25.6.1
root@RUAN:~ npm -v
11.9.0
```

- **命令截图**

![Clipboard_Screenshot_1771914954.png](https://developer.qcloudimg.com/http-save/yehe-1371944/775738a8e7e3c4c3edef0df6951b1fff.png)

## 4 一键安装OpenClaw

### 4.1 执行一键命令

> 执行该条命令，可以完成安装和配置。在之后的配置引导中，我们只配置大模型，其它配置如渠道、技能等将在后面章节陆续进行配置。

```bash
root@RUAN:~ curl -fsSL https://openclaw.ai/install.sh | bash
```

### 4.2 安装OpenClaw

脚本会自动下载并安装`OpenClaw`及其依赖组件，过程中无需人工干预。

- **命令截图**

![Clipboard_Screenshot_1771915080.png](https://developer.qcloudimg.com/http-save/yehe-1371944/73dff978a0491b42cdeb0c1fabb50e40.png)

### 4.3 配置OpenClaw

> 安装完成后，会直接进入配置引导步骤，按提示逐步操作即可。

#### （1）接受风险

> `OpenClaw` 非常强大，可以直接接管你的服务器（包括执行终端命令、读写文件、安装软件等），使用前需要明确接受这一风险。

![Clipboard_Screenshot_1771915150.png](https://developer.qcloudimg.com/http-save/yehe-1371944/1ca16fc34f16e6b52afa110768682873.png)

#### （2）选择引导方式

有以下两种引导方式，我们选择 `QuickStart` 方式：

| 引导方式       | 说明                                                         | 适用人群     |
| -------------- | ------------------------------------------------------------ | ------------ |
| **QuickStart** | 快速开始，先完成基础启动，后续用 `openclaw configure` 命令再详细配置 | 新手推荐     |
| **Manual**     | 手动配置，一步一步自己设置所有参数                           | 有经验的用户 |

![Clipboard_Screenshot_1771915190.png](https://developer.qcloudimg.com/http-save/yehe-1371944/bae3d826befae24042bbde3e3401f0a9.png)

> **提示**：如果第一次配置没选好，也不用紧张，后面可以随时重新配置：
>
> - 命令行方式：`openclaw configure`
> - 手动修改配置文件：`~/.openclaw/openclaw.json`（修改后需重启守护进程）

#### （3）选择模型

模型是 `OpenClaw` 的"大脑"，选择合适的模型非常重要。当前版本提供了多种模型供选择，这里选择推荐的 `MiniMax`：

![Clipboard_Screenshot_1771915228.png](https://developer.qcloudimg.com/http-save/yehe-1371944/c9d008217014fa03f3546475f0de6dc6.png)

> **说明**：选择模型后，需要填入对应的 API Key。如果还没有，请先前往所选模型的官网注册并获取 API Key。

#### （4）选择通道

> 这里先跳过，后续在「第5章 渠道接入」中会详细配置。

![Clipboard_Screenshot_1771915263.png](https://developer.qcloudimg.com/http-save/yehe-1371944/23871c5a4e759fa6dca06b816f920de6.png)

#### （5）选择技能

> 这里先跳过，后续在「第6章 技能安装」中会详细配置。

![Clipboard_Screenshot_1771915294.png](https://developer.qcloudimg.com/http-save/yehe-1371944/7df2a84d039c279be7c5d5f403c5893a.png)

#### （6）选择 Hooks

> Hooks 是`OpenClaw`的消息钩子机制，可以在消息收发的各个环节插入自定义处理逻辑。这里也先跳过，后续按需配置即可。

![Clipboard_Screenshot_1771915338.png](https://developer.qcloudimg.com/http-save/yehe-1371944/285876417f702cefe6cba5ac59927ee0.png)

#### （7）等待完成

当前版本（`2026.2.22-2`）后续步骤会自动完成，不用再做任何交互。

**请记录**输出中带`token`的URL，后面登录`OpenClaw`控制台需要：

![Clipboard_Screenshot_1771915370.png](https://developer.qcloudimg.com/http-save/yehe-1371944/5a1e207e7d7544f75ba7c4b237ebcbaf.png)

等待安装结束，直到终端输出：

```
Onboarding complete. Use the dashboard link above to control OpenClaw.
```

### 4.4 故障解决

#### （1）网关异常

虽然`OpenClaw`的引导安装已结束，但此时网关可能存在异常，无法正常使用：

![Clipboard_Screenshot_1771915434.png](https://developer.qcloudimg.com/http-save/yehe-1371944/95c7814649beb702f9c3198d52538964.png)

#### （2）解决方式

手工执行一次安装网关的命令即可解决，安装完成后再次查看网关状态是否正常：

```bash
# 手动安装网关
root@RUAN:~ openclaw gateway install

# 验证网关状态
root@RUAN:~ openclaw gateway status
```

![Clipboard_Screenshot_1771915467.png](https://developer.qcloudimg.com/http-save/yehe-1371944/f1c261e3bf4fa67ad77ccc0318051be6.png)

### 4.5 端口映射

因我们是在轻量云上部署的`OpenClaw`服务，出于安全考虑，控制台默认绑定在本地回环地址（`127.0.0.1`），无法直接从外部访问。为了能在本机浏览器远程访问控制台，需要通过 SSH 隧道做端口转发。

- **执行命令**（在你的**本地电脑**终端执行）

```bash
ssh -N -L 18789:127.0.0.1:18789 root@[你的轻量云服务器IP]
```

| 参数                         | 说明                                         |
| ---------------------------- | -------------------------------------------- |
| `-N`                         | 不执行远程命令，仅做端口转发                 |
| `-L 18789:127.0.0.1:18789`  | 将本机 18789 端口转发到服务器的 127.0.0.1:18789 |
| `root@[IP]`                  | 你的轻量云服务器地址                         |

- **命令截图**

![Clipboard_Screenshot_1771915576.png](https://developer.qcloudimg.com/http-save/yehe-1371944/7352defbb7f76ee661a79ca8f25d8649.png)

> **注意**：请不要关闭该终端窗口，关闭后端口转发即失效。如果需要持久化，可以考虑使用 `autossh` 工具。

### 4.6 登录控制台

端口映射配置完成后，在本地浏览器中打开前面记录的带`token`的URL（形如 `http://127.0.0.1:18789/?token=xxx`），即可登录`OpenClaw`控制台。

在对话窗口随便输入一些内容，如果`OpenClaw`能正常响应，说明大模型配置已经成功：

![Clipboard_Screenshot_1771915524.png](https://developer.qcloudimg.com/http-save/yehe-1371944/5bd1602ace25fabd818cbb09c26310b1.png)

## 5 渠道接入

### 5.1 渠道（Channel）是什么？

渠道是你与 `OpenClaw` **交互的"入口"**。你可以通过不同的渠道给 `OpenClaw` 发消息、接收回复，就像给它装上了不同的"沟通方式"。

以下是当前版本（`2026.2.22-2`）官方内置提供的渠道，如果不在里面，可以通过安装插件的形式进行添加：

![Clipboard_Screenshot_1771915599.png](https://developer.qcloudimg.com/http-save/yehe-1371944/ecfcd42f38f41c6f88299eab5e3750eb.png)

### 5.2 QQ 接入

> 接下来将以安装插件的形式，将`QQ`接入`OpenClaw`进行演示。

#### （1）创建 QQ 机器人

- **注册QQ开放平台**

> QQ开放平台：https://q.qq.com/

前往QQ开放平台完成开发者注册（需实名认证），注册成功后进入管理中心：

![Clipboard_Screenshot_1771915633.png](https://developer.qcloudimg.com/http-save/yehe-1371944/61be3527af4218397f7dc0e4b3611bf3.png)

- **创建QQ机器人**

在管理中心创建一个新的机器人应用，创建完成后，在QQ机器人管理页面获取当前机器人的`AppID`和`AppSecret`：

> ⚠️ **安全提示**：`AppID`和`AppSecret`是机器人的核心凭证，请妥善保管，切勿泄露到公开仓库或分享给他人。

![Clipboard_Screenshot_1771915677.png](https://developer.qcloudimg.com/http-save/yehe-1371944/c40dbb44d1e18b9f1834aaaf5ff348ec.png)

- **沙箱配置**

在QQ机器人的「开发管理」页面，找到「沙箱配置」，设置单独聊天（选择"在消息列表配置"）。沙箱模式允许你在正式发布前，在指定的测试QQ号中进行功能验证：

![Clipboard_Screenshot_1771915760.png](https://developer.qcloudimg.com/http-save/yehe-1371944/5024a01e1ec3ba7de00a7160aedeb2d1.png)

#### （2）OpenClaw 接入 QQ

- **安装QQBot插件**

回到轻量云服务器终端，安装QQBot插件：

```bash
# 方式一：通过 OpenClaw plugins 命令安装（推荐）
openclaw plugins install @sliverp/qqbot@latest

# 方式二：使用源码安装
git clone https://github.com/sliverp/qqbot.git && cd qqbot
openclaw plugins install .
```

- **添加QQBot渠道**

将前面获取的`AppID`和`AppSecret`配置到`OpenClaw`中：

```bash
export APP_ID=你的AppID
export APP_SECRET=你的AppSecret
openclaw channels add --channel qqbot --token "${APP_ID}:${APP_SECRET}"
# 终端输出：Added QQ Bot account "default".
```

> 也可以直接修改配置文件 `~/.openclaw/openclaw.json`，手动添加以下配置：
>
> ```json
> {
>   "channels": {
>     "qqbot": {
>       "enabled": true,
>       "appId": "你的AppID",
>       "clientSecret": "你的AppSecret"
>     }
>   }
> }
> ```

- **重启 Gateway**

配置修改后，需要重启`Gateway`使配置生效：

```bash
# 重启网关
openclaw gateway restart

# 确认网关状态正常
openclaw gateway status
```

#### （3）功能测试

在QQ中找到你创建的机器人，发送一条消息进行测试。如果机器人能正常回复，说明QQ渠道接入成功：

![Clipboard_Screenshot_1771915782.png](https://developer.qcloudimg.com/http-save/yehe-1371944/ca932cf6b4349e094122bdd44b342c17.png)

## 6 技能安装

### 6.1 技能（Skill）是什么？

技能是 `OpenClaw` 的**"能力插件"**，让它从一个只会聊天的机器人，变成一个能干实事的智能助手。每个技能本质上就是一个文件夹，核心是一个 `SKILL.md` 文件，AI 通过阅读它来理解这个技能是干什么的、什么时候该用它。

目前 `ClawHub`（技能市场）上已有 **1w+** 技能，每天都在快速增长中，覆盖办公自动化、开发工具、智能家居、社交媒体等各种场景：

![Clipboard_Screenshot_1771915820.png](https://developer.qcloudimg.com/http-save/yehe-1371944/9df6d55a286df05932bb2da46f6ed85b.png)

### 6.2 技能安装方式

#### 方式一：命令行方式

```bash
# 安装 ClawHub CLI（仅需执行1次）
npm i -g clawhub

# 搜索技能
clawhub search [关键词]

# 安装技能（支持单个或批量安装）
clawhub install [Skill slug]
clawhub install [Skill slug] --version <version>
clawhub install [Skill slug1] [Skill slug2] [Skill slug3]

# 升级技能
clawhub update [Skill slug]
clawhub update --all

# 卸载技能
clawhub uninstall [Skill slug]
```

#### 方式二：提示词方式

最简单的方式！直接在 `OpenClaw` 对话窗口中说：`帮我查找XXX技能` 或 `帮我安装XXX技能`，它会自行运行指令搞定，全程不用碰终端。这得益于 `clawhub CLI` 安装时，会默认安装一个管理技能的内置技能：

![Clipboard_Screenshot_1771915855.png](https://developer.qcloudimg.com/http-save/yehe-1371944/05f20b094a78accd0710d4fa03d1e29e.png)

### 6.3 技能安装演示

#### （1）命令行安装技能

以安装 `nano-pdf`（PDF处理技能）为例：

```bash
# 安装技能
root@RUAN:~ clawhub install nano-pdf
✔ OK. Installed nano-pdf -> /root/.openclaw/workspace/skills/nano-pdf

# 查看已安装技能
root@RUAN:~ clawhub list
nano-pdf  1.0.0
```

#### （2）提示词安装技能

- **查找技能**

直接在对话窗口告诉`OpenClaw`你想要什么能力，它会帮你搜索匹配的技能：

![Clipboard_Screenshot_1771915964.png](https://developer.qcloudimg.com/http-save/yehe-1371944/1c395d42798e40e9354381decb362639.png)

- **安装技能**

选定技能后，让`OpenClaw`帮你安装即可：

![Clipboard_Screenshot_1771915920.png](https://developer.qcloudimg.com/http-save/yehe-1371944/b82f9e7552938641e218a10eaaf13502.png)

## 7 常用运维命令

搭建完成后，日常运维中以下命令会经常用到：

```bash
# 查看 OpenClaw 运行状态
openclaw status

# 查看网关状态
openclaw gateway status

# 重启网关（修改渠道配置后需要执行）
openclaw gateway restart

# 重新进入配置引导
openclaw configure

# 查看已安装的插件
openclaw plugins list

# 查看已安装的技能
clawhub list

# 查看日志（排查问题时使用）
openclaw logs
```

## 8 总结

本文从零开始，完整走通了 `OpenClaw` 在腾讯云轻量云服务器上的手工部署全流程，涵盖以下核心环节：

1. **服务器购买**：选购腾讯云轻量应用服务器，完成基础环境准备
2. **依赖安装**：通过 `nvm` 安装 Node.js >= 22，满足 `OpenClaw` 运行要求
3. **一键安装与配置**：使用官方安装脚本快速完成安装，通过 `QuickStart` 引导完成模型选择、`Gateway` 安装等基础配置，并解决了网关异常等常见问题
4. **渠道接入**：以 `QQ` 为例，演示了从创建QQ机器人、安装插件到完成接入的完整流程，让 `OpenClaw` 拥有真正可用的交互入口
5. **技能安装**：通过命令行和提示词两种方式演示技能安装，展示了 `OpenClaw` 强大的生态扩展能力

`OpenClaw` 的核心价值在于：它不只是一个聊天机器人，而是一个能**真正动手干活的 AI Agent**。通过渠道实现随时随地沟通，通过技能不断扩展能力边界，通过记忆文件持续进化——部署只是起点，持续调教和使用才是让它真正变成你"数字管家"的关键。


OpenClaw 是一个能真正动手干活的开源 AI Agent——不仅能聊天，还能执行终端命令、读写文件、调用各种服务。要让它 7×24 小时在线，你需要一台稳定的云服务器。

腾讯云 × OpenClaw：手把手搭建你“能干活”的AI Agent

在腾讯云轻量应用服务器上从零手动搭建 OpenClaw，折腾明白每一步。

后台开发工程师

数据库

腾讯云轻量应用服务器+OpenClaw搭建AI助手教程，从零开始部署可执行终端命令、读写文件的智能Agent。详细讲解Ubuntu环境配置、Node.js安装、OpenClaw部署及QQ机器人接入流程，教你打造7×24小时在线的AI生产力工具。

轻量应用服务器

聊天机器人

云服务器

服务器

防火墙

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

lighthouse

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

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

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

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

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

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

社区新版编辑器体验调研

腾讯云 × OpenClaw：手把手搭建你“能干活”的AI Agent-腾讯云开发者社区-腾讯云

腾讯云 × OpenClaw：手把手搭建你“能干活”的AI Agent

腾讯云 × OpenClaw：手把手搭建你“能干活”的AI Agent

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐