推荐语
OpenClaw：你的私人AI助手，15分钟快速部署，数据100%本地安全，帮你自动处理邮件、日历等日常琐事！
核心内容：
1. OpenClaw的核心架构与功能优势
2. 安装前的硬件准备与推荐配置
3. 手把手安装教程与真实应用案例
杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家
OpenClaw（前身Clawdbot/Moltbot）是2026年最火爆的开源个人AI助手，由Peter Steinberger开发。它不是单纯的聊天机器人，而是真正能“动手做事”的AI代理（Agent）。
它运行在你自己的电脑、Mac Mini、VPS或Docker容器上，通过WhatsApp、Telegram、Discord、飞书等你日常使用的聊天App与你对话，然后自动帮你处理邮件、清空收件箱、管理日历、浏览网页、运行代码、控制浏览器、上传文件、家庭自动化……数据100%本地私有，不上传云端。
为什么推荐小白安装？
因为它有一键安装脚本、图形化向导、Web仪表盘，几乎零基础也能15分钟上手。GitHub星标已超24万，社区活跃，技能插件丰富。今天这篇指南从零开始，手把手教你安装、配置、使用，最后附上真实应用案例。全文超3000字，配图全部与文字一一对应，跟随操作绝对不会迷路！
第一章：OpenClaw到底是什么？为什么值得你花时间安装？
OpenClaw的核心架构非常清晰：Gateway（网关）+ Agent（智能体）+ Tools（工具）+ Channels（渠道）。
Gateway：单进程控制中心，监听你的聊天消息、路由到对应Agent、管理会话记忆。
Agent：使用大模型（如Claude Opus 4.5、GPT-5、Ollama本地模型、MiniMax等）进行思考和规划。
Tools：浏览器控制、文件读写、Shell执行、Gmail集成、日历API、Home Assistant等。
Channels：支持20+聊天平台，包括WhatsApp（Baileys）、Telegram、飞书、Discord等。
持久记忆+技能系统：它会记住你的偏好，还能安装/自写技能（Skills），实现自动化循环。
与ChatGPT、Claude不同的是：OpenClaw不是“只说不做”，而是真正的“数字分身”。它可以24/7待机，在后台帮你处理琐事。你在手机上发一条消息“帮我订明天的机票”，它就会打开浏览器、填写表单、支付确认后回复你已完成。
✨ 优势总结（小白最关心）：
• 完全开源免费（MIT协议），可本地部署。
• 数据永不离开你的设备。
• 支持本地模型（Ollama+Qwen2.5等），零API费用。
• 手机+电脑无缝联动。
• 社区技能库（ClawHub）一键安装，零代码自动化。
准备好笔记本或Mac Mini，我们开始安装！
第二章：安装前必做准备工作（10分钟搞定）
💻 硬件推荐（小白友好）：
• 日常使用：MacBook / Windows笔记本（8GB+ RAM）。
• 推荐24/7运行：Mac Mini M2/M4（低功耗）、旧电脑+Ubuntu、$5/月VPS（DigitalOcean/AWS Lightsail）、树莓派5（8GB版）。
• GPU加速本地模型：NVIDIA显卡（推荐RTX 3060+）或Apple Silicon。
🔧 软件准备：
Node.js 22+（必须！）
• macOS：直接用Homebrew brew install node@22 或官方安装包。
• Windows：强烈推荐WSL2（微软商店搜索“Ubuntu”安装），然后在WSL里安装Node。
• Linux：
curl -fsSL
https://deb.nodesource.com/setup_22.x |
sudo -E
bash - &&
sudo apt-get install -y nodejs
🔑 API密钥准备（推荐组合）：
• 首选：Anthropic（Claude）——注册https://console.anthropic.com，创建API Key（最强工具调用能力）。
• 备选：OpenAI GPT-4o / Groq（超快） / OpenRouter（一键多模型） / MiniMax / 通义千问（国内用户低延迟）。
• 本地免费：安装 Ollama（ollama.com），拉取：
ollama pull qwen2.5:32b
# 或 llama3.3:70b
📱 聊天App账号：
准备一个专用WhatsApp/Telegram号（建议新号，避免主号风险）。
🛡️ 安全意识：
OpenClaw有强大工具权限，建议用专用用户或Docker沙箱运行。
第三章：一键安装OpenClaw（最推荐方式，3分钟完成）
官方推荐一键安装脚本，自动检测Node、安装全局CLI、启动向导。
macOS / Linux / WSL（推荐）：
curl -fsSL
https://openclaw.ai/install.sh |
bash
执行后会自动：安装/升级Node.js、npm 全局安装 openclaw@latest、启动 onboarding 向导。
Windows PowerShell（原生，不推荐）：
iwr -useb https://openclaw.ai/install.ps1 | iex
跳过向导只安装（高级用户）：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
安装成功后，输入 openclaw --version 验证。
其他安装方式（备选）：
手动安装（适合已装Node的用户）：
npm install -g openclaw@latest openclaw onboard --install-daemon
从源码安装（开发者/贡献者）：
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm
install pnpm build pnpm link --global openclaw onboard
--install-daemon
Docker安装（最安全24/7方式，官方提供镜像）：
docker run -d --name openclaw \ -v ~/.openclaw:/root/.openclaw \ -p
18789:18789 \ openclaw/openclaw:latest
第四章：Onboarding向导完整 walkthrough
安装完立即运行：openclaw onboard
向导会一步步问你：
• 选择Agent身份：默认“Assistant”，可自定义名字（如“Clawd小爪”）。
• 选择主模型：下载 Anthropic API 密钥（Claude Sonnet 4.5 Opus）或选择Ollama本地模型。支持多模型回退（fallback）：Claude失败自动切GPT。
• 工作区（Workspace）：默认 ~/.openclaw/workspace，存放记忆、技能、配置文件。
• 安装Daemon服务：选择“Yes”，让它开机自启动（macOS用launchd，Linux用systemd）。
• 初始技能：推荐安装官方bundled skills（浏览器、Gmail、日历等）。
完成后运行以下命令检查：
openclaw doctor
# 检查配置健康
openclaw status
# 查看网关状态
openclaw dashboard
# 打开Web控制台（http://127.0.0.1:18789）
第五章：连接聊天App，让AI真正“听得到你说话”
Telegram（最简单，新手首选）：
1. Telegram搜索 @BotFather，创建新Bot，获取token。
2. 在向导或config.json中填入：
"channels": {
"telegram": {
"token":
"你的bot token",
"dmPolicy":
"pairing"
} }
3. 重启网关 openclaw gateway restart。
4. 私聊你的Bot，发送任意消息，会收到配对码，终端输入 openclaw pairing approve telegram 配对码 配对。
WhatsApp（最常用）：使用Baileys多设备登录，扫描二维码即可。向导会引导。
飞书/企业微信（国内用户）：通过extension插件，一键接入。
Discord/Slack：类似，填写 Bot token + Guild ID。
安全策略：默认DM使用“pairing”（陌生人需审批），群聊必须@提到才回复。强烈建议！
第六章：基本使用与CLI命令速查表
常用命令（记住这些就够日常用了）：
openclaw gateway --port 18789
# 前台启动网关
openclaw agent --message "帮我总结今天新闻"
# 直接让Agent执行
openclaw 消息发送 --to 你的TelegramID --message "测试" openclaw
技能安装浏览器
# 安装技能
openclaw cron add "每天早上8点说早安" --schedule "0 8 * * *"
Web仪表盘功能：聊天记录、会话管理、技能市场、Cron任务、日志、节点（iOS/Android手机联动）。
第七章：高级配置与安全最佳实践（必须看！）
安全第一（来自官方Security Guide）：
• 永远不要把Gateway暴露公网，用Tailscale或SSH隧道。
• DM策略设为pairing，群聊requireMention。
• 使用 Docker 沙箱或 tools.exec.host: "sandbox"。
• 定期运行 openclaw security audit --fix。
• 凭证权限700/600，定期轮换API Key。
优化性能：
• 本地模型用Ollama + GPU。
• 内存管理：OPENCLAW_STATE_DIR=/fast/ssd。
• 多Agent路由：不同聊天对象走不同workspace。
更新维护：
openclaw update openclaw doctor
第八章：故障排除（小白救命篇）
常见问题解决：
• openclaw command not find：export PATH="$(npm prefix -g)/bin:$PATH"加到 ~/.zshrc，重启电脑。
• sharp 构建错误：SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest。
• 模型连接失败：检查API Key是否正确，网络是否能访问Anthropic。
• 权限问题：用 sudo chown -R $USER ~/.openclaw。
• 服务没启动：openclaw gateway status 查看日志。
第九章：OpenClaw能做什么？真实应用案例（重头戏）
📨 案例1：邮件与日历全自动管家
你在Telegram说：“帮我处理今天邮件，重要会议加入日历。”
开爪会执行：连接Gmail读取未读邮件 → 用Claude总结优先级 → 自动回复模板邮件 → 把会议时间加入Google Calendar并设置提醒。
回复你：“已处理12封邮件，3个会议已加入日历。”
💻 案例2：开发者超级助手（程序员最爱）
“Review这个PR并反馈到Telegram” → 它 git pull、分析 diff、运行测试、生成评论、自动提交建议。
“帮我把Notion页面转成Astro网站” → 全程浏览器+文件操作，边看电视边完成。
🏡 案例3：家庭生活自动化
“每周日帮我规划下周三餐并下单Tesco” → 浏览超市网站、生成购物清单、预约配送。
“空气净化器开到安静模式” → 集成Winix/Home Assistant，自然语言控制家电。
📈 案例4：生意自动化（个体户福音）
“每天早上生成销售报告发给客户” → 拉取数据库、生成PDF、邮件群发。
“帮我搜索适合我简历的工作并申请” → JSearch API + 浏览器自动填写表单。
🏃 案例5：学习与健康助手
“Oura Ring今天数据如何？安排健身” → 读取健康数据，自动加日历。
“教我中文发音并纠正” → 语音输入+ElevenLabs TTS反馈。
🌟 案例6：高级玩法 - 多Agent梦之队
一个主Clawd Orchestrator，下挂14个专职Agent（研究、代码、设计、财务），自动委托任务。
以上案例全部来自官方Showcase和社区真实用户分享，复制粘贴Prompt即可复用。OpenClaw真正实现了“AI替你活”——你只管下指令，它替你执行。
第十章：进阶资源
现在你已经拥有了一个属于自己的超级AI助手。OpenClaw的魅力在于“可黑客”——你可以无限扩展技能、自定义Prompt、甚至贡献代码。进阶资源：
• 官方文档：https://docs.openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
• Discord社区：https://discord.gg/clawd
粤ICP备14082021号
免费POC，
零成本试错
