> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lwops.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# QwenPaw整合方案

> 基于 Lerwee Agentic Ops × QwenPaw 的整合方案，实现运维智能体快速接入

本文档面向 QwenPaw 用户，说明如何从插件市场安装乐维 IT Ops Agent，并配置乐维运维平台 API 信息。完成后，可在独立的运维智能体中使用告警诊断、设备巡检、告警转工单和 FAQ 搜索能力。

## 准备工作

| 准备项          | 说明                                                             |
| ------------ | -------------------------------------------------------------- |
| QwenPaw      | 已部署并可访问，版本为 1.1.12 或更高。                                        |
| QwenPaw 访问入口 | 已完成部署，并可正常登录和使用。                                               |
| 插件名称         | IT Ops Agent，当前示例版本为 1.0.5。                                    |
| 乐维连接信息       | 由管理员提供 API Base URL、API Secret 和运维平台门户地址；Secret 从平台 .env 文件获取。 |
| 操作权限         | 生产环境涉及删除、清理、重启等动作时，需要人工确认或审批。                                  |

## 一、安装 IT Ops Agent 插件

### 1. 进入插件管理

打开已部署的 QwenPaw，在左侧设置区域进入“插件管理”。首次进入时，“已安装插件”可能为空。

![QwenPaw整合方案 操作截图 1](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/itopsagent/image-01.png)

图 1 进入 QwenPaw 插件管理

### 2. 在插件市场搜索 IT Ops Agent

切换到“插件市场”，在右上角搜索框输入 IT Ops Agent。确认结果名称为“IT Ops Agent”，作者为乐维，版本为 1.0.5。

![QwenPaw整合方案 操作截图 2](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/itopsagent/image-02.png)

图 2 在插件市场搜索 IT Ops Agent

### 3. 安装并确认运行状态

点击插件卡片右侧“安装”，等待安装完成。返回“已安装插件”，确认 IT Ops Agent 的状态显示为“运行中”，左侧工作区同时出现“运维智能体”。

![QwenPaw整合方案 操作截图 3](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/itopsagent/image-03.png)

图 3 确认插件已安装并处于运行状态

> 安装结果<br />插件会创建独立的运维智能体，不改变 Default 智能体。<br />插件包含告警诊断、设备巡检、告警转工单和 FAQ 搜索 4 项能力。<br />如果安装后菜单未立即出现，刷新页面或重启 QwenPaw 后再确认。

## 二、配置乐维 API 信息

### 1. 打开运维智能体配置

在左侧工作区点击“运维智能体”。页面顶部显示“未初始化”时，需要先完成全局配置并保存。

![QwenPaw整合方案 操作截图 4](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/itopsagent/image-04.png)

图 4 打开运维智能体全局配置

### 2. 由管理员提供 API 地址和 Secret

管理员从乐维平台部署配置中确认 API 服务地址，并在 .env 文件中找到 API\_SECRET\_KEY。普通用户只需要拿到 API Base URL 和 API Secret，不需要服务器登录口令。

```latex theme={null}
服务器路径示例：
/itops/nginx/html/lwjk_app/.env

需要查找的配置项：
API_SECRET_KEY=<不要写入公开文档的真实密钥>
```

### 3. 填写全局配置

在“全局配置”中填写 API Base URL、API Secret 和 Timeout。QwenPaw 访问地址只用于打开 QwenPaw，不要填入 API Base URL。

```latex theme={null}
API Base URL=http://<乐维平台 API 地址>/backend_api
API Secret=<.env 中的 API_SECRET_KEY>
Timeout=30
```

### 4. 填写运维平台地址

在页面下方的“运维平台地址”卡片中填写乐维运维平台的门户 URL。该地址用于顶部“打开运维平台”按钮跳转，应填写浏览器可访问的门户首页，不要填写 API Base URL。

```latex theme={null}
运维平台地址=https://<乐维运维平台门户地址>/
```

![QwenPaw整合方案 操作截图 5](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/itopsagent/image-05.png)

图 5 填写运维平台门户地址

### 5. 保留同步开关并保存

默认保持“同步到告警诊断”“同步到设备巡检”“同步到告警转工单”三个开关开启，然后点击页面右下角“保存配置”。FAQ 搜索使用插件自带配置，不需要填写 API Secret。

> 地址说明<br />QwenPaw 访问地址：用于打开 QwenPaw 聊天和管理页面。<br />API Base URL：乐维运维平台的接口地址，以 /backend\_api 结尾。<br />运维平台地址：乐维运维平台的门户 URL，用于“打开运维平台”按钮跳转。

## 三、使用运维智能体

### 1. 切换到运维智能体

保存配置后返回“聊天”。如果当前智能体不是运维智能体，在左上角“当前智能体”列表中切换到运维智能体。

### 2. 输入运维任务

根据需要直接输入告警、巡检对象、工单要求或 FAQ 问题。涉及清理、删除、重启、修改配置等操作时，应先查看方案并确认影响范围。

| 能力     | 输入示例                          |
| ------ | ----------------------------- |
| 告警诊断   | 请诊断以下告警：\[告警标题和完整内容]          |
| 设备巡检   | 请对主机 192.168.x.x 执行健康巡检并生成报告。 |
| 告警转工单  | 请将以下告警转为工单：\[告警内容]            |
| FAQ 搜索 | 请查询“磁盘空间使用率过高”的处理方法。          |

## 四、确认是否完成

| 检查项  | 完成标准                                        |
| ---- | ------------------------------------------- |
| 插件安装 | “已安装插件”中存在 IT Ops Agent，状态为“运行中”。           |
| 菜单显示 | 左侧工作区可以看到“运维智能体”。                           |
| 参数配置 | API Base URL、API Secret、Timeout 和运维平台地址已保存。 |
| 配置同步 | 告警诊断、设备巡检、告警转工单的同步开关符合使用要求。                 |
| 任务调用 | 返回聊天后可以切换到运维智能体并提交运维任务。                     |