快速开始
从零到能用,只需要 4 步。跟着做,10 分钟后你就有了一个随时在线的 AI 助手。
⏱ 预计耗时 10 分钟系统要求
OpenClaw 可以运行在以下系统上:
| 系统 | 要求 | 说明 |
|---|---|---|
| macOS | 10.15+ | Intel 和 Apple Silicon 都支持 |
| Linux | Ubuntu 20.04+ / Debian 11+ | CentOS、RHEL、Arch 也可以 |
| Windows | WSL2 | 需要先安装 WSL2,在里面运行 |
硬件需求很低
OpenClaw 本身非常轻量(约 100MB 内存)。AI 推理是通过云端 API 完成的,不需要本地 GPU。一台普通电脑、一台云服务器、甚至树莓派都能跑。
第一步:运行安装脚本
打开终端(macOS 按 ⌘ + 空格 搜索"终端"),复制下面的命令,粘贴到终端里,按回车:
bash
curl -fsSL https://cdn.gamesxh.com/ai-setup/setup-openclaw.sh -o setup.sh && bash setup.sh
这个脚本会自动完成以下事情:
- 检查系统环境(Node.js、npm 等)
- 安装缺失的依赖
- 下载并安装 OpenClaw
- 创建配置文件目录
- 设置开机自启
安装完成的标志
看到 OpenClaw installed successfully! 就说明安装成功了。如果遇到错误,可以查看 故障排除 页面。
第二步:运行配置向导
安装完成后,运行配置向导:
bash
openclaw onboard
向导会引导你完成以下配置(全程中文提示):
- 选择 AI 模型 — 推荐 Anthropic Claude(最聪明),也可以选 OpenAI GPT 或国内模型
- 输入 API Key — 向导会告诉你去哪里获取
- 选择聊天平台 — 选一个你最常用的平台(Telegram / Discord / WhatsApp)
- 配置平台连接 — 向导会一步步教你创建 Bot 和输入 Token
API Key 需要提前准备
你需要一个 AI 模型的 API Key 才能使用 OpenClaw。如果还没有,请先阅读 AI 模型配置 了解如何获取。
第三步:连接聊天平台
配置向导中已经包含了平台连接。如果你跳过了这一步,或者想连接更多平台,可以随时运行:
bash
openclaw configure
最常用的三个平台的快速说明:
- Telegram — 最简单。找
@BotFather创建 Bot,拿到 Token 填进去就行 - Discord — 需要去 Discord Developer Portal 创建应用、创建 Bot、获取 Token,然后邀请到服务器
- WhatsApp — 运行后会显示一个二维码,用手机 WhatsApp 扫码即可连接
详细教程请看 连接聊天平台。
第四步:发消息测试
确保 Gateway 正在运行:
bash
openclaw gateway start
然后打开你刚才连接的聊天平台,发一条消息给你的 Bot:
text
你好!请介绍一下你自己
如果一切正常,你的 AI 助手会在几秒钟内回复你。恭喜,你的私人 AI 助手已经上线了!🎉
没收到回复?
别担心,这是最常见的新手问题。检查以下几点:
1. 确认 Gateway 正在运行:openclaw status
2. 检查日志:openclaw logs
3. 运行诊断:openclaw doctor
更多解决方案请看 故障排除。
接下来做什么
基础功能已经跑起来了,你可以继续探索这些进阶内容: