操作场景
当您需要一个 AI DBA 助手来管理数据库时，可通过创建 DatabaseClaw 实例完成部署。系统将在您所选地域和网络下自动创建容器服务集群并部署 DatabaseClaw 实例，实例部署在您的私有网络（VPC）内，直连数据库，确保数据不出域。
背景信息
DatabaseClaw 是面向 DBA 团队的 AI Agent 运维平台，支持通过自然语言对话完成数据库诊断、巡检、慢查询分析等日常运维任务。每个 DatabaseClaw 实例对应一个独立的 AI DBA 助手，具备独立的 Skill（运维技能）、SOUL（行为规范）和数据源配置。
核心概念说明：
概念 | 说明 |
DatabaseClaw（Claw） | 一个实例化的 AI DBA 助手，部署在用户 VPC 内网，直连数据库。 |
实例模板 | 包含 Skill 和 SOUL 配置的快照，可基于模板快速创建标准化的 Claw 实例。 |
Skill | Claw 的运维技能插件，如巡检、慢查询分析等。 |
SOUL | 定义 Claw 的 AI 助手身份、行为准则与回答风格的配置文件。 |
实现机制
创建 DatabaseClaw 实例时，系统执行以下流程：
1. 参数校验：后端校验 Claw 名称合规性、地域可用区合法性、VPC/子网存在性。
2. 服务角色检查：检查账号下是否已创建服务角色 ，若未创建则触发角色创建流程。
3. 集群创建/复用：在目标地域和 VPC 下创建或复用容器服务（TKE）集群。
4. Agent 部署：在 TKE 集群中创建 Claw Agent Pod，挂载 Skill 运行时和 SOUL 配置。
5. 能力初始化：根据选择的配置方式（快速创建/模板/自定义）初始化 Skill 列表和 SOUL 内容。
6. 状态流转：实例状态从
creating 变更为 running，部署完成后用户可进入对话。说明：
整个部署过程通常需要3-5分钟，期间实例状态为创建中，不可执行任何操作。
使用限制
限制项 | 限制说明 |
地域与可用区 | 创建成功后不支持切换地域和可用区。 |
网络要求 | 需提前在目标地域创建私有网络（VPC）和子网。 |
Claw 名称长度 | 支持2 - 20个字符的中英文、数字、中划线及下划线。 |
Claw 描述长度 | 最多200个字符。 |
注意事项
系统将在您所选地域和网络下自动创建容器服务集群并部署 DatabaseClaw 实例，相关资源费用按腾讯云标准计费，集群创建后将持续运行产生费用。
该集群归属于您的腾讯云账号下自主管理，创建完成后可在容器服务控制台查看和运维。
首次创建实例时，系统将自动在您的账号下创建默认服务角色
DatabaseClaw_QCSRoleInResourceAccess，用于查询和管理云数据库资源。一个腾讯云主账号仅使用一个默认角色，全局复用。
前提条件
已拥有腾讯云账号，并完成实名认证。
已被授予
QcloudDatabaseClawUserFullAccess 或 QcloudDatabaseClawAdminFullAccess CAM 策略。已在目标地域创建私有网络（VPC）和子网。如尚未创建，请参见 创建私有网络。
操作步骤
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击创建 DatabaseClaw，进入创建页面。
4. 配置基础信息，参数说明如下。
参数 | 是否必填 | 说明 |
Claw 名称 | 是 | 支持2 - 20个字符的中英文、数字、中划线及下划线。例如：生产环境-MySQL 巡检助手。 |
Claw 描述 | 否 | 描述该 Claw 实例的用途或场景，方便后续管理，最多200个字符。 |
5. 配置地域与网络，参数说明如下。
6. 选择能力配置方式，参数说明如下。
配置方式 | 说明 |
快速创建 | 使用官方推荐配置，开箱即用。适合首次使用的用户。 |
使用模板 | 选择管理员预设的模板，自动带出对应的 Skill 和 SOUL 配置，一键复用。 |
自定义配置 | 手动选择 SOUL 模板和需要安装的 Skill，按需灵活定制。 |
说明：
选择使用模板时，仅展示管理端已上架且对当前账号类型可见的模板。选择模板后将自动带出对应的 Skill 和 SOUL 配置。
7. 单击创建服务。
首次创建实例时，系统将弹出服务授权确认弹窗，需要在您的账号下创建默认服务角色
DatabaseClaw_QCSRoleInResourceAccess。单击同意并创建后，系统将自动完成角色创建及策略绑定，随后开始创建实例。
8. 创建成功后，页面将自动跳转至实例列表页面。新实例初始状态为创建中，待部署完成后自动切换为运行中。
服务角色策略说明
首次创建实例时系统代建的
DatabaseClaw_QCSRoleInResourceAccess 角色绑定以下策略：绑定策略 | 对应产品 | 权限级别 | 用途 |
QcloudCVMInnerReadOnlyAccess | 云服务器 CVM | 只读 | 查询 CVM 实例列表、网络信息和安全组，用于服务发现和网络拓扑探测。 |
QcloudCDBFullAccess | 云数据库 MySQL | 读写 | 管理 MySQL 实例的运维操作。 |
QcloudRedisFullAccess | 分布式缓存数据库 Distributed Cache | 读写 | 管理 Distributed Cache 实例的运维操作。 |
QcloudMongoDBFullAccess | 云数据库 MongoDB | 读写 | 管理 MongoDB 实例的运维操作。 |
QcloudCynosDBFullAccess | TDSQL-C MySQL 版 | 读写 | 管理 TDSQL-C MySQL 实例的运维操作。 |
QCloudTDAIDatabaseClawDenyDestructive | 全部数据库产品 | 显式 Deny | 拒绝所有数据库产品的销毁、清空、删库等高危不可逆操作。 |
说明：
后续步骤
实例创建完成后，即可使用对话功能开始 AI 运维。
相关操作
管理数据源
使用对话功能
常见问题
创建实例时提示权限不足怎么办？
请联系主账号管理员为您授予
QcloudDatabaseClawUserFullAccess（用户权限）或 QcloudDatabaseClawAdminFullAccess（管理员权限）CAM 策略。创建实例后可以更改地域吗？
不可以。地域和可用区在创建实例时确定，创建成功后不支持切换。如需更换地域，请新建实例。
