OpenClaw（小龙虾）新手避坑部署+千问/Coding Plan API配置教程

2026年初，OpenClaw（昵称“小龙虾”）以14.5万颗GitHub Stars的爆发式增速，成为开源AI智能体领域的黑马。这款由Peter Steinberger开发的执行框架，彻底打破传统AI“被动对话”的局限，凭借“自我迭代、主动出击、高度定制”三大核心优势，让AI从“能说会道”升级为“真正会干活”——它能记住用户习惯、主动捕捉任务机会，甚至通过技能扩展实现文件管理、代码开发、自动化办公等实际操作，成为个人与轻量团队的高效协作助手。

OpenClawo.png

OpenClaw的核心价值在于“思考+执行”的闭环能力，而这一能力的落地离不开两大关键：一是适配的部署方案，二是可靠的大模型API支持。对于零基础用户而言，部署流程复杂、API配置混乱、系统兼容性问题是主要痛点。本文基于2026年最新技术迭代与实测数据，完整拆解阿里云部署与Windows11/MacOS/Linux本地部署全流程，详细讲解阿里云千问大模型API与免费Coding Plan API的配置步骤，搭配可直接复制的代码命令与常见问题解答，全程无营销词汇，不提及无关平台，确保新手按步骤操作，30分钟内即可完成从部署到落地的全流程，充分释放OpenClaw的自动化价值。

一、核心认知：OpenClaw的底层逻辑与部署选型

（一）OpenClaw的核心架构：不止是AI，更是“执行型助手”

OpenClaw采用“网关-智能体-渠道-技能-记忆”五层架构，核心由四大模块构成：

1. Gateway网关：负责请求路由、权限控制与多渠道适配，是OpenClaw的“中枢神经”；

2. Agent智能体：承担任务规划、逻辑推理与技能调度，依托大模型实现自然语言理解与复杂任务拆解；

3. Skills技能：连接AI与现实世界的“手脚”，采用声明式、模块化、沙箱化设计，支持热插拔，涵盖文件管理、网页抓取、邮件处理等各类实用功能，ClawHub社区已提供数百款现成技能；

4. Memory记忆：实现永久记忆用户习惯、目标与交互历史，每一次互动都让AI更贴合个人需求。

核心结论：没有技能的OpenClaw只是“空有大脑的AI”，缺乏大模型支持的OpenClaw则无法实现高效推理，部署与API配置是发挥其价值的基础前提。

（二）部署方案对比：按需选择最适合你的方式

结合2026年实测优化，OpenClaw主要支持三大部署方案，适配不同用户需求：

部署方案核心优势适用人群操作难度成本水平核心特点阿里云部署7×24小时稳定运行、多设备访问、深度定制、数据私密开发者、长期使用者、团队用户★★★☆☆低（服务器约2美元/月起）完全自主控制，支持技能扩展与自动化任务，适合长期使用本地部署（Win11/MacOS/Linux）零服务器费用、数据本地存储、隐私可控、调试便捷新手、注重隐私、短期体验用户★★☆☆☆零成本（仅模型API费用）桌面一键安装，下载即用，适合快速体验核心功能云端托管服务免部署、免运维、开箱即用不想维护服务器的用户★☆☆☆☆中（订阅制约199元/月）省心省力，但定制化受限，本文重点覆盖前两种方案

选型建议：新手/普通用户优先选择本地部署，零成本快速体验；开发者/长期使用者推荐阿里云部署，享受稳定运行与深度定制能力。

（三）前置准备（全方案通用）

1. 账号准备：

   • 阿里云账号：注册阿里云账号并完成实名认证（用于服务器购买与千问API开通）；

   • GitHub账号（可选）：用于技能开发与社区交流；

   • 大模型平台账号：访问登录阿里云百炼大模型服务平台，阿里云百炼平台（获取千问API）或Coding Plan支持平台（获取免费API）。

2. 工具准备：

   • 远程连接工具：FinalShell（用于阿里云服务器操作，可选）；

   • 文本编辑器：VS Code/记事本（修改配置文件）；

   • 基础工具：Git（技能安装必需）、Chrome/Edge浏览器（访问控制台）；

3. 硬件与环境要求：

   • 本地部署：CPU≥2核，内存≥4GB，磁盘预留≥20GB SSD；

   • 阿里云部署：推荐2vCPU+4GiB内存配置（最低2vCPU+2GiB，低于此配置会导致服务启动失败）；

   • 核心依赖：Node.js 22.x版本（所有部署方案必需，一键安装脚本会自动配置）。

二、2026年阿里云部署OpenClaw(Clawdbot)全流程

阿里云部署适合需要长期稳定运行、多设备访问的场景，2026年阿里云推出OpenClaw专属预装镜像，将原本数小时的配置流程简化为“一键部署”，新手也能轻松操作。

（一）部署前补充准备

1. 确保阿里云账号已完成实名认证，且账号余额充足或开通按量付费权限；

2. 提前获取阿里云千问API-Key（获取路径：访问登录阿里云百炼大模型服务平台→密钥管理→创建API-Key），生成后立即保存（仅生成时可完整查看）；

3. 选择合适的服务器地域：优先选美国弗吉尼亚、新加坡（支持联网搜索、多渠道集成，无国内网络限制），国内用户可选中国香港（兼顾速度与功能完整性）；国内地域（除香港）的轻量应用服务器，联网搜索功能受限，需提前知晓。

（二）分步部署流程（全程可视化+代码复制）

步骤1：购买阿里云轻量应用服务器

1. 访问阿里云OpenClaw一键部署专题页面，点击“一键购买并部署”；

2. 核心参数配置（新手直接照抄，无需修改）：

   • 镜像类型：选择“应用镜像”→“OpenClaw（原Clawdbot）2026专属镜像”（基于Alibaba Cloud Linux 3.2104 LTS构建，预装Node.js 22、Docker、OpenClaw核心程序）；

   • 实例规格：2vCPU+4GiB内存、5Mbps带宽、40GB高效云盘（最低要求2vCPU+2GiB内存）；

   • 地域：根据需求选择（海外地域功能无限制，国内地域需备案）；

   • 实例名称：自定义（如“OpenClaw-2026-阿里云”）；

   • 登录方式：选择“密码登录”，设置复杂密码（包含大小写字母、数字、特殊符号），牢记备用；

   • 购买时长：测试阶段选1个月，长期使用推荐1年（性价比更高）；

3. 支付订单后，等待5-10分钟，直至实例状态变为“运行中”，记录服务器公网IP（后续配置需用到）。

步骤2：远程连接服务器

1. 进入轻量应用服务器实例详情页，点击“远程连接”→“Web终端”，输入服务器密码登录（无需本地SSH工具，新手推荐）；

2. 验证服务器状态与预装环境，执行以下命令：

   # 查看系统内核版本（正常输出为5.10.x-aliyun.x86_64） uname -r # 查看Docker版本（正常输出为20.10.x+） docker -v # 查看OpenClaw服务状态（正常输出为active(running)） systemctl status openclaw

   若OpenClaw服务未启动，执行以下命令启动：

   systemctl start openclaw systemctl enable openclaw # 设置开机自启

步骤3：端口放行（必做，否则无法访问）

OpenClaw依赖1878（控制台端口）与18789（服务通信端口），需执行以下命令放行：

# 安装防火墙（若未预装） yum install firewalld -y # 启动防火墙并设置开机自启 systemctl start firewalld systemctl enable firewalld # 放行核心端口 firewall-cmd --add-port=1878/tcp --permanent firewall-cmd --add-port=18789/tcp --permanent # 重启防火墙使配置生效 firewall-cmd --reload # 验证端口放行状态（输出1878/tcp、18789/tcp即为成功） firewall-cmd --list-ports | grep -E "1878|18789"

若仍无法访问，可在阿里云控制台手动添加安全组规则，将上述端口的入方向来源设为“0.0.0.0/0”（测试阶段使用）。

步骤4：配置大模型API（千问/Coding Plan二选一）

方式1：阿里云千问大模型API配置（稳定优先）

阿里云百炼提供90天7000万Token免费额度，足够日常使用，访问订阅阿里云百炼Coding Plan，配置步骤如下：

# 1. 进入OpenClaw配置目录 cd /opt/openclaw/config # 2. 编辑配置文件，添加千问API-Key（替换为你的API-Key） nano openclaw.json # 3. 在配置文件中添加以下内容 "model": { "provider": "qianwen", "apiKey": "你的阿里云百炼API-Key", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "modelName": "qwen3-max", "temperature": 0.7, "maxTokens": 2048 } # 4. 保存并退出（按Ctrl+O保存，Ctrl+X退出） # 5. 重启OpenClaw服务，使配置生效 systemctl restart openclaw

为避免API-Key泄露，推荐将其配置为环境变量：

# 配置永久性环境变量（Linux/MacOS通用） echo "export DASHSCOPE_API_KEY='你的阿里云百炼API-Key'" >> ~/.bashrc source ~/.bashrc # 验证环境变量是否生效 echo $DASHSCOPE_API_KEY

方式2：免费Coding Plan API配置（零成本优先）

以智谱AI Coding Plan为例（免费额度充足，新手首选），配置步骤如下：

# 1. 进入OpenClaw配置目录 cd /opt/openclaw/config # 2. 编辑配置文件，添加Coding Plan API（替换为你的API-Key） nano openclaw.json # 3. 在配置文件中添加以下内容 "model": { "provider": "zhipu", "apiKey": "你的智谱Coding Plan API-Key", "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4/", "modelName": "glm-4-coding", "temperature": 0.7, "maxTokens": 2048 } # 4. 保存并退出，重启服务 systemctl restart openclaw

步骤5：生成访问Token并验证部署

1. 执行以下命令生成管理员Token（登录控制台必需）：

   openclaw token generate --admin

2. 复制生成的Token，打开浏览器输入http://你的服务器公网IP:18789/?token=生成的Token，登录OpenClaw控制台；

3. 发送测试指令验证功能：“帮我创建一个文本文件，内容为‘OpenClaw阿里云部署成功’，保存至/opt/openclaw/data目录”，若能正常执行并返回文件路径，说明部署与API配置均成功。

三、2026年本地部署OpenClaw(Clawdbot)全流程（Win11/MacOS/Linux）

本地部署零成本、隐私可控，支持一键安装与手动安装双方案，新手优先选择一键安装，便捷高效。

（一）Windows11系统本地部署

方案1：一键安装（推荐，零代码）

1. 下载Windows11专属安装包（国内镜像，加速下载）：

   • 文件名称：workbuddy (Windows版).zip，大小537.1MB；

2. 解压安装包，双击“OpenClaw.exe”，按提示完成安装（默认安装路径即可）；

3. 启动程序后，系统自动初始化配置，浏览器自动跳转至http://localhost:18789，无需额外配置，直接使用。

方案2：手动安装（备用，适配自定义需求）

1. 以管理员身份打开PowerShell，执行以下命令安装基础依赖：

   # 安装Git winget install Git.Git git --version # 验证安装（输出2.x.x即为成功） # 安装Node.js 22.x（国内镜像加速） iwr -useb https://npmmirror.com/mirrors/node/v22.10.0/node-v22.10.0-x64.msi -OutFile node-install.msi Start-Process .node-install.msi -Wait node -v # 需显示v22.x.x # 配置npm国内镜像 npm config set registry https://registry.npmmirror.com # 全局安装OpenClaw npm install -g openclaw@latest # 启动初始化向导 openclaw onboard --mode QuickStart

2. 按初始化向导提示操作：同意免责声明→选择“本地部署”→启用记忆功能→完成配置；

3. 启动服务并生成Token：

   openclaw gateway start --port 18789 openclaw token generate --admin --allow-ip 127.0.0.1

4. 浏览器输入http://127.0.0.1:18789/?token=生成的Token，登录使用。

（二）MacOS系统本地部署

方案1：一键安装（推荐）

1. 下载MacOS专属安装包（同Windows11下载地址），文件名称：workbuddy (mac苹果电脑版).zip，大小562.1MB；

2. 解压后将“OpenClaw.app”拖入应用程序文件夹，双击启动；

3. 系统自动初始化，浏览器跳转至http://localhost:18789，直接登录使用。

方案2：手动安装（备用）

1. 打开终端，安装Homebrew（若未安装）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装基础依赖并配置镜像：

   brew install node@22 git brew link node@22 --force npm config set registry https://registry.npmmirror.com # 全局安装OpenClaw npm install -g openclaw@latest # 初始化并启动服务 openclaw onboard --mode QuickStart openclaw gateway start --port 18789 # 生成Token openclaw token generate --admin --allow-ip 127.0.0.1

3. 浏览器输入http://127.0.0.1:18789/?token=生成的Token，登录验证。

（三）Linux系统本地部署（以Ubuntu为例）

1. 打开终端，更新系统依赖并安装基础工具：

   sudo apt update && sudo apt upgrade -y # 安装Node.js 22.x curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs git # 配置npm国内镜像 npm config set registry https://registry.npmmirror.com # 全局安装OpenClaw sudo npm install -g openclaw@latest

2. 初始化并设置开机自启：

   openclaw onboard --mode QuickStart # 设置开机自启 sudo systemctl enable openclaw sudo systemctl start openclaw

3. 生成Token并验证：

   openclaw token generate --admin # 浏览器输入http://服务器IP:18789/?token=生成的Token，登录使用

（四）本地部署大模型API配置（千问/Coding Plan二选一）

方式1：阿里云千问API配置

1. 进入本地OpenClaw配置目录：

   • Windows11：cd $HOME/.openclaw/config

   • MacOS/Linux：cd ~/.openclaw/config

2. 编辑配置文件，添加千问API-Key：

   # Windows11：notepad openclaw.json # MacOS/Linux：nano openclaw.json

3. 添加以下配置（替换为你的API-Key）：

   "model": { "provider": "qianwen", "apiKey": "你的阿里云百炼API-Key", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "modelName": "qwen3-max", "temperature": 0.7, "maxTokens": 2048 }

4. 保存并重启服务：

   # Windows11：openclaw gateway restart # MacOS/Linux：sudo systemctl restart openclaw

方式2：免费Coding Plan API配置

1. 编辑本地配置文件，添加以下内容（以智谱为例）：

   "model": { "provider": "zhipu", "apiKey": "你的智谱Coding Plan API-Key", "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4/", "modelName": "glm-4-coding", "temperature": 0.7, "maxTokens": 2048 }

2. 重启服务，验证配置成功：

   openclaw chat "帮我总结OpenClaw的核心功能"

   若返回完整总结，说明API配置成功。

四、OpenClaw基础使用与技能扩展（新手必备）

部署与API配置完成后，可通过技能扩展OpenClaw的能力，以下是新手必备的基础操作与技能推荐：

（一）基础操作命令（全部署方案通用）

# 查看OpenClaw版本 openclaw --version # 查看服务状态 # 阿里云/ Linux：systemctl status openclaw # 本地Windows11/MacOS：openclaw status # 重启服务 # 阿里云/ Linux：systemctl restart openclaw # 本地Windows11/MacOS：openclaw gateway restart # 查看已安装技能 openclaw skills list --status ready # 安装常用技能 openclaw skills install file-manager summarize agent-browser email-manager # 卸载技能 openclaw skills uninstall [技能名称] # 查看运行日志（排查问题用） openclaw logs

（二）新手必装技能（适配千问/Coding Plan）

1. file-manager（文件管理技能）：支持自然语言操作本地/云端文件，如创建、修改、删除文件，是基础必备技能；

2. summarize（文本总结技能）：支持URL、PDF、长文本总结，搭配千问/Coding Plan的长上下文能力，快速提取核心信息；

3. agent-browser（浏览器自动化技能）：实现网页抓取、模拟点击等操作，自动获取实时数据；

4. email-manager（邮件管理技能）：支持邮件发送、接收、分类，实现办公自动化闭环；

5. skill-vetter（安全技能）：安装前扫描技能安全性，避免恶意插件风险。

（三）实战场景示例（OpenClaw+大模型协同）

场景1：自动化文件处理

指令：帮我完成以下任务： 1. 创建一个名为“2026工作记录”的文件夹，保存至本地桌面/阿里云服务器/opt/openclaw/data目录； 2. 新建文本文件，内容为“3月25日：完成OpenClaw部署与千问API配置”； 3. 将文件保存至上述文件夹，命名为“每日记录.txt”。

执行逻辑：大模型拆解任务，OpenClaw调用file-manager技能执行操作，全程无需手动干预。

场景2：网页数据抓取与总结

指令：用agent-browser技能访问阿里云百炼官网，抓取千问大模型的核心特性，用summarize技能总结为3条核心要点，保存至文本文件。

执行逻辑：大模型规划抓取流程，OpenClaw调用对应技能完成数据抓取与总结，原本30分钟的工作缩短至5分钟。

五、常见问题全面排查（新手必看）

（一）部署类问题

1. OpenClaw服务启动失败（提示“内存不足”）：

   • 成因：服务器/本地设备内存低于2GB，不满足最低配置要求；

   • 解决方案：升级服务器实例规格至2vCPU+2GiB以上，本地部署确保内存≥4GB，重启服务。

2. 浏览器无法访问控制台（提示“无法连接”）：

   • 成因：端口未放行、服务未启动、IP/Token输入错误；

   • 解决方案：

     # 1. 检查服务状态，确保正常运行 systemctl status openclaw（阿里云/Linux）/openclaw status（本地） # 2. 重新放行端口（以18789为例） firewall-cmd --add-port=18789/tcp --permanent && firewall-cmd --reload # 3. 核对服务器IP与Token，确保无输入错误

3. 本地一键安装失败（提示“文件损坏”）：

   • 成因：安装包下载不完整、杀毒软件拦截；

   • 解决方案：重新下载安装包，关闭杀毒软件后重试，或选择手动安装方案。

（二）API配置类问题

1. 大模型调用失败（提示“API-Key无效”）：

   • 成因：API-Key复制错误、过期、未完成实名认证；

   • 解决方案：重新生成API-Key，确保无多余空格，完成平台实名认证，重启服务。

2. API调用无响应（提示“网络超时”）：

   • 成因：服务器地域限制、网络不通、Base URL填写错误；

   • 解决方案：

     • 阿里云部署切换至海外/香港地域；

     • 测试网络连通性：ping dashscope.aliyuncs.com（千问）/ping open.bigmodel.cn（智谱）；

     • 核对Base URL，确保与大模型平台一致。

3. Token消耗过快：

   • 成因：大模型参数设置过高（如maxTokens=4096）、长文本交互频繁；

   • 解决方案：优化模型参数，降低maxTokens与temperature，避免无意义的长文本交互：

     openclaw config set model.maxTokens 1024 --json openclaw config set model.temperature 0.3 --json

（三）技能类问题

1. 技能安装失败（提示“网络超时”）：

   • 成因：网络不稳定、未切换国内镜像；

   • 解决方案：

     npm config set registry https://registry.npmmirror.com openclaw skills install [技能名称] --force

2. 技能执行无响应：

   • 成因：技能未启用、权限不足、与大模型协同异常；

   • 解决方案：

     openclaw skills enable [技能名称] openclaw gateway restart（本地）/systemctl restart openclaw（阿里云）

六、总结

2026年的OpenClaw已实现部署门槛的大幅降低，阿里云专属镜像的“一键部署”与本地的“零代码安装”，让零基础用户也能快速落地。通过本文的双部署流程，搭配阿里云千问或免费Coding Plan API配置，新手可在30分钟内完成从环境搭建到功能验证的全流程，充分发挥OpenClaw“思考+执行”的核心价值。

核心建议：新手从本地部署入手，零成本体验核心功能；长期使用者选择阿里云部署，享受7×24小时稳定运行与深度定制能力；技能安装遵循“按需选择”原则，避免冗余插件占用资源；API-Key需妥善保管，定期更换，降低泄露风险。

随着OpenClaw社区的持续迭代与大模型技术的升级，其自动化能力还将不断拓展。建议定期更新OpenClaw版本与技能，保持API配置的有效性，让AI助手持续适配个人与团队的需求，真正成为提升效率、释放生产力的得力帮手。