OpenClaw（俗称 “小龙虾”）是一款能真正执行任务的开源 AI 智能体网关，不是单纯的聊天工具 —— 它能帮你自动整理文件、运行脚本、网页自动化，数据全程本地存储，隐私更安全。本文详细拆解 Windows、macOS、Linux 电脑端，以及 Android、iOS 移动端 的真实部署步骤，附避坑指南和完整常用命令清单，新手也能一次搞定！
一、部署前必看：核心要求与准备
1.1 核心定义与价值
OpenClaw 是本地优先部署的 AI 执行网关，核心能力是 “把自然语言指令转化为实际操作”，支持文件管理、终端命令执行、网页自动化，数据完全由你掌控，适合注重隐私、需要高效自动化的个人 / 团队。
1.2 通用环境要求（真实准确版）
表格
| 部署端 | 系统要求 | 硬件建议 | 核心依赖 |
|---|---|---|---|
| 电脑端 | Windows 10+/macOS 12+/Ubuntu 22.04+ | 内存≥4GB（推荐 8GB），磁盘≥20GB | Node.js≥v22、npm/pnpm、Git |
| Android 端 | Android 8.0+ | 剩余存储≥200MB，RAM≥4GB | Termux（F-Droid 版，无 APK） |
| iOS 端 | iOS 14.0+ | 剩余存储≥100MB | Safari/Chrome 浏览器（仅远程 Web 管理） |
1.3 必备准备
- 稳定网络（下载依赖 / 模型）
- 对应设备权限（Windows PowerShell 管理员、macOS/Linux sudo、Android 未知来源安装 Termux）
- 模型 API Key（可选，后续可在 WebUI 配置）
二、电脑端部署（3 大系统详细步骤）
2.1 Windows 10/11 部署（新手首选）
- 打开 PowerShell：开始菜单搜索「PowerShell」，右键以管理员身份运行；
- 解锁脚本执行权限（必做）：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
提示时输入 Y 回车。
3. 执行官方一键安装：
iwr -useb https://openclaw.ai/install.ps1 | iex
- 国内加速（可选）：
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest
- 初始化配置：
openclaw onboard
- 启动网关：
openclaw gateway start
- 访问面板：
http://localhost:18789
2.2 macOS 12+ 部署
方案 1：官方一键（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard
openclaw gateway start
方案 2：手动 Homebrew
brew install node@22
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
2.3 Linux（Ubuntu 22.04+）
sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
openclaw onboard
sudo openclaw gateway start
2.4 电脑端常见问题避坑
- Windows 权限不足：必须管理员运行 PowerShell
- 启动失败：
openclaw doctor自动修复 - 端口占用：修改端口后重启
三、移动端部署（Android + iOS，真实无 APK）
3.1 Android 部署（Termux 命令行）
OpenClaw 官方无安卓 APK，只能通过 Termux 环境运行 Node.js 版本，这是唯一真实方法。
步骤：
- 下载 F-Droid 版 Termux（Google Play 已废弃）
- 打开 Termux，执行：
pkg update && pkg upgrade -y
pkg install nodejs-lts git tmux -y
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
- 初始化：
openclaw onboard
- 后台运行（防止掉线）：
tmux new -s openclaw
openclaw gateway start
按 Ctrl+B → D 后台挂起。
5. 访问：
手机浏览器打开：http://localhost:18789
3.2 iOS 端（仅远程管理，无本地运行）
iOS 无法本地运行 OpenClaw，只能远程连接电脑 / Android 的面板：
- 电脑 / Android 已运行 OpenClaw
- 同一 WiFi 下访问：
http://IP:18789 - Safari 添加到主屏幕，实现类 APP 体验
3.3 移动端常见问题
- Termux 后台被杀：开启忽略电池优化
- 无法访问：关闭防火墙、同一 WiFi
- Android 无 APK、无官方 APP，请勿相信第三方 APK
四、核心配置与使用入门
- 打开
http://localhost:18789 - 设置 → 模型配置
- 填入 API Key 或对接本地 Ollama 模型
- 重启网关生效：
openclaw gateway restart
五、OpenClaw 常用命令全清单（真实官方命令）
5.1 基础信息
openclaw -V
openclaw --help
openclaw onboard
openclaw doctor
openclaw update
5.2 网关服务（核心）
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status
openclaw gateway install # 开机自启
openclaw gateway uninstall
5.3 状态与日志
openclaw status
openclaw logs --follow
openclaw dashboard
5.4 配置与模型
openclaw config list
openclaw config set 键名 值
openclaw config validate
openclaw models list
openclaw models set 模型名
5.5 卸载
openclaw uninstall
openclaw uninstall --purge # 彻底删除
5.6 Termux 专用
tmux new -s openclaw
tmux attach -t openclaw
ip addr show # 查看本机IP
六、进阶技巧
- 多设备统一管理：电脑主节点 + 手机远程
- 技能市场扩展插件
- Termux 必须用 tmux 保活
七、常见问题解决
- 安装失败：
openclaw doctor - 端口被占用：修改 gateway.port
- API 调用失败：检查 Key / 余额
- Termux 掉线：电池优化 → 无限制
