

 这篇文章围绕【QClaw + 腾讯云智能体开发平台 ADP】组合链路：
 - **QClaw** 作为 零门槛、本地优先的执行端；
- **ADP / ADP Claw** 作为 企业级、多智能体、可运维 的控制平面；
-  腾讯云 **可观测平台（TCOP）+ 日志服务（CLS）+ Agent Memory** 等能力，构建 **可管、可控、可观测** 的全栈智能体工作流。

# 一、背景

OpenClaw 是一款本地优先、完全开源的 AI 智能体框架，定位是 可执行真实任务的个人 / 企业 AI 助手：

- 部署在个人电脑或云服务器；
- 有系统级权限，可操作文件、浏览器、邮件等工具；
- 通过 Skills 机制扩展能力，ClawHub / GitHub 有 5000+ Skill，涵盖搜索、代码、Office、RPA 等多类场景；
- 支持多通道接入：微信、企业微信、QQ、飞书、钉钉、Telegram、Discord 等 IM。

催生出的【养虾】生态：个人玩本地虾，企业玩云上虾，各大云厂商推出一键部署、监控、记忆、安全套件，腾讯云的 龙虾矩阵 最完整。

QClaw 是腾讯电脑管家团队基于 OpenClaw 打造的本地 AI 助手，面向个人与职场用户，特征：

- **零门槛部署**：Windows / macOS 双平台，一键安装；
- **微信 / QQ 整合**：扫码绑定后，微信对话框直接下达自然语言指令远程操控电脑；
- 集成 Kimi、DeepSeek、GLM 等主流模型，支持自定义模型；
- 直接继承 OpenClaw 的 Skill 市场，涵盖文件处理、日程管理、代码工具、浏览器自动化等高频能力；
- 数据在本地机器处理，适合对隐私敏感的办公场景。

**QClaw = 面向中国用户优化的「桌面版 OpenClaw 发行版」+ 微信 / QQ 直连能力**。

腾讯云智能体开发平台 ADP（Agent Development Platform）是一个面向企业的智能体构建和运行平台：

- 提供 **LLM + RAG + Workflow + Multi-Agent** 等主流智能体架构；
- 支持企业级知识库、工作流编排、多智能体协同、应用发布和全生命周期运维；
- 提供 API / SDK 和低代码编辑器，支持多渠道触达（企业微信、QQ、飞书、钉钉、Web、小程序等）。

龙虾生态方面，腾讯云推出 **ADP Claw（企业级 OpenClaw 解决方案）**：

- 一键在腾讯云轻量应用服务器 / 云桌面上部署 OpenClaw；
- 支持企业微信、微信客服 一键扫码 快速接入；

亮点是**五大安全防火墙**：
1. 模型调用和执行安全；
2. 对话输入 / 输出安全；
3. Skill / 工具调用安全；
4. 数据安全和资产保护；
5. Agent 执行环境隔离。

再叠加 **ADP Agent Portal**，可以把散落在不同平台的智能体统一纳管、统一路由。

# 二、总体方案设计

跟一般的 装一个龙虾玩玩 不同，企业级落地要同时解决三类问题：

1. 不用折腾环境和命令行，只要 会用微信 / 企业微信。常见办公场景（报表、文档、群发通知、会议纪要）开箱可用。
2. 谁能用哪些智能体？能调用哪些模型？能访问什么数据？Token 花了多少？性能如何？有无异常调用和越权访问？
3. 出了问题能追踪到 是哪一条链路、哪个 Agent、哪次调用；能在统一看板看到使用量、成本、安全告警等指标。

**QClaw + ADP** 组合：
- **QClaw**：个人电脑执行，贴近真实业务场景（文件、脚本、本地应用）。
- **ADP / ADP Claw**：作为企业 控制平面，统一管理模型、权限、工作流和安全策略。
- **TCOP + CLS + Agent Memory**：提供监控和长期记忆。

适合的人群：

- 不要求会深度后端 / DevOps，只要有基础脚本经验即可跟做；
- 用腾讯云官方提供的 一键部署、模板工作流、预置 Skill，减少自研成本；
- 优先用国内可稳定访问的大模型（Kimi、DeepSeek、GLM 等），必要时接入国际模型。

# 三、架构

QClaw + ADP Claw + TCOP逻辑架构图：
![image.png](https://developer.qcloudimg.com/http-save/yehe-11218869/046c6e7df1b5a2a8f844550f20284548.png)


1. **终端层：** 访问入口，包含本地和云端两种部署方式。
2. **控制层：** 核心控制平面，通过ADP进行应用创建（ADP Claw 模板）、工作空间配置（知识库、工作流、多 Agent）和渠道管理（企业微信、QQ、微信）。
3. **观测和安全层：** 可观测性、日志服务和长期记忆能力。

**本地能力交给 QClaw**：任何涉及文件操作、桌面自动化、本机 Office 的场景，优先让 QClaw 负责；

**跨系统流程交给 ADP Workflow**：拉通多个系统（企微、CRM、数据库、邮件）的场景，由 ADP 的 Workflow 串联多个 Agent / Skill。

**治理和审计全部落在云上**：调用模型、访问知识库、调用高权限工具等操作，统一通过 ADP / TCOP 进行审计和告警。


# 四、部署流程

 **从零环境** 一路搭到：
- 本地可用的 QClaw + OpenClaw 实例；
- 云端托管的 OpenClaw（Lighthouse）；
- ADP 中的 企业龙虾应用；
- 接入 IM 渠道；
- 打通腾讯云可观测平台（TCOP）+ 日志服务（CLS），做到 能跑、可控、可观测。

整体【养虾】流程图：
![image.png](https://developer.qcloudimg.com/http-save/yehe-11218869/892e72fb770c4da0b647d0f847458364.png)


## 4.1、环境准备

（1）操作系统：
- Windows 10 / 11（64 位）；
- macOS 12+；
- Linux / WSL2（用来部署 OpenClaw、接 TCOP/CLS）。

（2）基础硬件：2 核 CPU / 4GB 内存以上（云端至少 2c4g）。

（3）网络：能稳定访问 `https://openclaw.ai`、`https://cloud.tencent.com`、`https://lke.tencentcloudapi.com` ；

企业环境提前打开 80/443 及 OpenClaw 端口（默认 18789）。

（4）一个腾讯云主账号：用来开通 ADP、Lighthouse、CLS、TCOP 等服务；

（5）创建子账号，给一些：
- **ADP：智能体开发平台相关权限**；
- **Lighthouse：轻量应用服务器操作权限**；
- **CLS & TCOP：读写日志与查看监控权限**。

## 4.2、本地安装 QClaw 和 OpenClaw

QClaw 实际已经把 OpenClaw 打包成【一键安装版】。

一键安装 QClaw 客户端：

![og-image.png](https://developer.qcloudimg.com/http-save/yehe-11218869/74822fb0f94a1419d8a3f00ad543260a.png)
>QClaw 官网下载页面（Windows / macOS 版本入口）

步骤：

（1）根据系统选择对应安装包；
![image.png](https://developer.qcloudimg.com/http-save/yehe-11218869/8740b9d89be3755c9ee61efa96ed66f6.png)

（2）下载后双击安装包：
- Windows：一路“下一步”，选择安装路径（建议英文路径）；
- macOS：把图标拖入 `Applications` 即可。

![image](https://developer.qcloudimg.com/http-save/yehe-11218869/ba340d4651c26b392c36a2fc3a4a0b88.png)

QClaw 内置了 OpenClaw 安装流程，可以了解一下纯命令行安装 OpenClaw！

**macOS、Linux、WSL2：**
```bash
# 安装 OpenClaw（自动检测环境并安装 Node 等依赖）
curl -fsSL https://openclaw.ai/install.sh | bash

# 交互式初始化，引导配置默认模型等
openclaw onboard

# 安装并注册 gateway 守护进程
openclaw gateway install
openclaw gateway start

# 验证安装
openclaw --version
openclaw gateway status
```

**Windows（PowerShell）：**
```powershell
# PowerShell（管理员）执行
iwr -useb https://openclaw.ai/install.ps1 | iex

# 初始化和启动
openclaw onboard
openclaw gateway install
openclaw gateway start

# 验证
openclaw --version
openclaw gateway status
```

>上述命令来自 OpenClaw 官方安装文档，脚本会自动安装 Node 24+、配置全局 `openclaw` CLI 等。

QClaw 安装完成后：
1. 打开 QClaw 客户端；
2. QClaw 会自动检测本机是否已经有 OpenClaw，如果没有就选择 **【新建实例】**，QClaw 会在后台调用前面的安装脚本，自动完成 OpenClaw 的安装与配置；
3. 在 QClaw 首页点击【微信登录】，用手机微信扫码登录完成绑定。

![image](https://developer.qcloudimg.com/http-save/yehe-11218869/fc6c4724dc0087ab080ed7eb184346d7.png)

绑定成功后，就可以得到一个：本地优先、微信可直连、自带 OpenClaw 能力的【个人小龙虾】。
![image](https://developer.qcloudimg.com/http-save/yehe-11218869/62c0a8cc258c3785404393dedb2c4498.png)

## 4.3、腾讯云 Lighthouse 一键部署云端 OpenClaw

对于要 7×24 小时在线、多人共用的企业团队，最好在腾讯云 Lighthouse 上 **一键部署 OpenClaw 实例**。

控制台一键部署：

1. 登录腾讯云控制台，进入 **【轻量应用服务器 Lighthouse】**；
2. 点击「创建实例」，在应用镜像搜索 **“OpenClaw”** 专属模板；
3. 选择合适配置；
4. 确认购买，等待实例创建完成。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11218869/32deedc227c9bb9d405eb6b144d688bd.png)

大多数 OpenClaw 模板会在实例创建后自动安装并启动，可以登录实例确认：

```bash
# 1. SSH 登录到 Lighthouse 实例
ssh ubuntu@your-lighthouse-ip

# 2. 检查 openclaw 版本
openclaw --version

# 如未安装：
curl -fsSL https://openclaw.ai/install.sh | bash

# 3. 启动或重启 gateway
openclaw gateway start
openclaw gateway status
```

一定要在安全组放开 18789 端口（或配置指定的 gateway 端口）：
- ADP / QClaw / 其他前端跟这个 OpenClaw 实例进行 HTTP/WebSocket 通信；
- 最好只在 **内网或 VPN 场景** 放开，不要再公网裸露高权限 Agent。



## 4.4、把 QClaw 绑定微信 / 企业微信，实现远程指挥

绑定个人微信（远控 PC）：

1. 打开 QClaw 客户端；
2. 点击首页左下角 **【关联微信】**；
3. 用手机微信 **扫一扫** 扫描屏幕上的二维码，确认授权。

![image](https://developer.qcloudimg.com/http-save/yehe-11218869/0b45eb078bad486f711101c4bfa9dad7.png)

就可以在手机微信的【QClaw 客服号】直接下指令：

![image](https://developer.qcloudimg.com/http-save/yehe-11218869/46c361037bae86c6d97ae1afd59b9656.png)

QClaw 会调用本地 OpenClaw + 文件处理 Skill 自动完成。

![image](https://developer.qcloudimg.com/http-save/yehe-11218869/480ed3549b8631f64b0262cdcb37ebf3.png)


后面的 ADP 渠道接入中，会把 OpenClaw 机器人接入企业微信 / 微信客服，这时 QClaw 可以作为本地执行端、ADP Claw 作为云端编排和治理端，形成完整闭环。


## 4.5、ADP 创建 企业龙虾应用

ADP 智能体开发平台负责企业级的【应用中心】，OpenClaw 只是一种运行时形态。

控制台创建应用:

1. 登录 ADP 控制台：`https://adp.tencentcloud.com`；
2. 选择或创建一个 **工作空间**；
3. 新建应用：
	- 模板类型选择：**OpenClaw / ADP Claw**；
	- 填写应用名称、描述；
	- 选择默认模型。

创建完成后，会在应用列表中看到一个新的【龙虾型】应用，后面再通过这个应用接入 IM 渠道、配置工作流和插件。

![image](https://developer.qcloudimg.com/http-save/yehe-11218869/f15bb95882ec294b63c1674a41bef23a.png)



也可以借助 **tencentcloud-sdk-python** 和 LKE（ADP 底层服务）API 创建应用。

**安装 SDK：** `pip install --upgrade tencentcloud-sdk-python`

**示例：**
```python
# -*- coding: utf-8 -*-
import os
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.lke.v20231130 import lke_client, models

# 最好是通过环境变量注入，避免硬编码密钥
# export TENCENTCLOUD_SECRET_ID=xxx
# export TENCENTCLOUD_SECRET_KEY=yyy

secret_id = os.getenv("TENCENTCLOUD_SECRET_ID")
secret_key = os.getenv("TENCENTCLOUD_SECRET_KEY")

if not secret_id or not secret_key:
    raise RuntimeError("要先在环境变量中设置 TENCENTCLOUD_SECRET_ID / TENCENTCLOUD_SECRET_KEY")

cred = credential.Credential(secret_id, secret_key)

http_profile = HttpProfile()
http_profile.endpoint = "lke.tencentcloudapi.com"

client_profile = ClientProfile(httpProfile=http_profile)
client = lke_client.LkeClient(cred, "ap-guangzhou", client_profile)

# 创建 OpenClaw 类型的应用
req = models.CreateAppRequest()
req.WorkspaceId = "workspace-xxxxxx"   # 替换为 ADP 控制台看到的工作空间 ID
req.AppName = "SalesOpenClawHub"
req.AppType = "OpenClaw"

resp = client.CreateApp(req)
print(resp.to_json_string(indent=2, ensure_ascii=False))
```

运行成功后，会得到一个 JSON，包含 `AppId` 等关键信息，后续在 SDK 或自动化脚本中可继续配置知识库、流程等。

## 4.6、渠道接入

在创建好的 OpenClaw 应用：

1. 进入该应用详情页，选择【渠道设置】；
2. 点击【企业微信机器人】/【微信客服】，进入绑定页面；
3. 点击 **用企微扫码获取凭证，** 用手机企业微信扫码；自动完成 `BotId` 和 `Secret` 的配置；
4. 企业微信后台，把这个机器人加入目标群聊或单聊。

这时，群里的成员就可以直接 @ 机器人，使用 ADP 工作流编排 + OpenClaw 执行的【龙虾服务】。


## 4.7、接入腾讯云可观测平台和 CLS 日志服务


要满足企业级【可管可控】，要给 OpenClaw 装上 **日志黑盒 + 链路透视眼**。

首先是安装 TCOP & CLS 插件。

在部署 OpenClaw 的机器（本地或 Lighthouse）上执行：

```bash
# 安装腾讯云日志（CLS）输出插件
openclaw plugins install @tencent/cls-logger

# 安装可观测平台（TCOP）链路上报插件
openclaw plugins install @tencent/tcop-observability
```

成功后，可在 `openclaw plugins list` 看到这两个插件处于【启用】状态。

然后在腾讯云配置日志和可观测：

1. 登录腾讯云控制台，进入**CLS 日志服务**：创建 Logset 与 Topic，在插件配置填入对应 `TopicId`、`Region` 等信息。
2. 登录 **腾讯云可观测平台 TCOP**：在【数据接入】选择 OpenClaw 方案；按文档填入上报地址和与鉴权信息（插件配置文件或 ADP 控制台有一站式指引）。

完成后，就可以在 TCOP 看到：

- 每个对话会话的 **请求链路**、**响应耗时**、**调用模型** 和 **Token 消耗**；
- 每个 Skill 的 **调用频率 / 错误率**；
- OpenClaw 整体运行健康状况。


![image](https://developer.qcloudimg.com/http-save/yehe-11218869/9dc29c8b7be88307a0fd92024fcf031d.png)


## 4.8、端到端验证

完成上述部署后，就可以做一次【端到端健康检查】：

1. 企业微信@ 机器人发送指令。
2. ADP 工作流触发，调用 OpenClaw 对接数据库或 API 拉取数据；OpenClaw 调用 Skill 生成数据；群里收到一条相关结果的消息。
3. TCOP / CLS 验证：能看到对应会话的完整链路（IM 到 ADP 到 OpenClaw 到 Skill 到 模型）；能查看本次任务的错误码、耗时、Token 消耗。

如果这一步一切正常，【从 0 到 1 养虾】部署就已经 **打通全链路** 了。

## 4.9、常见问题


|问题现象|可能原因|排查建议|
|:-:|:-:|:-:|
|QClaw 无法连接 OpenClaw|gateway 未启动 / 端口被防火墙拦截|在目标机器执行 `openclaw gateway status`，确认 running；检查安全组和本机防火墙是否开放 18789 端口|
|企业微信收不到机器人回复|机器人未被拉入群 / 渠道未绑定成功|企业微信后台确认机器人已加入群；在 ADP 渠道页重新扫码授权|
|TCOP 没有任何数据|插件未安装或未正确配置|执行 `openclaw plugins list` 检查插件状态；核对 CLS/TCOP 中 Topic / 上报地址和插件配置是否一致|
|Python SDK 调用 LKE 报身份错误|SecretId/SecretKey 配错或缺失|用环境变量注入密钥；控制台重新生成 API 密钥并校验权限范围|

现在，就已经完成：

- **本地 QClaw + OpenClaw**
- **云端 Lighthouse + OpenClaw**：为团队提供 7×24 小时的 AI 助手；
- **ADP Claw 应用**：企业级智能体中枢，负责知识库、工作流、多智能体协作与权限管理；
- **TCOP + CLS**：可观测系统工程。

# 五、工作流编排


ADP Claw + 企微群发 Skill 构建一个智能 消息分发中心。

- 每周五自动向多个项目群发送【下周排期 / 会议通知】；
- 按群标签（产品、技术、运营）定制不同模板；
- 支持定时 / 手动触发。

先要获取不同群聊的唯一标识，这样龙虾才能在发消息时精确找到准确的群聊。获取方式很简单，直接问：
> @小龙虾 当前群的 ID 是多少？

就可以获得群ID。

ADP 创建 Workflow：
1. Query：从知识库 / 文档读取「下周排期」模板；
2. Use Agent：让 OpenClaw 根据群标签填充不同细节（会议主题、时间等）；
3. 调用企微群发 Skill，把消息分发到多个群聊；
4. 记录日志到 CLS。

安全控制交给 ADP Claw：能访问的文档范围、群组范围可精细配置；敏感内容通过输出内容安全策略进行过滤和脱敏。

ADP Claw 的五大防火墙机制：


1. 所有模型调用通过统一安全网关，基于 Agent 身份严格鉴权；记录调用日志，限流和异常行为检测。
2. 检测 Prompt 注入攻击，拦截试图诱导模型泄露系统指令、绕过策略的请求。
3. **Skill / 工具调用安全。**
4. 按用户、Agent、Skill 多维度的访问控制。
5. 每个 Agent / Workflow 实例运行在受控环境；某个 Skill 存在风险，也不会影响整个平台。

# 六、总结

QClaw + ADP 打通从个人桌面到企业系统的全链路智能体工作流，在为企业落地安全、易用的AI Agent提供一站式实践。

用腾讯云的全栈能力，解决智能体在企业落地面临的【易用性、安全性、可控性、可观测性】四大问题。
![image](https://developer.qcloudimg.com/http-save/yehe-11218869/04f5db3a641098a3228b3ec4506da92d.png)


腾讯云 可观测平台（TCOP）+ 日志服务（CLS）+ Agent Memory 等能力，构建 可管、可控、可观测 的全栈智能体工作流。

QClaw + ADP 打造可管可控的智能体工作流

2026 年，OpenClaw以超过 25 万 GitHub Star 的速度席卷开发者圈，誉为“史上增长最快的 AI Agent 项目”之一，衍生出的 QClaw、WorkBuddy、ADP Claw 等产品，重塑日常办公和企业智能体架构。

人工智能

云计算

低代码

QClaw+腾讯云ADP组合打造全栈智能体工作流：QClaw作为零门槛本地执行端，ADP提供企业级控制平面，结合TCOP+CLS实现可观测性。支持微信/QQ直连，集成主流大模型，覆盖文件处理、办公自动化等高频场景，满足个人和企业级AI助手需求，确保数据安全与隐私保护。

腾讯云可观测平台

轻量应用服务器

数据安全

内容安全

云服务器

日志服务

云桌面

防火墙

数据库

服务器

DevOps

路由

Linux

JSON

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

lighthouse

日志服务CLS新用户首单0.8折起！


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

tencentdb-catalog

coding

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

QClaw + ADP 打造可管可控的智能体工作流-腾讯云开发者社区-腾讯云

QClaw + ADP 打造可管可控的智能体工作流

QClaw + ADP 打造可管可控的智能体工作流

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐