OpenClaw 零基础安装教程：从 0 到 1 搭建你的私人 AI 网关
本文将带你从零开始，一步步完成 OpenClaw 的安装、配置和使用。无论你是 Linux、macOS 还是 Windows 用户，都能按照本教程顺利完成部署。
📋 本文目录
- 环境要求与准备工作
- Node.js 安装配置
- OpenClaw 安装步骤
- 初始化配置向导
- 第一个渠道配置（Telegram）
- 常见问题与解决方案
📦 环境要求
OpenClaw 对系统资源要求极低，即使在最便宜的 VPS 上也能流畅运行。
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| Node.js | v22.16+ LTS | v24 最新版 |
| 内存 | 512MB | 2GB+ |
| 磁盘空间 | 1GB | 10GB+ |
| 操作系统 | Linux / macOS / Windows | Ubuntu 22.04+ |
⚡ 第一步：安装 Node.js
OpenClaw 基于 Node.js 开发，我们需要先配置好 Node.js 环境。
Ubuntu / Debian 系统
# 使用 NodeSource 安装源 curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - sudo apt-get install -y nodejs # 验证安装 node --version npm --version
macOS 系统（使用 Homebrew）
brew install node@24 # 验证安装 node --version
⚠️ 如果遇到权限问题，可以使用 sudo 安装，或者配置 npm 全局目录到用户目录。
🚀 第二步：安装 OpenClaw
Node.js 环境准备好后，就可以开始安装 OpenClaw 了。
# 全局安装 OpenClaw npm install -g openclaw@latest # 验证安装 openclaw --version # 查看帮助 openclaw --help
💡 使用 -g 参数进行全局安装，这样可以在任何位置使用 openclaw 命令。
⚙️ 第三步：初始化配置
运行配置向导，完成基础设置。
# 运行配置向导（推荐） openclaw onboard # 或者只安装服务 openclaw onboard --install-daemon
按照向导提示，完成以下配置：
- ✅ 选择你的 AI 提供商（OpenAI、Anthropic、Groq 等）
- ✅ 输入对应的 API Key
- ✅ 配置默认模型
- ✅ 设置服务开机自启动
🤖 第四步：配置 Telegram 机器人
✅ 在 Telegram 中联系 @BotFather，创建一个新机器人，获取 Token。
# 配置 Telegram 渠道 openclaw channel telegram set-bot-token YOUR_BOT_TOKEN # 启用 Telegram 渠道 openclaw channel telegram enable # 查看渠道状态 openclaw channel telegram status
🎮 第五步：打开控制面板
一切配置好后，就可以使用 Web 控制面板管理你的 OpenClaw 了。
# 打开 Web 控制面板 openclaw dashboard # 或者手动访问 # http://127.0.0.1:18789/
🛠️ 常用管理命令
| 命令 | 说明 |
|---|---|
openclaw status |
查看服务状态 |
openclaw logs |
查看运行日志 |
openclaw gateway restart |
重启 Gateway 服务 |
openclaw doctor |
系统诊断检查 |
openclaw update |
更新到最新版本 |
❌ 常见问题排查
🔴 端口被占用
# 查找占用进程 lsof -i :18789 # 或修改配置文件 ~/.openclaw/openclaw.json
🔵 API Key 无效
# 重新配置 API Key openclaw provider set-key openai YOUR_KEY
🎉 感谢阅读 OpenClaw 技术文章！
有问题欢迎在评论区交流讨论~
📅 发布于 2026年05月12日
🏷️ 标签: OpenClaw, AI 助手, 自托管, 自动化, 开发工具