阿里云/本地部署 OpenClaw 从入门到熟练：基础交互与免费大模型配置完整指南-阿里云开发者社区

OpenClaw（Clawdbot）是一款可本地部署、支持多模型接入、支持文件交互与任务执行的开源 AI 智能体平台。部署完成后，最核心的使用场景集中在三项：自然对话交互、文件上传理解、多模型灵活切换。本文以零基础可上手为目标，完整覆盖对话使用、文件解析、模型切换方法，并同步提供 2026 年阿里云 ECS、MacOS、Linux、Windows11 部署流程，以及阿里云百炼 Coding Plan 免费大模型 API 配置与常见问题解决方案，所有命令可直接复制执行，全程无冗余表述，稳定可用。

一、OpenClaw 基础使用：对话、文件、模型三大核心操作

1.1 智能对话交互（基础必学）

OpenClaw 的对话并非普通聊天，而是支持上下文记忆、角色设定、多轮交互的结构化对话模式，可直接用于问答、写作、代码、总结、规划等场景。目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw部署教程图1.png

操作流程

打开浏览器进入 Web 面板：
- 本地：http://127.0.0.1:18789
- 阿里云：http://公网IP:18789
点击左侧菜单对话进入聊天界面
在输入框输入指令，按回车发送
系统自动保留上下文，支持连续追问与补充说明

高效使用技巧

角色预设：开头直接指定身份，回答更专业

你是一名资深后端工程师，请帮我分析这段代码并优化
你是一名办公助理，帮我撰写一份会议纪要
你是一名内容创作者，帮我生成一篇实操教程

上下文延续：直接基于上一轮结果继续提问

把刚才生成的内容精简为3条要点
把这段文字改成更正式的商务风格

清空对话：点击面板内清空按钮，释放上下文窗口
导出记录：支持导出 Markdown / PDF 存档

命令行对话（不进网页也能用）

openclaw chat --prompt "帮我解释什么是大模型上下文"

常用对话示例

帮我写一份项目周报模板
解释一下什么是向量数据库，用通俗语言
帮我检查这段命令是否有错误
帮我生成一份OpenClaw部署说明文档

1.2 文件上传与文档对话（高阶实用能力）

OpenClaw 支持直接上传文件并基于内容回答，可自动解析文本、表格、代码、图片（OCR）、压缩包，无需手动复制内容。

支持格式

文档：PDF、Word、TXT、MD、HTML
表格：Excel、CSV
图片：JPG、PNG（自动 OCR 提取文字）
代码：各类源码文件
压缩包：ZIP、RAR（自动解压读取）

操作步骤

进入对话界面
点击上传文件按钮，或直接拖拽文件到输入框区域
等待解析（10–30 秒，视文件大小）
直接提问，AI 将基于文件内容回答

典型使用场景

帮我总结这份PDF的核心观点
帮我提取这份Excel里的所有数据并生成汇总表
帮我分析这份代码的逻辑并找出潜在问题
帮我查看这份合同里的关键条款和风险点
帮我把图片里的文字提取出来并整理成文本

命令行批量上传（可选）

openclaw file upload ./文档.pdf
openclaw chat --prompt "基于上传的文件总结内容"

1.3 模型切换与配置（提升效果关键）

OpenClaw 支持云端模型、本地模型、自定义兼容 OpenAI 协议的模型，可根据任务类型、中文效果、隐私需求自由切换。

支持模型类型

云端免费/付费：通义千问、Kimi、DeepSeek、GLM 等
本地私有化：Llama、Qwen、Mistral 等
自定义：任何兼容 OpenAI API 格式的模型

面板内切换（最简单）

点击右上角模型选择器
在下拉列表选择目标模型
首次使用需填入 API Key
选择后立即生效，无需重启

命令行切换（最稳定）

# 查看所有已配置模型
openclaw models list

# 查看当前默认模型
openclaw models current

# 切换默认模型（阿里云百炼示例）
openclaw models set bailian/qwen3.5-plus

# 临时切换单次对话模型（不改变默认）
openclaw chat --model bailian/qwen3.5-plus --prompt "测试模型"

对话内快速切换

/model list
/model bailian/qwen3.5-plus
/model kimi-k2.5-free

模型选择建议

复杂推理、代码：qwen3.5-plus、deepseek-chat
中文写作、总结、文档：qwen3.5-plus、glm-4-free
隐私敏感、本地运行：Qwen 本地版
低成本日常使用：免费开源模型 / 免费额度模型

二、2026 年阿里云 ECS 部署 OpenClaw 完整流程

适合 7×24 小时运行、远程访问、团队使用。

2.1 服务器选购建议

操作系统：Alibaba Cloud Linux 3 / Ubuntu 22.04
推荐配置：2核 2GB 内存起步
公网 IP：必须开启
放行端口：18789（OpenClaw 默认端口）

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

第一步：点击打开访问阿里云OpenClaw一键部署专题页面。

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

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

轻量应用服务器OpenClaw镜像.png

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

阿里云百炼密钥管理图.png

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

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼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.2 环境安装与部署命令

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装基础依赖
sudo apt install nodejs npm git python3 python3-pip docker.io -y

# 启动并设置 Docker 开机自启
sudo systemctl enable docker
sudo systemctl start docker
sudo usermod -aG docker $USER
newgrp docker

# 切换 npm 镜像加速
npm config set registry https://registry.npmmirror.com

# 安装 OpenClaw
npm install -g openclaw@latest

# 初始化云端环境
openclaw init --mode cloud --port 18789 --sandbox enable

# 允许公网访问
openclaw config set gateway.bind 0.0.0.0

# 启动网关
openclaw gateway start

# 设置开机自启
openclaw config set gateway.autoStart true

2.3 安全组端口放行

在阿里云 ECS 控制台 → 安全组 → 添加规则：

端口：18789
协议：TCP
授权对象：0.0.0.0/0（或限定自己的 IP）

2.4 验证部署

浏览器访问：

http://你的公网IP:18789

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

3.1 MacOS 部署

# 安装 Homebrew（未装过执行）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装依赖
brew install node@22 git python3
open -a Docker

# 加速
npm config set registry https://registry.npmmirror.com

# 安装 OpenClaw
npm install -g openclaw@latest

# 初始化
openclaw init --sandbox enable --workdir ~/.openclaw

# 仅本地访问
openclaw config set gateway.bind loopback

# 启动
openclaw gateway start

# 打开面板
openclaw dashboard

3.2 Linux（Ubuntu）部署

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs git python3 docker.io
sudo systemctl enable docker
sudo systemctl start docker
sudo usermod -aG docker $USER

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

openclaw init --sandbox enable
openclaw gateway start

3.3 Windows11 部署（管理员 PowerShell）

winget install OpenJS.NodeJS
winget install Git.Git
winget install Python.Python.3.11

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

openclaw init --sandbox enable --workdir C:\Users\你的用户名\.openclaw
openclaw config set gateway.bind loopback
openclaw gateway start
openclaw dashboard

四、阿里云百炼 Coding Plan 免费大模型 API 配置

4.1 开通与获取 API Key

访问登录阿里云百炼大模型服务平台
进入 Coding Plan 套餐页面
开通免费/试用额度
生成专属 API Key（以 sk-sp- 开头）

4.2 写入配置文件

编辑：~/.openclaw/openclaw.json

{
   
  "models": {
   
    "mode": "merge",
    "providers": {
   
      "bailian": {
   
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "你的sk-sp-xxx",
        "api": "openai-completions",
        "models": [
          {
   
            "id": "qwen3.5-plus",
            "name": "Qwen 3.5 Plus",
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
   
    "defaults": {
   
      "model": {
   
        "primary": "bailian/qwen3.5-plus"
      }
    }
  }
}

4.3 重启生效

openclaw gateway restart

4.4 测试调用

openclaw chat --prompt "你好，请简单介绍自己"

五、OpenClaw 常用管理命令（必备）

# 查看版本
openclaw --version

# 启动网关
openclaw gateway start

# 停止网关
openclaw gateway stop

# 重启网关
openclaw gateway restart

# 查看状态
openclaw gateway status

# 查看日志
openclaw logs --limit 50
openclaw logs --follow

# 系统诊断
openclaw doctor

# 重置网关
openclaw gateway reset

# 打开 Web 面板
openclaw dashboard

六、常见问题解答（90% 新手都会遇到）

6.1 部署与启动问题

问题：网关启动失败，提示端口占用

# 查看占用
sudo lsof -i :18789  # Mac/Linux
netstat -ano | findstr 18789  # Windows

# 结束进程
kill -9 进程ID
taskkill /F /PID 进程ID

# 或更换端口
openclaw config set gateway.port 18790
openclaw gateway restart

问题：Web 面板无法访问

本地：确认 http://127.0.0.1:18789
阿里云：确认安全组放行 18789
重启网关：openclaw gateway restart

问题：命令不存在 command not found

重启终端
重新安装：npm install -g openclaw@latest

6.2 模型配置问题

问题：401 invalid api-key

API Key 错误
使用了通用 Key，不是 Coding Plan 专属 Key（必须 sk-sp- 开头）
重新生成并替换

问题：404 not found

baseUrl 错误
正确地址：https://coding.dashscope.aliyuncs.com/v1

问题：模型不存在

模型 ID 错误
正确：qwen3.5-plus

问题：阿里云能部署但无法调用模型

未放行 443 出口端口
系统时间不同步

6.3 文件与对话问题

问题：上传文件失败、解析超时

文件过大
格式不支持
重启网关再试

问题：AI 回答重复、混乱、失忆

清空对话
切换模型
重启网关

问题：文件内容读取不完整

大文件分批上传
使用命令行上传更稳定

七、稳定使用最佳实践

日常对话优先使用免费模型，成本更低
重要文件上传前先备份，避免误操作
定期重启网关，保持运行稳定
云端部署务必配置端口访问限制
API Key 不要泄露、不要硬编码在脚本中
模型切换优先选择同厂商切换，更稳定
长时间运行建议开启守护进程，防止自动退出

八、总结

OpenClaw 的核心使用逻辑非常清晰：对话交互 + 文件理解 + 模型切换，掌握这三项即可满足绝大多数日常场景。配合阿里云 ECS 可实现 7×24 小时稳定运行，本地部署则更轻量、隐私性更强。阿里云百炼 Coding Plan 提供的免费模型额度足以支撑个人日常使用，搭配正确配置后，回答质量、响应速度、稳定性都能达到日常可用水平。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

阿里云/本地部署 OpenClaw 从入门到熟练：基础交互与免费大模型配置完整指南