OpenClaw全场景部署保姆级教程：树莓派/阿里云MacOS/Linux/Windows11搭建集成skill零成本方案+百炼API配置

在AI智能体工具全民普及的2026年，OpenClaw（原Clawdbot）凭借“开源免费、多端适配、技能生态丰富”的核心优势，成为个人与中小企业搭建专属AI助手的首选。而选择合适的部署载体，直接决定了使用体验与成本控制——一台仅60美元的树莓派，能实现24/7不间断运行，年电费不足10元人民币，6-12个月即可回本；阿里云部署则胜在稳定可靠、无需本地硬件维护；本地电脑部署（MacOS/Linux/Windows11）则满足数据隐私优先的需求。

本文整合2026年最新实战经验，全面覆盖树莓派、阿里云、本地多系统三大部署场景，详细拆解免费大模型对接与阿里云百炼Coding Plan API配置流程，补充15+常见问题解答，所有代码命令均可直接复制执行，全程规避其他云厂商名称，无论是追求零成本的学生、注重稳定性的企业用户，还是看重数据安全的个人，都能找到适合自己的部署方案，快速解锁AI自动化能力。阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：部署载体怎么选？（按需匹配不踩坑）

不同部署载体的核心差异在于成本、稳定性、隐私性与操作难度，新手需根据自身需求选择，避免盲目跟风。

（一）四大部署载体核心对比

（二）核心原则：树莓派是“网关”而非“算力中心”

很多新手误解树莓派需要跑本地大模型，实则完全无需——树莓派的核心作用是“指令网关”：接收用户消息（如飞书、钉钉指令），转发至云端大模型（如阿里云百炼），再将结果返回给用户。这种模式既规避了树莓派算力不足的问题，又能实现零运行成本、24小时在线，完美平衡体验与成本。

二、部署前通用准备（5分钟搞定，所有场景适用）

无论选择哪种部署方式，都需提前完成以下准备，避免因资料缺失导致部署中断：

（一）基础工具与环境

1. 核心依赖：Node.js 22.x及以上版本（所有场景通用）、Git（用于拉取源码与技能）；
2. 终端工具：Windows用PowerShell（管理员模式），MacOS/Linux/树莓派用自带终端；
3. 浏览器：推荐Chrome/Edge最新版，用于访问管理面板与配置页面；
4. 存储介质：树莓派用户需准备16GB以上SD卡（推荐USB SSD，提升稳定性），其他场景无需额外存储。

（二）核心凭证获取

1. 阿里云百炼API-Key（可选，增强功能）：

   • 访问登录阿里云百炼大模型服务平台，进入“密钥管理”，点击“创建API-Key”，复制Access Key ID与Access Key Secret，妥善保存（仅创建时可完整查看）；
   • 新用户可领取免费调用额度（访问订阅阿里云百炼Coding Plan，超7000万tokens，90天有效期），满足日常使用需求。

2. 免费大模型API-Key（必选，零成本入门）：

   • 推荐硅基流动：注册即送超7000万tokens，90天有效期，支持中文场景，API兼容OpenAI协议，无需额外适配；
   • 获取步骤：访问订阅阿里云百炼Coding Plan，完成注册后进入“API密钥”页面，创建并复制API-Key。

3. 飞书/钉钉渠道凭证（可选，多端访问）：

   • 登录飞书开放平台，创建企业应用，获取App ID与App Secret；
   • 配置应用权限（消息发送、群聊访问等），记录回调地址（部署后需填写）。

三、四大部署场景详细流程（含代码命令）

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

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

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

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

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

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

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

（一）场景1：树莓派部署（零成本首选，技术爱好者必试）

树莓派部署核心是“系统烧录+基础环境配置+OpenClaw安装+模型对接”，全程30分钟内完成，推荐型号为Pi 5（4GB，性价比之王）。

步骤1：系统烧录与初始化

1. 下载工具与系统：
   • 访问树莓派官网，下载Pi Imager工具；
   • 打开工具，选择系统为“Raspberry Pi OS Lite (64-bit)”（Lite版更省内存，无需桌面环境）；
2. 烧录前配置（关键步骤）：
   • 点击工具右下角“设置”，勾选以下选项：
     • 启用SSH（必须，否则无法远程连接）；
     • 设置主机名（如“openclaw-pi”，方便后续识别）；
     • 配置Wi-Fi（输入SSID与密码，无网线时必备）；
     • 设置用户名与密码（牢记，远程登录需用到）；
3. 烧录与启动：
   • 将SD卡插入电脑，点击“烧录”，完成后插入树莓派；
   • 接上电源与网线（推荐网线，稳定性更强），等待1分钟启动。

步骤2：远程连接与基础环境配置

# 1. SSH远程连接树莓派（替换为你的用户名与主机名）
ssh your-username@openclaw-pi.local
# 输入设置的密码登录

# 2. 更新系统依赖
sudo apt update && sudo apt upgrade -y

# 3. 安装基础工具
sudo apt install -y git curl build-essential

# 4. 设置时区（影响定时任务准确性）
sudo timedatectl set-timezone Asia/Shanghai

# 5. 安装Node.js 22（OpenClaw核心依赖）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs

# 6. 验证安装（显示v22.x.x即成功）
node -v && npm -v

# 7. 配置npm国内镜像（避免依赖安装超时）
npm config set registry https://registry.npmmirror.com

步骤3：安装OpenClaw并初始化

# 1. 全局安装OpenClaw最新版
sudo npm install -g openclaw@latest

# 2. 初始化配置（生成默认配置文件）
openclaw onboard
# 按提示操作：
# 安全警告 → Yes
# 模式选择 → QuickStart（快速启动）
# 模型提供商 → 暂时跳过（后续手动配置）
# 通信渠道 → 按需选择（飞书/钉钉/None）
# 技能安装 → No（后续批量安装）

# 3. 配置免费大模型（硅基流动）
openclaw config set model.provider siliconflow
openclaw config set model.siliconflow.api_key "你的硅基流动API-Key"
openclaw config set model.siliconflow.base_url "https://api.siliconflow.cn/v1"

# 4. 配置阿里云百炼Coding Plan（可选，增强推理能力）
openclaw config set model.provider aliyun_bailian_coding
openclaw config set model.aliyun_bailian_coding.api_key "你的百炼API-Key"
openclaw config set model.aliyun_bailian_coding.base_url "https://coding.dashscope.aliyuncs.com/v1"

# 5. 设置开机自启（避免断电后需手动启动）
sudo tee /etc/systemd/system/openclaw.service << EOF
[Unit]
Description=OpenClaw AI Gateway
After=network.target

[Service]
User=$USER
ExecStart=$(which openclaw) gateway start --daemon
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

# 6. 启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable --now openclaw

# 7. 验证服务状态（显示active(running)即成功）
sudo systemctl status openclaw

步骤4：安装核心技能与验证

# 1. 安装ClawHub（技能管理底座）
npx clawhub@latest install clawhub

# 2. 安装基础必备技能（文件管理、浏览器自动化、系统命令）
npx clawhub@latest install file-manager agent-browser system-command

# 3. 验证技能安装
npx clawhub@latest list

# 4. 访问管理面板（浏览器打开）
http://树莓派IP:18789

# 5. 发送测试指令（如“帮我生成一篇100字的AI办公技巧文案”）
# 能正常返回结果即部署成功

树莓派专属避坑指南

1. 存储选择：优先用USB SSD替代SD卡，SD卡长期运行易损坏，导致配置丢失；
2. 内存优化：2GB内存型号需添加swap分区，避免内存不足：

   # 添加2GB swap分区
   sudo fallocate -l 2G /swapfile
   sudo chmod 600 /swapfile
   sudo mkswap /swapfile
   sudo swapon /swapfile
   # 设置开机自动挂载
   echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
   

3. 散热处理：树莓派长期运行会发热，建议搭配散热片或风扇，避免因过热死机。

（二）场景2：阿里云部署（企业首选，稳定可靠）

阿里云提供OpenClaw专属预制镜像，一键部署无需手动配置环境，适合团队协作与长期使用。

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

步骤1：创建阿里云服务器实例

1. 访问阿里云轻量应用服务器控制台，点击“创建实例”；
2. 地域选择：优先中国香港（免ICP备案，国内访问速度快），海外用户选新加坡；
3. 镜像选择：切换至“应用镜像”，搜索“OpenClaw 2026稳定版”；
4. 规格选择：2vCPU+4GiB内存+60GiB ESSD+5Mbps带宽（最低配置，支持5人团队协作）；
5. 完成支付，记录实例公网IP（后续访问与配置需用到）。

步骤2：端口放行与远程连接

1. 进入实例详情页，点击“安全组→添加规则”，放行以下端口：
   • 18789端口（OpenClaw Web控制台）；
   • 22端口（远程连接，可选）；
   • 443端口（加密数据传输）。
2. 远程连接服务器（推荐Web终端，无需额外工具）：

   # 验证环境（预装镜像已配置完成，直接验证）
   node -v  # 需≥22.0.0
   openclaw --version
   docker --version  # 沙箱运行依赖
   

步骤3：配置模型与验证

# 1. 配置阿里云百炼Coding Plan API
openclaw config set model.provider aliyun_bailian_coding
openclaw config set model.aliyun_bailian_coding.api_key "你的百炼API-Key"
openclaw config set model.aliyun_bailian_coding.base_url "https://coding.dashscope.aliyuncs.com/v1"

# 2. 配置免费模型（可选，备用）
openclaw config set model.provider siliconflow
openclaw config set model.siliconflow.api_key "你的硅基流动API-Key"

# 3. 生成管理员Token（登录控制台用）
openclaw token create --admin

# 4. 重启服务生效
systemctl restart openclaw

# 5. 访问Web控制台（浏览器打开）
http://实例公网IP:18789/?token=生成的Token

（三）场景3：MacOS本地部署（苹果用户专属）

MacOS适配Intel与M系列芯片，支持一键脚本部署，操作简洁高效。

方式1：一键脚本安装（推荐，5分钟完成）

# 1. 打开终端，执行官方一键安装脚本（国内加速版）
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

# 2. 加载环境变量（Zsh默认，Bash用户替换为~/.bash_profile）
source ~/.zshrc

# 3. 验证安装
openclaw --version

# 4. 初始化配置
openclaw onboard

# 5. 配置模型（本地大模型+云端模型双支持）
# 方案A：本地大模型（断网可用）
brew install ollama
ollama run qwen2.5:7b  # 安装轻量本地模型
openclaw config set model.provider ollama
openclaw config set model.ollama.base_url "http://localhost:11434"
openclaw config set model.ollama.model "qwen2.5:7b"

# 方案B：云端模型（阿里云百炼）
openclaw config set model.provider aliyun_bailian_coding
openclaw config set model.aliyun_bailian_coding.api_key "你的百炼API-Key"

# 6. 启动服务
openclaw gateway start

# 7. 访问控制台（浏览器打开）
open http://localhost:18789

方式2：手动安装（适配M系列芯片）

# 1. 用Homebrew安装Node.js 22
brew install node@22
brew link node@22 --force

# 2. 安装OpenClaw（解决M芯片sharp依赖报错）
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# 3. 后续步骤同一键脚本（初始化→配置模型→启动服务）

（四）场景4：Windows11本地部署（新手首选，零成本）

Windows11用户可通过一键脚本部署，全程无需复杂命令，10分钟即可完成。

步骤1：安装核心工具

# 1. 以管理员身份打开PowerShell，解锁脚本权限
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 输入Y确认

# 2. 一键安装Node.js 22
iwr -useb https://nodejs.org/dist/v22.3.0/node-v22.3.0-x64.msi | iex

# 3. 安装Git
iwr -useb https://github.com/git-for-windows/git/releases/download/v2.45.1.windows.1/Git-2.45.1-64-bit.exe | iex

# 4. 验证安装
node -v && npm -v && git --version

步骤2：安装OpenClaw并配置

# 1. 配置npm国内镜像加速
npm config set registry https://registry.npmmirror.com

# 2. 全局安装OpenClaw
npm install -g openclaw@latest

# 3. 初始化配置
openclaw onboard
# 按提示操作：快速启动→跳过模型选择→配置通信渠道（可选）

# 4. 配置免费模型
openclaw config set model.provider siliconflow
openclaw config set model.siliconflow.api_key "你的硅基流动API-Key"

# 5. 启动服务
openclaw gateway start

# 6. 访问控制台（浏览器打开）
start http://127.0.0.1:18789

（五）场景5：Linux本地部署（开发者首选，高度自定义）

Linux部署支持Ubuntu/CentOS/Deepin等主流发行版，适合深度定制与长期运行。

步骤1：前置环境准备（Ubuntu 22.04为例）

# 1. 更新系统依赖
sudo apt update && sudo apt install -y curl wget git

# 2. 安装Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 3. 安装Docker（沙箱运行依赖）
sudo apt install -y docker-ce docker-ce-cli containerd.io
sudo systemctl enable --now docker
sudo usermod -aG docker $USER && newgrp docker

# 4. 配置Docker国内镜像加速
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
   
  "registry-mirrors": ["https://registry.cn-hangzhou.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker

步骤2：安装OpenClaw并配置

# 1. 全局安装OpenClaw
sudo npm install -g openclaw@latest --registry=https://registry.npmmirror.com

# 2. 初始化配置
openclaw onboard

# 3. 配置模型（阿里云百炼）
openclaw config set model.provider aliyun_bailian_coding
openclaw config set model.aliyun_bailian_coding.api_key "你的百炼API-Key"

# 4. 配置系统服务（开机自启）
sudo tee /etc/systemd/system/openclaw.service << EOF
[Unit]
Description=OpenClaw AI Assistant
After=network.target docker.service

[Service]
User=$USER
ExecStart=$(which openclaw) gateway start --daemon
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

# 5. 启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable --now openclaw

# 6. 验证服务状态
sudo systemctl status openclaw

三、阿里云百炼Coding Plan API进阶配置（提升体验）

基础配置完成后，可通过以下进阶配置优化模型调用效果，避免额度超额，适合企业用户与高频使用场景：

阿里云百炼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 的地址。
  
  

（一）设置默认模型与地域

# 设置默认模型为通义千问-Plus（中文推理最优）
openclaw config set model.default "qwen-plus"

# 配置模型地域（与API-Key地域一致，降低延迟）
openclaw config set model.aliyun_bailian_coding.region "cn-beijing"

# 重启服务生效
openclaw restart

（二）设置调用额度限制（避免超额）

# 设置每日调用额度（单位：tokens，新手建议50000 tokens/天）
openclaw config set model.aliyun_bailian_coding.dailyLimit 50000

# 配置超额动作（停止调用，避免额外费用）
openclaw config set model.aliyun_bailian_coding.overLimitAction "stop"

# 重启服务生效
openclaw restart

（三）配置模型缓存（提升响应速度）

# 启用模型缓存
openclaw config set model.cache.enabled true

# 设置缓存有效期（60分钟）
openclaw config set model.cache.ttl 60

# 重启服务生效
openclaw restart

四、常见问题解答（FAQ）

（一）安装类问题

1. 问题1：Node.js安装后提示“command not found”

   • 解决方案：手动配置环境变量，将Node.js安装目录（如C:\Program Files\nodejs）添加到系统PATH，重启终端。

2. 问题2：树莓派部署提示“内存不足”

   • 解决方案：添加swap分区（参考树莓派避坑指南）；关闭不必要的后台进程；卸载无用技能。

3. 问题3：Windows11安装提示“权限不足”

   • 解决方案：以管理员身份运行PowerShell；执行Get-ExecutionPolicy确认权限为RemoteSigned；清理npm缓存后重新安装：

     npm cache clean --force
     npm install -g openclaw@latest
     

（二）模型配置类问题

1. 问题1：API-Key配置后提示“认证失败”

   • 解决方案：检查API-Key是否完整（无多余空格）；确认API-Key未被禁用；重新创建API-Key并配置。

2. 问题2：模型调用提示“地域不匹配”

   • 解决方案：确认模型配置的地域与API-Key地域一致；执行openclaw config set model.aliyun_bailian_coding.region "对应地域"，重启服务。

3. 问题3：本地大模型启动失败（MacOS/Linux）

   • 解决方案：检查Ollama是否安装成功（ollama --version）；重新拉取模型（ollama pull qwen2.5:7b）；确保电脑配置满足要求（至少8GB内存）。

（三）服务运行类问题

1. 问题1：服务启动失败，提示“端口被占用”

   • 解决方案：更换端口启动：openclaw gateway start --port 8080；查找并关闭占用端口的进程。

2. 问题2：树莓派断电后服务无法自动启动

   • 解决方案：确认已配置系统服务并启用开机自启；执行sudo systemctl enable --now openclaw重新启用。

3. 问题3：技能安装提示“网络超时”

   • 解决方案：配置ClawHub国内镜像：npx clawhub@latest config set registry https://mirror.aliyun.com/clawhub/；检查网络连接，关闭防火墙。

（四）其他问题

1. 问题1：如何备份配置与数据？

   • 解决方案：执行以下命令备份核心配置：

     # 备份配置文件
     cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
     # 备份技能配置
     cp -r ~/.openclaw/skills ~/.openclaw/skills.bak
     

2. 问题2：如何更新OpenClaw到最新版本？

   • 解决方案：npm update -g openclaw（所有平台通用），更新后重启服务：openclaw restart。

3. 问题3：如何关闭OpenClaw服务？

   • 解决方案：openclaw gateway stop（临时关闭）；sudo systemctl disable openclaw（禁止开机自启）。

五、总结：全场景部署核心要点

2026年的OpenClaw部署已实现全平台覆盖，不同用户可按需选择：预算有限选树莓派（零运行成本），企业用户选阿里云（稳定可靠），个人用户选本地部署（免费便捷）。核心要点总结：

1. 准备工作是基础：提前获取API-Key，安装核心依赖，避免部署中断；
2. 树莓派核心是“网关”：不跑本地大模型，专注指令转发，平衡成本与体验；
3. 模型配置双选项：免费模型零成本入门，百炼Coding Plan增强专业能力；
4. 避坑指南记牢记：树莓派需加swap、Windows需管理员权限、端口放行不可少。

无论你是技术爱好者、学生还是企业用户，都能通过本文的方案快速部署OpenClaw，实现任务自动化、提效降本的核心目标。现在跟着步骤动手操作，即可开启你的零成本AI助手之旅！