从零开始掌握 OpenClaw：你的第一个本地 AI Agent 助理

什么是 OpenClaw？

OpenClaw（曾用名 ClawdBot/Moltbot）是 2026 年最炙手可热的开源 AI Agent 项目，在 GitHub 上已斩获超过 68,000 颗星标。请注意，它不是普通的“聊天机器人”，而是一个真正长了手脚、能够替你执行任务的个人 AI 助理。

注：以上数据口径截至 2026 年 2 月 24 日，后续可能变化。

• 🔒 本地执行：数据存储在你的设备上，无需上传云端，隐私和数据安全完全由你掌控。
• 🚀 真实执行：不仅能陪你聊天，更能实际操作你的电脑，自动化处理邮件、日历、文件管理等繁杂任务。
• 💬 多平台消息：支持 WhatsApp, Telegram, Discord, Slack 等 10+ 平台，从单一入口统一管理所有通讯。
• 🧠 持久记忆：跨会话保存上下文和你的个人偏好。随着时间的推移，它会越来越懂你。
• 🆓 开源免费：完全开源，只需自备 API Key 即可零成本运行，完全自主控制。

本质区别：聊天机器人 vs AI Agent

新手阶段：基础入门

第一步：环境准备（打地基）

确保你的电脑满足以下基础要求：

• 操作系统： macOS、Linux 或 Windows
• Node.js 运行环境： v18 或更高版本（这是让 OpenClaw 能在电脑上跑起来的“底座引擎”）
• API Key（大模型的钥匙）： 这是赋予 AI 大脑和灵魂的门票。
  
  如果你还没有 API Key，可以通过以下途径获取：
  
  海外主流模型（需科学上网及海外支付）：
  • Anthropic Claude: console.anthropic.com (目前写代码、做任务最聪明的模型)
  • OpenAI GPT: platform.openai.com (最经典的 ChatGPT 背后的模型)
  • Google Gemini: aistudio.google.com (谷歌家的强力模型，部分地区可免费薅羊毛)
  
  国内主流模型（无需翻墙，支付宝/微信可买，非常适合新手）：
  • DeepSeek (深度求索): platform.deepseek.com (国产之光，极其便宜且代码能力出众)
  • 智谱 GLM (清华系): bigmodel.cn (国内老牌实力大厂，注册即送海量 Token 实名好用)
  • 阿里通义千问 (Qwen): bailian.aliyun.com (国内大厂出品，赠送额度多，响应速度快)
  • 零一万物 (Yi): platform.lingyiwanwu.com (性能均衡的国产开源模型)

# 打开你的“终端”或“命令行”窗口，复制下面这行代码并敲击回车
node --version

第二步：安装 OpenClaw

根据你的电脑使用水平，选择最适合的安装方式：

方法一：NPM 一键安装（🌟 强烈推荐给纯小白）

当你完成了第一步（成功安装了 Node.js 引擎），你就可以召唤 NPM 这个神奇的内置工具帮你自动下载了。

# 在终端中复制这行代码并回车（这会自动下载并安装 OpenClaw）
npm install -g openclaw

# 下载过程可能需要一杯茶的时间。完成后，输入下面这行命令验证：
openclaw --version

方法二：Docker 安装（推荐有 Docker 经验者）

# 拉取镜像并运行容器
docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

方法三：源码安装（推荐开发者）

# 克隆项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖并启动
npm install
npm run start

第三步：初始化配置

安装完成后，在终端中输入下面这行神奇的咒语，唤醒它的基础设置向导：

openclaw onboard

向导会像跟你聊天一样，一步步用英文问你问题，请根据提示操作：

• 选择 AI 模型（Anthropic / OpenAI 等）
• 输入你刚刚获取到的 API Key

  ⚠️ 小白避坑指南：把你准备好的那串长长的 API Key 复制，然后在终端里右键粘贴并回车。注意！为了密码防偷窥，你在终端里粘贴密码时，屏幕上是完全没有任何显示和变化的（光标也不会动），这是正常的！虽然看不见，但实际上已经粘贴进去了，你只管霸气地按回车键！

• 选择你想用什么软件跟它聊天（比如网页版、Telegram 等）
• 配置文件系统权限（建议小白先选“Sandbox 沙盒模式”，这样它只能在特定的安全文件夹活动，不用担心它弄乱你电脑里的其他资料）

第四步：第一次对话

现在，唤醒你的 AI 助理！

# 启动 OpenClaw 的命令行模式
openclaw

# 或者启动更直观的 Web 界面
openclaw dashboard

Telegram 示例（将它接入你的电报聊天）：

1. 打开 Telegram 软件，在顶部搜索栏精确搜索 @BotFather（认准带蓝V认证的“机器人老爹”）。
2. 在和它的对话框里发送指令 /newbot，按照提示给你的机器人起个名字和用户名（用户名必须以 bot 结尾）。
3. 成功后，它会发送给你一段文字，里面有一串红色的长字符（这就是你的专属 Token），例如 123456789:ABCdefGHI...，把它完整复制下来。
4. 在你的电脑终端中执行以下命令（注意：把下面引号里的中文替换成你刚才复制的那串红字）：
   
   openclaw config set channels.telegram.botToken "你的_BOT_TOKEN_粘贴在这里"
openclaw config set channels.telegram.enabled true
5. 在 Telegram 搜索栏输入你自己刚才创建的机器人名字，点击下方的 Start（开始），就可以和你的本地专属 AI 助理聊天啦！

第五步：理解核心概念

• Gateway（网关）： OpenClaw 与外部交互的桥梁，如 TG/Discord（消息网关）、HTTP（API网关）、CLI（命令行）。
• Skills（技能）： 类似于浏览器插件。从 Clawhub 安装 Skills，就能让 OpenClaw 学会发邮件、查日历等新本领。
• Memory（记忆）： 它会自动保存你的偏好、历史对话和重要待办。
• Sandbox（沙盒）： 保护你电脑的安全机制，限制它乱动不该动的文件。

ls ~/.openclaw            # 查看工作目录
openclaw config list      # 查看当前配置
openclaw skills list      # 查看已安装技能
openclaw security audit   # 运行安全审计

中级阶段：实用技能

基础跑通后，我们要让 OpenClaw 真正介入到日常工作流中，帮你提升效率。

第六步：安装和使用 Skills（技能）

默认的 OpenClaw 就像刚买的新手机，你需要给它装“App”。

# 搜索相关技能
openclaw skills search email

# 安装日常必备技能包
openclaw skills install @openclaw/email-manager  # 邮件管理
openclaw skills install @openclaw/calendar       # 日历管理
openclaw skills install @openclaw/file-organizer # 文件整理
openclaw skills install @openclaw/tavily-search  # 网页联网搜索

第七步：接入 Google Workspace

让 OpenClaw 帮你发邮件、建日程，需要对其进行授权。

# 配置凭证并授权
openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"
openclaw integrations google authorize

注意：你需要提前在 Google Cloud Console 中创建项目并下载 JSON 密钥。

第八步：设置定时任务（Cron Jobs）

你可以用自然语言让 OpenClaw 定时执行任务。

你：“我想让你每天早上 8 点给我发一份简报，包含今天的天气、日历安排、未读邮件数量和一句励志名言。”

OpenClaw 会自动在后台将这句话转化为 Cron Job。你可以随时管理它们：

openclaw cron list     # 列出任务
openclaw cron show <task-id>      # 查看任务详情
openclaw cron disable <task-id>   # 暂停任务
openclaw cron delete <task-id>    # 删除任务

第九步：配置持久记忆

让它变成“你的”专属助理，最快的方法是直接告诉它你是谁：

“记住：我叫林克，是个程序员。工作时间是周一到周五早9晚6。我喜欢简洁直接的回复，不要废话，用中文交流，时区是 GMT+8。”

高级阶段：硬核应用

如果你是一名极客或开发者，这里的玩法将彻底打开你的想象力。

第十步：编写自定义 Skill

找不到现成的技能？自己写一个。Skills 使用简单的 YAML 定义。

新建文件 ~/.openclaw/skills/daily-news.yaml：

name: "每日新闻摘要"
description: "获取并总结今日科技新闻"
version: "1.0.0"
triggers: ["今日新闻", "科技新闻"]

steps:
  - action: web_search
    query: "latest tech news today"
    max_results: 5
  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"
  - action: respond
    message: "📰 今日科技新闻摘要：\n\n{{summary}}"

openclaw skills reload # 重载配置生效

第十一步：多 Agent（代理）分身管理

你可以运行多个相互隔离的 OpenClaw 分身：

# 创建工作分身（配置强大的 Claude 模型）
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4.6"

# 创建个人娱乐分身（配置高性价比模型）
openclaw create-agent personal
openclaw config --agent personal set ai.model "gpt-4o-mini"

# 切换分身
openclaw switch-agent work

第十二步：极高安全性的 Docker 沙盒

如果你要让 Agent 运行未知的脚本或处理复杂系统任务，务必开启 Docker 级沙盒以隔离风险：

openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
openclaw sandbox test

第十三步：浏览器自动化控制

OpenClaw 可以像真人一样操作浏览器（点击、输入、翻页）。

# 安装浏览器控制插件
openclaw skills install @openclaw/browser-control
openclaw config set browser.enabled true

实战指令：“帮我打开亚马逊，搜索机械键盘，把评分最高的前3个商品价格记录下来发给我。”

第十四步：成本优化与监控

当你使用按量计费的 API 时，一定要限制月度预算。

# 设置每月硬性预算上限（例如 50 美元）
openclaw config set ai.monthlyBudget 50
openclaw stats cost # 随时查看账单

第十五步：故障排查与备份恢复

为了长期稳定使用，建议你建立“先排查、再恢复”的日常流程：

# 健康检查与日志排查
openclaw doctor
openclaw logs
openclaw config set logging.level "debug"

# 备份工作目录
cp -r ~/.openclaw ~/.openclaw-backup

# 可选：使用 Git 版本化配置
cd ~/.openclaw
git init
git add .
git commit -m "backup: openclaw config snapshot"

🏁 终极实践任务清单总结

对照以下清单，看看你完成了多少成就：

🧩 实战项目（挑战）

完成以下任意项目，能快速把 OpenClaw 变成可持续使用的生产力系统：

❓ 常见问题解答 (FAQ)

📚 学习与探索资源

OpenClaw 代表了 AI 的下一步演进方向：从“会说话的玩具”变成“会做事的员工”。如果你想深入研究，请收藏以下链接：

• 官方主阵地： 官网 | GitHub 仓库 | 中文文档
• 技能黑市： Awesome OpenClaw Skills (插件市场)
• 国内社区资源： OpenClaw 中文教程 (lua.ren) | 阿里云/Apifox 部署专栏
• 交流群组： Reddit (r/clawdbot) | 官方 Discord 服务器

写在最后： 只要你愿意花一个周末的时间来调教 OpenClaw，它绝对能成为你离不开的“数字分身”。祝你在自动化和 AI Agent 的世界里探索愉快！🦞✨

✅ 下一步

完成本教程后，建议从一个高价值场景开始深挖，例如“自动化早报”或“邮件整理”，再逐步扩展到多 Agent 和第三方集成。

• 深入一个方向：浏览器自动化、邮件管理、或项目管理集成
• 参与社区：在 GitHub/Discord 提问、提交 issue 或分享技能
• 做一次周度复盘：查看成本、成功率、失败日志并持续优化