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

向导会一步步引导你(交互式界面):

  1. 安全确认(输入Y)
  2. 选择AI模型提供商(推荐新手先选Anthropic、OpenAI、Google或OpenRouter;想零成本可选择Ollama本地模型)
  3. 输入API Key(如果使用云模型)
  4. 选择默认模型
  5. 配置聊天渠道(强烈推荐先添加Telegram或WhatsApp,手机上就能控制)
  6. 安装基础技能(Skills)
  7. 启动后台守护进程(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