什么是OpenClaw
OpenClaw 是一个开源、可自托管的个人 AI 助手平台。它能够将你常用的聊天工具（WhatsApp、Telegram、Discord、Slack、iMessage 等）与各种 AI 模型连接起来，让你在任何熟悉的聊天界面中直接与 AI 对话。项目在 GitHub 上已经获得超过 10 万颗星，社区非常活跃。
如果你一直想拥有一个属于自己的 AI 助手，但又不想被某个平台锁定，OpenClaw 是目前最值得尝试的方案之一。本文将手把手带你完成从零到可用的全部安装步骤。
系统要求
在开始之前，请确认你的环境满足以下条件：
- Node.js 22 或更高版本：OpenClaw 依赖较新的 Node.js 特性，22 是最低要求。
- 操作系统：macOS、Linux 或 Windows（推荐 macOS 或 Linux）。
- 网络连接：安装过程需要从 npm 仓库下载依赖包。
检查你当前的 Node.js 版本：
node -v
如果版本低于 22，建议使用 nvm 进行升级：
nvm install 22
nvm use 22
如果你还没有安装 nvm，可以参考 nvm 官方仓库 的说明进行安装。Windows 用户可以使用 nvm-windows。
通过npm安装OpenClaw
Node.js 环境就绪后，使用 npm 全局安装 OpenClaw：
npm install -g openclaw@latest
安装完成后，验证是否成功：
openclaw --version
如果正确输出版本号，说明安装已完成。
macOS 用户也可以通过 Homebrew 安装：
brew install openclaw
运行初始化向导
OpenClaw 提供了一个交互式的 onboard 向导，帮助你快速完成首次配置。运行以下命令启动向导：
openclaw onboard
向导会引导你完成以下步骤：
- 选择 AI 模型提供商：你可以选择 Anthropic Claude、OpenAI、Ollama（本地模型）、Gemini、OpenRouter 等。如果你还没有 API 密钥，可以先选择 Ollama 在本地运行模型。
- 配置 API 密钥：根据你选择的提供商，输入对应的 API 密钥。
- 选择聊天频道：选择你想连接的聊天平台，比如 WhatsApp、Telegram 等。首次安装建议先跳过这一步，后续再配置。
- 确认配置：向导会显示配置摘要，确认后写入配置文件。
所有配置信息会保存在 ~/.config/openclaw/openclaw.json5 文件中。你随时可以手动编辑这个文件来调整设置。
启动Gateway服务
配置完成后，启动 OpenClaw 的 Gateway 服务：
openclaw up
Gateway 默认运行在 18789 端口。你可以在浏览器中访问 http://localhost:18789 查看服务状态。
如果想让服务在后台运行：
openclaw up -d
打开Dashboard进行测试
OpenClaw 内置了一个 Web Dashboard，可以直接在浏览器中与 AI 对话，方便测试配置是否正确：
openclaw dashboard
这会自动打开浏览器并进入 Dashboard 界面。在对话框中输入一条消息，比如"你好，介绍一下你自己"，如果收到 AI 回复，说明整个链路已经打通。
常见问题排查
如果遇到问题，OpenClaw 提供了诊断工具：
openclaw doctor
这个命令会检查你的环境配置、依赖版本、API 连接状态等，并给出修复建议。
常见问题及解决方法：
command not found: openclaw：确保 npm 全局 bin 目录在你的 PATH 中。运行npm config get prefix查看路径，然后添加到 PATH。- Node.js 版本过低：使用
nvm install 22 && nvm use 22升级。 - API 连接失败：检查 API 密钥是否正确，网络是否能访问对应的 API 端点。可以用
curl手动测试。 - 端口冲突：如果 18789 端口被占用，可以在配置文件中修改
gateway.port字段。
下一步
安装完成后，你可以继续探索以下功能：
- 连接更多聊天平台（WhatsApp、Telegram、Discord 等）
- 配置多个 AI 模型提供商并在它们之间切换
- 创建自定义 Skill 扩展助手能力
- 配置 MCP Server 集成更多工具
更多信息请访问 OpenClaw，或查阅 OpenClaw官方文档。项目源码和 Issue 追踪请前往 OpenClaw GitHub仓库。