快速开始
5 分钟完成安装，开启你的 AI 助手之旅
最新版本： v0.8.0 (2026-03-01) | 推荐使用 Node 24，Node 22 LTS (22.16+) 兼容支持
💡 最快体验方式：
安装完成后运行 openclaw dashboard 直接在浏览器中打开控制面板，无需配置聊天渠道即可开始使用。
环境要求
- ✅Node.js 24 推荐，Node 22.16+ LTS 兼容
- ✅npm、yarn 或 pnpm 包管理器
- ✅支持的操作系统：macOS 12+、Linux (Ubuntu 20.04+)、Windows 10+ (原生 PowerShell 或 WSL 2)
- ✅至少 2GB 内存，推荐 4GB 以上
快速安装（推荐）
npm install -g openclaw
安装完成后，运行初始化向导：
openclaw onboard
按照向导提示配置模型、聊天渠道等信息，完成后即可开始使用。
验证安装
运行以下命令验证安装是否成功：
openclaw --version
如果输出版本号（如 v0.8.0），说明安装成功。
查看运行状态：
openclaw status
首次使用
1. 启动网关
网关是 OpenClaw 的核心服务，负责处理所有请求：
openclaw gateway start
2. 打开控制面板
在浏览器中打开控制面板，进行可视化操作：
openclaw dashboard
默认访问地址：http://localhost:18789
3. 测试助手
在控制面板的聊天界面中发送消息，测试助手是否正常工作：
你：帮我写一个 Hello World 程序
助手：当然可以！这是一个简单的 Hello World 程序...
常见安装问题
权限错误 (EACCES)
如果安装时出现权限错误，可以使用 sudo 或修改 npm 全局安装路径：
sudo npm install -g openclaw
或者配置 npm 全局安装到用户目录（推荐）：
npm config set prefix ~/.npm-global echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc source ~/.zshrc
网络超时
如果安装时网络超时，可以使用国内 npm 镜像：
npm install -g openclaw --registry=https://registry.npmmirror.com
网关启动失败或端口被占用
查看网关状态和错误日志：
openclaw gateway status openclaw logs gateway
修改默认端口（默认 18789）：
openclaw config set gateway.bind.port 8080模型配置错误
重新运行配置向导，或者直接编辑配置文件：
openclaw onboard openclaw config edit
控制面板访问失败
确认网关正常运行后，检查绑定地址配置：
openclaw config get gateway.bind远程访问需要将绑定地址设置为 0.0.0.0 或对应网卡地址，同时配置防火墙规则。
更多问题请查看 常见问题 页面
或在 GitHub Discussions、Discord 社区提问，我们会尽快回复