| name | install-openclaw |
| description | Install and configure OpenClaw non-interactively with Alibaba Cloud Model Studio. Use when the user asks to install OpenClaw, configure Aliyun Bailian/Model Studio/DashScope credentials, choose pay-as-you-go, Coding Plan, or Token Plan billing, set Base URL/model config, optionally configure DingTalk, start the local gateway service, or troubleshoot OpenClaw model/auth/channel setup. |
OpenClaw Non-Interactive Setup
Use this skill to turn a user's one-sentence request into a complete local OpenClaw setup. The normal path is one script command: resolve the Alibaba Cloud Model Studio plan, validate the API key/Base URL/model combination with the official anthropic-messages endpoint shape, install Node.js/npm/OpenClaw when needed, write config, install/restart the local gateway service, and verify a real local openclaw agent message through Gateway.
Do not execute openclaw onboard unless the user explicitly asks for interactive setup or asks to skip first-run BOOTSTRAP onboarding. After setup, always tell the user they can run openclaw onboard --skip-bootstrap if they want the first real task to run without the introductory BOOTSTRAP flow. Do not configure DingTalk unless the user provides DingTalk credentials or asks for DingTalk access.
Billing
Map user wording to --billing:
| User says | Use |
|---|
| 按量付费, 后付费, DashScope, 百炼 API Key | payg |
| Coding Plan, 订阅 coding, Coding Plan 专属 API Key | coding |
| Token Plan, 团队版, token 订阅 | token |
Do not infer Coding Plan or Token Plan only from a raw API key string. A normal
Alibaba Cloud Model Studio/DashScope/百炼 API Key is pay-as-you-go unless the
user explicitly says Coding Plan or Token Plan.
Default to --billing payg --region china when the user does not specify billing or region. If the user gives no API key and no usable environment variable, ask for the key and include the matching source URL:
Use --region singapore only for pay-as-you-go Singapore. If the user gives a custom Alibaba Cloud compatible endpoint, pass it through with --base-url; otherwise use the billing-specific defaults from the official OpenClaw guide. For deeper billing details, read references/aliyun-model-studio-openclaw.md.
Execute
If the user asks to install OpenClaw but has not provided an API key, run the
basic dependency precheck first:
python3 /home/ecs-user/.copilot-shell/skills/install-openclaw/scripts/install_openclaw.py \
--billing payg \
--precheck-only
After precheck passes, tell the user the matching API key source URL printed by
the script. If the user already provided an API key, run the full install
directly; the script performs the same dependency precheck before installing.
Run exactly this script from the installed skill directory for full install:
python3 /home/ecs-user/.copilot-shell/skills/install-openclaw/scripts/install_openclaw.py \
--billing payg \
--api-key "$BAILIAN_API_KEY"
If this skill is installed under a different agent home, keep the same relative script path:
python3 <install-openclaw-skill-dir>/scripts/install_openclaw.py ...
The authoritative implementation is scripts/install_openclaw.py.
The normal parameters are --billing, --api-key, --api-key-env, --region,
--base-url, --model-id, --npm-registry, --dry-run, --precheck-only,
--skip-preflight, --skip-tokenless, and DingTalk-specific flags.
Examples
Pay-as-you-go:
python3 /home/ecs-user/.copilot-shell/skills/install-openclaw/scripts/install_openclaw.py \
--billing payg \
--api-key "$BAILIAN_API_KEY"
Coding Plan:
python3 /home/ecs-user/.copilot-shell/skills/install-openclaw/scripts/install_openclaw.py \
--billing coding \
--api-key "$CODING_PLAN_API_KEY"
Token Plan:
python3 /home/ecs-user/.copilot-shell/skills/install-openclaw/scripts/install_openclaw.py \
--billing token \
--api-key "$BAILIAN_TOKEN_PLAN_API_KEY"
Prefer --api-key-env NAME when an environment variable already contains the key:
python3 /home/ecs-user/.copilot-shell/skills/install-openclaw/scripts/install_openclaw.py \
--billing payg \
--api-key-env BAILIAN_API_KEY
Custom endpoint:
python3 /home/ecs-user/.copilot-shell/skills/install-openclaw/scripts/install_openclaw.py \
--billing payg \
--api-key-env BAILIAN_API_KEY \
--base-url "https://dashscope.aliyuncs.com/apps/anthropic"
With DingTalk:
python3 /home/ecs-user/.copilot-shell/skills/install-openclaw/scripts/install_openclaw.py \
--billing coding \
--api-key-env CODING_PLAN_API_KEY \
--dingtalk-client-id "dingxxxxxx" \
--dingtalk-client-secret "$DINGTALK_CLIENT_SECRET" \
--install-dingtalk-plugin
What The Script Does
- Checks Node.js/npm and installs them with
dnf/yum when needed.
- Runs dependency precheck before installing or writing config.
- Runs a model endpoint pre-flight check before writing config or starting Gateway. It uses the official Alibaba Cloud OpenClaw
anthropic-messages shape and validates the resolved API key, Base URL, and model ID. Pass --skip-preflight only when the endpoint is temporarily unreachable and the user accepts deferring validation to Gateway startup.
- With
--dry-run, still resolves config and runs the model pre-flight check, but skips local install/config/gateway changes. Combine with --skip-preflight only for an offline local-flow preview.
- With
--precheck-only, checks only local dependencies and prints the API key source; it does not require or validate an API key.
- Installs OpenClaw with npm unless
--skip-install-openclaw is passed.
- Uses npm registry
https://registry.npmmirror.com by default; override with --npm-registry.
- Writes only OpenClaw schema-supported config fields.
- Writes Alibaba Cloud Model Studio config with
api = anthropic-messages.
- Sets
gateway.mode = local, gateway.bind = loopback, and gateway.auth.mode = none for local single-machine setup.
- Starts OpenClaw through
openclaw gateway install and openclaw gateway restart unless --skip-gateway is passed.
- After the Gateway port is listening, runs a bounded local message smoke test to verify the local operator device has
operator.write. If stale read-only local operator device state exists, the script clears it and retries the message smoke test.
- If the gateway port is occupied by OpenClaw, it clears that stale listener. If the port is occupied by another process, it stops and prints the process details for the user to decide.
- Auto-installs the tokenless OpenClaw plugin after OpenClaw is installed, for token usage tracking and response compression. Pass
--skip-tokenless to opt out.
- Prints first-run BOOTSTRAP guidance by default. Tell the user
openclaw onboard --skip-bootstrap keeps the first real task from being interrupted by OpenClaw's introductory BOOTSTRAP.md flow, and that they can still adjust IDENTITY.md, USER.md, and SOUL.md later under the OpenClaw workspace.
Verify
The script prints useful checks. Prefer:
openclaw models list
openclaw agent --message "hello" --agent main
openclaw gateway health
openclaw status
The script already runs the message smoke test unless --skip-gateway-write-check is passed. Do not treat EMBEDDED FALLBACK as success; if it mentions pairing required, scope upgrade pending approval, or missing scope: operator.write, read references/troubleshooting.md.
References
- Standard Alibaba Cloud OpenClaw guide: https://help.aliyun.com/zh/model-studio/openclaw
- Read
references/aliyun-model-studio-openclaw.md for the billing matrix and API key source URLs.
- Read
references/dingtalk-setup-guide.md only when configuring DingTalk.
- Read
references/troubleshooting.md when model/auth/channel checks fail.
