OpenClaw 是一款开源的个人 AI 助手，你可以完全在本地设备（Mac、Windows、Linux）上运行。它通过 Telegram、WhatsApp、Discord 等常用聊天工具与你交互，不仅能聊天，还能执行实际任务，如浏览器操作、邮件处理、日历管理等。整个安装过程只需一条命令 + 简单配置，新手通常 5 分钟内即可完成。

本教程基于官方文档和最新安装方式撰写，所有步骤均来自真实来源。

一、OpenClaw 是什么？适合谁？

OpenClaw（前身为 ClawdBot / Moltbot）是一个自托管的 AI 代理平台。它在你的本地设备上运行网关（Gateway），连接各种大语言模型（LLM），并通过聊天渠道接收指令。核心优势包括：

  • 隐私优先：所有数据留在你的设备上
  • 支持云模型（如 Claude、Gemini、OpenAI）和本地模型（如 Ollama）
  • 可扩展技能（Skills）：浏览器自动化、邮件、日历等
  • 跨平台支持：Mac、Windows、Linux，甚至 Raspberry Pi 或 VPS

适合希望拥有 7×24 小时私人 AI 助手、注重隐私并想让 AI 真正“做事”的用户。

二、安装前准备（不到 1 分钟）

系统要求：

  • macOS 12+、Windows 10/11、Linux（如 Ubuntu 22.04+）
  • 稳定的网络连接（用于下载依赖）
  • 推荐准备一个 LLM API Key（如 Anthropic Claude、Google Gemini、OpenAI 或本地 Ollama）

Windows 用户请以管理员身份打开 PowerShell；Mac/Linux 用户直接打开终端。

三、5 分钟安装步骤

步骤 1：运行一键安装命令（2-3 分钟）

Mac / Linux 用户：

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 配置向导（2-3 分钟）

openclaw onboard --install-daemon

向导会交互式引导你完成配置，包括：

  1. 安全确认（输入 Y）
  2. 选择 AI 模型提供商（Anthropic、OpenAI、Google、OpenRouter 或本地 Ollama）
  3. 输入 API Key（云模型）
  4. 选择默认模型
  5. 配置聊天渠道（推荐先添加 Telegram）
  6. 安装基础技能
  7. 启动后台守护进程（Daemon）

配置完成后，OpenClaw 会自动启动。你可以用 openclaw dashboard 打开本地 Web 控制面板查看状态。

四、首次使用测试

1. 在配置的聊天渠道（如 Telegram）中向 OpenClaw 发送消息，例如“你好”或“今天天气如何”。

2. 浏览器访问本地面板（通常是 http://localhost:18789），查看交互记录。

3. 测试简单任务是否正常执行。

五、常见问题与注意事项

  • Node.js 版本必须是 22+，老版本会导致失败。
  • Windows 用户必须使用管理员权限的 PowerShell。
  • 云模型有 token 费用，建议先用 OpenRouter 或切换本地 Ollama 实现零成本。
  • 如果无法连接，检查防火墙和端口。
  • 更新 OpenClaw 可运行 openclaw update 或重新执行安装命令。

遇到错误时，可复制错误信息搜索官方文档或社区。

六、下一步：进阶玩法

安装成功后，你可以：

  • 添加更多聊天渠道（Discord、Slack、WhatsApp 等）
  • 安装社区提供的技能
  • 搭建多 Agent 系统
  • 完全使用本地 Ollama 运行

更多详情请参考官方文档。

总结

通过一条官方安装命令 + onboard 向导，新手只需 5 分钟就能拥有自己的本地 AI 助手。OpenClaw 让 AI 从单纯聊天走向真正执行任务，值得每位 AI 爱好者尝试。

安装完成后，欢迎分享你的使用体验！

官方链接：
官网：https://openclaw.ai/

GitHub：https://github.com/openclaw/openclaw
文档：https://docs.openclaw.ai/