夜雨聆风> 从零开始搭建属于自己的 AI 助手，只需 5 分钟。
---
OpenClaw 是一个自托管的多渠道 AI 网关，让你可以在 WhatsApp、Telegram、Discord、iMessage 等多个聊天应用中，随时随地对 AI 助手说话。
它的核心特点：
✅ 完全自托管 - 数据掌握在自己手里，隐私安全 ✅ 多渠道支持 - 一个 Gateway 统一管理多个聊天应用 ✅ 无需服务器 - 本地电脑即可运行 ✅ 开源免费 - MIT 协议，社区驱动 简单说：你在手机上给 OpenClaw 发消息，它会帮你调用 AI 助手（比如 Pi），然后把回答通过聊天软件发回给你。
---
- 安装前准备
在开始之前，请确保：
- 1. 系统要求
- 操作系统
：macOS / Linux / Windows - Node.js 版本
：22 或更高 - 内存
：建议至少 4GB - 网络
：能访问 `openclaw.ai` 和模型提供商 API - 2. 检查 Node.js 版本
打开终端，输入：
```bash
node --version
```
如果版本低于 22，需要先升级 Node.js。
- macOS 升级 Node.js
如果你安装了 Homebrew：
```bash
brew install node@22
```
然后切换默认版本：
```bash
brew link --overwrite node@22
```
- Linux 升级 Node.js
以 Ubuntu 为例：
```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```
---
- 安装 OpenClaw
- 方法一：官方一键安装脚本（推荐）
最简单的方式，适合大多数用户：
```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```
脚本会自动：
检测你的系统 安装必要的依赖（Node.js、Git 等） 安装 OpenClaw 尝试引导你完成初始配置 - 方法二：手动安装
如果你更喜欢手动控制，可以这样做：
```bash
- 1. 全局安装 OpenClaw
npm install -g openclaw@latest
- 2. 进入配置目录
cd ~/.openclaw
```
- 验证安装成功
```bash
openclaw --version
```
应该能看到类似 `OpenClaw 2026.3.2` 的版本号。
---
- 初始配置（Onboarding）
第一次安装后，建议运行引导程序：
```bash
openclaw onboard --install-daemon
```
这个命令会：
1. 引导你配置模型提供商 - 选择 AI 助手的提供方（如 Anthropic、OpenAI 等）
2. 安装后台服务 - 让 OpenClaw 在后台持续运行
3. 创建基础配置 - 生成默认的配置文件
按照提示操作即可，通常只需要几步：
选择模型提供商（如 Anthropic） 输入 API 密钥（从提供商网站获取） 确认配置文件位置（默认 `~/.openclaw/openclaw.json`） ---
- 连接聊天渠道（以 WhatsApp 为例）
- 1. 登录 WhatsApp
```bash
openclaw channels login
```
运行后，会生成一个二维码。用 WhatsApp 扫描二维码即可完成绑定。
- 2. 启动 Gateway
```bash
openclaw gateway --port 18789
```
Gateway 启动后，你应该能看到类似这样的输出：
```
Gateway started on port 18789
Control UI available at http://127.0.0.1:18789/
```
- 3. 打开控制界面
在浏览器中打开：
```
http://127.0.0.1:18789/
```
你会看到一个 Web 界面，可以在这里：
查看和发送消息 配置渠道设置 管理会话 查看日志 ---
- 测试是否可用
现在，你可以在 WhatsApp 中给绑定的号码发送消息，试试看：
> "Hello, OpenClaw!"
你应该很快收到回复。如果 AI 助手已经配置好，它会以你的名义回复消息。
---
- 配置文件说明
OpenClaw 的配置文件位于：
```
~/.openclaw/openclaw.json
```
最基础的配置示例：
```json5
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"] // 只允许特定号码使用
},
telegram: {
botToken: "YOUR_BOT_TOKEN"
}
},
messages: {
groupChat: {
mentionPatterns: ["@openclaw"] // 群聊中需要 @openclaw 才会回复
}
}
}
```
重要提示：
`allowFrom` 用于控制谁能和你对话，建议先设置，防止被滥用 群聊建议开启 `requireMention` 或 `mentionPatterns`，避免在所有群中都会被触发 配置修改后需要重启 Gateway 才能生效 ---
- 常见问题
- Q1：安装后命令找不到？
解决方法：
macOS/Linux：
```bash
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
```
Windows：
1. 运行 `npm config get prefix` 查看安装路径
2. 将该路径添加到系统环境变量 PATH 中
3. 重启终端
- Q2：Gateway 启动失败，提示端口被占用？
解决方法：
换个端口运行：
```bash
openclaw gateway --port 18790
```
或者在配置文件中修改 `gateway.port`。
- Q3：WhatsApp 二维码扫描后没反应？
解决方法：
确保二维码已完全加载（等待 5-10 秒） 检查终端是否有错误日志 尝试刷新页面重新生成二维码 - Q4：收不到 AI 回复？
排查步骤：
1. 检查 API 密钥是否正确
2. 查看控制界面的日志，确认没有错误
3. 确认消息格式符合要求（群聊需要 @mention）
4. 检查是否在允许名单中
---
- 下一步可以做什么？
安装完成后，你可以：
1. 配置更多渠道 - Telegram、Discord、iMessage
2. 启用多代理路由 - 为不同工作流创建独立的 AI 实例
3. 安装插件 - 支持更多聊天平台（如 Mattermost）
4. 远程访问 - 通过 SSH 或 Tailscale 在其他设备上管理
详细文档：[OpenClaw 官方文档](https://docs.openclaw.ai)
---
- 总结
安装 OpenClaw 的整个过程：
```bash
- 1. 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
- 2. 初始配置
openclaw onboard --install-daemon
- 3. 登录 WhatsApp
openclaw channels login
- 4. 启动 Gateway
openclaw gateway --port 18789
```
只需要 4 条命令，就能把你的手机变成一个随时待命的 AI 助手。
---
- 关于作者
本文作者正在探索 AI 工具在个人生活中的应用，欢迎交流分享你的使用心得。
（完）
