OpenClaw 是一个在您自己设备上运行的个人 AI 助手,可以连接到各种消息平台,支持通过 GLM Coding Plan 等渠道配置使用智谱的 GLM 模型。以下是基于最新官方文档的完整安装指南。
openclaw安装下载详细资料(含视频): https://pan.quark.cn/s/2801d0dbf99c

一、部署前准备
1.1 系统与硬件要求
操作系统:Windows 10/11(64位)、macOS 12+、Linux(Ubuntu 22.04+/Debian 11+) 最低配置:2核CPU、4GB内存、10GB可用磁盘空间 推荐配置:4核CPU、8GB内存、40GB+ NVMe存储
1.2 核心依赖安装
**Node.js 22+**:必须安装22.x LTS或更高版本
Windows:使用nvm-windows管理 macOS/Linux:使用nvm或brew安装 验证命令: node --version升级方法: Git:用于代码克隆和版本控制
API密钥:准备大模型服务商的API Key(如MiniMax、Kimi、OpenAI、Claude等)
二、Windows系统部署(两种方案)
2.1 方案A:原生PowerShell一键安装(新手首选)
以管理员身份打开PowerShell 解锁脚本执行权限: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser执行一键安装命令(自动安装Node.js和依赖): iwr -useb https://openclaw.ai/install.ps1 | iex验证安装: openclaw --version
2.2 方案B:WSL2 + Ubuntu(官方推荐,更稳定)
安装WSL2: wsl --install重启电脑后,安装Ubuntu: wsl --install -d Ubuntu在Ubuntu终端中执行: curl -fsSL https://openclaw.ai/install.sh | bash验证安装: openclaw --version
三、macOS系统部署
安装Homebrew(包管理器): /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装依赖: brew install node@22 git安装OpenClaw: npm install -g openclaw@latest --registry=https://registry.npmmirror.com验证安装: openclaw --version
四、Linux/云服务器部署
4.1 基础环境配置
# Ubuntu/Debian系统更新sudo apt update && sudo apt upgrade -y# 安装核心依赖sudo apt install curl git npm python3-pip docker.io -y# 升级Node.js至22.0.0sudo npm install -g n && sudo n 22.0.0# 配置npm国内镜像npm config set registry https://registry.npmmirror.com4.2 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git4.3 设置开机自启
sudo systemctl enable openclawsudo systemctl start openclaw五、Docker部署(服务器/隔离环境首选)
安装Docker并启动服务 创建配置文件夹: mkdir -p ~/openclaw && cd ~/openclaw拉取最新镜像并运行: docker run -d --name openclaw-core -p 18789:18789 -v $(pwd):/data openclaw/openclaw验证容器状态: docker ps
六、手机端部署(安卓/鸿蒙)
6.1 APK直装(零基础首选)
下载正版APK:访问OpenClaw官方GitHub仓库,在"Releases"栏目下载"Android v2026.3.8"安装包 授权安装:选择"仅本次允许"未知来源应用 初始化配置:打开龙虾AI,选择"本地运行模式",关闭"公网访问"开关 权限设置:仅开启"悬浮窗、后台运行、通知"三大基础权限
6.2 Termux进阶部署(功能更全)
适合6GB内存以上手机,可自定义复杂任务、安装官方插件。
七、初始化配置向导
安装完成后,执行配置向导:
openclaw onboard --install-daemon7.1 配置流程详解
7.2 启动服务
# 启动网关服务openclaw gateway start# 打开Web控制台openclaw dashboard# 或直接访问http://localhost:18789八、接入飞书(国内用户推荐)
8.1 创建飞书应用
访问飞书开放平台,创建新应用 记录App ID和App Secret备用
8.2 安装飞书插件
# 安装飞书插件按照插件说明文档执行安装命令# 修改配置文件 ~/.openclaw/openclaw.json"channels": {"feishu": {"enabled": true,"appId": "你的App ID","appSecret": "你的App Secret","domain": "feishu","connectionMode": "websocket" }}8.3 配置飞书应用权限
开启机器人能力 开通相关消息权限 订阅事件:选择"长连接"方式 创建版本并发布
九、必备技能(Skills)安装
技能是OpenClaw的能力插件,安装命令:
npx clawhub@latest install <技能名>9.1 2026年新手必备技能
Agent Browser:核心必装,赋予浏览器操作能力 Tavily Web Search:联网搜索大脑,避免AI信息滞后 skill-vetter:安全守门员,审计第三方技能安全性 self-improving-agent:内置记忆与优化机制 summarize:网页、文档快速总结工具
十、常见问题解决
10.1 Windows环境问题
配置向导按回车无反应:用方向键选中选项,按空格打勾,再按回车 Gateway服务启动失败:放弃系统服务方式,手动启动: openclaw gateway run # 保持窗口打开openclaw dashboard # 新开窗口启动仪表盘
10.2 端口冲突
# 检查端口占用sudo netstat -tuln | grep 18789# 终止占用进程sudo kill -9 <进程ID># 或修改OpenClaw配置文件更换端口10.3 对接本地Ollama模型
修改配置文件 ~/.openclaw/openclaw.json:
"model": {"provider": "openai","name": "llama3","apiBase": "http://localhost:11434/v1","apiKey": "ollama-local"}十一、维护与升级
11.1 常用命令
# 检查服务状态openclaw gateway status# 查看运行日志openclaw logs follow# 运行诊断检查openclaw doctor# 升级到最新版本npm install -g openclaw@latest11.2 安全建议
仅开启必要权限,敏感权限一律关闭 关闭"公网访问"开关,避免远程控制风险 定期更新系统和应用安全补丁 重要数据保留3份备份
十二、云服务部署方案
12.1 阿里云部署(五种方案)
轻量云服务器部署:购买轻量应用服务器并安装OpenClaw镜像 无影云电脑企业版:内置OpenClaw便捷配置页及Skill平台 无影云电脑个人版:一键部署镜像,预装Linux环境 无影AgentBay部署:通过SDK快速集成 云服务器ECS部署:通过计算巢社区版部署
12.2 腾讯云轻量应用服务器
提供预装环境,支持一键部署OpenClaw,5分钟上线,性价比高。
OpenClaw部署相对简单,主要分为环境准备、平台安装、初始化配置三个步骤。对于新手,推荐使用Windows WSL2方案或macOS一键安装;对于生产环境,建议使用Docker或云服务器部署。部署完成后,可通过Web控制台或飞书等即时通讯工具与AI助手交互,实现自动化任务处理。
注意事项:OpenClaw运行时操作权限极大,建议在隔离环境中运行,并仔细阅读官方安全文档。
夜雨聆风