< 返回
OpenClaw快速入门教程
2026-02-28 09:36
作者：技术部
阅读量：1
OpenClaw（前Clawdbot → Moltbot）已成为2026年最火的开源AI代理框架之一。它让你用自然语言在Telegram、WhatsApp等聊天工具里指挥AI真正“做事”——写邮件、整理文件、操作浏览器、提交代码等，全程本地运行，隐私可控。
本文是针对新手的最实用快速入门，目标：30分钟内让你的第一个AI代理跑起来。适合Mac、Linux、Windows用户（WSL推荐）。
一、前置条件（5分钟检查）
在开始前，确保满足以下要求：
- 操作系统：macOS 12+ / Linux（Ubuntu 22.04+推荐） / Windows 10+（建议用WSL2）
- Node.js：v22 或更高（强烈推荐v22 LTS）
- 检查命令：node --version
- 没有或版本低？去 https://nodejs.org 下载最新LTS版安装
- 终端权限：macOS/Linux需能sudo，Windows建议以管理员身份运行PowerShell
- API Key（最重要！）：至少准备一个大模型API
- 推荐优先级（2026年性价比排序）：
- Anthropic Claude（Opus/Sonnet 4）——最强推理，推荐首选
- OpenAI GPT-4o / o1系列
- Google Gemini 1.5/2.0（免费额度较大）
- 本地模型（Ollama + DeepSeek / Llama 3.1 70B / Qwen2.5等）
- 网络：安装时需要联网，运行后可部分离线（本地模型）
二、安装OpenClaw（最快方式，3-8分钟）
官方提供了一键安装脚本，强烈推荐新手使用。
macOS / Linux / WSL
Bash
curl -fsSL https://openclaw.ai/install.sh | bash
- 脚本会自动检测Node.js、安装openclaw CLI全局包
- 安装完成后会提示运行向导
Windows（原生PowerShell，管理员模式）
PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
安装后，打开新终端，输入：
看到版本号（如2026.3.x）即成功。
手动安装备用方式（如果你不喜欢curl/iwr）：
Bash
npm install -g openclaw@latest
# 或用pnpm / bun
pnpm add -g openclaw@latest
bun add -g openclaw@latest
三、运行Onboarding向导（核心配置，10-15分钟）
安装完立刻运行：
Bash
openclaw onboard --install-daemon
这个向导是OpenClaw最友好的部分，会一步步问你：
-
同意条款 & 选择工作目录 默认：~/openclaw 或 ~/claw_workspace（建议用默认）
-
选择AI模型提供商
- Claude → 输入Anthropic API Key（从 https://console.anthropic.com 获取）
- OpenAI → 输入OpenAI Key
- Gemini → 输入Google AI Studio Key
- Ollama → 输入本地Ollama地址（默认http://127.0.0.1:11434）
建议先选Claude Opus/Sonnet，推理最强。
-
设置Gateway（消息中枢）
- 选择是否作为后台服务（daemon）运行 → 强烈推荐选“是”
- macOS用launchd，Linux用systemd，Windows用nssm或任务计划程序
-
连接第一个聊天渠道（最推荐Telegram）
- 选Telegram → 向导会让你去BotFather创建机器人，拿到Token粘贴
- 其他选项：WhatsApp（需要手机扫码）、Discord、Slack、Signal等
- 选完后会给你一个配对码或链接，在手机App里发送/pair 你的码完成绑定
-
基础安全设置
- 是否启用只读模式（Read-Only）？新手建议先开（AI只能读文件，不能写/删/执行shell）
- 设置PIN码或密码保护敏感操作
向导完成后，系统会自动：
- 启动Gateway（常驻后台）
- 创建默认Memory.md（长期记忆文件）
- 加载基础工具（浏览器、文件、shell等）
四、第一次对话 & 测试（5分钟验证）
用你绑定的Telegram（或WhatsApp等）给自己的Bot发消息：
简单测试1（读能力）：
简单测试2（写能力，需关闭只读模式）：
text
在我的桌面新建一个文件夹叫OpenClawTest，然后里面创建一个txt文件，内容写“我的第一个AI代理已经上线！”
高级测试（真正干活）：
text
帮我用中文总结一下今天 Hacker News 前10条热门新闻，并把链接整理成列表发给我
如果AI成功打开浏览器、抓取内容、总结并发回 → 恭喜！你已经跑通了完整链路！
五、常用命令速查（日常维护）
| 命令 |
作用 |
| openclaw status |
查看Gateway和Agent运行状态 |
| openclaw restart |
重启服务 |
| openclaw update |
更新到最新版 |
| openclaw onboard |
重新运行向导（改配置时用） |
| openclaw logs |
查看日志 |
| openclaw skills install xxx |
安装社区技能（未来会很丰富） |
| openclaw daemon stop/start |
手动停/启后台服务 |
六、新手常见问题 & 安全Tips（必读！）
- API费用爆炸 → 先用Gemini免费额度，或本地Ollama跑小模型测试
- Telegram收不到消息 → 检查Bot是否被mute、是否加了openclaw为联系人
- 浏览器打不开 → 需安装Chrome/Chromium，并给OpenClaw权限
- 安全第一 →
- 永远不要给主账号权限，先用小号/测试邮箱/测试手机
- 开启只读模式 + PIN验证高危操作
- 不要把敏感文件放默认工作目录
- 定期备份~/openclaw整个文件夹（含Memory.md）
- 想进阶 → 看官方文档：https://docs.openclaw.ai 重点章节：Wizard、Tools、Skills、MCP多Agent、Memory管理
七、结语：你现在拥有了一个“数字员工”
恭喜！完成以上步骤，你已经拥有了一个24/7待命、可本地运行、能真正执行任务的AI代理。接下来可以：
- 加更多聊天渠道（微信/飞书/企业微信）
- 解锁高级技能（写代码、自动周报、航班值机）
- 部署到Mac Mini / 小主机 / VPS上实现永不关机
有任何卡点，欢迎去官方Discord（https://discord.gg/clawd）或GitHub Discussions提问，社区非常活跃。
网站资讯
关于我们
