OpenClaw安装完全指南（适用小白）

OpenClaw（前身Clawdbot/Moltbot）是2026年最火爆的开源个人AI助手，由Peter Steinberger开发。它不是单纯的聊天机器人，而是真正能“动手做事”的AI代理（Agent）。它运行在你自己的电脑、Mac Mini、VPS或Docker容器上，通过WhatsApp、Telegram、Discord、Slack、飞书等你日常使用的聊天App与你对话，然后自动帮你处理邮件、清空收件箱、管理日历、浏览网页、运行代码、控制浏览器、上传文件、家庭自动化……数据100%本地私有，不上传云端。为什么推荐小白安装？因为它有一键安装脚本、图形化向导、Web仪表盘，几乎零基础也能15分钟上手。GitHub星标已超15万，社区活跃，技能插件丰富。今天这篇指南从零开始，手把手教你安装、配置、使用，最后附上真实应用案例。全文超4500字，配图全部与文字一一对应，跟随操作绝对不会迷路！

第一章：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。

软件准备：

1. Node.js 22+（必须！）macOS：直接用Homebrew brew install node@22 或官方安装包。Windows：强烈推荐WSL2（微软商店搜索“Ubuntu”安装），然后在WSL里安装Node。Linux：curl -fsSL deb.nodesource.com/setup\\_22.… | sudo -E bash - && sudo apt-get install -y nodejs。
2. API密钥准备（推荐组合）：首选：Anthropic（Claude）——注册console.anthropic.com，创建API Key（最强工具调用能力）。备选：OpenAI GPT-4o / Groq（超快） / OpenRouter（一键多模型） / MiniMax / 通义千问（国内用户低延迟）。
   本地免费：安装 Ollama（ollama.com），拉取 ollama pull qwen2.5:32b 或 llama3.3:70b。
3. 聊天App账号：准备一个专用WhatsApp/Telegram号（建议新号，避免主号风险）。
4. 安全意识：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镜像（
docs.openclaw.ai/install/docker），一行命令启动沙箱容器：

docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest

第四章：Onboarding向导完整 walkthrough（小白最重要一步）

安装完立即运行：

openclaw onboard

向导会一步步问你：

1. 选择Agent身份：默认“Assistant”，可自定义名字（如“Clawd小爪”）。
2. 选择主模型：下载 Anthropic API 密钥（Claude Sonnet 4.5 Opus）或选择Ollama本地模型。支持多模型回退（fallback）：Claude失败自动切GPT。
3. 工作区（Workspace）：默认 ~/.openclaw/workspace，存放记忆、技能、配置文件。
4. 安装Daemon服务：选择“Yes”，让它开机自启动（macOS用launchd，Linux用systemd）。
5. 初始技能：推荐安装官方bundled skills（浏览器、Gmail、日历等）。

完成后运行：

openclaw doctor          # 检查配置健康
openclaw status          # 查看网关状态
openclaw dashboard       # 打开Web控制台（http://127.0.0.1:18789）

第五章：连接聊天App，让AI真正“听得到你说话”

Telegram（最简单，新手首选）：

1. Telegram搜索
2. @BotFather
3. ，创建新Bot，获取token。
4. 在向导或config.json中填入：
5. json
6. "channels": { "telegram": { "token": "你的bot token", "dmPolicy": "pairing" } }
7. 重启网关 openclaw gateway restart。
8. 私聊你的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

第八章：故障排除（小白救命篇）常见问题解决：

1. openclaw command not find ： export PATH="$(npm prefix -g)/bin:$PATH"加到 ~/.zshrc，重启电脑。
2. sharp 构建错误 ：SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest。
3. 模型连接失败：检查API Key是否正确，网络是否能访问Anthropic。
4. 权限问题 ：用 sudo chown -R $USER ~/.openclaw。
5. 服务没启动：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、甚至贡献代码。进阶资源：

• 官方文档：docs.openclaw.ai
• GitHub：github.com/openclaw/op… 一下支持作者！）
• Discord社区：discord.gg/clawd （中文用户很多）
• 国内讨论：搜索“OpenClaw 小红书”或B站教程
• 安全邮箱：security@openclaw.ai

记住核心原则：本地优先、沙箱优先、审批优先。享受AI带来的生产力飞跃吧！（全文约5200字，包含所有命令、解释、截图对应、案例细节。如需特定平台视频演示或自定义技能模板，随时评论告诉我，我继续补充！）

Claw on！你的数字龙虾助手已就位！