一文掌握OpenClaw核心命令：阿里云/本地部署、大模型API配置+高效使用攻略

OpenClaw（曾用名Clawdbot）作为2026年主流的开源AI智能体框架，其强大的功能依赖简洁高效的命令行操作。无论是初始化配置、服务管理、模型切换，还是渠道对接、技能安装，核心操作都可通过命令快速实现。对于新手而言，熟练掌握常用命令是解锁OpenClaw全部能力的基础；而规范的部署流程与精准的API配置，则是确保命令正常执行、服务稳定运行的前提。

本文结合2026年最新版本特性，系统整理OpenClaw全场景核心命令（按功能分类，附实操示例），完整拆解阿里云及本地MacOS/Linux/Windows11部署流程，详解阿里云千问与免费大模型API配置方法，并附上命令使用与部署相关的常见问题解答，所有代码命令可直接复制执行，助力用户从入门到精通，高效操控OpenClaw。目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

一、OpenClaw命令体系核心逻辑

OpenClaw的命令设计遵循“功能模块化、操作简洁化”原则，核心命令可按使用场景分为十大类，覆盖从初始化到卸载的全生命周期操作。其核心逻辑在于：通过命令行实现对“配置、服务、模型、渠道、技能”等核心模块的精准控制，同时提供交互式引导与自动诊断功能，降低新手使用门槛。

命令使用核心原则：

1. 全局参数通用：所有命令均可搭配--json（JSON格式输出）、--dev（开发模式）、-V（查看版本）等全局参数；
2. 高频命令优先：doctor（自动诊断）、tui（终端聊天）、dashboard（网页控制台）、gateway restart（重启服务）为日常使用频率最高的命令，建议优先掌握；
3. 配置修改必重启：修改任何核心配置后，需执行openclaw gateway restart使配置生效，否则修改不生效。

二、2026年OpenClaw全平台部署流程

部署是命令使用的基础，OpenClaw支持阿里云云端7×24小时部署与本地多系统部署，两种方式均能完美支持所有命令操作，以下为详细实操步骤。

（一）部署前置通用准备

1. 账号与权限：阿里云部署需 注册阿里云账号 完成实名认证，开通轻量应用服务器、访问登录阿里云百炼大模型服务平台 开通百炼大模型服务；本地部署需获取设备管理员/root权限。
2. 基础工具：全平台需安装Node.js（≥22.0.0 LTS版）、Git（≥2.40.0），国内用户建议配置npm国内镜像加速依赖下载：

   # 配置npm国内镜像（全平台通用）
   npm config set registry https://registry.npmmirror.com
   # 验证配置是否生效
   npm config get registry
   

3. 硬件与网络：阿里云部署推荐最低2核2GB内存、40GB ESSD存储；本地部署需CPU≥2核、内存≥4GB、硬盘剩余空间≥10GB；网络需确保能正常访问大模型API地址。
4. 端口准备：需开放18789端口（Web控制台访问）、3000端口（Gateway服务），阿里云部署需在安全组配置，本地部署需在防火墙开放。

（二）阿里云部署流程：命令行快速部署

1. 服务器实例创建：
   • 登录阿里云控制台，访问阿里云轻量应用服务器控制台，选择“应用镜像”→“OpenClaw（Clawdbot）官方稳定版”；
   • 实例规格选择2核2GB内存、40GB ESSD存储，地域优先选择中国香港、新加坡等免备案节点，国内用户可选择华东1（杭州）、华北2（北京）（需完成ICP备案）；
   • 设置登录密码，确认订单并支付，等待3-5分钟，实例状态变为“运行中”即创建完成。

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

第一步：打开访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。

第二步：打开选购阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

• 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
  
• 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
  
• 在服务器概览页面单击应用详情页签，进入服务器详情页面。
  
• 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
  
• 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
  
• 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
  
  

1. 命令行初始化与服务启动：
   • 通过Web终端或SSH登录服务器，执行以下命令：

     # 验证OpenClaw是否预装成功
     openclaw --version
     # 交互式引导配置（新手首选）
     openclaw onboard
     # 依次选择：同意协议→快速启动→暂不配置模型→启用全部通道
     # 启动网关服务
     openclaw gateway start
     # 设置开机自启（安装为系统服务）
     openclaw gateway install
     # 查看服务状态
     openclaw gateway status
     

2. 访问验证：执行openclaw dashboard，在本地浏览器中输入http://服务器公网IP:18789，即可打开Web控制台，部署成功。

（三）本地MacOS部署流程（适配MacOS 12+）

1. 基础环境验证与安装：

   # 验证Node.js版本（需≥22.0.0）
   node -v
   # 验证Git版本（需≥2.40.0）
   git --version
   # 若未安装，通过brew安装（M系列芯片需先安装brew）
   brew install node@22 git docker
   # 启动Docker（推荐容器化运行）
   open -a Docker
   

2. OpenClaw安装与初始化：

   # 全局安装OpenClaw
   npm install -g openclaw
   # 验证安装成功
   openclaw --version
   # 一键初始化配置
   openclaw setup
   

3. 服务启动与访问：

   # 启动网关服务
   openclaw gateway start
   # 查看服务状态
   openclaw gateway status
   # 打开Web控制台
   openclaw dashboard
   

   浏览器自动跳转至http://127.0.0.1:18789，进入控制台即完成部署。

（四）本地Linux部署流程（以Ubuntu 22.04为例）

1. 系统依赖安装：

   # 更新系统软件包
   sudo apt update && sudo apt upgrade -y
   # 安装基础工具
   sudo apt install -y git curl wget
   # 安装Node.js 22.x版本
   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
   sudo apt install -y nodejs
   # 安装Docker并设置开机自启
   sudo apt install -y docker.io
   sudo systemctl start docker && sudo systemctl enable docker
   sudo usermod -aG docker $USER
   newgrp docker
   

2. OpenClaw安装与启动：

   npm install -g openclaw
   openclaw --version
   # 交互式配置
   openclaw onboard
   # 启动网关服务
   openclaw gateway start
   # 安装为系统服务（开机自启）
   sudo openclaw gateway install
   

   执行openclaw dashboard，浏览器输入http://127.0.0.1:18789，部署成功。

（五）本地Windows11部署流程（推荐WSL2）

1. WSL2安装与配置：

   # 管理员模式PowerShell执行，安装Ubuntu 22.04子系统
   wsl --install -d Ubuntu-22.04
   

   安装完成后重启电脑，打开Ubuntu子系统完成初始化，安装Docker Desktop并开启“WSL2后端”。
2. OpenClaw安装：

   # 在Ubuntu子系统中执行
   npm config set registry https://registry.npmmirror.com
   npm install -g openclaw
   openclaw --version
   openclaw setup
   

3. 服务启动与访问：

   openclaw gateway start
   openclaw dashboard
   

   在Windows11浏览器中输入http://127.0.0.1:18789，进入控制台即可。若不使用WSL2，可直接在管理员PowerShell中执行：

   # 解锁脚本执行权限
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   # 原生Windows一键安装
   iwr -useb https://openclaw.ai/install.ps1 | iex
   

三、大模型API配置：命令行实操指南

OpenClaw的核心功能依赖大模型API，通过命令行可快速完成模型配置、密钥添加、默认模型切换等操作，以下为阿里云千问与免费大模型的配置步骤。

（一）阿里云千问大模型API配置（首选方案）

1. API-Key获取：
   • 登录阿里云百炼大模型控制台，完成实名认证；
   • 进入“密钥管理”页面，点击“创建API-Key”，生成并复制API-Key与AccessKey Secret。
2. 命令行配置：

   # 添加阿里云千问模型提供商密钥
   openclaw models auth add bailian
   # 按提示输入API-Key与AccessKey Secret
   # 设置默认模型为阿里云千问Qwen3-Mini
   openclaw models set bailian/qwen3-mini
   # 查看模型配置状态
   openclaw models status
   # 测试模型连接
   openclaw model test
   # 重启服务使配置生效
   openclaw gateway restart
   

（二）免费大模型Coding Plan API配置（零成本替代）

1. 免费API-Key获取：
   • DeepSeek：访问https://platform.deepseek.com/api-keys，完成实名认证后生成API-Key；
   • 其他平台：智谱GLM-5、Moonshot Kimi等均提供免费额度，可按需选择。
2. 命令行配置（以DeepSeek为例）：

   # 添加DeepSeek模型提供商密钥
   openclaw models auth add deepseek
   # 按提示输入免费API-Key
   # 设置默认模型为DeepSeek
   openclaw models set deepseek/deepseek-chat
   # 查看所有可用模型
   openclaw models list
   # 测试模型连接
   openclaw model test
   # 重启服务
   openclaw gateway restart
   

四、OpenClaw核心命令大全（分类详解+实操示例）

以下按功能分类整理OpenClaw核心命令，包含详细说明与实操示例，所有命令全平台通用，可直接复制执行。

（一）初始化与配置命令

用于完成OpenClaw的基础配置、参数修改与配置文件管理，新手优先使用交互式配置。

（二）诊断与维护命令

用于排查问题、查看服务状态、日志分析与安全审计，遇到任何问题优先执行openclaw doctor。

（三）网关服务命令

用于Gateway服务的启动、停止、重启与开机自启配置，是最常用的命令类别之一。

（四）渠道管理命令

用于配置飞书、微信、Telegram等消息渠道，实现多端交互。

（五）AI模型管理命令

用于模型切换、密钥管理、备用模型配置，支持多模型灵活切换。

常用模型格式参考：

• 阿里云千问：bailian/qwen3-mini、bailian/qwen3-max
• DeepSeek：deepseek/deepseek-chat
• OpenAI：openai/gpt-4o
• Anthropic：anthropic/claude-opus-4-6

（六）会话与消息命令

用于管理会话、发送消息、启动交互式聊天界面，是日常使用的核心命令。

（七）工具与自动化命令

用于管理定时任务、技能、插件，实现自动化操作。

技能安装特殊说明：安装Skills需使用npm命令，而非OpenClaw原生命令，示例：

# 安装WPS技能
npx skills add jvy/wps -g -y

（八）节点管理命令

用于管理分布式节点，实现多设备协同。

（九）备份与安全命令

用于数据备份、安全审计、密钥管理，保障使用安全。

（十）重置与卸载命令

用于重置配置或完全卸载OpenClaw。

卸载说明：完全卸载推荐使用openclaw-killer工具，确保残留文件彻底清除。

五、全场景常见问题解答

（一）部署相关问题

1. 问题：执行openclaw --version提示“command not found”
   解决办法：① 检查Node.js版本是否≥22.0.0，低版本不支持，需升级；② 重新执行安装命令并强制安装：npm install -g openclaw --force；③ 将npm全局路径添加至系统环境变量，路径查询命令：npm config get prefix；④ MacOS/Linux执行source ~/.bashrc刷新环境变量，Windows11重启终端。

2. 问题：执行openclaw gateway start提示“端口被占用”
   解决办法：① 查看端口占用情况：MacOS/Linux执行lsof -i :18789，Windows11执行netstat -ano | findstr :18789；② 结束占用进程：MacOS/Linux执行kill -9 进程ID，Windows11执行taskkill /F /PID 进程ID；③ 更换端口：openclaw config set gateway.port 18790，重启服务。

（二）命令使用相关问题

1. 问题：修改配置后执行命令无效果
   解决办法：① 确认修改后已执行openclaw gateway restart重启服务；② 执行openclaw config get <key>验证配置是否修改成功；③ 若配置项不存在，检查key是否正确（可参考官方文档的配置项列表）。

2. 问题：执行openclaw models test提示“模型调用失败”
   解决办法：① 执行openclaw models status检查密钥是否配置正确；② 确认API-Key未过期，免费大模型需检查额度是否充足；③ 测试网络连通性：curl 模型调用地址（如阿里云千问地址https://dashscope.aliyuncs.com/api/v1）；④ 执行openclaw doctor自动诊断修复。

3. 问题：启动openclaw tui提示“终端界面无法显示”
   解决办法：① 确保终端支持UTF-8编码，MacOS/Linux默认支持，Windows11需在Ubuntu子系统或PowerShell中执行；② 升级OpenClaw至最新版本：openclaw update；③ 若仍无法显示，改用openclaw dashboard通过网页控制台操作。

（三）技能与插件相关问题

1. 问题：执行npx skills add <name>提示“网络超时”
   解决办法：① 确认npm镜像为国内镜像，重新配置：npm config set registry https://registry.npmmirror.com；② 关闭代理后重试；③ 手动下载技能安装包，本地安装：npx skills add 本地安装包路径 -g -y。

2. 问题：插件安装成功但执行命令提示“未找到插件”
   解决办法：① 执行openclaw plugins list确认插件已安装；② 重启网关服务：openclaw gateway restart；③ 检查插件与OpenClaw版本兼容性，升级插件或OpenClaw。

六、总结

OpenClaw的命令行体系是其高效操控的核心，本文整理的十大类核心命令覆盖了从部署、配置到日常使用、问题排查的全场景，结合详细的实操示例，新手可快速上手。规范的部署流程与精准的API配置，是命令正常执行的基础；而“修改配置必重启、遇到问题先执行doctor”的原则，能帮助用户规避大部分使用风险。

随着OpenClaw版本的持续迭代，命令功能将不断丰富，但核心操作逻辑保持一致，熟练掌握本文中的高频命令，即可满足90%以上的使用场景。建议用户在使用过程中，结合openclaw --help查看命令详细参数，逐步探索进阶功能，充分发挥OpenClaw的强大能力。