Imported from huaweicloud/huaweicloud-skills (skills/computing/flexus-l/huawei-cloud-flexus-l-server-openclaw-deployment/SKILL.md). Install upstream with npx skills add huaweicloud/huaweicloud-skills --skill huawei-cloud-flexus-l-server-openclaw-deployment. Copyright stays with the author.

⚠️ Security Execution Rules (Highest Priority):

1. All scripts MUST be executed via skill action=exec, NEVER run directly in shell
2. NEVER print script contents or commands containing AK/SK/Token in conversation
3. NEVER create temporary script files, prefer inline execution (python -c)
4. On execution failure, only return error info, do NOT rewrite scripts or print full commands
5. AK/SK/Token MUST be passed via environment variables, NEVER appear in conversation
6. ABSOLUTELY NEVER expose, log, or print AK/SK/Token values in any form - this is a critical security requirement
7. When using skill action=exec, credentials are automatically inherited from environment variables (HW_ACCESS_KEY, HW_SECRET_KEY, HW_SECURITY_TOKEN), no need to pass them as command line arguments

huawei-cloud-flexus-l-server-openclaw-deployment

Overview

This skill supports one-click deployment of the OpenClaw AI Agent platform to Huawei Cloud Flexus L Instance. It provides a complete OpenClaw instance management workflow, from initial deployment to post-deployment configuration, including:

• Automated instance creation
• Model installation via COC (Cloud Operations Center)
• Channel installation via COC (WeCom, Feishu, DingTalk, QQ)
• Automatic prerequisite checks before installation (Gateway and UniAgent status)

Use Cases

Typical Use Cases

User may say:

1. "I want to install OpenClaw on a Flexus L instance"
2. "I want to configure DeepSeek model on my deployed OpenClaw"
3. "Help me deploy OpenClaw with Feishu channel configured"

Prerequisites

Account Requirements

• Huawei Cloud AK/SK credentials with the following permissions:
  • Create Flexus L Instances
  • Access COC (Cloud Operations Center) services

Credential Acquisition Methods:

This skill supports obtaining Huawei Cloud credentials through the following methods (in order of priority from high to low):

Credential Types:

• Long-term AK/SK: Permanent credentials, no security_token required
• Temporary AK/SK: Temporary credentials with limited validity period, security_token required

1. Environment Variables (Default) (highest priority)

   • HW_ACCESS_KEY: Huawei Cloud Access Key AK
   • HW_SECRET_KEY: Huawei Cloud Access Key SK
   • HW_SECURITY_TOKEN: Security token (optional, only required for temporary credentials)

2. User-specified Configuration File or Other Environment Variables (used when default environment variables are not available)

   • Configuration file path or other environment variables specified by user during interaction

3. Interactive Input (when neither of the above methods is provided)

   • The program will prompt the user to enter AK/SK and other credential information

Important Notes:

• Long-term AK/SK: Permanent credentials that never expire, no security_token needed
• Temporary AK/SK: Obtained through IAM interface with limited validity period, must provide security_token

Architecture Diagram

This skill is built on multiple Huawei Cloud services, involving the following cloud services and components:

User/Agent      ──────▶│   Flexus L Instance   │──────▶│   OpenClaw App    │──────▶│ Model Config     │ ──────▶│  Channel Config     │ 
(Skill caller)           (Target Host)               (AI Agent Platform)          (API_BASE/KEY)       (WeCom/Feishu/DingTalk/QQ)            

Component Description:

• User/Agent: Skill caller that triggers OpenClaw deployment operations via natural language or API
• Flexus L Instance: Huawei Cloud Elastic Cloud Server, serving as the target host for OpenClaw deployment
• OpenClaw App: AI Agent collaboration platform running on the Flexus L instance
• Model Config: Configuration for external LLM services (API_BASE, API_KEY, MODEL_IDS, PROVIDER)
• Channel Config: Messaging channel configuration (WeCom, Feishu, DingTalk, QQ)

How to Use This Skill

Command Execution and Instructions

1. Deploy OpenClaw Instance (Create Huawei Cloud Flexus L Instance and deploy OpenClaw AI Agent platform) - Two Command Modes:

Command 1: Interactive Mode (The program will prompt for required parameters step by step)

python scripts/caller.py deploy

Command 2: Non-Interactive Mode

# Using long-term AK/SK (no security-token needed)
python scripts/caller.py deploy --name openclaw-{timestamp} --region cn-north-4 --ak <AK> --sk <SK> --non-interactive

# Using temporary AK/SK (security-token required)
python scripts/caller.py deploy --name openclaw-{timestamp} --region cn-north-4 --ak <Temporary AK> --sk <Temporary SK> --security-token <Security Token> --non-interactive

Parameter Description:

Note: OpenClaw only supports deployment in the following regions before June 2026 (before deploying to other regions, you can remind users to check the official website for the latest supported regions): China North-Beijing-4 (cn-north-4), China East-Shanghai-1 (cn-east-3), China South-Guangzhou (cn-south-1), China Southwest-Guiyang-1 (cn-southwest-2)

Command Examples:

# Example 1: Deploy with default configuration (interactive, will prompt for required parameters)
python scripts/caller.py deploy

# Example 2: Non-interactive mode deployment (suitable for automation scripts, creates directly without user confirmation)
python scripts/caller.py deploy --name openclaw-1780689482000 --region cn-north-4 --ak <Temporary AK> --sk <Temporary SK> --security-token <Security Token> --non-interactive

Default Configuration for Huawei Cloud Flexus L Instance when Deploying OpenClaw Instance

Execution Result and Status Code Description:

• On success, returns order ID and instance ID (resource ID, used for subsequent model and channel installation)
• Instance creation takes approximately 2 minutes, progress can be viewed in Huawei Cloud console. During instance creation, the installation of models and channels will not be affected, and subsequent commands can be executed directly. Status Code Description: Status codes "200", "201", "202" all indicate successful instance creation.

2. Configure (Install) Large Model Parameters on L Instance with OpenClaw Installed - Two Command Modes (Requires deploying OpenClaw instance first)

Command 1: Interactive Mode (The program will prompt for resource ID, region, model and other parameters step by step)

python scripts/caller.py maas

Command 2: Non-Interactive Mode

# Using long-term AK/SK (no security-token needed)
python scripts/caller.py maas --resource-id <Instance Resource ID> --region-id cn-north-4 --model-params '<Model configuration parameters>' --ak <AK> --sk <SK> --non-interactive

# Using temporary AK/SK (security-token required)
python scripts/caller.py maas --resource-id <Instance Resource ID> --region-id cn-north-4 --model-params '<Model configuration parameters>' --ak <Temporary AK> --sk <Temporary SK> --security-token <Security Token> --non-interactive

Parameter Description:

model-params Field Description:

Command Examples:

# Example 1: Install Huawei Cloud MaaS platform models with long-term AK/SK
python scripts/caller.py maas \
  --resource-id 0e1234567890abcdef \
  --region-id cn-north-4 \
  --model-params '{"provider":"huawei","api_key":"your_maas_api_key","model_ids":["deepseek-v3.2","qwen3-235b-a22b"]}' \
  --ak <Temporary AK> --sk <Temporary SK> --security-token <Security Token> --non-interactive

# Example 2: Install Huawei Cloud MaaS platform models with temporary AK/SK
python scripts/caller.py maas \
  --resource-id 0e1234567890abcdef \
  --region-id cn-north-4 \
  --model-params '{"provider":"huawei","api_key":"your_maas_api_key","model_ids":["deepseek-v3.2","qwen3-235b-a22b"]}' \
  --ak <Temporary AK> --sk <Temporary SK> --security-token <Security Token> --non-interactive

# Example 3: Install custom OpenAI compatible models with long-term AK/SK
python scripts/caller.py maas \
  --resource-id 0e1234567890abcdef \
  --region-id cn-north-4 \
  --model-params '{"provider":"https://api.openai.com/v1","api_key":"your_openai_key","model_ids":["gpt-4"]}' \
  --ak <Temporary AK> --sk <Temporary SK> --security-token <Security Token> --non-interactive

Status Code Description: Status codes "200", "201", "202" all indicate successful model installation.

3. channel - Configure (Install) Channels on L Instance with OpenClaw Installed - Two Command Modes (Requires deploying OpenClaw instance first)

Command 1: Interactive Mode

python scripts/caller.py channel

Command 2: Non-Interactive Mode

# Using long-term AK/SK (no security-token needed)
python scripts/caller.py channel --resource-id <Instance Resource ID> --region-id cn-north-4 --channel-list '<JSON array>' --ak <AK> --sk <SK> --non-interactive

# Using temporary AK/SK (security-token required)
python scripts/caller.py channel --resource-id <Instance Resource ID> --region-id cn-north-4 --channel-list '<JSON array>' --ak <Temporary AK> --sk <Temporary SK> --security-token <Security Token> --non-interactive

Parameter Description:

channel JSON Object Field Description:

Command Examples:

# Example 1: Install multiple channels (WeCom + Feishu) using long-term AK/SK
python scripts/caller.py channel \
  --resource-id 0e1234567890abcdef \
  --region-id cn-north-4 \
  --channel-list '[{"channel":"wecom","id":"xxx","secret":"xxx"},{"channel":"feishu","id":"yyy","secret":"yyy"}]' \
  --ak <AK> --sk <SK> --non-interactive

# Example 2: Install multiple channels (WeCom + Feishu) using temporary AK/SK
python scripts/caller.py channel \
  --resource-id 0e1234567890abcdef \
  --region-id cn-north-4 \
  --channel-list '[{"channel":"wecom","id":"xxx","secret":"xxx"},{"channel":"feishu","id":"yyy","secret":"yyy"}]' \
  --ak <Temporary AK> --sk <Temporary SK> --security-token <Security Token> --non-interactive

Status Code Description: Status codes "200", "201", "202" all indicate successful channel installation.

Web UI Access

Web UI access needs to be manually enabled in Huawei Cloud console, operation steps:

1. Log in to Huawei Cloud Flexus Application Server L Instance Console
   • 🔗 Console URL: https://console.huaweicloud.com/smb/?/resource/list
2. Find your OpenClaw instance in the instance list
3. Click the instance name to enter the details page
4. In the left menu of the details page, find and click "Application Details" option, then enter the "Basic Configuration" tab
5. In the "Basic Configuration" tab, find the "Access OpenClaw Web Interface" option at the top left, click the "Enable" button. You will then get the URL address to access the OpenClaw Web interface.

Code Structure, File Responsibilities and Key Functions

This skill uses a modular architecture for easier maintenance:

scripts/
├── caller.py          # Main entry - command line argument parsing, parameter parsing, command routing
├── lib.py             # Core library - L instance creation, COC script management
├── utils.py           # Utility functions - input prompts, credential configuration, region information
├── deploy.py          # Deployment module - `do_deploy_openclaw()` function for OpenClaw instance creation
├── models.py          # Model module - remote COC large model installation (with prerequisite checks), related functions `do_install_maas()`, `_check_prerequisites()`
├── channels.py        # Channel module - remote COC channel installation (with prerequisite checks), related functions `do_install_channel()`, `_check_prerequisites()`
├── gateway.py         # Gateway module - gateway status query (only for prerequisite checks), related functions `do_check_gateway()`
└── uniagent.py        # UniAgent module - UniAgent status query (only for prerequisite checks), `do_check_uniagent()`

Parameter Confirmation

Deployment Parameters

• --name: OpenClaw instance name, optional parameter, default is openclaw-{timestamp}
• --region: Target region ID, optional parameter, default is cn-north-4
• --ak: Huawei Cloud temporary Access Key AK, required parameter
• --sk: Huawei Cloud temporary Access Key SK, required parameter
• --security-token: Security token for temporary credentials (required), required parameter
• --non-interactive: Enable non-interactive mode, optional parameter

Model Configuration Parameters

• --resource-id: L instance resource ID (instance ID returned after deploying OpenClaw instance), required parameter
• --region-id: Region ID where L instance is located, consistent with the region selected when deploying the instance, required parameter
• --model-params: Model configuration parameters (JSON format), required parameter
  • provider: Model provider name (e.g., "huawei") or API address (e.g., "https://api.openai.com/v1")
  • api_key: Model API key
  • model_ids: Array of model IDs to install (non-empty)
• --ak: Huawei Cloud temporary Access Key AK, required parameter
• --sk: Huawei Cloud temporary Access Key SK, required parameter
• --security-token: Security token for temporary credentials (required), required parameter
• --timeout: Script execution timeout (seconds), optional parameter, default 600 seconds

Channel Configuration Parameters

• --resource-id: L instance resource ID (instance ID returned after deploying OpenClaw instance), required parameter
• --region-id: Region ID where L instance is located, consistent with the region selected when deploying the instance, required parameter
• --channel-list: Channel configuration (JSON array format), optional parameter
  • channel: Channel type: wecom (WeCom), feishu (Feishu), dingtalk (DingTalk), qqbot (QQ), required
  • id: Bot ID, required
  • secret: Bot secret, required
• --ak: Huawei Cloud temporary Access Key AK, required parameter
• --sk: Huawei Cloud temporary Access Key SK, required parameter
• --security-token: Security token for temporary credentials (required), required parameter
• --timeout: Script execution timeout (seconds), optional parameter, default 600 seconds

Environment Variable Support

All parameters can also be provided through environment variables:

• HW_ACCESS_KEY: Huawei Cloud AK (corresponds to --ak parameter)
• HW_SECRET_KEY: Huawei Cloud SK (corresponds to --sk parameter)
• HW_SECURITY_TOKEN: Temporary credential security token (corresponds to --security-token parameter)
• HW_PROJECT_ID: Huawei Cloud Project ID (optional)

Common Issues Quick Solutions