每日备份 2026-03-27

2026-03-27 23:38:45 +08:00
parent 4f11cd7b03
commit d09281e48c
827 changed files with 6991 additions and 148648 deletions
@@ -0,0 +1,238 @@
+# 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 助手！** 🚀