网宝
登录 快速注册
新闻中心 / / 正文

OpenClaw快速入门教程

2026-02-28 09:36
技术部
← 返回

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年性价比排序）：
      1. Anthropic Claude（Opus/Sonnet 4）——最强推理，推荐首选
      2. OpenAI GPT-4o / o1系列
      3. Google Gemini 1.5/2.0（免费额度较大）
      4. 本地模型（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
 
 

安装后，打开新终端，输入：

Bash
 
openclaw --version
 
 

看到版本号（如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最友好的部分，会一步步问你：

  1. 同意条款 & 选择工作目录 默认：~/openclaw 或 ~/claw_workspace（建议用默认）

  2. 选择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，推理最强。

  3. 设置Gateway（消息中枢）

    • 选择是否作为后台服务（daemon）运行 → 强烈推荐选“是”
    • macOS用launchd，Linux用systemd，Windows用nssm或任务计划程序

  4. 连接第一个聊天渠道（最推荐Telegram）

    • 选Telegram → 向导会让你去BotFather创建机器人，拿到Token粘贴
    • 其他选项：WhatsApp（需要手机扫码）、Discord、Slack、Signal等
    • 选完后会给你一个配对码或链接，在手机App里发送/pair 你的码完成绑定

  5. 基础安全设置

    • 是否启用只读模式（Read-Only）？新手建议先开（AI只能读文件，不能写/删/执行shell）
    • 设置PIN码或密码保护敏感操作

向导完成后，系统会自动：

  • 启动Gateway（常驻后台）
  • 创建默认Memory.md（长期记忆文件）
  • 加载基础工具（浏览器、文件、shell等）

四、第一次对话 & 测试（5分钟验证）

用你绑定的Telegram（或WhatsApp等）给自己的Bot发消息：

简单测试1（读能力）：

text
 
你好，我是新用户，介绍一下你自己能做什么？
 
 

简单测试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（必读！）

  1. API费用爆炸 → 先用Gemini免费额度，或本地Ollama跑小模型测试
  2. Telegram收不到消息 → 检查Bot是否被mute、是否加了openclaw为联系人
  3. 浏览器打不开 → 需安装Chrome/Chromium，并给OpenClaw权限
  4. 安全第一 →
    • 永远不要给主账号权限，先用小号/测试邮箱/测试手机
    • 开启只读模式 + PIN验证高危操作
    • 不要把敏感文件放默认工作目录
    • 定期备份~/openclaw整个文件夹（含Memory.md）
  5. 想进阶 → 看官方文档：https://docs.openclaw.ai 重点章节：Wizard、Tools、Skills、MCP多Agent、Memory管理

七、结语：你现在拥有了一个“数字员工”

恭喜！完成以上步骤，你已经拥有了一个24/7待命、可本地运行、能真正执行任务的AI代理。接下来可以：

  • 加更多聊天渠道（微信/飞书/企业微信）
  • 解锁高级技能（写代码、自动周报、航班值机）
  • 部署到Mac Mini / 小主机 / VPS上实现永不关机

有任何卡点，欢迎去官方Discord（https://discord.gg/clawd）或GitHub Discussions提问，社区非常活跃。

QQ客服 提交工单