alibabacloud-pai-dlc-job
Alibaba Cloud PAI-DLC (Deep Learning Containers) job management skill. Covers: distributed training job CRUD, monitoring (logs and events), and GPU sanity check. Triggers: "DLC", "PAI-DLC", "create-job", "list-jobs", "get-job", "stop-job", "update-job", "get-pod-logs", "get-job-events", "get-pod-events", "list-job-sanity-check-results".
Rank
62
Safety
84
Downloads
1.3k
Updated
Oct 10, 2026
Version
0.0.2
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.3K downloadsadoption · observed Oct 10, 2026
- Latest release
- 0.0.2release · observed Aug 14, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s173swjet2yrebzqrp6hjkvmy583mxef:alibabacloud-pai-dlc-job- Install using `clawhub skill install s173swjet2yrebzqrp6hjkvmy583mxef:alibabacloud-pai-dlc-job` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/sdk-team/alibabacloud-pai-dlc-job before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-pai-dlc-job/snapshot"
Documentation
CLAWHUB
145,025 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: alibabacloud-pai-dlc-job
description: |
Alibaba Cloud PAI-DLC (Deep Learning Containers) job management skill. Covers: distributed training job CRUD, monitoring (logs and events), and GPU sanity check. Triggers: "DLC", "PAI-DLC", "create-job", "list-jobs", "get-job", "stop-job", "update-job", "get-pod-logs", "get-job-events", "get-pod-events", "list-job-sanity-check-results".
---
# PAI-DLC Deep Learning Job Management
Manage deep learning training jobs on Alibaba Cloud PAI-DLC (Platform for AI - Deep
Learning Containers) service.
## Scenario Description
PAI-DLC is a distributed training service provided by Alibaba Cloud's AI Platform PAI,
supporting:
- **Job Creation and Execution** — Create distributed training jobs for TensorFlow,
PyTorch, XGBoost, and other frameworks
- **Job Monitoring** — Get job status, logs, events, and monitoring metrics
- **Compute Health Check** — Check health status of GPU and other compute devices
- **Job Management** — Update and stop jobs
**Architecture**: PAI Workspace + DLC Job + Computing Resources (ECS public pay-as-you-go
or Lingjun dedicated quota) + AIWorkSpace catalog (images / datasets / code sources /
quotas / workspaces).
## Installation Requirements
> **Pre-check: Aliyun CLI >= 3.3.1 required**
> Run `aliyun version` to verify version >= 3.3.1. If not installed or version is too low,
> see [references/cli-installation-guide.md](references/cli-installation-guide.md) for
> installation instructions.
> Then [Required] run `aliyun configure set --auto-plugin-install true` to enable
> automatic plugin installation.
> **Note on `--user-agent`:** Every API-invoking `aliyun` command in this skill MUST
> include `--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dlc-job/${SESSION_ID}`
> (unified User-Agent + session-id template — see [Observability](#observability) for
> the generation rules). Client-side helpers (`aliyun version`,
> `aliyun configure ...`, `aliyun plugin ...`, `aliyun <product> --help`) do not
> invoke remote APIs and therefore do not require the flag.
> **Network timeout & retry (rule `--help` doesn't enforce):** `aliyun` CLI
> defaults to 10s connect / 10s read with no retry. For long-running flows
> (large list, slow region) explicitly raise via global flags
> `--connect-timeout 15 --read-timeout 30 --retry-count 2`. Never rely on the
> default for user-confirmed high-risk calls (`stop-job` / `delete-*`).
```bash
aliyun version
aliyun configure set --auto-plugin-install true
aliyun pai-dlc --help
aliyun aiworkspace --help >/dev/null 2>&1 || aliyun plugin install --names aliyun-cli-aiworkspace
aliyun plugin update
```
## Observability
> **Why:** every PAI-DLC API call issued by this skill MUST carry a unified
> User-Agent so platform-side tracing can attribute the request to this skill
> and correlate all calls within a single agent session.
### User-Agent template
Every API-invoking `aliyun` command MUST pass:
```
--user-agent AlibabaCloud-Agent-Skills/ali_meta.json
{
"ownerId": "kn74p5w8ywv6prh40g0s82gmqh83nw54",
"slug": "alibabacloud-pai-dlc-job",
"version": "0.0.2",
"publishedAt": 1786696690094
}references/acceptance-criteria.md
# Acceptance Criteria: alibabacloud-pai-dlc-job
**Scenario**: PAI-DLC Deep Learning Job Management
**Purpose**: Skill Testing Acceptance Criteria
> **Note on snippets in this file:** Sections 1-3 below show product names,
> command names, and parameter names as **pattern placeholders** (e.g.,
> `aliyun pai-dlc <command>`). These are fragments for mismatch detection,
> not complete executable commands. The Section 4 "User-Agent" rule (and the
> SKILL.md core workflow) require every API-invoking command to end with
> `--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dlc-job/${SESSION_ID}`; full executable examples carry it.
---
# Correct CLI Command Patterns
## 1. Product — Verify Product Name Exists
CORRECT
```bash
aliyun pai-dlc <command>
```
INCORRECT
```bash
aliyun pai <command> # Error: product name should be pai-dlc
aliyun dlc <command> # Error: product name should be pai-dlc
aliyun PAI-DLC <command> # Error: case-sensitive, should use lowercase
```
## 2. Command — Verify Command Name Format
CORRECT (Plugin mode, lowercase with hyphens)
```bash
aliyun pai-dlc create-job
aliyun pai-dlc list-jobs
aliyun pai-dlc get-job
aliyun pai-dlc get-pod-logs
aliyun pai-dlc list-ecs-specs
aliyun pai-dlc get-web-terminal
aliyun pai-dlc stop-job
aliyun pai-dlc update-job
aliyun pai-dlc get-token
aliyun pai-dlc get-job-events
aliyun pai-dlc get-pod-events
aliyun pai-dlc get-job-sanity-check-result
aliyun pai-dlc list-job-sanity-check-results
```
INCORRECT (Traditional API format)
```bash
aliyun pai-dlc CreateJob # Error: should use create-job
aliyun pai-dlc ListJobs # Error: should use list-jobs
aliyun pai-dlc GetJob # Error: should use get-job
aliyun pai-dlc GetPodLogs # Error: should use get-pod-logs
```
## 3. Parameters — Verify Parameter Name Format
CORRECT (Lowercase with hyphens)
```bash
--job-id
--pod-id
--display-name
--job-type
--job-specs
--user-command
--workspace-id
--resource-id
--page-number
--page-size
--start-time
--end-time
--max-lines
--user-agent
```
INCORRECT (CamelCase or underscore)
```bash
--JobId # Error: should use --job-id
--jobId # Error: should use --job-id
--job_id # Error: should use --job-id
--displayName # Error: should use --display-name
--DisplayName # Error: should use --display-name
```
## 4. User-Agent — Must Include Identifier
CORRECT
```bash
aliyun pai-dlc list-jobs --region cn-hangzhou --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dlc-job/${SESSION_ID}
```
INCORRECT
```bash
aliyun pai-dlc list-jobs --region cn-hangzhou # Error: missing --user-agent
```
## 5. JobSpecs Format — Verify JSON Structure
CORRECT - Method 1: EcsSpec (Public Resources)
```bash
--job-specs '[{"Type":"Worker","PodCount":1,"Image":"registry.cn-hangzhou.aliyuncs.com/pai-dlc/pytorch:1.12","EcsSpec":"ecs.gn6i-c4g1.xlarge"}]'
```
CORRECT - Method 2: ResourceConfig (Dedicated Resource Group)
```bash
--job-specs '[{"Type":"Worker","Preferences/cli-installation-guide.md
# Aliyun CLI Installation & Configuration Guide
Complete guide for installing and configuring Aliyun CLI.
> **Aliyun CLI 3.3.1+**: Supports installing and using all published Alibaba Cloud product plugins. Make sure to upgrade to 3.3.1 or later for full functionality.
## Installation
### macOS
**Using Homebrew (Recommended)**
```bash
brew install aliyun-cli
# Upgrade to latest
brew upgrade aliyun-cli
# Verify version (>= 3.3.1)
aliyun version
```
**Using Binary**
```bash
# Download
wget https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-amd64.tgz
# Extract
tar -xzf aliyun-cli-macosx-latest-amd64.tgz
# Move to PATH
sudo mv aliyun /usr/local/bin/
# Verify
aliyun version
```
### Linux
**Debian/Ubuntu**
```bash
# Download
wget https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz
# Extract and install
tar -xzf aliyun-cli-linux-latest-amd64.tgz
sudo mv aliyun /usr/local/bin/
# Verify
aliyun version
```
**CentOS/RHEL**
```bash
# Download
wget https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz
# Extract and install
tar -xzf aliyun-cli-linux-latest-amd64.tgz
sudo mv aliyun /usr/local/bin/
# Verify
aliyun version
```
**ARM64 Architecture**
```bash
# Download ARM64 version
wget https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-arm64.tgz
# Extract and install
tar -xzf aliyun-cli-linux-latest-arm64.tgz
sudo mv aliyun /usr/local/bin/
```
### Windows
**Using Binary**
1. Download from: https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip
2. Extract the ZIP file
3. Add the directory to your PATH environment variable
4. Open new Command Prompt or PowerShell
5. Verify: `aliyun version`
**Using PowerShell**
```powershell
# Download
Invoke-WebRequest -Uri "https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip" -OutFile "aliyun-cli.zip"
# Extract
Expand-Archive -Path aliyun-cli.zip -DestinationPath C:\aliyun-cli
# Add to PATH (requires admin privileges)
$env:Path += ";C:\aliyun-cli"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [System.EnvironmentVariableTarget]::Machine)
# Verify
aliyun version
```
## User-Agent for Skill Calls (session-id)
> Do NOT use the deprecated `aliyun configure ai-mode` to set the User-Agent.
> Instead, pass `--user-agent` explicitly on every API-invoking command using
> the unified session-id template. See the `Observability` section in `SKILL.md`
> for the full rules.
```bash
# Generate the session-id ONCE per skill session, then reuse it everywhere
SESSION_ID=$(uuidgen | tr 'A-Z' 'a-z')
export SESSION_ID
# Every API-invoking command appends the templated User-Agent:
aliyun pai-dlc list-jobs --region cn-hangzhou --page-size 1 \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dlc-job/${SESSION_ID}
```
## Configuration
### Quick Start
```bash
aliyun configure set \
--mode AK \
--access-key-id <your-access-key-id> \
--access-key-secret <your-access-key-secret> \
--region cn-hangzhou
```
All `aliyun configure` commands support non-inreferences/job-management.md
# Job Lifecycle Management
Operational rules for `update-job` / `stop-job` / `get-web-terminal` /
`get-token` — focused on **what `--help` cannot tell you**: status windows,
silent-no-op cases, and the high-risk `stop-job` confirmation protocol.
For the full parameter list of any subcommand, run
`aliyun pai-dlc <cmd> --help`.
## 1. Status-to-Operation Compatibility
| Operation | Allowed Job Status | Caveat |
|-----------|--------------------|--------|
| `update-job --accessibility` | Any | Takes effect immediately |
| `update-job --description` | Any | Metadata only |
| `update-job --priority` | `Creating` / `Queuing` / `EnvPreparing` | **AND** job uses quota (`--resource-id`); once `Running`, cannot be modified |
| `update-job --job-specs` (PodCount) | Elastic-enabled jobs only | Restricted to supported phases |
| `stop-job` | `Running` / `Queuing` only | Irreversible — three-step protocol below |
| `get-web-terminal` | `Running` only | Pod must be alive |
| `get-token` | Any | Read-only sharing |
> **`update-job` does NOT expose `--display-name`** — to rename a job,
> recreate it.
## 2. `update-job --priority` Pre-check Protocol
Always probe both `Status` and `ResourceId` before issuing a priority update;
otherwise the API returns `200 OK` while silently dropping the change.
```bash
aliyun pai-dlc get-job \
--region <region> --job-id <job-id> \
--cli-query '{Status: Status, ResourceId: ResourceId}' \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dlc-job/${SESSION_ID}
```
Proceed **only if both** hold:
- `Status` ∈ `Creating` / `Queuing` / `EnvPreparing`
- `ResourceId` is non-empty (quota-based job, e.g. `quotaXXXX`)
After issuing the update, expect a 10–60 second propagation delay before
`get-job` reflects the new `Priority`.
## 3. `stop-job` — Three-Step Protocol (HIGH RISK)
Stopping a `Running` job discards in-memory progress unless the user's script
checkpoints. **Never call `stop-job` without explicit user confirmation.**
### Step 1 — Pre-check
```bash
aliyun pai-dlc get-job \
--region <region> --job-id <job-id> \
--cli-query '{Status: Status, Name: DisplayName}' \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dlc-job/${SESSION_ID}
```
### Step 2 — Confirm with the user
Present `Status` + `DisplayName`. Use this prompt template:
```
Job <job-id> ("<DisplayName>") is currently <Status>.
Stopping a Running job cannot be undone and will discard any in-memory progress.
Are you sure you want to stop this job? [yes/no]
```
Do NOT proceed without an explicit `yes`.
### Step 3 — Execute, then verify
```bash
aliyun pai-dlc stop-job --region <region> --job-id <job-id> \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dlc-job/${SESSION_ID}
# Verify (expected: "Stopped")
aliyun pai-dlc get-job --region <region> --job-id <job-id> \
--cli-query "Status" \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dlc-job/${SESSION_ID}
```
## 4. `get-web-terminal`
Requires the Pod to be alAionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/sdk-team/skills/alibabacloud-pai-dlc-job",
"sourceUrl": "https://clawhub.ai/sdk-team/skills/alibabacloud-pai-dlc-job",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T20:37:34.675Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-pai-dlc-job/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-pai-dlc-job/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T20:37:34.675Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/sdk-team/alibabacloud-pai-dlc-job",
"sourceUrl": "https://clawhub.ai/sdk-team/alibabacloud-pai-dlc-job",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T20:37:34.675Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.0.2",
"href": "https://clawhub.ai/sdk-team/alibabacloud-pai-dlc-job",
"sourceUrl": "https://clawhub.ai/sdk-team/alibabacloud-pai-dlc-job",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-14T08:38:10.094Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-pai-dlc-job/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-pai-dlc-job/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.0.2",
"description": "- Added session-based User-Agent flag with {session-id} template to all API-invoking commands for unified observability and traceability. - Deprecated use of `aliyun configure ai-mode` for User-Agent; now all `--user-agent` flags must be passed explicitly per command. - Updated installation and usage instructions in SKILL.md to reflect new User-Agent and session tracking requirements. - Expanded observability guidance, including session-id generation and export rules. - Removed obsolete helper steps and documentation (e.g., skill-card.md, deprecated ai-mode instructions).",
"href": "https://clawhub.ai/sdk-team/alibabacloud-pai-dlc-job",
"sourceUrl": "https://clawhub.ai/sdk-team/alibabacloud-pai-dlc-job",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-14T08:38:10.094Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
