---

name: zadig description: ⚠️ 需要 ZADIG_API_URL + ZADIG_API_KEY | Zadig DevOps 平台 API 客户端

Zadig Skill

基于 Zadig OpenAPI 规范实现的 DevOps 平台客户端。

配置

必须配置以下环境变量（添加到 ~/.openclaw/workspace/.env）：

# 必填
ZADIG_API_URL=https://your-zadig.example.com
ZADIG_API_KEY=your-jwt-token

# 可选
ZADIG_DEFAULT_PROJECT=your-project

权限说明

• read:env - 读取 .env 文件获取 API 凭证
• network:https - 向 Zadig API 服务器发起请求

核心功能

• 项目管理
• 工作流管理
• 环境管理
• 服务管理
• 构建管理
• 测试管理

使用示例

const zadig = require('./skills/zadig');

// 列出项目
const { projects } = await zadig.listProjects();

// 触发工作流
await zadig.triggerWorkflow({
  projectKey: 'yaml',
  workflowKey: 'build',
  inputs: [...]
});

// ===== 便捷方法 =====

// 获取服务状态（一步到位）
const status = await zadig.getServiceStatus({
  projectKey: 'yaml',
  envName: 'dev',
  serviceName: 'service1'
});
/* 返回:
{
  service_name: 'service1',
  env_name: 'dev',
  status: 'Running',
  image: 'koderover.tencentcloudcr.com/test/service1:xxx',
  pod_name: 'service1-xxx-xxx',
  node: '172.16.64.16',
  ip: '172.16.64.132',
  ports: [{ containerPort: 20221, protocol: 'TCP' }],
  service_endpoints: [{ name: 'service1', service_port: 20221, node_port: 31331 }]
}
*/

// 获取服务日志（同步返回文本）
const logs = await zadig.getServiceLogsSync({
  projectKey: 'yaml',
  envName: 'dev',
  serviceName: 'service1',
  tailLines: 100
});
// 返回日志文本

// 获取工作流任务状态
const task = await zadig.getWorkflowTask({
  workflowKey: 'dev-build',
  taskId: 67
});

安全建议

1. 使用最小权限的 API Token
2. 不要将 API Key 提交到版本控制