至顶AI实验室出品：OpenClaw 完整部署指南（保证全网最详细版，并且已经亲测有效）

继DeepSeek、Manus之后，要问我2026年最火的AI产品是啥，肯定是最近被全网刷屏的OpenClaw。

OpenClaw（曾用名：Clawdbot、Moltbot），一款可以部署在个人电脑上的AI代理。不同于前两者在模型能力和硬件突破上的"军备竞赛"，OpenClaw走的是另一条路——让AI真正成为你的"数字分身"。它不需要你有一台配置爆表的工作站，不需要你懂复杂的技术架构，甚至连独立显卡都不需要。因为它的聪明之处在于，把"大脑"放在云端，而你的电脑只是一个轻量级的"遥控器"。

好了，下面就由至顶AI实验室带领大家进行完整的部署操作。

算力要求：虽然是开源部署，但其因为更多调用的是云端模型能力（API，当然调用本地模型也可以），其本身对算力的要求极低，完全不用担心电脑跑不起来，有无独立显卡都不重要，也不用纠结显存。

本文档特点：每个命令都附带详细解释，帮助您理解每一步的作用，如果太过简单的命令，也可以忽视注解。基于: 官方文档 + 社区实践 + 实际部署经验

最后，本指南为您提供：

• ✅ 三大系统完整部署方案：Linux（以及基于Linux的各种系统，比如Ubuntu），Mac OS，Win11
• ✅ 每个命令的详细解释
• ✅ 常见问题的解决方法
• ✅ 浏览器控制使用指南：个人重点推荐，因为其他几个交互方式（WhatsApp，Telegram，Discord，Slack，Signal，iMessage），我没有账号，懒得下载申请了，浏览器就挺好，但如果是mac，还是重点推荐iMessage）
• ✅ 企业 IM 完整接入
• ✅ 10 个经典应用场景

一、系统要求与环境检查

最低要求

检查 Node.js

node --version

命令详解：

• node - Node.js 运行程序
• --version - 显示版本号参数

预期输出：v22.x.x 或更高

如果没安装或版本过低：访问 https://nodejs.org 下载

检查 npm

npm --version

命令详解：

• npm - Node Package Manager，包管理器
• --version - 显示版本号

预期输出：10.x.x 或更高

Linux 部署

步骤 1: 更新系统

sudo apt update && sudo apt upgrade -y

命令详解：

• sudo - Super User Do，以管理员权限执行
• apt - Advanced Package Tool，包管理工具
• update - 更新软件包列表
• && - 逻辑与，前一命令成功才执行后一命令
• upgrade - 升级所有软件包
• -y - 自动确认，不询问

作用：更新系统到最新状态

时间：2-5 分钟

步骤 2: 安装 Node.js 22

添加仓库

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

命令详解：

• curl - 下载工具
• -fsSL - 参数组合：
  • -f - 失败不输出错误页
  • -s - 静默模式
  • -S - 显示错误
  • -L - 跟随重定向
• | - 管道，传递输出
• sudo -E bash - - 以管理员执行脚本
  • -E - 保留环境变量

作用：添加 Node.js 22.x 仓库

时间：30秒-1分钟

安装 Node.js

sudo apt-get install -y nodejs

命令详解：

• apt-get install - 安装软件
• -y - 自动确认
• nodejs - 软件包名

作用：安装 Node.js 和 npm

时间：2-3 分钟

步骤 3: 配置 Git（重要！）

git config --global url."https://github.com/".insteadOf git@github.com:
git config --global url."https://".insteadOf ssh://

命令详解：

• git config - Git 配置命令
• --global - 全局配置
• url."https://github.com/".insteadOf - URL 重写规则
• git@github.com: - SSH 格式 URL

作用：强制使用 HTTPS 而非 SSH，避免权限错误

重要性：⭐⭐⭐⭐⭐ 我在尝试过程中就遇到的 SSH 错误的问题，至少折腾了半小时，所以一定切记

步骤 4: 配置 npm（避免权限问题）

创建全局目录

mkdir -p ~/.npm-global

命令详解：

• mkdir - Make Directory，创建目录
• -p - Parents，创建父目录，目录存在不报错
• ~ - 用户主目录
• .npm-global - 隐藏目录（.开头）

作用：创建专用的 npm 全局目录

配置 npm 前缀

npm config set prefix '~/.npm-global'

命令详解：

• npm config set - 设置配置
• prefix - 全局安装路径
• '~/.npm-global' - 新路径

作用：告诉 npm 使用新目录，不需要 sudo

添加到 PATH

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

命令详解：

• echo - 输出文本
• export PATH=... - 设置环境变量
  • ~/.npm-global/bin - npm 可执行文件目录
  • :$PATH - 追加原有 PATH
• >> - 追加到文件末尾
• ~/.bashrc - Bash 配置文件

作用：让系统能找到全局安装的命令

重新加载配置

source ~/.bashrc

命令详解：

• source - 在当前 shell 执行脚本
• ~/.bashrc - 配置文件

作用：使 PATH 配置立即生效

重要性：依然⭐⭐⭐⭐⭐ ，否则极易出现权限混乱的问题。

步骤 5: 安装 OpenClaw

npm install -g openclaw@latest

命令详解：

• npm install - 安装命令
• -g - Global，全局安装
• openclaw - 包名
• @latest - 最新版本

作用：全局安装 OpenClaw

时间：2-5 分钟

输出：显示 "changed 741 packages" 表示成功

步骤 6: 运行配置向导

openclaw onboard --install-daemon

命令详解：

• openclaw - OpenClaw 命令
• onboard - 初始化向导
• --install-daemon - 安装系统服务

作用：引导完成配置，安装开机自启服务

向导问题：

1. AI 模型：推荐 Anthropic
2. API Key：这个就看自己能力了，淘宝，302平台啥的都可以
3. 工作空间：默认即可
4. 消息频道：可跳过
5. 技能包：可跳过，如果后续让其做一些复杂工作，可以随用随装。

时间：5-10 分钟

步骤 7: 启动网关

openclaw gateway --port 18789 --verbose

命令详解：

• gateway - 网关子命令
• --port 18789 - 监听端口
  • 18789 - 默认端口号
• --verbose - 详细输出

作用：启动 OpenClaw 核心服务

预期输出：

OpenClaw Gateway starting...
Listening on http://127.0.0.1:18789
Gateway ready!

注意：此命令会占用终端，按 Ctrl+C 可停止

步骤 8: 验证安装

浏览器访问：http://localhost:18789

地址详解：

• localhost - 本地主机（127.0.0.1）
• 18789 - 端口号

预期：看到 OpenClaw 控制面板

macOS 部署

步骤 1: 安装 Homebrew

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

命令详解：

• /bin/bash -c - 执行 bash 命令
• $() - 命令替换
• curl - 下载安装脚本

作用：安装 macOS 包管理器时间：5-10 分钟

步骤 2: 安装 Node.js

brew install node@22

命令详解：

• brew - Homebrew 命令
• install - 安装
• node@22 - Node.js 22 版本

时间：3-5 分钟

步骤 3-7

与 Linux 相同，唯一区别：

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

区别：macOS 默认用 Zsh，配置文件是 .zshrc

Windows 11 部署

步骤 1: 安装 WSL2

打开 PowerShell（管理员模式运行）：

• 按 Win+X
• 选择"Windows PowerShell (管理员模式运行)"

wsl --install -d Ubuntu

命令详解：

• wsl - Windows Subsystem for Linux
• --install - 安装
• -d Ubuntu - 安装 Ubuntu 发行版

作用：

1. 启用 WSL 功能
2. 安装 WSL2 内核
3. 下载 Ubuntu
4. 设置 WSL2 为默认

时间：10-20 分钟

完成后：必须重启电脑

步骤 2: 首次配置

重启后打开 Ubuntu，这里需要特别注意，Ubuntu正确打开方式（很多不熟悉wsl的同学会出现错误，直接打开WSL，结果WSL会一闪而过），开始菜单——终端（不是CMD，不是powershell，就是终端）——右侧小箭头下拉，选择Ubuntu.

设置：

Enter new UNIX username: yourname
New password: ****

说明：

• 用户名：
• 密码：

步骤 3-7

与 Linux 步骤完全相同。

步骤 8: Windows 访问

打开 Windows 浏览器：http://localhost:18789

原理：WSL2 自动转发端口到 Windows

二、运行与配置

前台运行

openclaw gateway --port 18789 --verbose

特点：

• 占用终端
• 实时查看日志
• 适合调试

后台运行

nohup openclaw gateway --port 18789 --verbose > gateway.log 2>&1 &

命令详解：

• nohup - No Hang Up，断开终端继续运行
• > - 重定向输出
• gateway.log - 日志文件
• 2>&1 - 错误输出也重定向到日志
  • 2 - 错误输出（stderr）
  • 1 - 标准输出（stdout）
• & - 后台运行

查看日志：（不想看就不看，不重要）

tail -f gateway.log

命令详解：

• tail - 显示文件末尾
• -f - Follow，持续监控
• 按 Ctrl+C 停止

停止后台进程（不想用的时候）

pkill -f openclaw

命令详解：

• pkill - Process Kill
• -f - 匹配完整命令行
• openclaw - 进程关键字

配置文件（知道就好，不需要操作啥）

位置：~/.openclaw/openclaw.json

查看配置

cat ~/.openclaw/openclaw.json

命令详解：

• cat - Concatenate，显示文件

编辑配置

方法 1：nano（推荐）

nano ~/.openclaw/openclaw.json

操作：

• 方向键移动
• 直接编辑
• Ctrl+O 保存
• Ctrl+X 退出

方法 2：vim

vim ~/.openclaw/openclaw.json

操作：

• 按 i 进入编辑
• 按 Esc 退出编辑
• 输入 :wq 保存退出

三、浏览器控制（非MAC时推荐）

启用步骤

1. 编辑配置：

nano ~/.openclaw/openclaw.json

1. 添加配置：

{
  "browser": {
    "enabled": true,
    "color": "#FF4500"
  }
}

配置详解：

• enabled: true - 启用浏览器控制
• color - 窗口主题色（十六进制）

1. 重启网关：

pkill -f openclaw
openclaw gateway --port 18789 --verbose

使用示例

openclaw agent --message "帮我在京东搜索 MacBook Pro 价格" --thinking high

AI 执行流程：

1. 打开浏览器
2. 访问京东
3. 搜索商品
4. 提取价格
5. 返回结果

四、企业 IM 接入

这里我给出几个核心步骤。

钉钉快速接入

# 1. 安装插件
openclaw plugins install @openclaw-china/channels
# 2. 配置
openclaw config set channels.dingtalk '{"enabled": true, "clientId": "dingxxxxxx", "clientSecret": "your-secret"}' --json

飞书快速接入

# 1. 安装插件
openclaw plugins install @openclaw-china/channels
# 2. 配置
openclaw config set channels.feishu '{"enabled": true, "appId": "cli_xxxxxx", "appSecret": "your-secret"}' --json

五、十大经典应用场景

我让部署好的openclaw去他自己的社区里（https://openclaw.ai/showcase）选择了它自己认为最经典的 10 个应用场景，并给我简单做了整理：

1. 开发者工作流自动化

场景描述: 自动化代码审查、CI/CD 触发、问题跟踪

实现方式:

• 集成 GitHub/GitLab
• 当有新 PR 时，OpenClaw 自动审查代码
• 在 Telegram 中发送审查结果和合并建议

技能需求: GitHub、Linear、GitLab

案例: @bangnokia - PR 自动审查并在 Telegram 反馈

bash

# 示例：审查最新 PR
openclaw agent --message "审查最新的 Pull Request"

2. 自动化日程与任务管理

场景描述: 跨平台同步日程，自动创建提醒

实现方式:

• 集成 Google Calendar、Apple Notes、Things 3
• 语音或文字创建任务
• 自动分类和设置优先级

技能需求: Calendar、Notes、Notion

案例: @AS - 健康助手整合 Oura 数据与日程

bash

# 示例
openclaw agent --message "明天上午 10 点提醒我开会"

3. 智能家居控制

场景描述: 通过聊天控制家中设备

实现方式:

• 集成 Home Assistant、Philips Hue
• 语音控制灯光、温度、空气净化器

技能需求: Home Assistant、智能设备 API

案例: @antonplex - 自动管理房间空气质量

bash

# 示例
openclaw agent --message "打开客厅的灯"

4. 网页自动化与数据抓取

场景描述: 自动填表、数据采集、网购助手

实现方式:

• 使用浏览器控制功能
• 自动导航、填写表单、提取数据

技能需求: Browser Control

案例:

• @marchattonhere - 自动生成周购物清单并下单
• @George5562 - 自动预订学校午餐

bash

# 示例
openclaw agent --message "帮我查京东上 MacBook Pro 的最新价格"

5. 每日简报与信息聚合

场景描述: 自动生成每日摘要（天气、任务、新闻）

实现方式:

• 定时任务（cron）
• 整合多个数据源
• 生成图片或文字简报发送到 Telegram/飞书

技能需求: Weather、News、Calendar

案例: @buddyhadry - 每日生成场景图片简报

bash

# 配置定时任务
openclaw cron add "0 7 * * *" "生成今日简报"

6. 文件管理与搜索

场景描述: 智能文件整理、搜索、批量重命名

实现方式:

• 访问本地文件系统
• OCR 提取图片文字
• 自动分类和归档

技能需求: File System、OCR

bash

# 示例
openclaw agent --message "找出桌面上所有的 PDF 文件"

7. 邮件自动化

场景描述: 自动回复、邮件分类、重要邮件提醒

实现方式:

• 集成 Gmail Pub/Sub
• 自动识别重要邮件
• 生成回复草稿

技能需求: Gmail

bash

# 示例
openclaw agent --message "总结今天收到的邮件"

8. 多智能体协作

场景描述: 多个 AI 代理分工协作完成复杂任务

实现方式:

• 配置多个 Agent
• Opus 4.5 作为协调者
• 其他模型作为执行者

技能需求: Multi-agent Routing

案例: @adam91holt - 14+ 代理协同工作

配置示例：

json

{
  "agents": {
    "orchestrator": {
      "model": "anthropic/claude-opus-4-5",
      "role": "coordinator"
    },
    "coder": {
      "model": "anthropic/claude-sonnet-4-5",
      "role": "code_execution"
    }
  }
}

9. 健康数据跟踪

场景描述: 整合可穿戴设备数据，生成健康报告

实现方式:

• 集成 Oura Ring、Apple Health
• 分析睡眠、运动数据
• 生成个性化建议

技能需求: Health APIs

案例: @AS - Oura 数据与日程整合

10. 教育与学习助手

场景描述: 个性化学习计划、作业辅导、知识管理

实现方式:

• 整合 Notion、Obsidian
• 创建学习笔记
• 定时复习提醒

技能需求: Notion、Obsidian

bash

# 示例
openclaw agent --message "帮我总结今天学习的 Python 知识点"

六、常见问题（很重要）

❌ npm 权限错误

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

❌ Git SSH 错误

git config --global url."https://github.com/".insteadOf git@github.com:
git config --global url."https://".insteadOf ssh://

❌ 端口占用

kill -9 $(lsof -t -i :18789)

或使用其他端口：

openclaw gateway --port 8080 --verbose

❌ Node.js 版本过低

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
nvm alias default 22

❌ WSL2 内存占用高

创建 C:\Users\YourUsername\.wslconfig：

[wsl2]
memory=4GB
processors=2

然后重启：

wsl --shutdown

❌ AI 无响应

# 检查配置
openclaw doctor
# 查看日志
tail -f ~/.openclaw/logs/*.log
# 测试连接
openclaw agent --message "测试" --thinking off

七、升级和维护（如果出现新的版本，旧版本一定记得删除缓存）

升级 OpenClaw

npm install -g openclaw@latest

或：

openclaw update --channel stable

频道选项：

• stable - 稳定版（推荐）
• beta - 测试版
• dev - 开发版

查看版本

openclaw --version

清理缓存

rm -rf ~/.npm/_cacache
npm install -g openclaw@latest

八、有用资源（个人认为）

• 官网: https://openclaw.ai
• GitHub: https://github.com/openclaw/openclaw
• 文档: https://docs.openclaw.ai
• 案例: https://docs.openclaw.ai/start/showcase
• Discord: https://discord.gg/clawd
• 中文社区: https://www.moltcn.com
• 中国插件: https://github.com/BytePioneer-AI/moltbot-china

END

本文来自至顶AI实验室，一个专注于探索生成式AI前沿技术及其应用的实验室。致力于推动生成式AI在各个领域的创新与突破，挖掘其潜在的应用场景，为企业和个人提供切实可行的解决方案。