[特殊字符] OpenClaw（Clawd）完整安装教程：从零搭建你的专属 AI 助手

前言最近有个开源 AI 助手彻底火出圈了——OpenClaw曾用名 ClawdBot / Moltbot。截至 2026 年 1 月它的 GitHub 星数飙到 4.2 万fork 数超 5800全球有 1200 多名开发者主动参与贡献单日最高新增 2.07 万星。这个项目为什么这么火简单说OpenClaw 是一个本地运行的 AI 助手和普通聊天机器人不同它能真正执行任务——读写文件、运行脚本、操控浏览器、管理邮件和日程。而且它支持多渠道接入你可以通过 WhatsApp、Telegram、Discord、Slack 甚至 iMessage 跟它交互。最关键的是——完全开源、数据本地化你的隐私由你自己掌控。今天我就从头到尾讲清楚怎么搭建 OpenClaw。本地安装、Docker 部署、服务器远程访问全都有。一、安装前的准备1.1 系统要求OpenClaw 支持以下操作系统系统要求macOSmacOS 12LinuxUbuntu 20.04 / CentOS 等主流发行版Windows通过 WSL2 运行或使用原生 PowerShell1.2 Node.js 版本OpenClaw需要 Node.js 22.22.3、24.15 或 25.9官方推荐使用 Node 24。检查当前 Node.js 版本bashnode -v如果版本低于要求或者没有安装 Node.js不用慌——官方的一键安装脚本会自动检测并帮你安装 Node.js。你也可以手动从 nodejs.org 下载安装 LTS 版本。1.3 网络要求安装过程需要从 GitHub 和 npm 拉取资源建议保持网络畅通。国内用户如果速度太慢可以考虑使用代理或镜像源。二、快速安装推荐方式对于绝大多数用户官方的一键安装脚本是最简单、最快捷的方式。2.1 macOS / Linux 安装打开终端Terminal执行以下命令bashcurl -fsSL https://clawd.bot/install.sh | bash或者使用 OpenClaw 官方域名bashcurl -fsSL https://openclaw.bot/install.sh | bash安装脚本会自动检测系统环境、安装必要依赖包括 Node.js然后把openclaw命令部署到全局。⚠️ 特别提醒建议找一台不怕折腾的电脑来安装不要用工作机。2.2 Windows 安装Windows 用户请使用 PowerShell建议以管理员身份运行第一步解锁脚本执行权限Windows 默认禁止运行远程脚本需要先授权powershellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser如果系统提示确认输入Y或A并按回车。第二步执行安装命令powershelliwr -useb https://clawd.bot/install.ps1 | iex如果下载速度慢可以替换为国内镜像源powershelliwr -useb https://openclaw.ai/install.ps1 | iex整个过程大约需要 3-8 分钟脚本会自动处理 Node.js 环境、权限配置和依赖安装。2.3 验证安装安装完成后关闭当前终端重新打开一个新终端输入以下命令验证bashopenclaw --version如果成功显示出版本号如2026.3.7说明安装成功。三、其他安装方式3.1 通过 npm 全局安装如果你已经安装了 Node.js 22也可以直接通过 npm 安装bashnpm install -g openclawlatest3.2 通过 pnpm 安装如果你偏好 pnpmbashpnpm add -g openclaw3.3 从源码安装适合开发者或想修改核心代码的用户bashgit clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm build3.4 通过 Docker 部署Docker 方式适合希望隔离运行环境的用户。目前社区提供了多种 Docker 部署方案使用 Docker Compose推荐bashgit clone https://github.com/hllinc/openclaw-in-docker.git cd openclaw-in-docker docker compose up -d中文版 Docker 镜像也可以使用bashgit clone https://github.com/mf-yang/openclaw-cn.git cd openclaw-cn docker compose up -d openclaw-cn-gateway说明截至目前OpenClaw 未提供官方预构建 Docker 镜像以上为社区方案。四、初始化配置关键步骤安装完成只是第一步接下来需要给 AI 助手注入灵魂——配置模型和渠道。4.1 启动配置向导在终端中执行bashopenclaw onboard --flow quickstart这会进入一个交互式的问答流程。4.2 配置步骤详解第一关风险提示系统会询问是否继续选yes。第二关选择 AI 模型OpenClaw 支持多种模型Anthropic ClaudeClaude 3.5 Sonnet、Claude Opus 4.5 等OpenAI GPTGPT-4、GPT-4o 等Google GeminiQwen千问——免费额度大日常够用本地模型通过 Ollama 运行 Llama、Mistral 等——完全免费对于新手推荐选择 Qwen 或 Kimi等国内模型速度快且有免费额度。第三关输入 API Key把你准备好的 API Key 输进去。如果选择 Qwen系统可能会自动打开浏览器让你登录获取 API Key。第四关连接通讯工具可选系统会问你要不要连接 WhatsApp、Telegram、Discord 等渠道。WhatsApp扫码即可绑定最简单Telegram需要在 Telegram 里找BotFather创建机器人获取 Token 后粘贴到终端其他渠道可以先跳过以后在管理面板中随时添加第五关安装技能Skills系统会询问是否安装 Claude Skill 和 hook。简单理解这就是给 AI 装插件让它能干更多活。如果暂时不确定需要什么功能直接跳过就行后面随时可以加。4.3 启动服务配置完成后在终端中输入bashopenclaw start等待显示Gateway started successfully之类的成功日志就表示服务已经启动。4.4 打开管理面板打开浏览器访问以下地址texthttp://127.0.0.1:18789你将看到 OpenClaw 的网页控制台界面。五、常见问题与避坑指南❌ 问题 1Node.js 版本过低症状安装失败提示版本不支持。解决使用 nvmNode Version Manager管理 Node 版本bash# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash # 安装 Node 24 nvm install 24 nvm use 24❌ 问题 2网络不通 / 下载慢症状安装脚本卡住或超时。解决确保网络畅通必要时开启代理Windows 用户确保代理开启了Tun 模式让 PowerShell 也能走代理尝试使用国内镜像源❌ 问题 3Windows 权限问题症状提示没有管理员权限。解决右键点击 PowerShell选择“以管理员身份运行”。❌ 问题 4npm 安装报错 128症状npm error code 128。解决这是最常见的问题之一通常是因为网络问题或 Git 相关。可以尝试检查网络连接使用npm config set registry https://registry.npmmirror.com切换镜像源直接使用一键安装脚本代替 npm 安装❌ 问题 5命令找不到症状输入openclaw提示 command not found。解决检查是否安装成功重新打开一个新终端再试检查 PATH 是否包含 Node 的 bin 目录尝试旧版命令名clawdbot --version或moltbot --version❌ 问题 6安装后无法启动解决运行诊断命令bashopenclaw doctor这会检查环境配置并给出修复建议。六、结语到这里你的专属 AI 助手就搭建完成了回顾一下整个过程准备环境确保系统满足要求一键安装用官方脚本快速部署初始化配置选模型、配 API Key、连渠道启动服务让 AI 助手跑起来OpenClaw 最吸引人的地方在于——它是真正属于你自己的 AI。数据留在本地隐私由你掌控而且可以通过日常聊天工具随时随地指挥它干活。接下来你可以在管理面板里探索各种配置选项安装更多 Skills 扩展功能接入 Telegram / WhatsApp 等渠道实现 7×24 小时随身 AI如果在安装过程中遇到问题欢迎在评论区留言交流