OpenClaw（俗称“小龙虾”）是2026年爆火的开源AI Agent框架，能让你拥有一个24小时在线的“数字员工”——自动处理文件、操作浏览器、对接钉钉/飞书等。本教程覆盖Windows/Mac/Linux本地部署和阿里云云端部署两种主流方案，并附赠免费大模型API配置和权限解锁技巧，新手照着做就能跑起来。如果你有自己的云服务器，同样可以按照文中的云端部署步骤操作，体验完全一致
本地部署我们使用Ubuntu系统搭建到恒枢云的云服务器上来帮助我们管理服务端数据库等

硬件要求

部署方式	最低配置	推荐配置
本地部署	4GB内存 + 20GB硬盘	8GB内存 + 30GB硬盘
阿里云部署	2核2GB + 40GB硬盘	2核4GB + 40GB硬盘

核心依赖

• Node.js 22+（必须≥22，18/20版本有兼容性问题）

• npm（Node.js自带）

• Git（版本管理）

• 可选：Docker（容器）

国内网络优化

# 配置npm淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry

本地部署方案

MacOS部署（最简单）
 

步骤1：安装Homebrew

bash

/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

步骤2：安装Node.js 22

bash

brew install node@22

步骤3：一键安装OpenClaw

bash

npm config set registry https://registry.npmmirror.com
sudo npm install -g openclaw@latest --unsafe-perm=true

步骤4：初始化并启动

bash

openclaw onboard          # 新手向导
openclaw gateway start    # 启动网关

浏览器打开 http://127.0.0.1:18789 即可使用。

Windows11部署（通过WSL2）

步骤1：启用WSL
以管理员身份打开PowerShell，执行：

powershell

wsl --install -d Ubuntu-24.04

重启电脑，按提示设置Ubuntu用户名和密码。

步骤2：进入Ubuntu终端，安装Node.js

bash

sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

步骤3：安装OpenClaw

bash

npm config set registry https://registry.npmmirror.com
npm install -g openclaw

步骤4：初始化并启动

bash

openclaw onboard
openclaw gateway start

在Windows浏览器打开 http://127.0.0.1:18789 

Linux部署（Ubuntu/Debian）

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

# 配置镜像并安装
npm config set registry https://registry.npmmirror.com
sudo npm install -g openclaw

# 初始化
openclaw onboard
openclaw gateway start

访问 http://你的IP:18789 

云端部署方案（7×24小时在线）

如果你希望OpenClaw能7×24小时在线，可以将其部署到云服务器上。下面以阿里云为例（其他云厂商如恒枢云等操作类似），提供两种方式。

3.1 一键购买部署（推荐新手）

1. 访问 阿里云OpenClaw一键部署页面，点击「一键购买并部署」。

2. 服务器配置：

   • 镜像：选择「OpenClaw(Moltbot)镜像」

   • 内存：必须2GB及以上

   • 地域：推荐美国（弗吉尼亚）或香港（国内地域联网搜索功能受限）

3. 放行端口：
   在轻量应用服务器控制台 → 应用详情 → 点击「端口放通」→ 一键放行18789端口。

4. 获取访问地址：
   点击「访问Web UI面板」→ 复制生成的URL（格式：http://公网IP:18789?token=xxx）

手动部署（如果你已经有了服务器）

如果你的云服务器已经存在（无论是阿里云、腾讯云还是恒枢云等），可以按以下步骤手动安装

# SSH登录服务器
ssh root@你的服务器IP

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

# 安装OpenClaw
npm config set registry https://registry.npmmirror.com
npm install -g openclaw

# 配置允许外部访问
openclaw config set gateway.host 0.0.0.0
openclaw config set gateway.port 18789

# 启动
openclaw gateway start

访问 http://你的公网IP:18789 

配置AI大模型（免费方案）

OpenClaw需要对接大模型才能干活，推荐阿里云百炼Coding Plan（新用户有免费额度）。

4.1 获取API Key

1. 访问 阿里云百炼大模型平台，完成实名认证。

2. 进入「控制台」→「密钥管理」→ 创建API Key。

3. 复制生成的 sk-xxxx 格式的Key，妥善保存。

4.2 配置到OpenClaw

方法一：通过向导配置

bash

openclaw onboard

选择 Alibaba → 粘贴API Key → 按提示完成。

方法二：手动编辑配置文件

bash

vim ~/.config/openclaw/config.json

写入以下内容：

json

{
  "model": {
    "type": "aliyun-bailian",
    "api_key": "你的API-Key",
    "model_name": "qwen-7b-chat",
    "max_tokens": 2048,
    "temperature": 0.7
  }
}

4.3 验证配置

bash

openclaw gateway start

访问Web界面，输入测试消息，如果正常回复说明配置成功

权限解锁（让小龙虾“真正干活”）

为什么需要解锁？

OpenClaw 2026.3.2+版本默认只开放聊天功能，系统命令、文件操作、浏览器控制等核心能力默认关闭（安全考虑）。需要手动解锁才能实现自动化。

解锁步骤

步骤1：切换到full模式

bash

openclaw config set agent.permissions full

步骤2：安装浏览器技能（实现网页自动化）

bash

# 服务器环境需安装Chromium
sudo apt install -y chromium-browser

# 安装agent-browser技能
npm install -g clawhub
clawhub install agent-browser

步骤3：重启网关

bash

openclaw gateway restart

步骤4：验证权限
在Web界面输入：帮我打开百度搜索OpenClaw，如果能自动打开浏览器说明解锁成功

安全提醒

• 禁止用root用户运行OpenClaw（建议创建专用用户openclaw）

• 如非必要，不要将网关暴露在公网

• 定期用 openclaw doctor --fix 检查配置

养成指南：让小龙虾越来越懂你

三层记忆文件

在工作目录（默认~/.openclaw/）下创建以下文件：

1. SOUL.md（人格定义）

markdown

# 核心身份：我的高效办公助手
性格：细心、高效、不废话
职责：帮我处理文件整理、邮件回复、日程提醒

2. USER.md（你的档案）

markdown

- 姓名：张三
- 时区：中国北京（23点后不打扰）
- 偏好：文件命名格式“日期+名称”，输出简洁

3. AGENTS.md（行为规则）

markdown

## 会话前必做
1. 先读SOUL.md确认身份
2. 再读USER.md确认服务对象

## 安全规则
- 删除文件前先问我
- 不透露我的隐私信息

故障排查

问题	解决方法
command not found	重新加载环境：source ~/.bashrc 或重启终端
对话无反应	检查服务状态：openclaw gateway status
权限不足	运行 openclaw doctor --fix 自动修复
安装卡住	确认npm镜像配置正确，尝试 npm cache clean -f

总结

你已经成功搭建了一只专属“小龙虾”！回顾一下核心要点：

1. 国内用户必配npm镜像，否则寸步难行

2. 本地部署选Mac最简单，云服务器选阿里云一键部署最省心（其他云厂商如恒枢云等操作类似）

3. API Key用阿里云百炼，新用户有免费额度

4. 解锁full权限才能自动化，记得注意安全

5. 养成比部署更重要，多喂文件让它记住你

现在，去和你的小龙虾聊聊天吧！有问题可以在评论区留言，我会持续更新这份教程～