OpenClaw（Clawdbot）部署指南：本地MacOS/Linux/Windows11+阿里云服务器+千问/Coding Plan配置

OpenClaw是一款可本地部署的AI Agent工具，支持文件读取、命令执行、邮件发送、消息收发等自动化能力，可作为个人数字助理或轻量化自动化助手使用。2026年版本已全面兼容macOS、Linux、Windows11系统，同时支持阿里云ECS/轻量应用服务器云端部署，可对接阿里云千问大模型与百炼Coding Plan免费API，兼顾稳定性、安全性与成本控制。本文将完整覆盖本地安装、云端部署、模型配置、安全加固、健康检查与常见问题排查，全程可复现，无额外依赖。

一、部署前核心准备与安全须知

OpenClaw具备文件读写、命令执行、外部API调用等高权限能力，部署前必须明确安全边界：

1. 本地部署优先绑定127.0.0.1，禁止公网直接暴露控制面板；
2. API Key单独管理，不嵌入代码、不分享他人；
3. 消息渠道建议使用专用账号，避免个人主号隐私泄露；
4. 云端部署必须开启防火墙，仅放行必要端口，配置访问令牌。
5. 目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
   

核心环境要求

版本检查与升级

# 检查Node版本
node -v
# 低于22版本需升级
# macOS/Linux安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# Windows11使用nvm-windows或直接官网下载安装

二、本地全平台部署（MacOS/Linux/Windows11）

（一）macOS部署流程

1. 打开终端，执行一键安装脚本

   curl -fsSL https://openclaw.ai/install.sh | bash
   

2. 验证安装

   openclaw --version
   # 输出openclaw/2026.x.x即为成功
   

3. 启动配置向导并安装后台服务

   openclaw onboard --install-daemon
   

4. 安全绑定本地地址

   # 编辑配置文件
   nano ~/.openclaw/openclaw.json
   # 修改canvas_host为127.0.0.1
   "canvas_host": "127.0.0.1"
   # 保存退出：Ctrl+O → 回车 → Ctrl+X
   

5. 启动服务并获取令牌

   openclaw gateway --verbose
   

6. 访问控制面板

   http://127.0.0.1:18789
   

（二）Linux部署流程（以Ubuntu/Debian为例）

1. 更新系统依赖

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y git
   

2. 安装Node.js 22

   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
   sudo apt install -y nodejs
   node -v
   

3. 安装OpenClaw

   npm install -g openclaw@latest
   # 或pnpm（速度更快）
   pnpm add -g openclaw@latest
   

4. 初始化配置

   openclaw onboard --install-daemon
   

5. 端口与防火墙配置

   # 检查端口占用
   lsof -i :18789
   # 放行端口（Ubuntu）
   sudo ufw allow 18789/tcp
   

6. 安全加固与启动

   # 修改本地绑定
   sed -i 's/canvas_host.*/canvas_host": "127.0.0.1"/g' ~/.openclaw/openclaw.json
   openclaw start
   

（三）Windows11部署流程

1. 以管理员身份打开PowerShell
2. 执行安装脚本

   iwr -useb https://openclaw.ai/install.ps1 | iex
   

3. 验证安装

   openclaw --version
   

4. 运行配置向导

   openclaw onboard --install-daemon
   

5. 修改配置文件

   notepad $env:USERPROFILE\.openclaw\openclaw.json
   # 找到canvas_host，改为"127.0.0.1"
   

6. 启动服务并访问面板

   openclaw gateway --verbose
   # 浏览器访问 http://127.0.0.1:18789
   

（四）Docker通用部署（全平台兼容）

适合服务器、无环境依赖场景：

# 拉取镜像
docker pull openclaw/openclaw:latest
# 启动容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest
# 进入容器配置
docker exec -it openclaw bash
openclaw onboard --install-daemon

三、2026阿里云服务器部署OpenClaw完整流程

阿里云ECS/轻量应用服务器可实现7×24小时稳定运行，适合长期自动化任务。

步骤1：购买与创建实例

1. 登录阿里云控制台，选择轻量应用服务器或ECS；
2. 镜像选择应用镜像→OpenClaw（Clawdbot）；
3. 配置推荐：2核2GB起步，2核4GB更流畅，系统选择Ubuntu 22.04；
4. 完成购买，获取公网IP与登录密码。

阿里云用户零基础部署 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 的地址。
  
  

步骤2：端口放行与安全组配置

1. 进入实例详情→防火墙/安全组；
2. 放行TCP 18789端口，仅限必要IP访问；
3. 禁止0.0.0.0/0全开放，降低暴露风险。

步骤3：服务器端部署

1. SSH连接服务器

   ssh root@公网IP
   

2. 检查环境并安装

   node -v
   npm install -g openclaw@latest
   openclaw onboard --install-daemon
   

3. 配置公网安全访问

   # 生产环境建议绑定内网IP或加Token验证
   nano ~/.openclaw/openclaw.json
   # 设置访问令牌
   "token": "自定义强密码令牌"
   

4. 启动并设置开机自启

   openclaw start
   systemctl enable openclaw
   

5. 公网访问面板

   http://公网IP:18789
   # 输入令牌登录
   

四、AI模型API配置（千问+免费Coding Plan）

（一）阿里云千问大模型API配置

1. 开通阿里云百炼Model Studio，完成实名认证；
2. 进入API密钥管理，创建并复制API Key；
3. 执行配置命令

   openclaw config set model.provider aliyun_bailian
   openclaw config set model.aliyun_bailian.api_key "你的API Key"
   openclaw config set model.aliyun_bailian.base_url "https://dashscope.aliyuncs.com/compatible-mode/v1"
   openclaw config set agents.defaults.model.primary "bailian/qwen3.5-plus"
   

4. 验证连通性

   openclaw doctor --repair
   

（二）阿里云百炼Coding Plan免费API配置

Coding Plan提供免费额度，适合测试与轻量使用，兼容OpenAI协议。

1. 进入阿里云百炼→Coding Plan，开通免费套餐；
2. 创建专属API Key，记录Key与Base URL；
3. 配置命令

   openclaw config set model.provider openai
   openclaw config set model.openai.api_key "Coding Plan-API-Key"
   openclaw config set model.openai.base_url "https://coding.dashscope.aliyuncs.com/v1"
   openclaw config set agents.defaults.model.primary "qwen3.5-plus"
   

4. 手动配置文件方式

   nano ~/.openclaw/openclaw.json
   # 添加/修改如下字段
   "model": {
        
   "provider": "openai",
   "openai": {
        
   "apiKey": "你的Key",
   "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
   "model": "qwen3.5-plus"
   }
   }
   

五、消息渠道配置（Telegram/WhatsApp）

Telegram配置

1. 打开Telegram，搜索@BotFather；
2. 发送/newbot，按提示设置名称与用户名；
3. 获取Bot Token；
4. 运行配置向导

   openclaw onboard
   

5. 选择Telegram，粘贴Token完成绑定。

WhatsApp配置

1. 运行配置向导，选择WhatsApp；
2. 终端生成二维码，打开WhatsApp→设置→扫码登录；
3. 建议使用专用账号，避免个人消息进入上下文。

六、健康检查与运维命令

# 全面自检并修复
openclaw doctor --repair
# 查看运行状态
openclaw status
# 重启服务
openclaw restart
# 停止服务
openclaw stop
# 查看日志
openclaw logs
# 重置配置
openclaw config reset

七、费用估算与省钱策略

OpenClaw本体免费，模型调用按量计费：

• 轻度用户（偶尔使用）：月均5-15美元；
• 中度用户（日常自动化）：月均20-50美元；
• 重度用户（持续任务）：月均80-200美元+。

省钱技巧：

1. 定期新建会话，减少上下文token消耗；
2. 简单任务使用Coding Plan免费额度；
3. 在模型控制台设置月度消费上限；
4. 本地轻量任务优先低消耗模型。

八、2026常见问题速查

九、部署完成总结

完成以上步骤后，你已拥有：

1. 本地MacOS/Linux/Windows11稳定运行的OpenClaw；
2. 阿里云云端24小时在线部署版本；
3. 阿里云千问与免费Coding Plan双模型支持；
4. 安全加固的本地控制面板与令牌认证；
5. Telegram/WhatsApp消息渠道联动能力。

OpenClaw可通过安装Skills扩展文件管理、代码编写、日程安排、数据统计等能力，后续可进一步配置权限策略、任务流与自动化规则，打造专属私人AI助手。