OpenClaw(前身为ClawdBot/Moltbot)是一款开源的个人AI助手,你可以完全在自己的电脑或服务器上运行。它通过WhatsApp、Telegram、Discord等常用聊天工具与你交互,不仅能回答问题,还能真正执行任务,比如浏览网页、发送邮件、管理日历、清空收件箱等。数据全部留在本地,隐私安全。
本教程从零开始,适合完全没有经验的小白。整个过程最快5-10分钟即可完成,所有步骤基于官方文档(docs.openclaw.ai)和最新安装方式撰写。
一、OpenClaw是什么?为什么值得安装?
OpenClaw是一个自托管的AI代理平台。它在本地运行“Gateway”(网关),连接各种大语言模型(支持Claude、Gemini、OpenAI、OpenRouter或完全本地Ollama),并通过聊天渠道接收你的指令。
主要优势:
- 隐私第一:所有数据不离开你的设备
- 支持云模型和本地模型(零费用)
- 可扩展技能(Skills):浏览器自动化、邮件处理、文件操作、智能家居等
- 跨平台:Mac、Windows、Linux、甚至树莓派或VPS
- 24/7一直在线(安装后台守护进程后)
特别适合想拥有私人AI助手、注重隐私的用户。
二、安装前准备
系统要求:
- macOS 12+、Windows 10/11、Linux(如Ubuntu 22.04+)
- 稳定的网络连接
- 推荐准备一个LLM API Key(可选):Anthropic Claude、Google Gemini、OpenAI 或 OpenRouter
- Windows用户请以“管理员身份”打开PowerShell
小白提示:不需要提前安装Node.js,官方安装脚本会自动处理。
三、从零安装步骤(最简单的一键方式)
步骤1:运行官方一键安装命令(2-3分钟)
Mac / Linux / WSL用户:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows用户(PowerShell 管理员模式):
iwr -useb https://openclaw.ai/install.ps1 | iex
脚本会自动检测系统、安装或升级Node.js(需要22+版本)、全局安装OpenClaw。
步骤2:验证安装是否成功
openclaw --version
如果显示版本号,安装成功。
步骤3:运行Onboard配置向导(3-5分钟,最重要一步)
openclaw onboard --install-daemon
向导会一步步引导你(交互式界面):
- 安全确认(输入Y)
- 选择AI模型提供商(推荐新手先选Anthropic、OpenAI、Google或OpenRouter;想零成本可选择Ollama本地模型)
- 输入API Key(如果使用云模型)
- 选择默认模型
- 配置聊天渠道(强烈推荐先添加Telegram或WhatsApp,手机上就能控制)
- 安装基础技能(Skills)
- 启动后台守护进程(Daemon,让OpenClaw开机自启、一直运行)
配置完成后,终端会提示成功,并自动打开或显示本地仪表盘地址(通常是 http://localhost:18789)。
四、首次使用与测试
1. 在配置的聊天渠道(如Telegram)中添加你的OpenClaw机器人,向它发送消息测试,例如:“你好” 或 “今天天气怎么样”。
2. 浏览器打开本地仪表盘,查看对话记录和状态。
3. 测试简单任务,例如让它帮你搜索信息或执行技能。
如果使用完全本地模式(Ollama),需先安装Ollama并运行模型。
五、常见问题与注意事项(小白必读)
- Node.js版本必须 ≥22,老版本会报错
- Windows用户一定要用管理员PowerShell运行
- 云模型会产生少量费用,建议先用OpenRouter找便宜方案,或切换Ollama实现完全免费
- 无法连接时检查防火墙、端口(18789)和网络
- 更新OpenClaw:运行
openclaw update或重新执行安装命令 - 推荐安装在专用设备上(如旧电脑或Mac Mini),并注意安全(不要暴露公网)
遇到错误时,复制错误信息到官方文档搜索或GitHub Issues。
六、安装后下一步进阶
成功运行后,你可以:
- 添加更多聊天渠道(Discord、Slack、WhatsApp等)
- 安装社区技能,扩展更多功能
- 搭建多Agent系统(多个AI助手协同工作)
- 结合Ollama实现100%本地运行
- 设置开机自启和自动化任务
总结
OpenClaw从零安装非常简单,一条命令 + onboard向导,小白也能在10分钟内拥有自己的本地AI助手。它让AI不再只是聊天,而是真正帮你做事,是2026年最受欢迎的开源AI项目之一。
安装完成后,欢迎在评论区分享你的配置过程或使用体验!如果卡在某一步,也可以贴出错误信息,我可以帮你排查。
官方链接:
官网:https://openclaw.ai/
文档:https://docs.openclaw.ai/
GitHub:https://github.com/openclaw/openclaw
快速开始:https://docs.openclaw.ai/start/getting-started