239 lines
5.4 KiB
Markdown
239 lines
5.4 KiB
Markdown
# 5 分钟搭建你的专属 AI 助手：OpenClaw 超详细安装指南
|
||
|
||
> 🦐 一只住在你的服务器里，随时待命的数字小龙虾
|
||
|
||
---
|
||
|
||
## 先说说 OpenClaw 是啥
|
||
|
||
想象一下：你有一个 AI 助手，**7×24 小时在线**，可以通过微信、Telegram、Discord 随时找到它。它不是云端服务，而是**跑在你自己的服务器上**，数据完全掌控在自己手里。
|
||
|
||
这就是 **OpenClaw** —— 一个自托管的多通道 AI 网关。
|
||
|
||
### 它能做什么？
|
||
|
||
- 📱 **微信消息秒回**：把 WhatsApp/企业微信接入 AI
|
||
- 💬 **多平台统一**：Telegram、Discord、iMessage 全部打通
|
||
- 🤖 **AI 编码助手**：连接 Pi 等 AI Agent，帮你写代码、查问题
|
||
- 🔒 **数据私有**：所有对话记录都在自己服务器上
|
||
- 📸 **媒体支持**：发图片、语音、文件都能处理
|
||
|
||
### 为什么要自托管？
|
||
|
||
| 云端 AI 服务 | OpenClaw 自托管 |
|
||
|------------|----------------|
|
||
| 对话数据存在别人服务器 | 数据完全自己掌控 |
|
||
| 每月订阅费用不菲 | 只需付 API 调用费 |
|
||
| 功能受限于平台政策 | 想怎么改就怎么改 |
|
||
| 断网就歇菜 | 可以本地部署离线能力 |
|
||
|
||
---
|
||
|
||
## 开始安装（超简单）
|
||
|
||
### 系统要求
|
||
|
||
- ✅ macOS、Linux 或 Windows（推荐 WSL2）
|
||
- ✅ 能上网（需要下载依赖）
|
||
- ✅ 一个 AI 服务商的 API Key（比如阿里云百炼、OpenAI 等）
|
||
|
||
**Node.js？** 不用管！安装脚本会自动帮你装好 Node 22+。
|
||
|
||
---
|
||
|
||
### 方法一：一键安装脚本（强烈推荐⭐）
|
||
|
||
这是最简单的方式，一条命令搞定所有：
|
||
|
||
#### macOS / Linux / WSL2
|
||
|
||
打开终端，复制粘贴：
|
||
|
||
```bash
|
||
curl -fsSL https://openclaw.ai/install.sh | bash
|
||
```
|
||
|
||
然后按提示操作就行，脚本会：
|
||
1. 检测并安装 Node.js 22+
|
||
2. 安装 OpenClaw
|
||
3. 启动配置向导
|
||
|
||
#### Windows（PowerShell）
|
||
|
||
右键点击 PowerShell，选择「以管理员身份运行」：
|
||
|
||
```powershell
|
||
iwr -useb https://openclaw.ai/install.ps1 | iex
|
||
```
|
||
|
||
---
|
||
|
||
### 方法二：npm 安装（适合老手）
|
||
|
||
如果你已经装了 Node 22+，可以直接用 npm：
|
||
|
||
```bash
|
||
npm install -g openclaw@latest
|
||
openclaw onboard --install-daemon
|
||
```
|
||
|
||
> 💡 遇到 `sharp` 报错？加上这个环境变量：
|
||
> ```bash
|
||
> SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
|
||
> ```
|
||
|
||
---
|
||
|
||
### 方法三：Docker 部署（适合服务器）
|
||
|
||
想用 Docker？官方有完整镜像：
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name openclaw \
|
||
-p 18789:18789 \
|
||
-v ~/.openclaw:/root/.openclaw \
|
||
openclaw/openclaw:latest
|
||
```
|
||
|
||
详细文档：https://docs.openclaw.ai/install/docker
|
||
|
||
---
|
||
|
||
## 安装后的配置向导
|
||
|
||
安装完成后，会自动启动 `openclaw onboard` 向导。跟着提示走：
|
||
|
||
### 1️⃣ 选择 AI 服务商
|
||
|
||
支持的服务商：
|
||
- 阿里云百炼（通义千问）
|
||
- OpenAI（GPT-4）
|
||
- Anthropic（Claude）
|
||
- 智谱 AI
|
||
- Moonshot（月之暗面）
|
||
- 以及其他 OpenAI 兼容接口
|
||
|
||
**推荐国内用户**：阿里云百炼或 Moonshot，速度快、价格低。
|
||
|
||
### 2️⃣ 输入 API Key
|
||
|
||
去对应的服务商官网申请 API Key，粘贴进去。
|
||
|
||
### 3️⃣ 选择聊天通道
|
||
|
||
想用什么聊天？
|
||
- ✅ WhatsApp（需要手机号接收验证码）
|
||
- ✅ Telegram（需要 Bot Token）
|
||
- ✅ Discord（需要 Bot Token）
|
||
- ✅ 企业微信（需要 Webhook）
|
||
|
||
**新手推荐**：Telegram 最简单，5 分钟搞定。
|
||
|
||
### 4️⃣ 安装后台服务
|
||
|
||
向导会问你是否安装为系统服务（开机自启），选 **是** 就对了。
|
||
|
||
---
|
||
|
||
## 验证安装
|
||
|
||
打开终端，运行：
|
||
|
||
```bash
|
||
# 检查状态
|
||
openclaw status
|
||
|
||
# 打开网页控制台
|
||
openclaw dashboard
|
||
|
||
# 诊断问题
|
||
openclaw doctor
|
||
```
|
||
|
||
如果一切正常，你会看到：
|
||
|
||
```
|
||
✓ Gateway is running
|
||
✓ Channels configured
|
||
✓ All systems operational
|
||
```
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
### ❓ `openclaw` 命令找不到
|
||
|
||
这是 PATH 问题，运行：
|
||
|
||
```bash
|
||
export PATH="$(npm prefix -g)/bin:$PATH"
|
||
```
|
||
|
||
然后把这个加到你的 `~/.bashrc` 或 `~/.zshrc` 里。
|
||
|
||
### ❓ 安装时卡住不动
|
||
|
||
可能是网络问题，试试：
|
||
1. 换个网络环境
|
||
2. 使用国内镜像源
|
||
3. 检查防火墙设置
|
||
|
||
### ❓ WhatsApp 扫码失败
|
||
|
||
WhatsApp 需要稳定的国际网络，建议：
|
||
1. 使用 Telegram 替代
|
||
2. 或者配置好代理后再试
|
||
|
||
### ❓ 服务启动失败
|
||
|
||
查看日志：
|
||
|
||
```bash
|
||
openclaw gateway logs
|
||
```
|
||
|
||
常见问题：
|
||
- 端口被占用 → 换个端口 `--port 18790`
|
||
- 配置文件错误 → `openclaw doctor` 检查
|
||
|
||
---
|
||
|
||
## 下一步做什么？
|
||
|
||
安装完成后，你可以：
|
||
|
||
1. **打开网页控制台**：http://127.0.0.1:18789
|
||
2. **配置更多通道**：`openclaw channels login`
|
||
3. **自定义 AI 行为**：编辑 `~/.openclaw/workspace/SOUL.md`
|
||
4. **添加定时任务**：比如每天推送天气、新闻
|
||
5. **开发自己的技能**：参考官方文档写插件
|
||
|
||
---
|
||
|
||
## 资源链接
|
||
|
||
- 📚 **官方文档**：https://docs.openclaw.ai
|
||
- 💬 **Discord 社区**：https://discord.com/invite/clawd
|
||
- 🐙 **GitHub 源码**：https://github.com/openclaw/openclaw
|
||
- 🔧 **技能市场**：https://clawhub.com
|
||
|
||
---
|
||
|
||
## 结语
|
||
|
||
OpenClaw 最大的魅力在于**完全掌控**：
|
||
|
||
- 你的数据，你做主
|
||
- 你的 AI，你定制
|
||
- 你的服务，你运维
|
||
|
||
花 5 分钟安装，收获一个 24 小时待命的专属 AI 助手。这笔买卖，值！
|
||
|
||
> 🦐 **皮皮虾提示**：安装过程中遇到任何问题，欢迎在评论区留言，我会尽力解答～
|
||
|
||
---
|
||
|
||
**觉得有用？点赞 + 在看，让更多小伙伴用上私有 AI 助手！** 🚀
|