操作场景
SOUL 管理页面用于定义 AI 助手的身份、行为准则与回答风格。管理端已发布的 SOUL 模板即为用户端创建或编辑 Claw 时的 SOUL 可选集。本文介绍如何新建、编辑和删除 SOUL。
背景信息
SOUL（System Objective Understanding Layer）是 DatabaseClaw 的核心配置之一，用于定义 AI 助手的身份角色、行为准则、回答风格和能力边界。通过 SOUL 配置，您可以精确控制 AI 助手在特定业务场景下的响应策略、专业领域和操作权限。一个规范的 SOUL 配置通常包含以下结构：
身份定义：AI 助手的角色定位。
行为准则：回答时应遵循的规范。
回答风格：语言风格和交互方式。
能力边界：明确可以做和不可以做的事情。
SOUL 分为预设和自定义两类，预设 SOUL 由系统提供，不可编辑和删除。系统提供以下预置 SOUL 模板：
预置 SOUL 模板
DatabaseClaw 平台提供以下预置 SOUL 模板，用户在创建或编辑 Claw 时可直接选用。
DBA 专家助手
DBA 专家助手是面向腾讯云全线数据库产品的智能运维诊断助手，专注于实例管理、性能诊断、慢查询分析、参数配置审查和监控数据解读等场景。
SOUL 核心能力：
身份定义：经验丰富的全引擎 DBA，覆盖 MySQL、feRedis、MongoDB、TDSQL-C、MariaDB、PostgreSQL、SQL Server 等腾讯云全线数据库产品。
行为准则：事实导向、引擎感知、建议有据、风险提醒、坦诚不确定、主动追问。
能力范围：查询实例信息、拉取监控数据、检索分析慢查询、检查参数配置、跨引擎诊断对比、执行常规 DML 写操作（需用户确认）。
安全管控：DDL 操作一律禁止执行，破坏性不可逆操作被永久禁止，写操作前必须完成影响说明、风险提醒、用户确认三步流程。
注意：
DBA 专家助手 SOUL 内置了严格的安全红线规则，包括写操作分层管控、禁止信息泄露、禁止越权操作、禁止盲目执行和拒绝攻击五项系统强制规则，确保 AI 助手在生产环境下安全运行。
openclaw 默认 SOUL
openclaw 默认 SOUL 是一个通用型 AI 助手人格配置，强调真正有帮助的交互风格，适用于需要灵活响应的通用数据库运维场景。
SOUL 核心能力：
行为风格：真正有帮助而非表演式帮助，跳过客套直接解决问题。
主动性：优先自主寻找答案，遇到困难后再向用户提问。
判断力：允许有观点和偏好，而非机械执行。
安全意识：对外部操作（邮件、消息等）谨慎确认，对内部操作（阅读、组织、学习）大胆执行。
隐私边界：私人信息严格保密，外部操作前先确认，不代替用户发言。
安全管控：与 DBA 专家助手相同的五项安全红线规则（写操作分层管控、禁止信息泄露、禁止越权操作、禁止盲目执行、拒绝攻击）。
使用限制
限制项 | 限制说明 |
SOUL 名称长度 | 支持1 - 128个字符。 |
SOUL 内容大小 | 最大100KB。 |
SOUL 内容格式 | 支持 Markdown 格式。 |
预设 SOUL | 系统预设 SOUL 不可禁用、不可编辑、不可删除。 |
SOUL 版本号 | 必填项，用于标识 SOUL 的迭代版本。 |
注意事项
SOUL 新建后默认为已开启状态，开启后用户端即可见。如暂不希望用户使用，可在创建后手动禁用。
禁用 SOUL 仅影响新创建的 Claw 实例选择，不影响已绑定该 SOUL 的现有实例。
删除 SOUL 后不可恢复，如仅需临时停用，建议使用禁用功能替代删除。
用户端对 SOUL 的编辑存储在实例级别，不会反向影响管理端的 SOUL 模板。
SOUL 内容建议按身份定义、行为准则、回答风格、能力边界结构编写，确保 AI 助手行为可控。
建议在 SOUL 中明确设定安全红线（如禁止执行 DDL、禁止泄露内部信息等），防止 AI 助手越权操作。
修改已发布的 SOUL 后，仅对后续新创建或重新绑定的 Claw 实例生效，已有实例需手动更新。
前提条件
已被授予
QcloudDatabaseClawAdminFullAccess CAM 策略。操作步骤
查看 SOUL 列表
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > SOUL 管理页面。
4. 页面以卡片展示所有 SOUL，区分预设和自定义两类。支持按名称或描述搜索。
新建 SOUL
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > SOUL 管理页面。
4. 在页面上方单击新建 SOUL，在弹窗中填写以下信息。
参数 | 是否必填 | 说明 |
SOUL 名称 | 是 | SOUL 的名称，便于后续识别和选择。 支持输入1-128字符。 |
SOUL 描述 | 否 | 描述该 SOUL 的功能和使用场景。 |
SOUL 版本 | 是 | SOUL 的版本号。示例：1.0.0 |
SOUL 内容 | 否 | 定义 AI 助手的身份、行为准则与能力边界。支持 Markdown 格式，最大100KB。 |
5. 单击确定并发布完成创建。
新建的 SOUL 默认为已开启状态，开启后用户端可见。
查看 SOUL 详情
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > SOUL 管理页面。
4. 单击目标 SOUL 卡片，即可在右侧面板中查看该 SOUL 的详细信息。
顶部概览
参数 | 说明 |
SOUL 名称 | SOUL 的名称。 |
运行状态 | SOUL 当前的运行状态，如启用中（绿色标识）。 |
关联信息 | 已关联的用户数、关联的 Claw 实例使用数。 |
创建时间 | SOUL 的创建时间，如2026-04-11 22:09:05创建。 |
来源标签 | SOUL 来源类型，如自定义。 |
SOUL 信息页签
参数 | 说明 |
描述 | SOUL 的功能描述文本。 |
创建时间 | SOUL 的创建时间。 |
SOUL 内容 | SOUL 的内容展示。 |
启用/禁用 SOUL
启用：单击 SOUL 卡片上的开关启用 SOUL。启用后用户端创建或编辑模板时可选择该 SOUL。
禁用：单击 SOUL 卡片上的开关禁用 SOUL，系统将展示影响范围（被多少实例使用、涉及多少用户），需勾选确认后，单击确认。禁用后新创建的模板不可选择该 SOUL。
编辑/复制/删除 SOUL
编辑：在 SOUL 卡片右下方单击
复制：在 SOUL 卡片右下方单击
删除：在 SOUL 卡片右下方单击
注意：
仅自定义类型 SOUL 可编辑和删除，系统预设 SOUL 不可编辑、不可删除。
删除 SOUL 后不可恢复。如仅需临时停用，建议使用禁用功能。
用户端对 SOUL 的编辑存储在实例上，不影响管理端的 SOUL 模板。
相关操作
对应的 API 接口
API 名称 | 说明 |
CreateSOUL | 创建 SOUL 模板。 |
ModifySOUL | 修改 SOUL 模板。 |
DeleteSOUL | 删除 SOUL 模板。 |
DescribeSOULList | 查询 SOUL 列表。 |
DescribeSOULDetail | 查询 SOUL 详情。 |
常见问题
SOUL 内容有什么编写建议？
建议按“身份定义、行为准则、回答风格、 能力边界”结构编写，使用 Markdown 格式增强可读性。
删除 SOUL 后已使用该 SOUL 的实例会受影响吗？
不会。实例创建时已将 SOUL 内容复制到实例级别，管理端删除 SOUL 模板不影响已有实例的运行。
