openclaw-zadig

Zadig 平台的 OpenClaw 插件，为 OpenClaw Agent 提供工作流、环境、服务、构建、发布等操作能力。

openclaw-zadig 向 OpenClaw AI Agent 注册 13 个 Zadig 操作工具，涵盖工作流触发、环境管理、镜像更新、构建配置、发布计划等核心 DevOps 场景。插件同时提供配套的 AI Skill 文档，帮助 Agent 正确调用每个工具。

目录

• 使用
  • 安装
  • 配置
  • 工具列表
• 贡献者
  • 项目结构
  • 本地开发
  • 发布

使用

安装

npx -y openclaw-zadig install

配置

在 OpenClaw 配置文件中添加插件配置：

{
  "plugins": {
    "entries": {
      "openclaw-zadig": {
        "config": {
          "zadigUrl": "https://zadig.example.com",
          "apiToken": "your-api-token"
        }
      }
    }
  }
}

| 字段 | 必填 | 说明 | |------|:----:|------| | zadigUrl | 是 | Zadig 实例地址（如 https://zadig.example.com） | | apiToken | 是 | 在「账号设置 → API Token」中生成 | | tools.deny | 否 | 禁用指定工具名称列表，如 ["zadig_scan", "zadig_infra"] |

工具列表

工作流与发布

| 工具 | 说明 | |------|------| | zadig_workflow | 工作流触发、任务状态查询、审批操作 | | zadig_release | 发布计划与交付版本管理 |

环境与服务

| 工具 | 说明 | |------|------| | zadig_environment | 环境管理与服务镜像更新 | | zadig_service | 服务列表查询与详情 |

构建与测试

| 工具 | 说明 | |------|------| | zadig_build | 构建配置管理（增删改查） | | zadig_test | 测试任务执行与结果查询 | | zadig_scan | 代码扫描（SonarQube 等） |

项目与基础设施

| 工具 | 说明 | |------|------| | zadig_project | 项目创建、列表与详情 | | zadig_infra | 集群与镜像仓库管理 |

运营与管理

| 工具 | 说明 | |------|------| | zadig_insight | 数据洞察与统计 | | zadig_policy | 策略配置 | | zadig_user | 用户管理 | | zadig_system | 系统配置 |

每个工具均有对应的 AI Skill 文档，位于 skills/ 目录下。

贡献者

项目结构

openclaw-zadig/
├── index.ts                  # 插件入口，注册所有工具和 CLI 命令
├── src/
│   ├── tools/                # 13 个工具模块，每个子目录对应一个 Zadig 领域
│   ├── core/                 # 公共类型、Zadig HTTP 客户端、配置 Schema
│   ├── commands/             # CLI 命令（diagnose）
│   └── install/              # install / update / doctor / info 命令实现
├── skills/                   # 每个工具对应的 AI Agent Skill 文档
├── bin/
│   └── openclaw-zadig.js     # CLI 入口，委托给 openclaw-zadig-tools
├── docs/                     # Zadig OpenAPI 参考文档
└── openclaw.plugin.json      # 插件声明（id、configSchema、skills 路径）

本地开发

# 安装依赖
npm install

# 类型检查
npm run typecheck

# 构建（输出到 dist/）
npm run build

发布

# prepublishOnly hook 会自动触发构建
npm publish