跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsWeChatAI

OpenClaw AI Agent 部署指南：基于腾讯云轻量应用服务器搭建

在腾讯云轻量应用服务器上部署 OpenClaw AI Agent 的完整流程。包括购买服务器、安装 Node.js 环境、使用脚本一键安装 OpenClaw、配置网关与模型、通过 SSH 隧道访问控制台，以及接入 QQ 渠道和安装技能。最后提供了常用运维命令，帮助用户实现 7×24 小时在线的自动化智能助手。

霸天发布于 2026/4/6更新于 2026/10/25129 浏览
OpenClaw AI Agent 部署指南：基于腾讯云轻量应用服务器搭建

前言

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

本文环境信息：

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

购买轻量应用服务器

选购服务器

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

推荐配置如下：

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

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

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

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

连接服务器

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

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

安装依赖

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

安装 nvm
  • 安装命令
# 下载并安装 nvm
curl -so- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# 使配置生效
. ~/.bashrc
安装 Node.js
  • 安装命令
# 安装 Node.js（要求 >= 22）
nvm install 25

# 验证安装
node -v
npm -v

一键安装 OpenClaw

执行一键命令

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

curl -fsSL https://openclaw.ai/install.sh | bash
安装 OpenClaw

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

配置 OpenClaw

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

接受风险

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

选择引导方式

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

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

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

选择模型

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

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

选择通道

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

选择技能

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

选择 Hooks

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

等待完成

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

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

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

Onboarding complete. Use the dashboard link above to control OpenClaw.
故障解决
网关异常

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

解决方式

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

# 手动安装网关
openclaw gateway install

# 验证网关状态
openclaw gateway status
端口映射

因我们是在轻量云上部署的 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]你的轻量云服务器地址

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

登录控制台

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

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

渠道接入

渠道（Channel）是什么？

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

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

QQ 接入

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

创建 QQ 机器人
  • 注册 QQ 开放平台

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

  • 创建 QQ 机器人

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

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

  • 沙箱配置

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

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 渠道

将前面获取的 AppID 和 AppSecret 配置到 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": [
    {
      "name": "qqbot",
      "token": "your_app_id:your_app_secret"
    }
  ]
}
  • 重启 Gateway

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

# 重启网关
openclaw gateway restart

# 确认网关状态正常
openclaw gateway status
功能测试

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

技能安装

技能（Skill）是什么？

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

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

技能安装方式
方式一：命令行方式
# 安装 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 安装时，会默认安装一个管理技能的内置技能：

技能安装演示
命令行安装技能

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

# 安装技能
clawhub install nano-pdf
✔ OK. Installed nano-pdf -> /root/.openclaw/workspace/skills/nano-pdf

# 查看已安装技能
clawhub list
nano-pdf 1.0.0
提示词安装技能
  • 查找技能

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

  • 安装技能

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

常用运维命令

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

# 查看 OpenClaw 运行状态
openclaw status

# 查看网关状态
openclaw gateway status

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

# 重新进入配置引导
openclaw configure

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

# 查看已安装的技能
clawhub list

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

总结

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

  1. 服务器购买：选购腾讯云轻量应用服务器，完成基础环境准备
  2. 依赖安装：通过 nvm 安装 Node.js >= 22，满足 OpenClaw 运行要求
  3. 一键安装与配置：使用官方安装脚本快速完成安装，通过 QuickStart 引导完成模型选择、Gateway 安装等基础配置，并解决了网关异常等常见问题

目录

  1. 前言
  2. 购买轻量应用服务器
  3. 选购服务器
  4. 安全组配置
  5. 连接服务器
  6. 安装依赖
  7. 安装 nvm
  8. 下载并安装 nvm
  9. 使配置生效
  10. 安装 Node.js
  11. 安装 Node.js（要求 >= 22）
  12. 验证安装
  13. 一键安装 OpenClaw
  14. 执行一键命令
  15. 安装 OpenClaw
  16. 配置 OpenClaw
  17. 接受风险
  18. 选择引导方式
  19. 选择模型
  20. 选择通道
  21. 选择技能
  22. 选择 Hooks
  23. 等待完成
  24. 故障解决
  25. 网关异常
  26. 解决方式
  27. 手动安装网关
  28. 验证网关状态
  29. 端口映射
  30. 登录控制台
  31. 渠道接入
  32. 渠道（Channel）是什么？
  33. QQ 接入
  34. 创建 QQ 机器人
  35. OpenClaw 接入 QQ
  36. 方式一：通过 OpenClaw plugins 命令安装（推荐）
  37. 方式二：使用源码安装
  38. 终端输出：Added QQ Bot account "default".
  39. 重启网关
  40. 确认网关状态正常
  41. 功能测试
  42. 技能安装
  43. 技能（Skill）是什么？
  44. 技能安装方式
  45. 方式一：命令行方式
  46. 安装 ClawHub CLI（仅需执行 1 次）
  47. 搜索技能
  48. 安装技能（支持单个或批量安装）
  49. 升级技能
  50. 卸载技能
  51. 方式二：提示词方式
  52. 技能安装演示
  53. 命令行安装技能
  54. 安装技能
  55. 查看已安装技能
  56. 提示词安装技能
  57. 常用运维命令
  58. 查看 OpenClaw 运行状态
  59. 查看网关状态
  60. 重启网关（修改渠道配置后需要执行）
  61. 重新进入配置引导
  62. 查看已安装的插件
  63. 查看已安装的技能
  64. 查看日志（排查问题时使用）
  65. 总结

更多推荐文章

查看全部
  • LangGraph：构建具有状态与循环的 AI Agent
  • 基于 FastGPT 与 MCP 协议构建工具增强型 AI Agent
  • Web 开发者多模态 Agent 图像识别实战：JS+Python 全栈方案
  • WebCode 与 Clawdbot：AI 助手框架的技术架构深度对比
  • 大厂 Android 开发面试真题与核心知识点汇总
  • C++ ODB ORM 实战指南：从环境搭建到数据库映射
  • 私有化部署清华 ChatGLM2-6B 大模型实践指南
  • 前端拖拽交互实战：告别原生 API 的卡顿体验
  • FuseLLM：基于知识融合的大模型集成方法
  • 医疗 AI 可信系统全栈实现：向量索引与贝叶斯网络
  • ROS 2 实战：海龟仿真器与 ros2 run 命令详解
  • 开源 AI 编码代理 OpenCode 本地部署指南
  • AI 模型调优实战：网格搜索与最佳实践
  • 6 位百万美元白帽黑客：利用漏洞赏金实现财务自由
  • 开源 RAG 引擎 RAGFlow 部署与实战指南
  • ComfyUI 提示词助手实战：构建自动化流程提升 AI 绘画效率
  • AIGC 自动化编程实战：Python、Java、JS 与 VBA
  • 精准努力：被蝙蝠咬死的野马死于愤怒
  • XRoboToolkit：基于 PICO 4 Ultra 的机器人遥操作方案（一）
  • OpenClaw iOS/Android 端部署教程：语音唤醒与随身 AI 助手

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online