OpenClaw零基础保姆级图文攻略：阿里云/本地部署、免费大模型API配置、Skills集成及避坑指南

2026年初，AI智能体框架OpenClaw（曾用名Clawdbot、Moltbot）在开源社区迅速崛起，凭借本地部署、数据隐私与自主任务执行的核心优势，成为替代传统云端AI工具的优选。它能本地运行、自主调用系统工具、处理文件，完全无需依赖第三方云端，数据全程安全可控。

本文面向零基础新手，提供2026年在MacOS、Linux、Windows11本地部署OpenClaw的详细步骤，重点讲解阿里云百炼免费大模型API配置，并覆盖部署、配置、使用全流程的常见问题，全程无复杂技术门槛，新手可按步骤完成搭建。阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw与本地部署的价值

OpenClaw是一款可本地部署的AI智能体框架，区别于传统云端AI（数据上传云端、依赖外部服务），它的核心价值在于本地可控：所有数据、操作、日志都存储在你的设备，不会泄露；支持本地文件读写、系统命令执行、浏览器操作等高阶能力，云端环境无法实现。

为什么优先本地部署？

1. 数据隐私安全：文件、对话、操作记录全程本地，无第三方泄露风险，适合处理敏感数据；
2. 功能完整解锁：可直接调用本地程序、剪贴板、桌面权限，实现真正的自主执行；
3. 零成本使用：无需购买云服务器，老旧电脑（内存≥4GB、硬盘≥20GB）即可流畅运行；
4. 自定义空间大：可自由修改配置、安装专属Skills插件，适配个人使用场景。

部署前置准备（全平台通用）

二、2026年跨系统本地部署步骤（新手零基础）

（一）MacOS系统部署

1. 安装依赖工具
   打开终端，执行以下命令安装Xcode命令行工具（基础编译依赖）：

   xcode-select --install
   

   若提示已安装，直接跳过；未安装则按指引完成安装。

2. 克隆官方仓库
   执行命令下载OpenClaw源码：

   git clone https://github.com/openclaw-project/openclaw.git
   cd openclaw
   

3. 配置Python虚拟环境
   避免污染系统环境，创建并激活虚拟环境：

   python3 -m venv claw-env
   source claw-env/bin/activate
   

4. 安装核心依赖
   升级pip并安装项目依赖，--no-cache-dir 解决缓存导致的安装失败：

   pip install --upgrade pip
   pip install -r requirements.txt --no-cache-dir
   

5. 初始化配置文件
   复制示例配置为正式配置：

   cp config/example_config.json config/claw_config.json
   

6. 启动服务
   前台运行（便于查看日志，排查错误）：

   python -m openclaw.gateway
   

   后台运行（不占用终端，推荐长期使用）：

   nohup python -m openclaw.gateway > claw_run.log 2>&1 &
   

（二）Linux系统（Ubuntu 22.04）部署

1. 安装系统依赖
   打开终端，执行以下命令安装基础工具与编译依赖：

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y git python3 python3-venv python3-pip gcc g++ libssl-dev
   

2. 克隆仓库并进入目录

   git clone https://github.com/openclaw-project/openclaw.git
   cd openclaw
   

3. 配置虚拟环境

   python3 -m venv claw-env
   source claw-env/bin/activate
   

4. 安装依赖与初始化配置

   pip install --upgrade pip
   pip install -r requirements.txt
   cp config/example_config.json config/claw_config.json
   

5. 配置系统服务（开机自启）
   创建系统服务文件，实现开机自动运行：

   sudo tee /etc/systemd/system/openclaw.service << EOF
   [Unit]
   Description=OpenClaw AI Agent Local Service
   After=network.target
   
   [Service]
   User=$USER
   WorkingDirectory=$(pwd)
   ExecStart=$(pwd)/claw-env/bin/python -m openclaw.gateway
   Restart=on-failure
   RestartSec=5
   
   [Install]
   WantedBy=multi-user.target
   EOF
   

6. 启动并启用服务

   sudo systemctl daemon-reload
   sudo systemctl start openclaw
   sudo systemctl enable openclaw
   

   验证服务状态：sudo systemctl status openclaw，显示active (running)即为成功。

（三）Windows11系统部署（WSL2+Ubuntu 22.04）

Windows11原生环境存在依赖兼容性问题，WSL2子系统是最优部署方式，步骤如下：

1. 开启WSL2并安装Ubuntu
   以管理员身份打开Windows PowerShell，执行命令启用WSL2并安装Ubuntu 22.04：

   wsl --install
   # 安装完成后重启电脑
   # 重启后输入用户名和密码（自定义，记住后续使用）
   

2. 进入WSL2子系统
   后续所有操作均在WSL2内执行，打开PowerShell输入：

   wsl -d Ubuntu-22.04
   

   进入后终端前缀变为$，即为Linux环境。

3. 执行Linux部署步骤
   完全复用Linux系统的部署命令（克隆仓库→配置环境→安装依赖→启动服务）：

   git clone https://github.com/openclaw-project/openclaw.git
   cd openclaw
   python3 -m venv claw-env
   source claw-env/bin/activate
   pip install --upgrade pip
   pip install -r requirements.txt
   cp config/example_config.json config/claw_config.json
   python -m openclaw.gateway
   

   （四）新手零基础阿里云上部署OpenClaw喂饭级步骤流程

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

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

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

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

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

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

（五）部署成功验证

无论哪个系统，部署完成后打开浏览器，访问 http://localhost:18789（默认端口），若能正常进入OpenClaw本地控制台界面，即为部署成功。

若提示端口占用，修改配置文件更换端口：

1. 编辑配置文件：

   vim config/claw_config.json  # MacOS/Linux
   # Windows WSL2：notepad config/claw_config.json
   

2. 找到gateway模块，修改port参数（如改为18790）：

   {
        
     "gateway": {
        
       "host": "0.0.0.0",
       "port": 18790
     }
   }
   

3. 保存退出，重启OpenClaw服务生效。

三、阿里云百炼免费大模型API配置（核心步骤）

OpenClaw本身是智能体框架，需对接大模型才能实现自然语言交互与任务执行。阿里云百炼免费版qwen-flash模型是新手最优选择，零成本、高稳定、适配国内网络，完全满足日常使用需求。

（一）获取阿里云百炼API密钥

1. 注册并登录阿里云账号，完成实名认证（个人/企业均可）；
2. 访问阿里云轻量应用服务器控制台，进入官方服务页面；
3. 左侧导航栏点击“API密钥管理”，选择“创建密钥”，系统生成Access Key ID与Access Key Secret（务必妥善保存，仅显示一次，泄露会导致账户风险）；
4. 进入“模型服务”页面，找到并开通qwen-flash免费模型（支持多轮对话、工具调用，免费额度足够日常使用）。

（二）OpenClaw对接阿里云百炼API配置

1. 编辑OpenClaw配置文件

   # MacOS/Linux
   vim config/claw_config.json
   # Windows WSL2
   notepad config/claw_config.json
   

2. 替换model模块内容（填入你的API密钥）

   {
        
     "model": {
        
       "provider": "aliyun_bailian",
       "access_key_id": "你的Access Key ID",
       "access_key_secret": "你的Access Key Secret",
       "default_model": "qwen-flash",  // 阿里云百炼免费模型
       "endpoint": "https://dashscope.aliyuncs.com/compatible-mode/v1",
       "timeout": 30,  // 模型调用超时时间（秒）
       "max_tokens": 2048,  // 单次生成最大Token数
       "temperature": 0.7  // 回复随机性（0-1，越低越稳定）
     }
   }
   

   🔍 地域说明：endpoint为北京地域地址，若在其他地域（如新加坡、美国弗吉尼亚），需替换为对应地域的endpoint：

   • 新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
   • 美国弗吉尼亚：https://dashscope-us.aliyuncs.com/compatible-mode/v1

3. 验证API连通性
   执行测试脚本，检查配置是否生效：

   python scripts/test_model_connection.py
   

   若终端输出Model connection successful，即为API配置成功；若提示认证失败，检查API密钥是否正确、模型是否已开通。

（三）API配置关键避坑点

1. 复制API密钥时，去除换行符、空格等格式杂质，建议先粘贴至纯文本编辑器（如记事本）清理后再复制；
2. 确保default_model为qwen-flash（免费模型），未开通会提示“模型无访问权限”；
3. 配置文件为JSON格式，逗号、引号不可缺失，否则会导致服务启动失败；
4. 网络问题：若提示连接超时，检查本地网络是否能访问dashscope.aliyuncs.com，可执行ping dashscope.aliyuncs.com测试连通性。

四、Skills插件管理（扩展核心能力）

Skills是OpenClaw的“能力插件”，涵盖文件处理、代码开发、信息监控、内容创作等上万款免费插件，通过安装Skills，可快速扩展OpenClaw的功能边界，无需自行开发代码。

（一）核心管理命令

1. 安装ClawHub客户端（Skills管理工具）

   npm install -g clawhub
   

2. 搜索目标Skill（以信息监控、PDF处理为例）

   clawhub search "info monitor" "pdf pro"
   

3. 一键安装Skill

   clawhub install info-monitor pdf-pro
   

4. 查看已安装Skill

   openclaw skills list
   

5. 卸载无用Skill

   clawhub uninstall pdf-pro
   

6. 重启服务加载Skill

   # MacOS/Linux
   pkill -f openclaw && nohup python -m openclaw.gateway > claw_run.log 2>&1 &
   # Windows WSL2
   stop-process -name python -Force; nohup python -m openclaw.gateway > claw_run.log 2>&1 &
   

（二）新手必装核心Skill推荐

1. find-skills：自主搜索20万+Skill库，快速找到小众任务所需插件，安装量第一；
2. pdf-pro：合并、拆分、提取PDF内容，解决数字文书工作痛点；
3. agent-browser：给AI装上“眼睛”，实现网页浏览、填表、数据抓取、自动化操作；
4. skill-creator：将个人工作流程打包为专属Skill，实现个性化定制。

五、常见问题解答（新手必看，解决90%问题）

（一）部署类问题

（二）API配置类问题

（三）功能使用类问题