/install aliyun-dns-cli
Category: tool
Alibaba Cloud DNS (Alidns) CLI
Goals
- Query and manage Alibaba Cloud DNS records via
aliyun-cli. - Quickly configure CNAME for Function Compute custom domains.
When to Use
- When you need to add/update DNS records in Alibaba Cloud DNS.
- When you need CNAME setup for FC custom domains.
Install aliyun-cli (without sudo)
curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o /tmp/aliyun-cli.tgz
mkdir -p ~/.local/bin
tar -xzf /tmp/aliyun-cli.tgz -C /tmp
mv /tmp/aliyun ~/.local/bin/aliyun
chmod +x ~/.local/bin/aliyun
Configure Credentials
~/.local/bin/aliyun configure set \
--profile default \
--access-key-id \x3CAK> \
--access-key-secret \x3CSK> \
--region cn-hangzhou
Configure region as default; if best region is unclear, ask the user.
Query DNS Records
Query subdomain records:
~/.local/bin/aliyun alidns DescribeSubDomainRecords \
--SubDomain news.example.com
Add CNAME Record
~/.local/bin/aliyun alidns AddDomainRecord \
--DomainName example.com \
--RR news \
--Type CNAME \
--Value \x3CTARGET>
FC Custom Domain CNAME Target
Custom domain should point to FC public CNAME:
\x3Caccount_id>.\x3Cregion_id>.fc.aliyuncs.com
Example (Hangzhou):
1629965279769872.cn-hangzhou.fc.aliyuncs.com
Common Issues
- If apex CNAME is not supported, use subdomain like
wwwor ALIAS/ANAME records. - Create FC custom domain only after DNS propagation, otherwise
DomainNameNotResolvedmay occur.
References
-
aliyun-cli installation
-
Alidns API(AddDomainRecord / DescribeSubDomainRecords)
-
FC custom domain configuration and CNAME guidance
-
Official source list:
references/sources.md
Validation
mkdir -p output/aliyun-dns-cli
echo "validation_placeholder" > output/aliyun-dns-cli/validate.txt
Pass criteria: command exits 0 and output/aliyun-dns-cli/validate.txt is generated.
Output And Evidence
- Save artifacts, command outputs, and API response summaries under
output/aliyun-dns-cli/. - Include key parameters (region/resource id/time range) in evidence files for reproducibility.
Prerequisites
- Configure least-privilege Alibaba Cloud credentials before execution.
- Prefer environment variables:
ALICLOUD_ACCESS_KEY_ID,ALICLOUD_ACCESS_KEY_SECRET, optionalALICLOUD_REGION_ID. - If region is unclear, ask the user before running mutating operations.
Workflow
- Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
- Run one minimal read-only query first to verify connectivity and permissions.
- Execute the target operation with explicit parameters and bounded scope.
- Verify results and save output/evidence files.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install aliyun-dns-cli - After installation, invoke the skill by name or use
/aliyun-dns-cli - Provide required inputs per the skill's parameter spec and get structured output
What is Aliyun Dns Cli?
Use when you need to query, add, and update DNS records via aliyun-cli, including CNAME setup for Function Compute custom domains. It is an AI Agent Skill for Claude Code / OpenClaw, with 106 downloads so far.
How do I install Aliyun Dns Cli?
Run "/install aliyun-dns-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Aliyun Dns Cli free?
Yes, Aliyun Dns Cli is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Aliyun Dns Cli support?
Aliyun Dns Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Aliyun Dns Cli?
It is built and maintained by cinience (@cinience); the current version is v1.0.0.