
# 腾讯云 TAT 一键安装 LightClaw 完全指南

> **3 分钟，零命令行经验，让你的云服务器秒变 AI 工作站。**

## 前言

LightClaw是一款开源的 AI 智能体平台，支持接入主流大模型（OpenAI、Claude、DeepSeek 等），提供开箱即用的 AI 对话、自动化工作流等能力。

传统部署方式需要 SSH 登录服务器、手动安装依赖、配置环境变量……对新手来说门槛不低。而借助腾讯云 **TAT（自动化助手）**，你只需在控制台点几下鼠标，就能完成全部安装——**全程无需 SSH，无需敲命令**。

### 你需要准备什么？

| 项目 | 要求 |
|------|------|
| 腾讯云账号 | 已实名认证 |
| 云服务器（CVM / Lighthouse） | Ubuntu 20.04+ / Debian 11+ / CentOS 8+ / TencentOS 3+ |
| 安全组 | 放通 **8088** 端口（或你自定义的端口） |
| TAT Agent | 默认已预装，无需额外操作 |

---

## Step 1：进入自动化助手（TAT）控制台

登录 [腾讯云控制台](https://console.cloud.tencent.com/)，在左侧导航栏找到 **自动化助手**，或直接搜索 "TAT" 进入自动化助手页面。

你会看到 TAT 的功能概览，包括「我的命令」「公共命令」「执行记录」等模块。

![Clipboard_Screenshot_1775571219.png](https://developer.qcloudimg.com/http-save/yehe-11441700/9a479f091e30b9ac301ad63a3b346fb3.png)

---

## Step 2：创建自定义命令

点击左侧菜单中的 **「我的命令」**，然后点击 **「创建命令」** 按钮，开始配置安装脚本。

在创建命令页面，你需要填写以下基本信息：

- **命令名称**：填写一个容易识别的名称，例如 `安装LightClaw`
- **命令类型**：选择 **`SHELL`**
- **超时时间**：建议设置为 **600 秒**（安装过程需要下载依赖，预留充足时间）

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

---

## Step 3：填写安装脚本内容


### 可选参数配置

脚本支持通过 TAT 参数注入来自定义安装行为：

| 参数名 | 说明 | 默认值 |
|--------|------|--------|
| `lightclawPort` | 服务端口 | `8088` |
| `lightclawPassword` | 登录密码 | 空（首次访问设置） |
| `lightclawVersion` | 指定版本号 | 最新版 |
| `lightclawSkipWizard` | 跳过设置向导 | `false` |

如果你需要自定义端口或预设密码，可以在 TAT 的「参数设置」中添加对应的参数。

![4.png](https://developer.qcloudimg.com/http-save/yehe-11441700/72b1d4b7d3e4892c3062d1fa0bc6b375.png)

---

## Step 4：选择目标实例并执行

命令创建完成后，点击 **「执行」**。在弹出的执行面板中：

1. **选择目标实例**：勾选你要安装 LightClaw 的云服务器
2. **确认参数**：如果配置了自定义参数（端口、密码等），在此处填写具体值
3. 点击 **「执行命令」**

> 💡 **提示**：确保目标服务器的 TAT Agent 状态为「在线」。腾讯云新购服务器默认已预装 TAT Agent。

![3.png](https://developer.qcloudimg.com/http-save/yehe-11441700/729e0b932eedac55cde5933825b1dbc7.png)

---

## Step 5：查看执行进度

命令执行后，页面会自动跳转到 **「执行详情」** 页面。你可以实时查看：

- **执行状态**：等待中 → 执行中 → 已完成
- **输出日志**：脚本的实时输出，包括每个安装步骤的进度

安装过程大约需要 **1~3 分钟**（取决于网络速度），脚本会依次完成：

1. ✅ 检测操作系统版本
2. ✅ 安装系统依赖（curl、pip）
3. ✅ 安装 uv 包管理器
4. ✅ 安装 Python 3.12
5. ✅ 安装 LightClaw
6. ✅ 初始化配置
7. ✅ 注册并启动 systemd 服务

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

---

## Step 6：确认安装成功

当执行状态变为 **「已完成」** 且输出日志中出现如下信息时，说明安装成功：

```
[INFO] ============================================
[INFO]   LightClaw installation completed!
[INFO]   Version: x.x.x
[INFO]   URL: http://<你的公网IP>:8088
[INFO] ============================================
```

你也可以在日志末尾看到总安装耗时。

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

---

## Step 7：访问 LightClaw 控制台

打开浏览器，输入：

```
http://<你的服务器公网IP>:8088
```

> ⚠️ **注意**：请确保服务器安全组已放通 **8088** 端口（TCP 入站规则）。如果你自定义了端口，请放通对应端口。

首次访问会进入 **设置向导**，引导你完成基础配置。

![0.png](https://developer.qcloudimg.com/http-save/yehe-11441700/d077e989ed35e7a0ba5b1e2953241285.png)

---

## Step 8：完成初始配置

在设置向导中，你需要完成以下配置：

1. **设置登录密码**：为你的 LightClaw 实例设置一个安全密码
2. **配置 LLM 提供商**：填入你的大模型 API Key（支持 OpenAI、Claude、DeepSeek、通义千问等）
3. **确认并保存**

配置完成后，你就可以开始使用 LightClaw 了！🎉

![a.png](https://developer.qcloudimg.com/http-save/yehe-11441700/37bf3c35139f4422f269598d27b407a7.png)

---

## 常用运维命令

安装完成后，如果你需要通过 SSH 管理服务，以下命令会很有用：

```bash
# 查看服务状态
systemctl status lightclaw

# 重启服务
systemctl restart lightclaw

# 查看实时日志
journalctl -u lightclaw -f

# 查看 LightClaw 版本
~/.lightclaw/bin/lightclaw version

# 修改登录密码
~/.lightclaw/bin/lightclaw passwd
```

---

## 常见问题

### Q：安装失败，提示 glibc 版本过低？

LightClaw 要求 glibc ≥ 2.28。CentOS 7（glibc 2.17）不受支持，请升级到 CentOS 8+ 或使用 Ubuntu 20.04+。

### Q：浏览器无法访问 8088 端口？

请检查腾讯云安全组规则，确保已添加 **TCP 入站规则**，端口为 `8088`（或你自定义的端口），来源设为 `0.0.0.0/0`。

### Q：如何升级 LightClaw？

通过 TAT 再次执行安装脚本即可，脚本会检测已有安装并进行升级。或者 SSH 登录后执行：

```bash
~/.lightclaw/venv/bin/pip install --upgrade lightclaw \
  -i https://mirrors.cloud.tencent.com/pypi/simple
systemctl restart lightclaw
```

### Q：如何卸载？

```bash
systemctl stop lightclaw
systemctl disable lightclaw
rm -rf ~/.lightclaw /etc/systemd/system/lightclaw.service
systemctl daemon-reload
```

---

## 总结

通过腾讯云 TAT 自动化助手，我们实现了 **零 SSH、零命令行** 的 LightClaw 一键部署。整个过程只需要：

1. 在 TAT 控制台创建命令
2. 粘贴安装脚本
3. 选择服务器执行
4. 等待 1~3 分钟
5. 浏览器访问即可使用

这种方式特别适合不熟悉 Linux 命令行的用户，也适合需要批量部署的场景——TAT 支持同时对多台服务器执行命令，一次操作即可完成整个集群的部署。

> 📖 **参考资料**：[腾讯云 TAT 自动化助手官方文档](https://cloud.tencent.com/document/product/1340) | [LightClaw 项目主页](https://cloud.tencent.com/developer/article/2649706)

LightClaw是一款开源的 AI 智能体平台，支持接入主流大模型（OpenAI、Claude、DeepSeek 等），提供开箱即用的 AI 对话、自动化工作流等能力。

腾讯云 TAT 一键安装 LightClaw 完全指南——已有云服务器一键安装

腾讯云 TAT 一键安装 LightClaw 完全指南， 3分钟，零命令行经验，让你的云服务器秒变 AI 工作站！

云计算

人工智能

运维

腾讯云TAT一键安装LightClaw教程，3分钟零命令行部署AI工作站。支持OpenAI、Claude等主流大模型，提供自动化工作流功能。只需在腾讯云控制台操作，无需SSH登录，适合新手快速搭建AI平台。包含安装步骤、常见问题及运维命令，助你轻松完成部署。

自动化助手

云服务器

包管理器

云安全

服务器

CentOS

Python

Ubuntu

Debian

Linux

Agent

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

2026采购季 | AI焕新·智启新局

lighthouse

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯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编辑器全新改版上线，欢迎大家体验!

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

社区新版编辑器体验调研

腾讯云 TAT 一键安装 LightClaw 完全指南——已有云服务器一键安装-腾讯云开发者社区-腾讯云

腾讯云 TAT 一键安装 LightClaw 完全指南——已有云服务器一键安装

腾讯云 TAT 一键安装 LightClaw 完全指南——已有云服务器一键安装

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐