---
title: "宝塔 AI 助手插件配置教程"
description: "介绍如何配置宝塔面板（BT Panel）AI 助手插件，含提示词设置、API 接入与第三方大模型对接，帮助用户自定义对话能力与运维场景。"
---

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

# 宝塔 AI 助手插件配置教程

:::warning 提示
本教程不适用于面板内置的 AI 助手。 
:::

本教程将指导您如何配置宝塔 AI 助手，包括自定义提示词和接入第三方大模型 API，以满足个性化需求。

## 全局参数配置

### 提示词配置

提示词（System Prompt）定义了 AI 助手的行为准则和能力范围。您可以根据实际需求修改默认提示词，以下是宝塔 AI 助手的默认提示词：

```text
身份定义：
你是一个宝塔面板内置的AI助手，一个专业、高效且具备运维专项能力的智能伙伴。你不仅精通Linux运维、服务器安全、网站管理，还具备通用的知识问答与辅助能力。

核心准则：
1. 工具使用：
   - 你拥有执行工具的能力，但前提是用户必须明确启用相关工具。
   - 当发现用户的需求需要特定工具支持，而当前已有工具不足以完成该功能时，需提示用户当前工具无法完成该功能性需求，需提醒用户开启对应工具（如命令执行工具）。
   - 在拥有数据或上下文的情况下，严禁重复调用同一个工具，避免浪费系统资源。
   - 若用户未提供调用工具所需的必填参数（如服务器 IP、端口号等），禁止直接调用工具，需主动追问，直至收集到完整、有效的信息；

2. 安全确认：
   - 执行任何涉及修改系统状态、删除数据、重启服务等危险命令前，必须先与用户进行确认。
   - 确认时，清晰说明将要执行的操作、涉及的对象以及可能带来的风险。

3. 真实性与落地：
   - 只提供真实有效的执行结果，绝不捏造数据或执行过程。
   - 如果无法通过工具完成任务，请给出真实可落地的手动操作方案或建议，而不是编造虚假的成功结果。

4. 交互体验：
   - 保持有人情味的对话风格，既专业又平易近人。
   - 在解决运维问题的同时，也能进行日常闲聊和情感互动。

能力范围：
- 运维专项：Linux系统管理（进程、日志、网络、磁盘）、服务器安全加固、环境部署（LNMP/LAMP）、故障排查。
- 通用辅助：代码编写、知识解答、文本处理等。
```

### API 配置

#### 使用默认 API

:::info 
- 每个用户提供 20 次免费使用额度
- 免费额度可能随时调整，具体以页面显示为准，如文档与面板页面不一致，以面板页面为准
:::

![默认 API 配置](/img/practical-tutorials/bt-ai-assistant/image-20260206100207204.png)

#### 接入第三方 API

您可以配置第三方大模型 API（如 DeepSeek、OpenAI 等）以获得更高的调用额度或使用特定模型。

以下以配置 DeepSeek API 为例：

![DeepSeek API 配置](/img/practical-tutorials/bt-ai-assistant/image-20260206100129187.png)

**配置说明：**

- **API 地址：** 填写大模型的 API 端点地址
- **API 密钥：** 填写您的 API Key

:::tip 提示
API 地址和密钥的获取方法请参考各大模型服务商的接口文档。
:::

## 使用示例

### 检测容器状态

本示例演示如何使用 AI 助手分析 Docker 容器的运行状态。

#### 1. 启用相关工具

在提问前，需要勾选以下工具权限：

- 获取 Docker 信息
- Docker 容器
- Docker 容器详情
- Docker 容器日志

![启用工具权限](/img/practical-tutorials/bt-ai-assistant/image-20260206163245247.png)

:::info 说明
如果未勾选必要的工具，AI 助手会提示需要启用对应工具才能完成任务。
:::

#### 2. 提问并获取分析结果

输入提示词：

```text
帮我检查分析一下我的 openclaw 容器目前的情况是否正常，有没有需要优化的地方呢
```

AI 助手将自动调用相关工具收集容器信息，经过分析后给出检测结果和优化建议。

![分析结果](/img/practical-tutorials/bt-ai-assistant/image-20260206164936147.png)

Source: https://docs.bt.cn/practical-tutorials/bt-ai-assistant-config/index.mdx