OpenClaw 是一款完全开源的个人本地 AI 助手（Personal AI Assistant）。它运行在你的电脑或服务器上，通过 WhatsApp、Telegram、Discord、Slack 等常用聊天工具与你交互。AI 不仅能聊天，还能真正执行任务：浏览网页、发送邮件、管理日历、清空收件箱、定时自动化、文件操作等。所有数据都留在你的设备上，隐私得到最大保障。

本攻略从零开始，覆盖 Mac、Windows、Linux 全平台，包含安装、onboard 配置向导、AI 模型选择、聊天渠道连接、持久记忆设置、自动化任务等完整流程。所有步骤基于 OpenClaw 官方文档（docs.openclaw.ai）和 2026 年最新实践，确保真实有效。

一、OpenClaw 是什么？值得安装吗？

OpenClaw（曾用名 ClawdBot / Moltbot）是一个自托管的 AI 代理平台（Gateway）。它在本地运行网关，连接各种大语言模型（LLM），并通过聊天渠道接收你的指令。

主要优势：

  • 隐私第一：数据永不离开你的设备
  • 支持云模型（Claude、GPT、Gemini）和完全本地模型（Ollama）
  • 可扩展技能（Skills）和自动化（Cron/Heartbeat）
  • 多渠道支持：Telegram、WhatsApp、Discord 等
  • 跨平台：Mac、Windows（推荐 WSL2）、Linux
  • 24/7 后台运行（安装 Daemon 后）

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

二、系统要求与准备工作

最低配置：

  • CPU：2 核以上（推荐 4 核+）
  • 内存：4GB+（本地模型推荐 16GB+，GPU 更好）
  • 存储：至少 10GB 可用空间
  • Node.js：22.16+（推荐 24，安装脚本会自动处理）
  • 网络：稳定互联网连接（安装时下载依赖）

平台注意事项：

  • Mac：macOS 12+，推荐安装 Xcode Command Line Tools 和 Homebrew
  • Windows：Windows 10/11，强烈推荐使用 WSL2（Ubuntu），原生 Windows 支持有限
  • Linux：Ubuntu 22.04+ 等，推荐服务器或专用设备

准备一个 LLM API Key（可选）：

  • Anthropic（Claude）：console.anthropic.com
  • OpenAI / OpenRouter（聚合多家，便宜）
  • Google Gemini
  • 本地 Ollama：完全免费

安全建议：最好使用专用电脑或设备运行，不要暴露到公网；定期备份工作区文件夹。

三、一键安装 OpenClaw（最推荐，2-5 分钟）

Mac / Linux / WSL2 用户

打开 Terminal，复制粘贴运行：

curl -fsSL https://openclaw.ai/install.sh | bash

如果不想立即运行向导：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows 用户

以管理员身份打开 PowerShell，运行：

iwr -useb https://openclaw.ai/install.ps1 | iex

不运行向导版：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

安装完成后验证：

openclaw --version

看到版本号（如 2026.x.x）即成功。

其他安装方式（高级）

  • 使用 npm： npm install -g openclaw@latest
  • 使用 pnpm（推荐）： pnpm add -g openclaw@latest
  • Docker / 从源码构建：详见官方文档

四、运行 Onboard 配置向导（最重要一步，3-8 分钟）

安装后立即运行（推荐带 Daemon）：

openclaw onboard --install-daemon

向导会一步步交互式引导：

  1. 安全确认：阅读警告后输入 Y（OpenClaw 需要执行任务权限）
  2. 选择安装模式：新手推荐 QuickStart
  3. 选择 AI 模型提供商（Provider）：
    • Anthropic（Claude 系列，工具调用强）
    • OpenAI（GPT）
    • Google（Gemini）
    • OpenRouter（多模型聚合，便宜）
    • Ollama（完全本地）
  4. 输入 API Key（云模型）
  5. 选择默认模型（向导会列出可用模型）
  6. 配置聊天渠道（推荐先加 Telegram）
  7. 安装基础技能（Skills）
  8. 启动后台服务（Daemon：macOS 用 launchd，Linux 用 systemd，Windows WSL 支持）

配置完成后，运行以下命令打开本地仪表盘：

openclaw dashboard

默认地址：http://localhost:18789（用浏览器打开，登录 token 通常在终端显示）。

五、平台特定配置与常见问题

Mac 专属

  • 安装 Xcode Command Line Tools： xcode-select --install
  • Homebrew 安装依赖（如果提示）
  • Daemon 集成菜单栏 App（可选）

Windows 专属

  • 强烈推荐安装 WSL2：搜索“启用 Windows 子系统 Linux”
  • 在 WSL Ubuntu 中运行安装命令
  • 原生 PowerShell 可能部分技能受限

Linux 专属

  • 确保有 curl、build-essential 等基础包
  • Daemon 用 systemd 管理： systemctl status openclaw

常见安装问题解决：

  • Node.js 版本错误：脚本通常自动安装 24 版；手动检查 node --version
  • 权限不足：Windows 用管理员 PowerShell；Mac/Linux 注意 sudo
  • 网络问题：检查防火墙，端口 18789
  • 安装失败：运行 openclaw doctor 诊断

六、基础配置（模型、渠道、记忆、自动化）

1. 配置 AI 模型

通过向导已设置，或手动切换：

openclaw models set anthropic/claude-sonnet-4-6

本地 Ollama 配置：

  1. 安装 Ollama 并运行 ollama serve
  2. 下载模型： ollama pull qwen2.5-coder:32b
  3. 设置： openclaw models set ollama/qwen2.5-coder:32b

2. 连接聊天渠道

openclaw channels add

Telegram：用 @BotFather 创建 Bot，获取 Token 并配对。
WhatsApp：扫描二维码（推荐独立号码）。

3. 设置持久记忆（让 AI 记住你）

mkdir -p ~/.openclaw/workspace
touch ~/.openclaw/workspace/MEMORY.md

编辑 MEMORY.md 写入个人信息、偏好、规则。
启用语义搜索：在配置文件中设置 memory.backend 为 qmd 或 local。

4. 设置自动化任务（Cron）

openclaw cron add "0 8 * * *" "每天早上8点发送天气和新闻摘要"

查看任务： openclaw cron list

七、常用命令速查表

  • 状态检查： openclaw status
  • 重启： openclaw restart
  • 日志： openclaw logs --follow
  • 诊断： openclaw doctor
  • 更新： openclaw update
  • 配置向导： openclaw onboard 或 openclaw configure

八、安全与进阶建议

  • 使用 allowlist 限制只有自己能使用
  • 专用设备运行 + 防火墙
  • 定期备份 ~/.openclaw/workspace 文件夹
  • 安装社区技能：通过 ClawHub 或 clawhub install browser 等
  • 多 Agent 系统：设置 CEO/CTO 等层级

总结

通过官方一键安装脚本 + onboard 向导，Mac/Windows/Linux 用户都能在 10 分钟内完成 OpenClaw 的完整安装与配置。后续逐步添加渠道、记忆和自动化任务，你将拥有一个真正属于自己的 24/7 本地 AI 助手。

安装完成后，建议先测试简单聊天、一个 cron 任务，并设置 MEMORY.md。遇到任何问题，运行 openclaw doctor 或查看官方文档。

欢迎在评论区分享你的安装平台、选择的模型和第一个自动化任务！如果卡在某一步，贴出错误信息，我可以帮你进一步排查。

官方链接：
官网：https://openclaw.ai/
完整文档：https://docs.openclaw.ai/
快速开始：https://docs.openclaw.ai/start/getting-started
安装页面：https://docs.openclaw.ai/install
GitHub：https://github.com/openclaw/openclaw