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

  • rzexin
  • 发布于 13小时前
  • 阅读 122

腾讯云×OpenClaw:手把手搭建你“能干活”的AIAgentrzexin2026.02.241前言OpenClaw是一个能真正动手干活的开源AIAgent——不仅能聊天,还能执行终端命令、读写文件、调用各种服务。要让它7×24小时在线,你需要一台稳定的云服务器。为什么

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

rzexin 2026.02.24

1 前言

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

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

关于在轻量云上开箱即用 OpenClaw,已经有不少文章了(《🔥🔥🔥玩转OpenClaw|云上OpenClaw(Clawdbot)最全实践教程合辑》)。一键镜像虽然方便,但对开发人员而言可能缺少了折腾的乐趣。 因此,本文选择另一条路:从一台干净的轻量云服务器开始,手动完成整个 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 连接到你的轻量云服务器:

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

3 安装依赖

OpenClaw 要求 Node.js 版本 >= 22,我们使用 nvm(Node Version Manager)来安装和管理 Node.js 版本。

3.1 安装 nvm

  • 安装命令
# 下载并安装 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

  • 安装命令
# 安装 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_1771915048.png

4 一键安装OpenClaw

4.1 执行一键命令

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

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

4.2 安装OpenClaw

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

  • 命令截图

Clipboard_Screenshot_1771915080.png

4.3 配置OpenClaw

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

(1)接受风险

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

Clipboard_Screenshot_1771915150.png

(2)选择引导方式

有以下两种引导方式,我们选择 QuickStart 方式:

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

Clipboard_Screenshot_1771915190.png

提示:如果第一次配置没选好,也不用紧张,后面可以随时重新配置:

  • 命令行方式:openclaw configure
  • 手动修改配置文件:~/.openclaw/openclaw.json(修改后需重启守护进程)

(3)选择模型

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

Clipboard_Screenshot_1771915228.png

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

(4)选择通道

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

Clipboard_Screenshot_1771915263.png

(5)选择技能

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

Clipboard_Screenshot_1771915294.png

(6)选择 Hooks

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

Clipboard_Screenshot_1771915338.png

(7)等待完成

当前版本(2026.2.22-2)后续步骤会自动完成,不用再做任何交互。

请记录输出中带token的URL,后面登录OpenClaw控制台需要:

Clipboard_Screenshot_1771915411.png

等待安装结束,直到终端输出:

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

4.4 故障解决

(1)网关异常

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

Clipboard_Screenshot_1771915434.png

(2)解决方式

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

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

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

Clipboard_Screenshot_1771915467.png

4.5 端口映射

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

  • 执行命令(在你的本地电脑终端执行)
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_1771915493.png

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

4.6 登录控制台

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

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

Clipboard_Screenshot_1771915524.png

5 渠道接入

5.1 渠道(Channel)是什么?

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

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

Clipboard_Screenshot_1771915599.png

5.2 QQ 接入

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

(1)创建 QQ 机器人

  • 注册QQ开放平台

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

前往QQ开放平台完成开发者注册(需实名认证),注册成功后进入管理中心:

Clipboard_Screenshot_1771915633.png

  • 创建QQ机器人

在管理中心创建一个新的机器人应用,创建完成后,在QQ机器人管理页面获取当前机器人的AppIDAppSecret

⚠️ 安全提示AppIDAppSecret是机器人的核心凭证,请妥善保管,切勿泄露到公开仓库或分享给他人。

Clipboard_Screenshot_1771915677.png

  • 沙箱配置

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

Clipboard_Screenshot_1771915707.png

(2)OpenClaw 接入 QQ

  • 安装QQBot插件

回到轻量云服务器终端,安装QQBot插件:

# 方式一:通过 OpenClaw plugins 命令安装(推荐)
openclaw plugins install @sliverp/qqbot@latest

# 方式二:使用源码安装
git clone https://github.com/sliverp/qqbot.git && cd qqbot
openclaw plugins install .
  • 添加QQBot渠道

将前面获取的AppIDAppSecret配置到OpenClaw中:

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,手动添加以下配置:

{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "你的AppID",
      "clientSecret": "你的AppSecret"
    }
  }
}
  • 重启 Gateway

配置修改后,需要重启Gateway使配置生效:

# 重启网关
openclaw gateway restart

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

(3)功能测试

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

Clipboard_Screenshot_1771915782.png

6 技能安装

6.1 技能(Skill)是什么?

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

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

Clipboard_Screenshot_1771915820.png

6.2 技能安装方式

方式一:命令行方式

# 安装 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

6.3 技能安装演示

(1)命令行安装技能

以安装 nano-pdf(PDF处理技能)为例:

# 安装技能
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_1771915887.png

  • 安装技能

选定技能后,让OpenClaw帮你安装即可:

Clipboard_Screenshot_1771915920.png

7 常用运维命令

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

# 查看 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。通过渠道实现随时随地沟通,通过技能不断扩展能力边界,通过记忆文件持续进化——部署只是起点,持续调教和使用才是让它真正变成你"数字管家"的关键。

点赞 0
收藏 0
分享
本文参与登链社区写作激励计划 ,好文好收益,欢迎正在阅读的你也加入。

0 条评论

请先 登录 后评论
rzexin
rzexin
0x6Fa5...8165
江湖只有他的大名,没有他的介绍。