## 一、引言：认识 OpenClaw —— 你的本地 AI 数字分身

OpenClaw 的前身是广受欢迎的 Clawdbot 和 Moltbot，在2026年正式升级为开源项目后迅速走红，GitHub Stars 已突破10万。它的核心理念很简单：把AI变成你的操作系统级代理，而不是仅仅用来问答的聊天机器人。

### 普通AI vs OpenClaw 功能对比

• 特性	普通AI聊天	OpenClaw
  回答问题	✅	✅
  执行终端命令	❌	✅
  读写本地文件	❌	✅
  操控浏览器	❌	✅
  收发邮件	❌	✅（需Skill）
  长期记忆	❌	✅
  24/7自主运行	❌	✅
  数据完全自控	❌	✅

你可以把它想象成一位“数字员工”：你在睡觉时它能自动处理任务，你不在电脑前也能通过手机指挥它创建文档、发送邮件、总结网页内容。最关键的是，所有数据都存储在你自己的设备或服务器上，无需担心隐私泄露。

> 小贴士：Token 就像进入房间的钥匙，每次访问Web控制台都需要输入。别丢了！

—

## 二、新手部署步骤详解

完成部署后，你可能会遇到以下问题……但别慌，我们先一步步来，确保每一步都稳扎稳打。

### （一）部署前准备事项

在动手之前，请确认你已完成以下准备工作：

#### 1. 系统与硬件要求

• 部署方式	操作系统	内存	存储	核心依赖
  云端部署	Ubuntu 22.04+ / Alibaba Cloud Linux 3	≥2GB（推荐4GB）	≥40GiB ESSD	预装Node.js等
  Windows本地	Win10/11（64位）	≥4GB（推荐8GB）	≥2GB可用空间	Node.js v22+, Git
  macOS/Linux本地	macOS 12+ 或主流Linux	≥2GB（推荐4GB）	≥1GB可用空间	Node.js v22+, Git

【注意】

• • Windows用户必须启用WSL2才能原生运行。
• • 内存低于2GB可能导致服务启动失败或频繁崩溃。

#### 2. 必备工具与凭证获取

• 你需要提前准备好：
  • 阿里云账号：并完成实名认证
  • 百炼API Key：登录阿里云百炼平台 → “密钥管理” → 创建AccessKey ID和Secret，新用户享7000万Token免费额度（有效期90天）
  • 基础工具：Chrome浏览器、SSH客户端（如FinalShell）、文本编辑器（VS Code）

#### 3. 基础依赖安装

• 所有本地部署均需手动安装以下组件：

##### 安装 Node.js（v22 推荐）

• # Windows（PowerShell管理员模式）
  iwr -useb https://nodejs.org/dist/v22.0.0/node-v22.0.0-x64.msi | iex
  
  # macOS（使用Homebrew）
  brew install node@22
  
  # Linux（Ubuntu）
  curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
  sudo apt install -y nodejs
  

验证是否成功：

• node -v
  

• 输出 v22.x.x 即表示安装正确。

##### 安装 Git

• 前往 https://git-scm.com/download 下载对应系统版本并安装。

##### 配置 npm 国内镜像（加速下载）

• npm config set registry https://registry.npmmirror.com
  

• 这能显著提升后续包的下载速度。

> 避坑提醒：务必以管理员身份运行 PowerShell 或终端，否则可能出现权限错误。

—

### （二）部署方式选择与实施

现在你可以根据自身情况选择最适合的部署路径了。

#### 1. 云端部署（推荐新手首选）

如果你希望实现7×24小时运行、多设备随时访问，强烈推荐使用阿里云轻量服务器一键部署。

##### 方案一：阿里云轻量服务器一键部署

• 适合无运维经验的新手，全程可视化操作。

准备工作清单

• • 已注册阿里云账号并完成实名认证
• • 准备好支付方式（首月约30元，学生可享优惠）

操作步骤如下：

• 1. 访问 阿里云OpenClaw专题页
  • 2. 点击【一键购买并部署】
  • 3. 配置建议：
    • • 镜像：选择“OpenClaw(Moltbot)镜像”
    • • 实例规格：2核4GB内存 + 40GiB ESSD（性价比最优）
    • • 地域：务必选择中国香港或新加坡（免备案，网络通畅）

太棒了！你已经完成了第一步！

接下来进入阿里云控制台：

• • 找到你的实例 → 进入「应用详情」页面
  • • 点击【一键放通】→ 自动开放端口 18789
  • • 点击【配置百炼API-Key】→ 粘贴你之前获取的AccessKey ID和Secret
  • • 点击【执行命令】→ 系统自动生成登录用的Token

最后点击【打开网站页面】，跳转至 http://公网IP:18789，输入Token即可登录。

> 小贴士：公网IP可在实例详情页找到，格式类似 47.88.xx.xx

##### 方案二：现有服务器重置部署

• 已有阿里云轻量服务器的用户可直接重置系统：

1. 登录控制台 → 找到目标实例 → 「更多」→「重置系统」

• 2. 选择「自定义镜像」→ 查找「OpenClaw(Clawdbot)专属镜像（2026版）」
  • 3. 勾选确认重置（⚠️ 此操作会清除所有数据，请提前备份）

后续步骤同方案一：端口放行 → 配置API-Key → 生成Token → 访问控制台^[2]。

#### 2. 本地部署（零成本测试）

如果你想先试用再决定是否上云，本地部署是理想选择。

##### Windows系统部署

• 适用于个人用户短期体验。

步骤1：解锁脚本权限

• 以管理员身份打开PowerShell，执行：

  • Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
    

  • 输入 Y 确认^[9]。

步骤2：一键安装OpenClaw

• iwr -useb https://openclaw.ai/install.ps1 | iex
  

• 等待3-5分钟，看到“安装成功”提示即完成^[3]。

步骤3：初始化配置

• openclaw onboard --install-daemon
  

• 按提示选择：
  • • 模型提供商：qwen（通义千问）或 moonshot（Kimi）
  • • 默认端口：18789（无需修改）
  • • 开机自启：选“是”

步骤4：生成访问Token

• openclaw token generate
  

• 复制生成的Token保存备用。

步骤5：访问本地控制台

• 浏览器打开：

  • http://127.0.0.1:18789/?token=刚才生成的Token
    

• 输入后即可登录使用^[9]。

##### macOS/Linux系统部署

• 流程更简单，几乎全自动。

步骤1：执行一键安装脚本

• # macOS
  curl -fsSL https://openclaw.ai/install.sh | bash
  
  # Linux（Ubuntu为例）
  curl -fsSL https://openclaw.ai/install.sh | bash
  

步骤2：初始化配置

• openclaw onboard
  

• 接受风险提示 → 选择QuickStart模式 → 可暂时跳过API-Key配置。

步骤3：启动服务

• openclaw gateway start
  

步骤4：访问控制台

• 浏览器打开：

  • http://localhost:18789
    

• 首次使用无需Token即可访问。

> 避坑提醒：若提示命令未找到，请检查Node.js是否已正确添加到PATH环境变量。

—

### （三）部署后功能验证（必做三步测试）

无论哪种部署方式，登录控制台后请立即执行以下三项测试，确保一切正常。

1. 基础交互测试

• 输入：“你好，我是OpenClaw用户”
• 若能正常回复，说明自然语言解析功能正常。

2. 文件处理测试

• 输入：“创建一个名为‘OpenClaw部署测试’的TXT文件，内容为‘2026年阿里云部署成功’”
• 若返回“文件创建成功”，说明基础自动化功能正常。

3. 模型调用测试

• 输入：“告诉我你支持的核心功能”
• 若列出文档处理、任务提醒、工具集成等功能，说明API-Key配置成功，模型调用正常。

全部通过？恭喜你！OpenClaw已正式上线运行！

当你熟悉基本操作后，可以开始扩展功能……

—

## 三、常见问题和避坑指南

尽管部署过程尽可能简化，但你仍可能遇到一些典型问题。以下是按阶段分类的解决方案。

### （一）部署阶段常见问题

#### 问题现象：PowerShell报错“执行策略禁止”

• 这是Windows最常见的权限问题。

原因分析

• 系统默认禁止运行未签名的脚本，属于安全机制。

解决步骤

• Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  

• 输入 Y 确认即可解除限制。

> 警告：不要使用 Unrestricted 模式，存在安全隐患。

#### 问题现象：浏览器无法访问 http://IP:18789

• 页面显示连接超时或拒绝访问。

原因分析

• 通常是防火墙或云服务商安全组未放行端口。

解决步骤

• • 本地部署：检查本地防火墙是否阻止18789端口
  • • 云端部署：进入阿里云控制台 → 实例详情 → 安全组 → 添加规则放行 TCP:18789

【注意】严禁将18789端口暴露在公网！建议绑定监听地址为 127.0.0.1 并通过SSH隧道访问。

#### 问题现象：安装命令无反应

• 执行脚本后没有任何输出。

原因分析

• Node.js未正确安装或未加入PATH，或PowerShell未以管理员运行。

解决步骤

• 1. 重新安装Node.js，并勾选“Add to PATH”
  • 2. 以管理员身份运行PowerShell
  • 3. 再次尝试安装命令

—

### （二）配置阶段典型错误

#### 问题现象：API-Key配置无效

• 模型调用失败，提示“权限不足”。

原因分析

• 复制密钥时包含了空格、换行符，或地域不匹配。

解决步骤

• 1. 重新从阿里云百炼控制台复制AccessKey
  • 2. 使用CLI重新设置：

    • openclaw config set models.providers.bailian.accessKeyId "你的ID"
      openclaw config set models.providers.bailian.accessKeySecret "你的Secret"
      

  • 3. 重启服务使配置生效：

    • openclaw gateway restart
      

#### 问题现象：Token认证失败

• 提示“unauthorized”或“Token无效”。

原因分析

• Token过期、复制错误或浏览器缓存干扰。

解决步骤

• 1. 重新生成Token：

  • openclaw token generate
    

  • 2. 清除浏览器缓存后重试
  • 3. Docker用户需检查环境变量是否覆盖配置

#### 问题现象：配置文件语法错误

• 启动时报错“Config invalid”、“unexpected field”。

原因分析

• YAML缩进错误（混用Tab与空格），或字段层级错误。

解决步骤

• 1. 使用内置校验命令检测：

  • openclaw config validate
    

  • 2. 使用Python验证YAML合法性：

    • python3 -c "import yaml; yaml.safe_load(open('~/.config/openclaw/config.yaml').read()); print('YAML OK')"
      

  • 3. 确保使用空格缩进（推荐2或4个空格），布尔值写为 true 而非 "true"

—

### （三）运行阶段高频故障

#### 问题现象：Agent无响应或重复执行

• 指令发出后没有反应，或同一任务被多次执行。

原因分析

• session去重未开启，或bindings配置错误。

解决步骤

• 1. 启用session去重：

  • openclaw config set sessions.deduplication true
    

  • 2. 检查Agent状态：

    • openclaw agents status
      

  • 3. 查看日志定位问题：

    • openclaw logs --gateway --follow
      

#### 问题现象：Skill调用异常

• 技能安装后无法使用或报错。

原因分析

• 插件未加载、网络不通或资源耗尽。

解决步骤

• 1. 手动加载技能：

  • openclaw plugins load <Skill名称>
    

  • 2. 查看技能日志：

    • openclaw logs --skill <Skill名称>
      

  • 3. 检查服务器资源：

    • top
      free -h
      

#### 问题现象：邮件发送认证失败

• 使用email技能时提示“SMTP认证失败”。

原因分析

• 未开启IMAP/SMTP服务，或使用了登录密码而非授权码。

解决步骤

• 1. 登录邮箱后台开启IMAP/SMTP
  • 2. 获取专用“授权码”代替密码
  • 3. 在配置中更新凭据并重启服务：

    • systemctl restart openclaw
      

—

### （四）安全防护最佳实践

#### 最小权限原则

• • 不要以root/administrator权限运行OpenClaw
  • • 限制File System Manager等技能仅访问指定目录
  • • 启用沙箱模式运行第三方Skill：
      skills.sandbox: true

#### 敏感信息保护

• 使用外部密钥管理存储API Key：

  • openclaw secrets add --key aliyun-api-key --value "你的密钥"
    openclaw config set models.providers.aliyun.apiKey "$(openclaw secrets get --key aliyun-api-key)"
    

• 定期轮换密钥可大幅提升安全性。

#### 网络暴露风险防范

• • 严禁将18789端口直接暴露公网
  • • 绑定监听地址为 127.0.0.1
  • • 如需远程访问，使用SSH隧道或反向代理结合IP白名单

#### 技能安装安全准则

• • 仅从官方ClawHub安装高星认证技能
  • • 安装前查看代码审查逻辑
  • • 避免安装来源不明、无更新记录的技能

—

## 四、推荐的 Skill 安装方法

OpenClaw的强大之处在于其丰富的Skill生态。目前已有超过5,700款社区技能可供安装。以下是四种主流安装方式。

### （一）安装方式对比表（推荐指数排序）

• 方法	适用人群	是否需命令行	推荐指数
  自然语言安装	完全新手	否	⭐⭐⭐⭐⭐
  Web可视化面板	阿里云用户	否	⭐⭐⭐⭐☆
  命令行安装	技术爱好者	是	⭐⭐⭐☆☆
  手动上传安装	备用方案	是	⭐⭐☆☆☆

—

### （二）具体安装方法详解

#### 方法一：自然语言安装（AI 自动完成）

• 这是2026年最推荐的新手方式，真正实现“对话即操作”。

操作示例

• 在控制台输入：

  • 帮我安装Skill，项目地址是https://github.com/anthropics/skills/blob/main/skills/pptx，遇到报错时自动修复，无需询问我
    

• AI将自动完成：
  • • 下载依赖
    • • 解压安装
    • • 错误修复
  • 全程无需干预。

进阶用法

• • 批量安装：帮我安装daily-report、summarize、meeting-notes三个技能
  • • 指定版本：帮我安装summarize技能的1.2.0版本
  • • 查看说明：告诉我weather技能的使用方法

> 小贴士：这种方式就像有个技术助理帮你干活，特别适合怕命令行的新手。

#### 方法二：Web 可视化面板安装（图形点击）

• 阿里云用户可通过图形界面一键安装。

操作路径

• 1. 登录阿里云控制台 → OpenClaw实例详情
  • 2. 【应用管理】→【OpenClaw配置】→【技能（Skills）】
  • 3. 在“新增Skills”框中输入技能名称（如 summarize）
  • 4. 点击【安装技能】

等待1-2分钟，技能自动生效。

> 避坑提醒：输入时避免多余空格，否则无法识别。

#### 方法三：命令行安装（高效可控）

• 专业用户的首选方式，支持批量管理和版本控制。

前置条件

• npm install -g clawhub@latest
  

常用命令

• # 安装单个技能
  clawhub install weather
  
  # 批量安装
  clawhub install summarize find-skills email
  
  # 搜索技能
  clawhub search "翻译"
  
  # 查看已安装列表
  clawhub list
  

安装后记得重启网关：

• openclaw gateway restart
  

#### 方法四：手动上传安装（备用方案）

• 当网络不佳时可采用此方式。

操作步骤

• 1. 访问 ClawHub官网 下载 .zip 包
  • 2. 解压得到技能文件夹
  • 3. 上传至指定路径：
    • • 阿里云：/root/.openclaw/workspace/skills/
    • • Windows本地：C:\\Users\\你的用户名\\.openclaw\\workspace\\skills\\
    • • macOS/Linux：~/.openclaw/workspace/skills/
  • 4. 重启OpenClaw生效

> 警告：必须上传解压后的文件夹（含 SKILL.md），不能直接传压缩包！

—

### （三）初学者推荐 Skill 套装

• Skill 名称	功能描述	安装命令
  weather	查询全球城市天气	clawhub install weather
  summarize	总结网页/PDF/视频内容	clawhub install summarize
  find-skills	根据需求推荐相关Skill	clawhub install find-skills
  email	收发邮件、分类与自动回复	clawhub install email
  calendar-sync	同步Google Calendar或阿里云日历	clawhub install calendar-sync
  self-improving-agent	自动记录错误并优化行为	npx clawhub@latest install self-improving-agent

建议按顺序逐步安装，避免一次性加载过多导致性能下降。

—

### （四）新手部署环境选择建议

• 部署方案	维护成本	可用性	安全性
  本地部署	中	依赖设备开机	高（数据完全本地）
  云端部署	低	7×24小时在线	中（需防范公网暴露）

建议：先本地试用熟悉操作，再迁移到云端长期运行。

—

## 五、结语：从部署到精通的成长路径

你已经完成了OpenClaw的完整部署，掌握了常见问题的应对方法，并学会了如何扩展功能。接下来的成长路径如下：

1. 先本地试用：在个人电脑上跑通流程，理解基本概念

• 2. 再迁移上云：选择阿里云部署实现全天候服务
• 3. 逐步扩展技能：从基础套装开始，按需添加生产力工具
• 4. 加入社区交流：
  • • Discord：https://discord.com/invite/clawd
  • • 中文社区：https://clawd.org.cn/
• 5. 持续学习文档：
  • • 官方文档：https://docs.openclaw.ai/
  • • 汉化版入口：https://holtchas.github.io/openclaw-docs-zh/

> 快速自查清单

• • 已完成基础三步测试
• • API-Key配置正确
• • Token可正常登录
• • 至少安装一个Skill
• • 设置了开机自启（云端）
• • 已备份配置文件

太棒了！你已经迈出了成为AI Agent高手的第一步。继续探索吧，你的数字分身正等待唤醒。