OpenClaw(Clawdbot)解析：OpenClaw是什么、能做什么？保姆级部署步骤（阿里云+本地）+ 免费多模型API配置+常见问题解答

在AI技术飞速迭代的2026年，“能说会道”的对话式AI已不再新鲜，而能“落地干活”的自动化AI代理成为新的核心需求。OpenClaw（前身为Clawdbot、Moltbot，俗称“龙虾AI”）作为开源本地AI智能体的领军者，凭借“本地优先、强执行能力、多端适配”的核心优势，快速崛起为个人与企业构建专属“数字员工”的首选工具。截至2026年3月，其GitHub星标数已突破24.7万，社区贡献者超300人，技能生态覆盖办公、开发、生活等全场景，真正实现了从“对话建议”到“自动化执行”的跨越，被用户亲切称为“真正干活的AI”，用户群体也自嘲为“养虾人”“甲壳教徒”，项目口号更是直白点出其核心价值——“The AI that actually does things”（真正干活的AI）。

很多新手对OpenClaw的认知存在偏差，误以为它只是一款普通的对话式AI，实则它是一款遵循MIT协议的开源、本地优先的AI自动化代理引擎，核心是让AI直接操控设备、自动完成工作流，打破了传统AI“只说不做”的局限。本文将从“核心认知、全平台部署、百炼API配置、实战场景、常见问题”五大维度，结合2026年最新稳定版（v2026.3.8），为大家带来保姆级全流程指南，所有代码可直接复制执行，全程大白话讲解，同时严格规避指定平台，聚焦阿里云与本地全平台部署，兼顾实用性与便捷性，助力零基础用户1-2小时内从0到1部署成功，彻底解锁OpenClaw的全部核心能力。阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw(Clawdbot)是什么？能做什么？

（一）OpenClaw的本质与起源

OpenClaw由奥地利程序员Peter Steinberger主导开发，2025年10月在GitHub首发，曾用名Clawdbot、Moltbot（均延续龙虾主题），2026年初正式定名，其“龙虾”的昵称与图标源于“OpenClaw = 开放的爪子”的意象，象征着它“抓取任务、执行任务”的核心能力。它采用MIT开源许可证，可免费使用，核心设计理念是将大语言模型（LLM）的自然语言理解能力与系统级执行能力深度结合，强调本地优先、数据主权，避免云端隐私风险，同时以模块化技能（Skills）实现功能的无限扩展。

与传统对话式AI（如ChatGPT、豆包）、普通自动化工具（如n8n、Zapier）相比，OpenClaw的核心差异的在于“任务统筹与自主执行能力”，用一张表格就能清晰区分：

简单来说，OpenClaw就像一个24小时待命的“全能数字员工”：你只需下达一个自然语言目标指令（比如“整理本周下载文件夹的文件”），它就会自动拆解任务、调用对应的技能插件、协调执行顺序，最后直接交付成果，全程无需你中间干预，彻底摆脱“逐个对接工具、手动监督环节”的低效模式。

（二）OpenClaw的核心技术架构与特性

OpenClaw采用三层架构设计，逻辑清晰、扩展性强，同时具备五大核心特性，适配不同用户的需求：

1. 三层核心架构

• 网关（Gateway）：消息路由中枢，对接微信、飞书、Telegram等50+通讯入口，实现跨平台指令的统一分发，无论是手机发消息、网页输入指令，还是命令行操作，都能精准传递给AI智能体；
• 智能体大脑（Agent）：基于大模型拆解自然语言指令为可执行步骤，规划流程并处理异常，支持阿里云百炼、OpenAI、Ollama等本地/云端模型自由切换，是OpenClaw的“决策核心”；
• 技能插件（Skills）：执行“抓手”，社区已贡献5700+技能，涵盖文件管理、邮件自动化、PPT生成、网页爬虫、智能家居控制等，用户可一键安装或自定义开发，就像给手机装App一样，按需扩展功能。

2. 五大核心特性

• 本地优先与隐私可控：引擎、数据、日志均存储于自有设备/服务器，敏感数据不出内网，所有配置与记忆默认存储在~/.openclaw/目录，以明文Markdown文件形式存在，可直接编辑，满足个人隐私与企业合规需求；
• 强执行能力：支持文件读写、脚本执行、浏览器自动化、API调用、多步骤任务链编排，可直接操作系统与软件，真正实现“从建议到执行”的落地闭环；
• 多入口无缝接入：兼容WebUI、CLI、HTTP API，以及飞书、钉钉、Telegram等20+ IM平台，支持语音唤醒，无需专用App，随时随地都能指挥“数字员工”干活；
• 持久记忆系统：能记住你的工作习惯、文件路径、术语偏好，“养”得越久，执行任务越贴合你的需求，实现长期个性化适配；
• 开源可扩展：插件热加载、自定义工具注册，支持二次开发与商业落地，社区生态持续扩张，可无限扩展功能边界，适配个性化场景需求。

（三）OpenClaw能做什么？高频应用场景

OpenClaw的核心适配场景是“流程清晰、步骤固定、判断标准统一”的重复性任务，避开需要“复杂沟通、关键决策、边做边改”的工作，才能发挥最大价值。以下是最常用的四大类场景，覆盖个人与企业80%的高频需求：

1. 办公自动化（个人/企业首选）

• 文件管理：批量整理归档文件、重命名照片/文档、按类型分类文件夹，自动删除空文件夹；
• 报表与纪要：自动生成周报、Excel报表、会议纪要，提取核心信息，同步发送至指定邮箱或群聊；
• 跨工具协同：从Excel提取数据→生成PPT→发送给指定人，全程自动化，无需手动切换软件；
• 代码辅助：代码自动修复、添加注释、格式化，对接GitHub实现代码提交、版本管理。

2. 网络与系统运维

• 网页自动化：浏览器自动填表、数据抓取、页面截图，生成结构化数据报告；
• 服务器监控：实时监控服务器CPU、内存使用率，异常时发送预警信息；
• 数据备份：定时备份重要文件、数据库，备份失败自动提醒，避免数据丢失。

3. 生活与便捷服务

• 信息聚合：定时抓取新闻、行业资讯，总结核心要点，推送至手机；
• 日程管理：设置定时提醒、预约车票、查询天气，联动智能家居控制灯光、空调；
• 批量操作：批量发送邮件、短信，批量修改文件格式，节省重复操作时间。

4. 隐私安全场景

• 纯本地运行：无需联网，所有数据存储在本地，适合处理敏感文档、内部资料，规避云端数据泄露风险；
• 权限管控：可限制技能的操作范围，禁止高危操作，避免文件误删、配置异常。

（四）部署前必做准备（避免踩坑，一次成功）

在启动部署操作前，需提前准备好设备、凭证与基础工具，明确配置要求，避免因准备不足导致后续操作中断或失败。

1. 设备与环境要求

无论是云端还是本地部署，内存是核心硬性要求，低于4GB会导致服务启动失败，各部署方式的具体要求如下：

⚠️ 关键提醒：OpenClaw依赖Node.js和大量TypeScript代码，内存占用较高。如果设备只有2GB内存且未配置Swap，服务启动后会被系统自动终止，进程莫名消失且日志无报错，这是新手最易踩的部署坑；另外，阿里云服务器地域优先选择中国香港（免备案）或华东1（杭州），确保与阿里云百炼API地域一致，降低网络延迟。

2. 必备凭证与工具

• 核心凭证：阿里云账号（注册阿里云账号，完成实名认证，用于服务器购买与百炼API开通）、阿里云百炼Coding Plan API Key（格式为sk-sp-xxxxx，访问订阅阿里云百炼Coding Plan，新用户可领90天免费额度）及专属Base URL；
• 辅助工具：SSH远程工具（FinalShell、Xshell，用于阿里云服务器登录）、系统终端（Windows11：PowerShell管理员模式；MacOS/Linux：原生终端）、文本编辑器（VS Code、记事本、Nano）、加密记事本（存储API Key、Token等敏感凭证）；
• 可选工具：飞书/钉钉/Telegram账号（多渠道控制用）、Ollama（本地模型部署用）、GitHub账号（自定义技能安装用）。

3. 基础工具安装（全系统通用，必做）

基础工具是部署OpenClaw的前提，所有命令可直接复制执行，避免手动安装出错：

# 1. 安装Node.js（推荐v22+，确保兼容性，避免版本过低导致部署失败）
# Windows11（PowerShell，管理员模式）
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y

# MacOS（终端）
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Linux/Ubuntu（终端）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 2. 验证Node.js版本（显示v22+即为成功）
node -v

# 3. 安装核心工具（Git、pnpm，技能管理与依赖安装必备）
# Windows11
winget install Git.Git -y
npm install -g pnpm

# MacOS/Linux
brew install git  # MacOS
sudo apt install git -y  # Linux
npm install -g pnpm

# 4. 安装Docker（容器化部署必备，官方推荐，稳定性更强）
# Windows11：下载Docker Desktop并安装，开启“以管理员身份运行”（官网：https://www.docker.com/products/docker-desktop/）
# MacOS
brew install docker --cask
open -a Docker  # 启动Docker

# Linux/Ubuntu
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker
sudo systemctl enable docker

# 5. 配置npm国内镜像，加速依赖下载（解决国内下载缓慢、超时问题）
npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com

# 6. 验证工具安装（显示版本号即为成功）
git --version && pnpm --version && docker --version

⚠️ 避坑提醒：npm安装完成后，若终端提示“openclaw: command not found”，是因为npm全局安装目录未添加到系统PATH，需手动将路径添加到~/.zshrc（MacOS/Linux）或系统环境变量（Windows11）；MacOS M系列芯片用户，若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖。

二、2026年OpenClaw(Clawdbot)全平台部署流程（阿里云+本地）

OpenClaw支持阿里云云端部署与本地部署（Windows11/MacOS/Linux），两种部署方式各有优势，可根据自身需求选择：阿里云部署适合需要7×24小时稳定运行、多设备访问、团队共享的场景；本地部署适合功能测试、数据隐私要求较高的场景，以下为详细步骤，全程保姆级指导，新手可直接照搬。

（一）阿里云部署（长期运行首选，新手易上手）

阿里云为2026版OpenClaw打造了专属一键部署方案，通过预置镜像、简化流程设计，彻底打破技术门槛，无需用户掌握编程技能，同时提供手动部署与Docker部署两种方式，适配不同需求。

方案一：一键脚本部署（新手首选，5分钟完成）

适配阿里云轻量应用服务器特性，脚本自动优化系统配置、安装依赖并启动服务，无需手动干预，新手快速上手。

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

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

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

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

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

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

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

阿里云百炼Coding Plan 配置教程：创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

• 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
  
• 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
  
• 在服务器概览页面单击应用详情页签，进入服务器详情页面。
  
• 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
  
• 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
  
• 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
  
  

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

   • 访问阿里云轻量应用服务器控制台，选择“Ubuntu 22.04 LTS”系统镜像；
   • 核心配置：2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽，地域优先选择中国香港（免备案）或华东1（杭州），付费类型选“包年包月”；
   • 提交订单后，记录服务器公网IP、默认登录账号（root）与密码，在阿里云控制台“安全组”中，一键放行22（SSH远程端口）、18789（OpenClaw核心端口）、443（API调用端口）。

2. 一键部署操作（通过FinalShell远程连接服务器）：

# 1. SSH连接服务器（替换为你的服务器公网IP，按提示输入密码）
ssh root@你的服务器公网IP

# 2. 执行阿里云专属一键部署脚本（国内优化版，自动处理依赖与配置）
curl -fsSL https://openclaw.ai/aliyun-install.sh | bash

# 3. 按向导完成核心配置（新手直接按默认选择，无需修改）
# 关键步骤提示：
# 1. 网关模式：选择remote（支持远程访问，多设备可连接）
# 2. 绑定地址：0.0.0.0:18789（默认，无需修改）
# 3. 模型选择：暂时选择“Custom Provider”（后续配置阿里云百炼API）
# 4. 认证设置：自动生成访问令牌（Token），复制保存好，登录Web控制台需用

# 4. 验证部署与开机自启（确保服务器重启后服务不中断）
systemctl status openclaw  # 显示active(running)即为服务正常
systemctl enable openclaw  # 设置开机自启
curl http://127.0.0.1:18789/api/v1/health  # 返回healthy即为部署成功

1. 远程访问验证：
   • 打开浏览器，输入 http://服务器公网IP:18789，粘贴之前保存的访问令牌，能正常进入OpenClaw Web控制台，即为部署成功；
   • 控制台可直观查看服务状态、配置技能、发送指令，新手可先熟悉界面布局。

方案二：Docker Compose部署（生产环境首选，稳定隔离）

遵循容器化部署最佳实践，通过Docker Compose实现环境隔离、数据持久化与快速升级，适配企业级生产需求，稳定性更强，适合长期运行。

1. 基础环境配置（SSH远程连接服务器）：

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

# 2. 安装Docker与Docker Compose（若已安装可跳过）
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo apt install docker-compose-plugin -y
sudo systemctl start docker && sudo systemctl enable docker

# 3. 验证Docker安装（显示版本号即为成功）
docker --version && docker compose version

1. 创建配置与启动服务：

# 1. 创建项目目录（用于存储配置、日志与数据，实现持久化）
mkdir -p /opt/openclaw && cd /opt/openclaw

# 2. 编写docker-compose.yml文件（直接复制，无需修改）
cat > docker-compose.yml << EOF
version: "3.8"
services:
  openclaw:
    image: openclaw/openclaw:2026-latest  # 2026最新稳定版镜像
    container_name: openclaw
    ports:
      - "18789:18789"  # 映射核心端口
    volumes:
      - openclaw-data:/root/.openclaw  # 配置与数据持久化
      - /var/log/openclaw:/var/log/openclaw  # 日志持久化
    restart: unless-stopped  # 异常自动重启
    command: ["openclaw", "gateway", "run"]
    network_mode: bridge
    environment:
      - TZ=Asia/Shanghai  # 时区设置（避免时间异常）
      - GATEWAY_MODE=remote  # 支持远程访问
      - GATEWAY_BIND=0.0.0.0:18789
volumes:
  openclaw-data:
EOF

# 3. 启动容器（后台运行）
docker compose up -d

# 4. 初始化配置（设置访问令牌，替换为你的高强度密码）
docker compose exec openclaw openclaw config set gateway.auth.token "your-secret-token"

# 5. 查看日志，确认启动成功（无报错即为正常）
docker compose logs -f

1. 安全加固（可选，企业用户必做）：
   • 在阿里云控制台“安全组”中，将18789端口访问来源限制为企业内网IP或个人常用IP，避免恶意访问；
   • 定期更新Docker镜像，执行docker pull openclaw/openclaw:2026-latest && docker compose restart openclaw，修复安全漏洞。

（二）本地部署（Windows11+MacOS+Linux，隐私优先）

本地部署适合功能测试、数据隐私要求较高的场景，所有数据存储在本地设备，无需依赖云服务器，各系统部署流程略有差异，以下为详细步骤。

1. Windows11本地部署（兼容适配，新手易上手）

系统要求：Windows11 64位、8GB+内存、20GB+可用空间，关闭第三方杀毒软件（避免误删文件）

# 1. 管理员模式打开PowerShell，解决执行策略限制（避免命令无法执行）
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

# 2. 安装核心依赖（Git、Python，若已安装可跳过）
winget install Git.Git -y
winget install Python.Python.3.10 -y
# Docker需手动下载安装：https://www.docker.com/products/docker-desktop/，安装后启动

# 3. 安装Node.js与pnpm（若已安装可跳过）
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y
npm install -g pnpm

# 4. 克隆OpenClaw仓库（国内镜像加速，避免下载缓慢）
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw

# 5. 安装项目依赖
pnpm install

# 6. 构建并启动服务
pnpm ui:build && pnpm build
node dist/cli.js onboard  # 交互式初始化配置（按默认选择即可）
node dist/cli.js gateway run --bind 0.0.0.0:18789

# 7. 生成访问令牌（登录WebUI用，复制保存）
node dist/cli.js token generate --admin

关键配置与避坑：

• 将C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表，避免技能文件被误判为病毒；
• 访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录；
• 若启动失败，检查18789端口是否被占用，执行netstat -ano | findstr 18789，终止占用进程后重新启动。

2. MacOS本地部署（体验最佳，官方推荐）

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

# 1. 安装Homebrew（国内镜像加速，若已安装可跳过）
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

# 2. 安装核心依赖（Git、Python、Docker）
brew install git python@3.10 node@22 docker --cask
open -a Docker  # 启动Docker，等待启动完成（Docker图标不再跳动）

# 3. 配置Node.js环境变量（避免命令无法识别）
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 4. 安装pnpm
npm install -g pnpm

# 5. 克隆OpenClaw仓库（国内镜像加速）
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw

# 6. 安装项目依赖
pnpm install

# 7. 构建并启动服务（后台运行，不占用终端）
pnpm ui:build && pnpm build
node dist/cli.js onboard
nohup node dist/cli.js gateway run --bind 0.0.0.0:18789 > ~/.openclaw/logs/gateway.log 2>&1 &

# 8. 生成访问令牌（登录WebUI用，复制保存）
node dist/cli.js token generate --admin

M系列芯片避坑：若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖；若Docker启动失败，检查MacOS系统版本是否符合要求（需MacOS 12+）。

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

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

# 1. 更新系统依赖（确保系统组件最新，避免依赖冲突）
sudo apt update && sudo apt upgrade -y

# 2. 安装核心工具与依赖
sudo apt install curl git python3-pip -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g pnpm

# 3. 安装Docker（若已安装可跳过）
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker && sudo systemctl enable docker

# 4. 配置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

# 5. 克隆OpenClaw仓库（国内镜像加速）
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw

# 6. 安装项目依赖
pnpm install

# 7. 构建并启动服务
pnpm ui:build && pnpm build
node dist/cli.js onboard
node dist/cli.js gateway run --bind 0.0.0.0:18789

# 8. 生成访问令牌（登录WebUI用，复制保存）
node dist/cli.js token generate --admin

访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录；若需远程访问，需放行18789端口，执行sudo ufw allow 18789/tcp && sudo ufw enable。

三、阿里云百炼Coding Plan API配置（核心步骤，免费可用）

OpenClaw本身不具备大模型能力，需对接外部模型才能实现“意图解析、任务规划”的核心功能——简单来说，OpenClaw是“数字员工”的身体，而大模型是“数字员工”的大脑。阿里云百炼Coding Plan凭借免费额度、国内节点稳定性、与OpenClaw的无缝适配，成为普通人与企业的最优选择，新用户可领取90天免费调用额度，完全满足日常使用需求。

（一）API凭证获取步骤（免费，新手必看）

1. 注册登录阿里云账号，完成实名认证（个人用户可通过支付宝刷脸即时生效，企业用户需上传资质审核）；
2. 访问订阅阿里云百炼Coding Plan，进入服务订阅页面，选择适合的套餐（新用户可领取90天免费调用额度），完成订阅（RAM子账号需主账号授权）；
3. 订阅完成后，进入百炼控制台“密钥管理”页面，点击“创建API Key”，获取专属API Key（格式为sk-sp-xxxxx，与普通百炼Key格式不同，需单独获取）；
4. 记录专属Base URL：https://coding.dashscope.aliyuncs.com/v1（OpenAI兼容协议，必须使用该地址，否则无法抵扣免费额度）；
5. 保存好API Key与Base URL，建议存储在加密记事本中，避免泄露。

（二）OpenClaw对接百炼Coding Plan API（全环境通用）

配置步骤全平台一致，只需修改配置文件并重启网关，所有命令可直接复制执行：

# 1. 编辑OpenClaw配置文件（不同系统打开方式不同）
# Windows11（PowerShell）
notepad $env:USERPROFILE\.openclaw\openclaw.json

# MacOS/Linux/阿里云
nano ~/.openclaw/openclaw.json

# 2. 添加百炼Coding Plan配置（替换为你的API Key，其他参数无需修改）
{
   
  "models": {
   
    "providers": {
   
      "bailian-coding": {
   
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "你的Coding Plan API Key",  # 替换为你获取的API Key
        "api": "openai-completions",
        "models": [
          {
   
            "id": "qwen3.5-coding",
            "name": "百炼Coding Plan Qwen3.5",
            "contextWindow": 32768,
            "maxTokens": 4096,
            "reasoning": false  // 国内模型必设，否则回复为空，新手必看！
          }
        ]
      }
    },
    "default": "bailian-coding/qwen3.5-coding"  # 设置百炼为默认模型
  },
  "tools": {
   
    "agentCommunication": {
   
      "enabled": true,
      "allowCrossAgent": true
    }
  }
}

# 3. 保存文件后，重启网关使配置生效（不同部署方式重启命令不同）
# 阿里云/Linux（脚本/源码部署）
openclaw gateway restart

# 阿里云/Linux（Docker部署）
docker compose restart openclaw

# MacOS
pkill -f openclaw && nohup node dist/cli.js gateway run --bind 0.0.0.0:18789 > ~/.openclaw/logs/gateway.log 2>&1 &

# Windows11（PowerShell）
Stop-Process -Name node -Force
node dist/cli.js gateway run --bind 0.0.0.0:18789

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

1. 验证方法（快速确认配置成功）

• 打开OpenClaw Web控制台，输入自然语言指令：“帮我整理~/Downloads文件夹的文件，按文档、图片、视频分类，删除空文件夹”；
• 若OpenClaw返回“任务已执行，已创建分类文件夹，共整理XX个文件”，且本地/服务器对应文件夹已完成整理，即为配置成功；
• 若未返回结果或提示“模型不可用”，需检查配置是否正确，重启网关后再次尝试。

2. 避坑要点（新手必看，解决90%的API配置问题）

• 凭证混用：Coding Plan API Key前缀为sk-sp-，与普通百炼Key格式不同，混用会导致鉴权失败，提示“API Key无效”；
• 接口地址错误：必须使用专属Base URL（https://coding.dashscope.aliyuncs.com/v1），使用其他地址会无法抵扣免费额度，提示“额度不足”；
• 未设置reasoning：国内模型（包括百炼）必须添加"reasoning": false，否则模型无法正常响应，回复为空；
• 配置不生效：修改配置文件后，必须重启网关（Docker部署需重启容器），否则参数无法加载；
• 额度不足：若提示“百炼API额度不足”，登录百炼控制台查看剩余额度，领取免费套餐或充值，也可减少上下文长度，降低Token消耗。

四、实战场景：让OpenClaw立刻干活（落地即用）

部署与API配置完成后，通过以下高频场景实战，快速感受OpenClaw的自动化价值，所有指令可直接在WebUI或IM平台发送，无需编写任何脚本。

（一）场景1：文件自动整理（最常用，节省手动时间）

# 1. 安装文件管理技能（全环境通用）
pnpm add @openclaw/skill-file-manager

# 2. 发送自然语言指令（WebUI/IM平台直接输入）
“帮我整理~/Downloads文件夹的所有文件，按类型（文档、图片、视频、安装包）创建子文件夹，将对应文件移动到各文件夹，删除空文件夹，整理完成后告诉我结果”

# 3. 查看执行结果
# 指令执行后，OpenClaw会返回整理报告，包含各文件夹文件数量与名称；
# 同时可直接查看对应文件夹，确认整理效果，全程无需手动操作。

（二）场景2：办公自动化——会议纪要生成与邮件发送

# 1. 安装办公技能与邮件技能（全环境通用）
pnpm add @openclaw/skill-office-automation @openclaw/skill-email

# 2. 配置邮件账号（替换为你的邮箱信息）
openclaw config set skills.email.smtpHost "smtp.163.com"  # 邮箱SMTP服务器
openclaw config set skills.email.smtpPort 465  # SMTP端口
openclaw config set skills.email.username "你的邮箱账号"
openclaw config set skills.email.password "你的邮箱授权码"

# 3. 发送指令（WebUI/IM平台）
“将以下会议记录整理为结构化纪要（包含参会人、讨论内容、行动项、截止日期），生成Markdown文件并发送到team@example.com邮箱：
参会人：张三、李四、王五
讨论内容：1. OpenClaw部署进度：完成80% 2. 下周计划：完成测试与上线 3. 问题：服务器资源不足
行动项：张三负责测试（周五前），李四协调服务器（周三前），王五跟进API配置”

# 4. 执行结果
# 自动生成规范的会议纪要，保存到本地指定目录，并发送至目标邮箱，返回邮件发送成功回执。

（三）场景3：服务器监控与异常预警（阿里云部署专属）

# 1. 安装服务器监控技能
pnpm add @openclaw/skill-server-monitor

# 2. 配置监控参数（设置预警阈值）
openclaw config set skills.server-monitor.cpuThreshold 80  # CPU使用率超过80%预警
openclaw config set skills.server-monitor.memoryThreshold 80  # 内存使用率超过80%预警
openclaw config set skills.server-monitor.alertChannel "feishu"  # 预警推送至飞书
openclaw config set skills.server-monitor.feishuChatId "你的飞书群ID"

# 3. 设置定时监控（每10分钟监控一次）
openclaw cron add --name "server-monitor" --schedule "*/10 * * * *" --command 'openclaw skills run server-monitor'

# 4. 手动测试
openclaw skills run server-monitor

预期效果：每10分钟自动监控服务器CPU、内存使用率，若超过预警阈值，飞书群会收到预警信息，包含当前使用率与异常提示，无需手动登录服务器查看。

（四）场景4：多渠道控制——飞书远程指挥（全环境通用）

# 1. 安装飞书集成技能
pnpm add @openclaw/skill-feishu

# 2. 配置飞书凭证（替换为你的飞书App ID与App Secret）
openclaw config set skills.feishu.appId "你的飞书App ID"
openclaw config set skills.feishu.appSecret "你的飞书App Secret"

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

# 4. 飞书发送指令
# 在飞书群@OpenClaw机器人，发送“帮我查看服务器当前CPU使用率，生成简易报告”，机器人自动执行并返回结果；
# 也可发送“帮我整理今天的行业资讯，总结3条核心信息”，机器人会自动联网搜索并返回摘要。

五、常见问题解答（避坑指南，解决90%的新手问题）

结合2026年最新版本特性与用户实战反馈，整理了部署、API配置、技能使用过程中的高频问题，每个问题均提供具体解决方案，新手遇到问题可直接对照排查。

（一）部署类问题

1. 问题1：OpenClaw启动提示“Node.js版本过低”？

   • 解决方案：执行node -v验证版本，确保≥22.0.0；Linux/MacOS用sudo npm install -g n && sudo n 22.2.0升级，Windows重新运行Node.js安装命令（winget install OpenJS.NodeJS.LTS --version 22.2.0 -y）；升级后重启网关。

2. 问题2：Web控制台无法访问，提示“无法连接”或“端口超时”？

   • 原因：端口被占用、服务未启动、防火墙/安全组未放行端口；
   • 解决方案：
     ① 检查18789端口是否被占用（Windows：netstat -ano | findstr 18789；Linux/MacOS：lsof -i:18789），终止占用进程；
     ② 重启网关服务（openclaw gateway restart），确认服务状态为“running”；
     ③ 阿里云部署：检查安全组是否放行18789端口；本地部署：关闭防火墙或添加端口例外；
     ④ 确认网关绑定地址为0.0.0.0:18789，而非127.0.0.1（仅本地可访问）。

3. 问题3：Docker部署后，容器启动失败，日志提示“权限不足”？

   • 原因：挂载目录权限不足，Docker无法读写配置与日志文件；
   • 解决方案：赋予挂载目录权限，执行sudo chmod -R 775 /opt/openclaw（阿里云/Linux），然后重启容器（docker compose restart openclaw）。

4. 问题4：服务启动后，进程莫名消失，日志无报错？

   • 原因：内存不足，未配置Swap空间，被系统OOM Killer终止；
   • 解决方案：按部署步骤配置Swap空间（2GB及以上），若服务器/本地设备配置过低，升级至2vCPU+4GiB内存及以上；关闭冗余应用，释放内存。

5. 问题5：阿里云部署后，远程无法访问Web控制台？

   • 解决方案：① 检查服务器安全组，确保18789端口允许所有IP访问；② 确认服务器防火墙已放行18789端口（sudo ufw status）；③ 验证服务器公网IP是否正确，能否正常ping通；④ 查看网关日志（openclaw gateway logs --follow），排查报错。

（二）API与模型类问题

1. 问题1：百炼API调用提示“密钥无效”或“鉴权失败”？

   • 解决方案：① 逐字符核对API Key，确保为sk-sp-xxxxx前缀格式，与普通百炼Key区分开；② 登录百炼控制台，确认密钥未过期、未被禁用；③ 重新创建密钥并更新配置文件；④ 检查Base URL是否正确，确保与密钥地域一致。

2. 问题2：调用模型时，回复内容为空，无任何反馈？

   • 原因：未在模型配置中添加"reasoning": false，国内模型不支持默认的思考模式；
   • 解决方案：编辑openclaw.json，在models数组中添加"reasoning": false，重启网关生效；若仍为空，检查API Key是否正确，是否有剩余额度。

3. 问题3：提示“百炼API额度不足”？

   • 解决方案：① 登录百炼控制台，查看剩余免费额度，若额度耗尽，领取新的免费套餐或充值；② 减少上下文长度，避免不必要的历史对话携带，降低Token消耗；③ 优先使用轻量模型（如qwen3.5-coding），替代高性能模型；④ 定期清理对话历史，释放Token。

（三）技能与实战类问题

1. 问题1：技能安装提示“依赖缺失”或“安装失败”？

   • 解决方案：① 查看技能详情（openclaw skills info 技能名），确认缺失的依赖；② 安装依赖（Python库用pip3 install 依赖名）；③ 国内用户用清华源加速（pip3 install 依赖名 --index-url=https://pypi.tuna.tsinghua.edu.cn/simple）；④ 验证Node.js版本是否兼容。

2. 问题2：飞书/钉钉无法指挥OpenClaw，机器人不响应？

   • 解决方案：① 核对飞书/钉钉App ID与App Secret，确保配置正确；② 确保机器人已添加到群聊，且拥有发送消息的权限；③ 查看技能日志（openclaw skills logs feishu），排查报错；④ 重启网关，重新配置技能。

3. 问题3：执行任务时，提示“权限不足，无法访问文件/文件夹”？

   • 原因：OpenClaw运行账号无对应文件/文件夹的访问权限；
   • 解决方案：① 赋予文件/文件夹权限（Linux/MacOS：chmod -R 775 文件夹路径）；② 以管理员身份运行OpenClaw（Windows：PowerShell管理员模式；Linux：sudo命令）。

（四）安全与运维类问题

1. 问题1：如何保护API Key、Token等敏感凭证？

   • 解决方案：① 用加密记事本存储敏感凭证，避免明文保存；② 禁止将配置文件上传至公开仓库（如GitHub）；③ 定期更换网关Token与API Key；④ 阿里云部署时，将敏感凭证存储在环境变量中，避免写死在配置文件。

2. 问题2：如何备份OpenClaw配置与数据，避免丢失？

   • 解决方案：备份~/.openclaw目录（包含配置、技能、记忆数据），执行以下命令：

     # MacOS/Linux/阿里云
     cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)
     # Windows11（PowerShell）
     Copy-Item -Path $env:USERPROFILE\.openclaw -Destination $env:USERPROFILE\.openclaw-backup-$(Get-Date -Format yyyyMMdd) -Recurse
     

   • 建议设置定时备份，每周备份一次，避免配置丢失。

3. 问题3：如何查看OpenClaw运行日志，排查报错？

   • 解决方案：

     # 脚本/源码部署（全环境通用）
     tail -f ~/.openclaw/logs/gateway.log
     # Docker部署
     docker compose logs -f openclaw
     # 快速诊断所有问题
     openclaw status --all
     openclaw doctor  # 自动修复常见配置问题
     

六、总结

OpenClaw(Clawdbot)的爆火，本质是满足了个人与企业对“自托管、强执行、隐私可控”AI自动化的核心需求。它不是传统AI的替代者，而是将AI能力落地到实际任务的“桥梁”，通过本地优先的设计、灵活的模型适配与丰富的技能生态，让“数字员工”成为普通人也能轻松拥有的工具。

本文整合的2026年最新全流程指南，覆盖了OpenClaw的核心认知、阿里云+本地全系统部署（一键脚本、Docker、源码）、阿里云百炼Coding Plan API配置、实战场景与常见问题解答，所有代码可直接复制执行，全程保姆级指导，新手可按自身需求选择部署方式，从简单场景入手，逐步扩展功能。

核心要点总结，帮助你快速掌握关键信息：

1. 定位清晰：OpenClaw是“任务统筹者”，不是“单一执行者”，聚焦流程化、重复性任务，避开复杂决策与人际沟通类工作；
2. 部署选择：个人测试选本地部署（隐私优先），长期运行/团队共享选阿里云部署（稳定优先），企业生产环境优先Docker容器部署；
3. 配置关键：Node.js版本≥22.0.0，百炼API需正确配置凭证与Base URL，国内模型必须添加reasoning: false，修改配置后需重启网关；
4. 安全第一：限制端口访问、保护敏感凭证、定期备份数据、及时更新版本，避免技能投毒与数据泄露；
5. 落地逻辑：先跑通1-2个高频场景（如文件整理、会议纪要），再逐步安装技能、扩展自动化边界，避免盲目堆砌技能导致冲突。

通过本文的教程，你可轻松搭建专属OpenClaw自动化引擎，将重复繁琐的工作交给“数字员工”，聚焦更有价值的核心任务，真正实现效率倍增，无论是个人办公还是企业运维，都能发挥巨大作用。