保姆级教程：1分钟阿里云/本地部署 OpenClaw 🦞AI 配置免费大模型 API + Skill 优化及避坑指南

2026年，OpenClaw（曾用名Clawdbot）作为开源AI智能体框架，凭借“灵活扩展、跨平台适配、低门槛部署”的核心优势，成为个人与轻量团队搭建专属AI助手的首选。但新手在部署过程中常面临多重痛点：系统环境配置复杂、模型调用超时、技能安装失败、局域网访问受限等。

本文基于实测经验与官方优化指南，整合四大核心内容：一是2026年OpenClaw全平台部署流程（阿里云+MacOS+Linux+Windows11）；二是阿里云百炼免费大模型API配置步骤；三是模型优化、技能管理、记忆系统升级等进阶操作；四是新手高频问题与解决方案，所有代码可直接复制执行，助力零基础用户1-2小时内完成部署与优化，解锁OpenClaw全功能。阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw部署与优化核心逻辑

（一）部署环境选型建议

OpenClaw对硬件要求较低，但不同部署场景的硬件配置需针对性适配：

• 网关主机：旧笔记本、迷你主机或阿里云服务器均可，最低配置4核CPU+8GB内存+SSD存储，确保网关流畅运行；
• 模型主机：若使用本地大模型（如Ollama、LM Studio），建议配备独立显卡（如RTX 4080 12GB），提升推理速度；无独立显卡可选择阿里云百炼API，零硬件门槛；
• 存储选择：优先使用SSD，提升技能安装、文件读写与模型加载速度，避免机械硬盘导致的卡顿。

（二）部署模式对比与选择

建议新手先通过本地部署熟悉操作，需长期运行或远程访问时迁移至阿里云。

（三）前置准备（必做，避免部署中断）

1. 账号与凭证准备

• 阿里云账号：注册阿里云账号 并完成实名认证，用于开通阿里云百炼免费API；
• 阿里云百炼API密钥：访问登录阿里云百炼大模型服务平台，开通服务后创建Access Key ID和Access Key Secret（保存至加密记事本）；
• 辅助工具：Chrome/Edge浏览器、SSH终端（FinalShell，阿里云部署用）、VS Code（文本编辑）、加密记事本（存储敏感凭证）、Rufus（制作Linux启动盘，可选）。

2. 设备与环境要求

• 系统要求：Windows11/10、MacOS 12+、Linux（Ubuntu 22.04 LTS）、阿里云服务器（Ubuntu 22.04 LTS）；
• 核心依赖：Node.js≥v22.0.0、Python≥3.9（部分功能依赖）、Git（技能安装依赖）；
• 网络要求：阿里云服务器优先选择中国香港地域（免备案），本地设备确保网络通畅，可正常下载依赖与API调用。

二、2026年OpenClaw全平台部署流程（零基础友好）

（一）阿里云部署（长期运行首选）

适合需要不间断运行、多设备远程访问的场景，依托云服务器稳定性，支持进阶优化，新手30分钟可完成。

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

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

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

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

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

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

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

1. 服务器选购与基础配置

1. 服务器选购：

   • 访问阿里云轻量应用服务器控制台，选择“Ubuntu 22.04 LTS”系统镜像；
   • 核心配置：4vCPU+8GiB内存+40GiB ESSD+200Mbps带宽，地域选择中国香港（免备案），付费类型选“包年包月”；
   • 提交订单后，等待实例状态变为“运行中”，记录公网IP、登录账号（默认root）与密码。

2. 端口放行与环境准备：

# 1. SSH登录服务器（替换为你的公网IP）
ssh root@你的服务器公网IP

# 2. 一键放行核心端口
sudo apt install ufw -y
sudo ufw allow 22/tcp  # SSH连接端口
sudo ufw allow 18789/tcp  # OpenClaw核心端口
sudo ufw allow 443/tcp  # API调用端口
sudo ufw enable
sudo ufw status  # 显示“ALLOW”即为成功

# 3. 更新系统依赖并安装核心工具
sudo apt update && sudo apt upgrade -y
sudo apt install curl git python3-pip openssh-server -y

# 4. 安装Node.js 22+（稳定版）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 5. 配置npm国内镜像，加速安装
npm config set registry https://registry.npmmirror.com

# 6. 开启SSH服务（便于远程管理）
sudo systemctl enable ssh --now

2. OpenClaw安装与初始化

# 1. 一键安装OpenClaw（官方脚本，自动适配环境）
curl -fsSL https://openclaw.ai/install.sh | bash

# 2. 运行配置向导（核心步骤，按提示操作）
openclaw onboard

# 交互配置步骤（新手直接按以下提示选择）
# 1. 接受风险提示：输入Yes
# 2. 选择模型提供商：暂时选择“Custom Provider”（后续配置百炼API）
# 3. 网关绑定：选择lan（监听所有网络接口，支持多设备访问）
# 4. 频道配置：输入Skip（后续按需添加）
# 5. 技能配置：输入Skip（后续手动安装）
# 6. 钩子（Hooks）：输入Skip
# 7. 孵化方式：选择Open the Web UI（启动Web控制台）

# 3. 启动网关服务
openclaw gateway start

# 4. 生成访问令牌（登录控制台需用，复制保存）
openclaw config get gateway.auth.token

3. 部署验证

• 浏览器输入 http://服务器公网IP:18789，粘贴访问令牌，能正常进入Web控制台即为部署成功；
• 命令行验证：openclaw gateway status，显示“running”即为服务正常。

（二）本地部署（Windows11+MacOS+Linux）

1. Windows11部署（办公场景适配）

系统要求：Windows11/10 64位、4GB+内存（推荐8GB+）、10GB+可用空间

# 1. 以管理员身份打开PowerShell（右键开始菜单选择）
# 2. 解决执行策略限制（避免脚本无法运行）
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

# 3. 安装核心依赖（Node.js 22+、Python 3.9、Git）
winget install OpenJS.NodeJS.LTS --version 22.2.0
winget install Python.Python.3.9
winget install Git.Git

# 4. 配置npm国内镜像，加速安装
npm config set registry https://registry.npmmirror.com

# 5. 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 6. 运行配置向导
openclaw onboard

# 交互步骤（参考阿里云部署的选择）
# 1. 接受风险提示：输入Yes
# 2. 模型提供商：选择Custom Provider
# 3. 网关绑定：选择lan
# 4. 其余步骤：均输入Skip

# 7. 启动网关服务
openclaw gateway start

# 8. 获取访问令牌
openclaw config get gateway.auth.token

关键配置（必做）：

• 将C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表，避免被误判为病毒；
• 若出现“权限不足”报错，执行icacls %USERPROFILE%\.openclaw /grant:r 你的用户名:(F)赋予完全控制权限。

访问方式：浏览器输入 http://localhost:18789，粘贴令牌即可登录。

2. MacOS部署（体验最佳，推荐）

系统要求：MacOS 12+（M系列/Intel芯片）、8GB+内存、10GB+可用空间

# 1. 打开终端（Cmd + Space输入“Terminal”）
# 2. 安装Homebrew（国内用户用镜像加速）
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

# 3. 安装核心依赖（Node.js 22、Python 3.9、Git）
brew install node@22 python@3.9 git

# 4. 配置Node.js环境变量（确保全局可调用）
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 5. 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 6. 运行配置向导
openclaw onboard

# 交互步骤（参考阿里云部署）
# 1. 接受风险提示：输入Yes
# 2. 模型提供商：选择Custom Provider
# 3. 网关绑定：选择lan
# 4. 其余步骤：均输入Skip

# 7. 启动网关服务（后台运行）
nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 &

# 8. 获取访问令牌
openclaw config get gateway.auth.token

M系列芯片避坑：若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖，避免Rosetta 2转译兼容性问题。

访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录。

3. Linux部署（Ubuntu 22.04 LTS，稳定性强）

系统要求：Ubuntu 22.04 LTS、4GB+内存、10GB+可用空间

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

# 2. 安装核心工具
sudo apt install curl git python3-pip openssh-server -y

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

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

# 5. 开启SSH服务
sudo systemctl enable ssh --now

# 6. 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 7. 运行配置向导
openclaw onboard

# 交互步骤（参考阿里云部署）
# 1. 接受风险提示：输入Yes
# 2. 模型提供商：选择Custom Provider
# 3. 网关绑定：选择lan
# 4. 其余步骤：均输入Skip

# 8. 启动网关服务并设置开机自启
sudo systemctl enable --now openclaw
openclaw gateway start

# 9. 获取访问令牌
openclaw config get gateway.auth.token

访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录。

三、阿里云百炼免费API配置（核心步骤，零成本解锁智能）

（一）API密钥获取步骤

1. 登录阿里云官网，访问登录阿里云百炼大模型服务平台；
2. 点击“开通服务”，阅读并同意服务协议，新用户自动领取90天免费额度（可在“费用管理”中查看）；
3. 进入“密钥管理”页面，点击“创建Access Key”，完成身份验证（短信/扫码）后，生成Access Key ID和Access Key Secret；
4. 复制并保存密钥（仅创建时可完整查看Access Key Secret，丢失需重新创建）；
5. 开启“消费限额”（推荐）：进入“费用管理”→“消费限额”，设置每月最大消费额度，避免超额计费。

（二）OpenClaw对接阿里云百炼API（全环境通用）

# 1. 配置百炼API密钥（替换为你的凭证）
openclaw config set models.providers.bailian.accessKeyId "你的Access Key ID"
openclaw config set models.providers.bailian.accessKeySecret "你的Access Key Secret"

# 2. 配置国内接口地址（降低延迟）
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"

# 3. 设置默认模型（推荐qwen3.5，免费额度足够使用）
openclaw config set models.default "qwen3.5"

# 4. 配置上下文窗口（避免“窗口过小”错误）
openclaw config set models.providers.bailian.models.0.contextWindow 32768

# 5. 配置超时时间与优化参数
openclaw config set models.providers.bailian.timeout 60000
openclaw config set models.providers.bailian.skillCooperation true

# 6. 重启网关生效（不同环境重启命令）
# 阿里云/Linux
openclaw gateway restart

# MacOS
pkill -f openclaw && nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 &

# Windows11（PowerShell）
openclaw gateway stop
openclaw gateway start

（三）API配置验证与避坑要点

1. 验证方法：登录OpenClaw Web控制台，输入测试指令：帮我生成一份2026年4月工作周报模板，返回结构化回复即为配置成功；
2. 避坑要点：
   • 密钥复制错误→逐字符核对，避免多余空格或换行，区分Access Key ID与Secret；
   • 接口地址错误→国内部署必须使用指定地址，否则调用超时；
   • 上下文窗口不匹配→确保配置的contextWindow与模型支持的一致（qwen3.5支持32768）；
   • 服务未重启→配置后必须重启网关，否则配置不生效。

四、OpenClaw进阶优化（性能与功能双提升）

（一）局域网访问配置（多设备共享）

若需局域网内其他设备访问OpenClaw，需完成以下配置（全环境通用）：

# 1. 确认网关绑定为lan（已通过配置向导设置，再次验证）
openclaw config set gateway.bind lan

# 2. 放行防火墙端口（确保局域网设备可访问）
sudo ufw allow 18789/tcp
sudo ufw reload

# 3. 允许不安全认证（解决浏览器设备标识问题）
openclaw config set gateway.controlUi.allowInsecureAuth true

# 4. 添加允许的来源（替换为你的服务器/本地IP）
openclaw config set gateway.controlUi.allowedOrigins '["http://你的IP:18789", "http://localhost:18789", "http://127.0.0.1:18789"]'

# 5. 重启网关生效
openclaw gateway restart

配置完成后，局域网内其他设备可通过 http://你的IP:18789 访问控制台。

（二）技能安装与管理（扩展核心能力）

1. 安装联网搜索技能（以百度搜索为例）

# 1. 从ClawHub安装技能（网络不佳可手动下载解压至~/.openclaw/skills/）
npx clawhub@latest install baidu-search

# 2. 配置技能API密钥（替换为你的百度搜索API密钥）
openclaw config set env.BAIDU_API_KEY "你的百度搜索API密钥"

# 3. 重启网关生效
openclaw gateway restart

# 4. 验证技能状态（显示ready即为成功）
openclaw skills info baidu-search

2. 安装浏览器自动化技能（控制Chrome浏览器）

# 1. 安装官方Chrome浏览器（非Snap版本，Linux示例）
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y

# 2. 配置浏览器自动化（全环境通用）
openclaw config set browser.enabled true
openclaw config set browser.executablePath "/usr/bin/google-chrome-stable"  # Linux路径
# Windows路径：C:/Program Files/Google/Chrome/Application/chrome.exe
# MacOS路径：/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
openclaw config set browser.headless true  # 无头模式，不显示浏览器窗口
openclaw config set browser.noSandbox true
openclaw config set browser.attachOnly false
openclaw config set browser.defaultProfile "openclaw"

# 3. 重启网关并验证状态
openclaw gateway restart
openclaw browser status  # 显示running: true和cdpReady: true即为成功

（三）记忆系统优化（QMD语义记忆）

安装QMD实现语义记忆，提升长对话响应速度，减少重复提问：

# 1. 安装bun（QMD依赖）
npm i -g bun

# 2. 安装QMD语义记忆工具
bun install -g github:tobi/qmd

# 3. 创建软链接（Linux/MacOS，确保全局可调用）
sudo ln -s $(which qmd) /usr/local/bin/qmd

# 4. 配置OpenClaw使用QMD
openclaw config set memory.backend qmd
openclaw config set memory.qmd.limits.timeoutMs 8000

# 5. 重启网关生效
openclaw gateway restart

# 6. 验证（日志中出现qmd memory backend enabled即为成功）
openclaw logs --follow | grep qmd

（四）分层模型策略（提升响应效率）

为不同任务配置不同模型，简单任务用小模型，复杂任务用云端模型：

# 1. 配置小模型处理简单任务（如本地Ollama qwen:7b）
openclaw config set models.providers.ollama.baseUrl "http://localhost:11434/api/generate"
openclaw config set models.providers.ollama.models.0.id "qwen:7b"
openclaw config set models.providers.ollama.models.0.contextWindow 16384

# 2. 配置云端模型处理复杂任务（阿里云百炼qwen3.5）
openclaw config set models.providers.bailian.models.0.id "qwen3.5"
openclaw config set models.providers.bailian.models.0.contextWindow 32768

# 3. 配置路由逻辑（简单任务关键词：总结、翻译、查询；复杂任务：分析、生成、开发）
openclaw config set models.routing '{"simple":["总结","翻译","查询"],"complex":["分析","生成","开发"]}'
openclaw config set models.default "ollama:qwen:7b"
openclaw config set models.complexDefault "qwen3.5"

# 4. 重启网关生效
openclaw gateway restart

五、新手高频问题解答

（一）部署类问题

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

   • 解决方案：执行openclaw gateway stop停止旧进程，再执行openclaw gateway start；若仍失败，Windows执行netstat -ano | findstr "18789"，Mac/Linux执行lsof -i:18789，终止占用进程后重启。

2. 问题2：Web控制台无法加载，提示ERR_SSL_PROTOCOL_ERROR？

   • 原因：误用HTTPS访问HTTP端口；
   • 解决方案：使用http://你的IP:18789访问，确保已开启allowInsecureAuth: true。

3. 问题3：Mac M系列芯片安装QMD失败？

   • 解决方案：执行arch -arm64 bun install -g github:tobi/qmd，指定ARM架构安装，或手动下载源码解压至对应目录。

4. 问题4：Linux部署后，SSH无法远程连接？

   • 解决方案：确认SSH服务已开启（sudo systemctl status ssh），防火墙放行22端口（sudo ufw allow 22/tcp），重新尝试连接。

（二）API与模型类问题

1. 问题1：阿里云百炼API调用提示“密钥无效”？

   • 解决方案：逐字符核对API密钥，删除多余空格；登录百炼控制台，确认密钥未过期、未被禁用，若丢失，重新创建密钥。

2. 问题2：模型调用提示“context window too small”？

   • 原因：上下文窗口设置过小，与模型支持的不一致；
   • 解决方案：同步修改OpenClaw与模型的上下文窗口（如设置为32768），参考API配置中的上下文窗口配置命令。

3. 问题3：本地模型调用超时或速度慢？

   • 解决方案：① 关闭其他占用显存/内存的程序；② 降低模型参数（如从14B改为7B）；③ 启用QMD记忆系统；④ 升级显卡驱动至最新版本。

（三）技能与配置类问题

1. 问题1：技能安装后显示“missing”，无法使用？

   • 原因：缺少依赖（API密钥、工具、系统组件）；
   • 解决方案：执行openclaw skills info 技能名查看缺失项，补全API密钥或安装对应依赖，重启网关后技能自动变为“ready”。

2. 问题2：配置文件修改后报错，提示JSON语法错误？

   • 解决方案：① 执行openclaw doctor --fix自动修复；② 手动编辑~/.openclaw/openclaw.json，检查中文逗号、多余括号等错误；③ 执行python3 -m json.tool ~/.openclaw/openclaw.json验证格式。

3. 问题3：局域网内其他设备无法访问OpenClaw？

   • 解决方案：① 确认网关绑定为lan（openclaw config get gateway.bind）；② 检查防火墙18789端口已放行；③ 确认allowedOrigins已添加局域网IP；④ 关闭设备防火墙或添加例外。

（四）日常维护命令

六、总结

OpenClaw的部署与优化核心在于“环境适配+模型配置+功能扩展”，本文通过全平台部署流程、免费API配置、进阶优化操作与高频问题解答，助力新手快速落地。核心要点总结：

1. 部署选择：阿里云适合长期运行与远程访问，本地部署适合隐私敏感场景，MacOS/Linux兼容性更佳；
2. API配置：阿里云百炼免费额度充足，核心是正确填写密钥、配置上下文窗口，重启网关生效；
3. 进阶优化：局域网访问需配置绑定地址与防火墙，技能安装需补全依赖，QMD记忆系统可提升长对话效率；
4. 避坑核心：确保Node.js版本≥22.0.0，配置文件格式正确，端口放行到位，模型与上下文窗口匹配。

通过本文的流程与技巧，零基础用户可快速解锁OpenClaw全功能，无论是日常轻量任务、复杂数据分析，还是多设备协同，都能通过优化配置实现高效运行，真正发挥AI智能体的核心价值。