ReaderMX.
DBdoctor

数据库智能运维skill—DBClaw安装与配置文档

D小助手约 9 分钟
Image

DBClaw介绍

DBClaw(dbdoctor-tools) 是将 DBdoctor 平台的核心能力封装为 AI 可调用的 Skills。当为 OpenClaw 或 Claude Code 配置 DBClaw 能力后，用户可在终端或飞书等场景中，通过自然语言直接调用 DBdoctor 平台的功能，无需登录平台进行页面操作，实现随时随地、即问即用的数据库智能运维体验。

图片

DBdoctor -DBClaw 技能菜单

本文提供OpenClaw+DBClaw，与Claude Code+DBClaw两种安装与配置方式，您可根据需求选择一种进行配置即可。

一、OpenClaw（龙虾）+DBClaw 安装与配置

1.安装部署DBdoctor

免费下载地址：https://www.dbdoctor.cn/?utm=01

可根据需要选择下载企业版（推荐下载），免费版

2.安装龙虾（如已安装请忽略此步）

前置条件：Node.js 22 或更新版本

安装 OpenClaw 最简单的方法是使用官方安装脚本：macOS/Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)：

iwr -useb https://openclaw.ai/install.ps1 | iex
Image

设置 OpenClaw

运行上述安装命令后，配置过程将自动开始。如果没有开始，您可以运行以下命令开始配置：

openclaw onboard --install-daemon

若之前已经初始化，您也可以运行openclaw config选择model配置。

Image

开始配置（以智谱AI为例，也可以选择其他厂商大模型）：

  • I understand this is powerful and inherently risky. Continue? | 选择 ● Yes

  • Onboarding mode | 选择 ● Quick Start

  • Model/auth provider | 选择 ●Z.AI

配置 Z.AI 提供商

选择 Z.AI 作为 Model/auth provider 后，选Coding-Plan-CN，系统会提示您输入 API Key。

 粘贴您的智谱 API Key 并按 Enter 键，然后选择您想要使用的模型，例如: zai/glm-5

注意: 支持 2026.2.22-2 及以上版本，目前在编程套餐中支持的模型有GLM-5 GLM-5-Turbo GLM-4.7 GLM-4.5-Air GLM-4.6 GLM-4.5 GLM-4.5V GLM-4.6V请勿选择其它模型 Flash FlashX 以免造成扣费。

Image

完成设置

继续完成剩余的 OpenClaw 功能配置。

  • Select channel | 选择并配置您需要的功能。

  • Configure skills | 选择并安装您需要的功能。

  • 完成设置

继续完成剩余的 OpenClaw 功能配置。

  • Select channel | 选择并配置您需要的功能。

  • Configure skills | 选择并安装您需要的功能。

  • 完成设置

与机器人交互

设置完成后，cli 会询问您How do you want to hatch your bot?

  • 选择 ● Hatch in TUI (recommended)

现在您可以在 Terminal UI 中开始与您的机器人聊天了。

3.DBdoctor-tools 安装

安装 clawhub
npm i -g clawhub

管理技能

  • 搜索技能

clawhub search "dbdoctor-tools"

  • 下载新技能

clawhub install dbdoctor-tools
4.添加飞书渠道
飞书创建机器人应用

首先，登录 飞书开放平台，进入开发者后台，点击「创建企业自建应用」：

出错啦! - bilibili.com

Image

填写应用名称和描述，给你的机器人起个好听的名字吧，我这里叫「十三香」：

Image

创建完成后进入应用详情页，在「添加应用能力」中点击添加 机器人 能力：

Image

添加完机器人能力后，接下来要开通权限。

进入左侧「权限管理」页面：

Image

选择开通哪些权限呢？

这里分两种情况：

1）如果你的飞书里没有敏感信息（比如个人玩耍用的），可以粗暴一点，直接把im:、contact:、file:、user、card、application 相关的权限全勾上。注意，应用身份权限和用户身份权限要分别选择。

Image

飞书的权限控制还是很详细的，每个权限的作用都标得清清楚楚：

Image

2）如果你经常使用飞书，或者是企业飞书，有隐私数据，那就需要精细控制权限了。最少只需要开通以下 3 个：

im:messageim:chatcontact:user.base:readonly

如果你想更精细地选择权限，但又不想一个个手动勾选，可以直接复制下面这份 JSON 权限配置，通过批量导入一键搞定：

Image
{"scopes": {"tenant": ["aily:file:read","aily:file:write","application:application.app_message_stats.overview:readonly","application:application:self_manage","application:bot.menu:write","cardkit:card:read","cardkit:card:write","contact:user.employee_id:readonly","corehr:file:download","event:ip_list","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource"],"user": ["aily:file:read","aily:file:write","im:chat.access_event.bot_p2p_chat:read"]}}

在权限管理页面选择批量导入。把 JSON 粘贴进去，点击「确认新增权限」就搞定了：

Image

权限配置完成后，点击「创建版本」，发布应用：

Image

填写版本号和更新说明、按需选择是否对外共享：

Image

然后申请线上发布：

Image

发布后需要审核。由于我这个账号本身就是管理员，自己审自己就行，秒通过：

Image

进入「飞书管理后台」审核通过即可：

Image
Image

审核通过后，应用会自动上线。可以看到发布成功的状态：

Image

最后，回到应用的「凭证与基础信息」页面，获取 App ID 和 App Secret，复制保存好，下一步要用。

Image

注意这俩是你机器人的钥匙，千万不要泄露给别人！

OpenClaw 添加飞书频道

拿到 App ID 和 App Secret 之后，就可以把飞书频道绑定到 OpenClaw 了。

这里有两种方法，任选其一。

方法一、让 AI 自己来装

直接在 OpenClaw 网页端跟 AI 对话，把密钥发过去，让它帮你配：

帮我安装飞书频道，App ID 是 xxx，App Secret 是 xxx
Image

让 AI 自己给自己装频道，确实很符合 AI 时代的做事方式。但这个方法偶尔会翻车，AI 可能理解错你的意思。

方法二、命令行安装（推荐）

打开终端（Windows 用户以管理员身份运行 PowerShell，Mac 用户打开终端），执行一行命令：

openclaw channels add
Image

然后跟着向导一步步操作就好，几乎 100% 成功。先选择要安装的频道，这里选择 Feishu 频道，然后选择使用 npm 安装工具下载：

Image

接下来输入你刚才保存的 App Secret 和 App ID，连接模式选择 WebSocket 长连接。还要选择具体的频道，国内用户选择 Feishu 频道，国外用户选择 Lark。

Image

然后配置 DM 私聊的访问控制方式，建议选择配对码模式，这样只有通过配对码验证的用户才能跟机器人私聊，更安全。当然这里跳过也行，后面随时能改：

Image

对接完成后，在 OpenClaw 网页控制台的频道列表中就能看到飞书了：

Image

配置飞书事件

频道接好了，但还需要在飞书侧配置事件订阅，不然飞书不知道该把哪些消息推给 OpenClaw。

回到飞书开发者后台，进入「事件与回调」配置，开启 长连接 的事件订阅方式：

Image

然后添加事件，至少要添加 接收消息（im.message.receive_v1） 这一项，其他的可以按需添加，比如机器人进群、被移除群等：

Image

添加好的事件列表如图：

Image

配置好事件后，别忘了最关键的一步：发布新版本！改了配置不发布是不会生效的，很多人就卡在这一步：

Image

这次更新版本会自动审核通过：

Image

到这里，飞书侧的配置就全部搞定了，离成功就差最后一步了！

私聊配对

在飞书中搜索你刚才创建的机器人，进入私聊。

随便跟小龙虾说一句话，比如：我要验牌。

发送第一条消息后，机器人会返回一个 配对码：

Image

拿到配对码后，有两种方式完成配对。

方式一、让小龙虾自己搞定

直接在 OpenClaw 网页端把配对信息发给 AI，让它帮你配：

帮我配对飞书渠道
OpenClaw: access not configured.Your Feishu user id: ou_xxxxxxxxxxxxxxxxPairing code: YUPIISDOGAsk the bot owner to approve with:openclaw pairing approve feishu YUPIISDOG
Image

方式二、命令行配对（推荐）

在终端中执行一行命令，把 <配对码> 替换成你自己收到的那串配对码：

openclaw pairing approve feishu <配对码>

执行成功后，会提示配对完成：

Image

配对成功后，再发一条消息试试，这次 AI 成功回复了！

Image

到这里，你的 OpenClaw 就已经和飞书打通了，可以愉快地聊起来了~

二、Claude Code + DBClaw（dbdoctor-tools） 安装与配置

1.安装部署DBdoctor

免费下载地址：https://www.dbdoctor.cn/?utm=01

可根据需要选择下载企业版（推荐下载），免费版

2.Claude Code安装与配置（如已安装请忽略此步）

2.1前提条件：

  • 您需要安装 Node.js 18 或更新版本环境（https://nodejs.org/en/download/）

  • MacOS 用户推荐使用 nvm 方式安装 Nodejs （https://nodejs.org/en/download/）或 Homebrew 方式（https://formulae.brew.sh/formula/node）。不推荐直接安装包安装(后续可能会遇到权限问题)

  • Windows 用户还需安装 Git for Windows（https://git-scm.com/download/win）

进入命令行界面，安装 Claude Code

npm install -g @anthropic-ai/claude-code

运行如下命令，查看安装结果，若显示版本号则表示安装成功

claude --version

2.2配置大模型

此处以智谱大模型为例：

访问 智谱AI开放平台（https://bigmodel.cn/） → 注册账号并完成实名认证 → 在控制台获取API Key。

支持 MacOS & Linux & Windows, 注意不同系统配置文件路径不一样。注意需保证修改的 JSON 文件格式正确性(比如多或少,)。

MacOS & Linux & Windows

# 编辑或新增 `settings.json` 文件# MacOS & Linux 为 `~/.claude/settings.json`# Windows 为`用户目录/.claude/settings.json`# 新增或修改里面的 env 字段# 注意替换里面的 `your_zhipu_api_key` 为您上一步获取到的 API Key{  "env": {    "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",    "API_TIMEOUT_MS": "3000000",    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1  }}# 再编辑或新增 `.claude.json` 文件# MacOS & Linux 为 `~/.claude.json`# Windows 为`用户目录/.claude.json`# 新增 `hasCompletedOnboarding` 参数{  "hasCompletedOnboarding": true}

配置成功后，请确保重新打开一个新的终端窗口，以便环境配置生效。

如有调整诉求，可直接通过调整配置文件的方式（位于 ~/.claude/settings.json）来调整到其他模型

（1）手动修改配置文件~/.claude/settings.json，添加或替换如下环境变量参数：

{  "env": {    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"  }}

注：使用 GLM-5.1，需要在将上方的环境变量参数值手动修改模型为 “glm-5.1”。

（2）启动一个新的命令行窗口，运行claude启动 Claude Code，在 Claude Code 中输入/status确认模型状态

2.3使用Claude  Code

配置完成后，进入一个您的代码工作目录，在终端中执行 claude 命令即可开始使用 Claude Code

若遇到「Do you want to use this API key」选择 Yes 即可

启动后选择信任 Claude Code 访问文件夹里的文件，如下：

Image
Image

3.添加dbdoctor-tools 技能

3.1添加技能

方式一：clawhub安装

安装clawhub：

# 安装clawhubnpx clawhub@latest install sonoscli# 安装到当前项目下： npx clawhub@latest install dbdoctor-tools --force --workdir ~/.claude

可能会触发速率限制，若安装不上，则使用方式二进行手动安装。安装成功后展示：

Image

方式二：手动安装

dbdoctor-tools skills 技能仓库地址如下：https://clawhub.ai/dbdoctor-das/dbdoctor-tools

点击Download zip ，将下载的zip 解压后放到.claude/skills/dbdoctor-tools目录下

Image

3.2配置环境变量

可以选择让claude code 自动帮助配置，如下：

Image

配置成功后，claude code 会逐步检查依赖，并执行某个tool，例如查询数据库实例数量：

Image

3.3场景测试：查询实例

/dbdoctor-tools 查看当前有哪几个oracle实例？
Image

继续追问：查看第一个的数据库io基础监控信息

Image

三、真实使用测试

实例信息查看

帮我看下当前纳管了多少个实例？

Image

慢sql查看

看下mysql-pilke6sg 实例有哪些慢sql 和根因问题

Image

数据库信息查看

帮我看下mysql-pilke6sg 实例下面有哪些数据库？匹配 包含test的数据库

Image

sql执行

帮我执行 select * from dbdtest.test_ref_a where a=1;

Image

sql执行

帮我执行delete  from dbdtest.test_ref_a where a=1;

均被拦截，但是openclaw 乱给了链接

Image

sql改写

帮我改写 select * from dbdtest.test_ref_a where a=1;

Image

SQL审核

帮我审核一下 select * from dbdtest.ref_test_a where a=1;*

Image

SQL审核

查看mysql引擎有哪些审核规则？

Image

数据库信息查看

看下dbdtest 下面表结构ddl

Image

巡检

帮我对mysql-pilke6sg 执行一下巡检吧

Image

巡检

查看oracle引擎有哪些巡检规则？

Image

会话查看

当前mysql-pilke6sg 实例有哪些会话？

Image

性能诊断

帮我诊断mysql-pilke6sg 实例 最近三个小时的数据库性能问题

龙虾hang住半天，看日志分析，已经分析完成，但是并没有发送到飞书

Image
图片
图片

KEEP THE THREAD GOING

更多来源文章

三个AI三种说法？以后不用自己拼结论了

😧 问监控AI——“正常” 问诊断AI——“可能是锁” 问优化AI——“建议加索引” 三个AI三种说法，还得自己当调度员拼凑结论。 说好的AI时代，怎么还是我一个人在扛？ 💡 该结束了。 告别“自己拼结论”，AI数据库管理团队帮你搞定。 8个专业智能体 + 小D同学总调度： 告警→巡检→根因诊断→锁分析→慢SQL→S…

阅读全文