OpenClaw

开源终端 AI 个人助手 —— 不只是写代码，更能聊天、操控浏览器、发消息、跑定时任务

阅读前自检：这篇教程适合你吗？

如果你符合以下任意一条，这篇教程就是为你准备的：

  • 你想在终端里用一个 AI 助手处理日常开发和生活任务
  • 你听说过 OpenClaw 但不知道它能干什么、怎么上手
  • 你想了解 OpenClaw 和 Claude Code / Copilot 的差异
  • 你需要一份完整的中文安装、配置、实战参考手册

价格： ¥9.9 买断制，一次购买永久查阅。

目录

第一章 认识 OpenClaw
开源 · 多模型 · 浏览器操控 · 消息频道 · 定时任务
第二章 快速上手（5分钟）
安装 → 初始化 → 启动 → 三条验证指令
第三章 安装指南（全平台）
macOS · Linux · Windows · Docker 完整安装
第四章 配置详解
模型选择 · 消息频道 · API Key · 记忆系统 · 国内网络
第五章 日常使用
聊天交互 · 文件操作 · 浏览器控制 · Cron 定时任务
第六章 实战场景（核心价值）
邮件处理 · 代码开发 · 信息收集 · 智能家居 · 自动化
第七章 高级功能
ClawHub 技能市场 · 多智能体 · 语音模式 · 浏览器自动化
第八章 进阶技巧
多模型策略 · 自定义技能 · 成本控制 · 安全 · 系统服务
第九章 常见问题与排错
安装 · 频道连接 · 网络 · 性能
附录：命令速查与环境变量
全部 CLI 命令 + 环境变量一览

第一章 认识 OpenClaw

1.1 什么是 OpenClaw

OpenClaw 是一个开源的终端 AI 个人助手。它运行在你的电脑上，通过自然语言帮你完成各种任务——不只是写代码，还能控制浏览器、在 Telegram/Discord/WhatsApp 上收发消息、执行定时任务、处理文件、分析数据。它支持接入多个大语言模型，完全开源，数据留在本地。

核心特性：

  • 多模型支持： 可接入 Claude、GPT、DeepSeek、Gemini 等任意模型，自由切换
  • 终端原生： 不离开终端完成所有操作，支持管道和脚本集成
  • 浏览器自动化： 基于 Playwright，能自动操作网页、截图、抓取数据
  • 消息频道： 通过 Telegram / Discord / WhatsApp 远程控制你的 AI 助手
  • 技能系统： ClawHub 社区技能市场，一键安装扩展能力
  • 记忆系统： 持久化聊天记忆，助手越用越懂你
  • 开源免费： MIT 协议，代码完全透明，数据本地处理

1.2 谁需要它

OpenClaw 适合更广泛的人群，不只是开发者：

  • 全栈开发者——写代码、调试、重构、生成测试
  • 产品经理 / 运营——自动收集信息、生成报告、定时监控
  • 极客玩家——搭建个人 AI 助手、智能家居中枢
  • 自由职业者——邮件处理、文档生成、日程管理自动化
  • 想体验 Agent 的初学者——开源免费，门槛低，社区活跃

1.3 对比同类工具

特性OpenClawClaude CodeGitHub Copilot
开源性MIT 开源闭源闭源
运行环境终端原生终端原生IDE 插件
模型选择多模型（任意）仅 Claude仅 GPT
浏览器操控Playwright 深度集成无无
消息频道Telegram/Discord/WhatsApp无无
定时任务内置 Cron 调度无无
技能市场ClawHub 社区生态无无
数据隐私完全本地API 发送至 AnthropicAPI 发送至 OpenAI
定价免费（自付 API 费用）API 按量计费$10-39/月

1.4 系统要求

  • 操作系统： macOS、Linux、Windows（WSL2 推荐）
  • Node.js： 18+（推荐 20+）
  • 可选： Playwright 浏览器（用于浏览器自动化功能）
  • 网络： 需要访问所选 AI 模型的 API 端点
  • 存储： 约 500MB（含 Playwright 浏览器）

第二章 快速上手（5分钟）

2.1 安装 OpenClaw

npm install -g openclaw

提示： 全局安装后，openclaw 命令即可在任意终端使用。

2.2 初始化项目

openclaw init my-assistant
cd my-assistant

初始化会创建配置文件 openclaw.config.json，其中包含模型设置、频道配置、记忆系统等所有选项。

2.3 配置环境变量

创建 .env 文件并填入你的模型 API Key：

OPENAI_API_KEY=sk-你的openai-key
ANTHROPIC_API_KEY=sk-ant-api03-你的anthropic-key

2.4 启动助手

openclaw start

2.5 三条验证指令

启动后试试这三条命令，确认一切正常：

openclaw chat "你好，请介绍一下你自己"
openclaw chat "列出当前目录下的所有文件"
openclaw chat "帮我创建一个 hello.py，打印 Hello OpenClaw"

第三章 安装指南（全平台）

3.1 环境准备

首先确认 Node.js 版本：

node --version

必须 Node.js 18+。如版本不足，按下方各平台指引升级。

3.2 macOS 安装

brew install node
npm install -g openclaw
openclaw --version

3.3 Linux 安装

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g openclaw

如果使用 Playwright 浏览器功能，需要额外安装依赖：

npx playwright install-deps chromium

3.4 Windows 安装

推荐使用 WSL2：

wsl --install -d Ubuntu

然后在 WSL 中按 Linux 流程安装。

如果必须使用原生 Windows PowerShell：

winget install OpenJS.NodeJS.LTS
npm install -g openclaw

3.5 Docker 安装

OpenClaw 也支持 Docker 部署，适合服务器环境：

docker pull openclaw/openclaw:latest
docker run -it --rm -v $(pwd):/workspace -e OPENAI_API_KEY=$OPENAI_API_KEY openclaw/openclaw

3.6 验证安装

openclaw --version
openclaw --help
openclaw chat "你好"

第四章 配置详解

4.1 模型选择与配置

OpenClaw 支持多种模型，在 openclaw.config.json 中配置：

{
  "model": {
    "provider": "anthropic",
    "name": "claude-sonnet-4-20250514"
  }
}

支持的模型提供商和常用模型：

提供商常用模型适用场景
Anthropicclaude-sonnet-4, claude-haiku代码、长文、推理
OpenAIgpt-4o, gpt-4o-mini多模态、通用对话
DeepSeekdeepseek-chat, deepseek-reasoner高性价比、中文优化
Googlegemini-2.5-pro, gemini-2.5-flash超长上下文
Ollama（本地）llama3, qwen2.5, mistral离线、零成本、隐私优先

切换模型的命令行方式：

openclaw chat --model deepseek-chat "你好"

4.2 消息频道配置

OpenClaw 最强大的功能之一：通过消息 App 远程控制你的 AI 助手。

4.2.1 Telegram 频道

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的BotFather获得的Token",
      "allowedUsers": ["你的Telegram用户ID"]
    }
  }
}

获取 Bot Token：在 Telegram 搜索 @BotFather，发送 /newbot 按提示创建。

4.2.2 Discord 频道

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "你的Discord Bot Token",
      "channels": ["频道ID"]
    }
  }
}

4.2.3 WhatsApp 频道

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "webhook": "你的WhatsApp Webhook地址"
    }
  }
}

4.3 API Key 管理

推荐使用 .env 文件管理所有 Key，不要直接写在配置文件中：

OPENAI_API_KEY=sk-xxx
ANTHROPIC_API_KEY=sk-ant-api03-xxx
DEEPSEEK_API_KEY=sk-xxx
GOOGLE_API_KEY=AIza-xxx

环境变量自动加载，OpenClaw 会读取 .env 文件。

echo $OPENAI_API_KEY

4.4 记忆系统配置

OpenClaw 内置持久化记忆，让助手记住你的偏好和历史上下文：

{
  "memory": {
    "enabled": true,
    "storage": "sqlite",
    "path": "./openclaw-memory.db",
    "maxTokens": 10000
  }
}

可以随时查看和清空记忆：

openclaw memory list
openclaw memory clear

4.5 国内网络配置

如果访问海外 API 不稳定，可以配置代理：

export HTTPS_PROXY="http://127.0.0.1:7890"

或者在 openclaw.config.json 中直接配置：

{
  "proxy": "http://127.0.0.1:7890"
}

使用国产模型（如 DeepSeek）则无需代理，延迟更低。

第五章 日常使用

5.1 聊天交互模式

进入交互式对话：

openclaw chat

单次问答：

openclaw chat "帮我解释这段代码的作用" < src/app.ts

使用管道输入：

cat error.log | openclaw chat "分析这些错误日志"

5.2 文件操作

OpenClaw 可以直接读写文件：

openclaw chat "读取 package.json，检查所有依赖是否有已知漏洞"
openclaw chat "在 src/utils 目录下创建一个 logger.ts 工具模块"
openclaw chat "把 images/ 目录下所有 PNG 图片转为 WebP 格式"

5.3 浏览器控制

这是 OpenClaw 的杀手级功能——让 AI 像人一样操作浏览器：

openclaw browser "打开 https://github.com/trending，列出今天前5个热门项目"
openclaw browser "登录 https://mail.google.com，检查未读邮件"
openclaw browser "打开百度，搜索「OpenClaw AI终端助手」，截图第一页结果"

5.4 Cron 定时任务

OpenClaw 内置 Cron 调度器，让 AI 定时执行任务：

{
  "cron": [
    {
      "schedule": "0 9 * * *",
      "task": "浏览今日 HackerNews 头条并总结5条要点，发送到 Telegram"
    },
    {
      "schedule": "0 */6 * * *",
      "task": "检查 GitHub 上我关注的仓库是否有新 Release"
    }
  ]
}

管理定时任务：

openclaw cron list
openclaw cron run "任务名称"

5.5 会话管理

openclaw session list
openclaw session resume 上次会话ID
openclaw session delete 会话ID

第六章 实战场景（核心价值）

场景 1：邮件处理

openclaw browser "打开 Gmail，检查最近10封未读邮件，帮我草拟回复"
openclaw chat "总结我今天的邮件要点，标记出需要立即回复的"

场景 2：代码开发

openclaw chat "基于 Express + TypeScript 创建一个 REST API 项目骨架"
git diff HEAD~10 | openclaw chat "Review 最近10次提交，找出潜在的代码问题"

场景 3：信息收集

openclaw browser "浏览 ProductHunt 今天的首页，总结前5名产品及其核心功能"
openclaw browser "打开知乎热榜，抓取前20条话题，按分类整理"

场景 4：智能家居控制

通过 MQTT 或 Home Assistant API，OpenClaw 可以成为你的智能家居中枢：

openclaw chat "把客厅灯光调到暖色，温度设为 24 度"

配合 Cron 实现自动化：

openclaw chat "每天早上7点打开窗帘，晚上11点关闭所有灯"

场景 5：数据分析

openclaw chat "读取 data.csv，分析销售趋势，生成一份 Markdown 报告"
openclaw chat "用 Python 分析 server.log，统计错误频率最高的前10个接口"

场景 6：自动化工作流

openclaw chat "每天下午5点，从 Notion 读取今日任务完成情况，生成日报发送到 Telegram"
openclaw browser "打开 Jira，查看我当前 Sprint 的任务进展，把阻塞项汇总发给我"

第七章 高级功能

7.1 技能系统（ClawHub）

ClawHub 是 OpenClaw 的社区技能市场，你可以一键安装技能来扩展助手的能力。技能本质上是预制的 Prompt + 工具组合。

openclaw skill install clawhub/pdf-reader
openclaw skill install clawhub/github-issue-bot
openclaw skill list

你也可以发布自己的技能到 ClawHub：

openclaw skill publish ./my-custom-skill

7.2 多智能体模式

OpenClaw 支持同时运行多个 Agent，每个负责不同任务：

{
  "agents": [
    {
      "name": "code-reviewer",
      "model": "claude-sonnet",
      "role": "专门审查代码质量和安全漏洞"
    },
    {
      "name": "researcher",
      "model": "gpt-4o",
      "role": "负责信息搜索和调研"
    }
  ]
}

使用场景：一个 Agent 写代码，另一个 Agent 审查，主 Agent 协调——形成完整的开发流水线。

7.3 语音模式

OpenClaw 支持语音输入和输出，无需打字即可交互：

openclaw voice start
openclaw voice transcribe audio.mp3

语音模式依赖 Whisper（语音转文字）和 TTS（文字转语音）模型，可在配置中指定。

7.4 浏览器自动化（Playwright）深入

OpenClaw 基于 Playwright 实现了深度的浏览器自动化。AI 可以理解页面结构和视觉元素：

openclaw browser --headless "登录我的 GitHub 账号，创建一个新的 public repo"
openclaw browser "打开淘宝，搜索'机械键盘'，按销量排序，截图前3页"
openclaw browser "访问 https://news.ycombinator.com，抓取前30条新闻标题和链接，保存为 JSON"

第八章 进阶技巧

8.1 多模型策略

不同任务用不同模型，性价比最高：

  • 简单问答 / 翻译 / 摘要： 用 DeepSeek 或 gpt-4o-mini，速度快成本低
  • 复杂代码 / 长文写作： 用 Claude Sonnet，逻辑严密
  • 多模态 / 图片理解： 用 GPT-4o 或 Gemini，视觉能力强
  • 离线 / 隐私敏感： 用 Ollama 本地模型，零 API 费用

在配置中为不同 Agent 分配不同模型，实现最优性价比。

8.2 自定义技能开发

创建你自己的技能文件 my-skill/skill.json：

{
  "name": "daily-standup",
  "version": "1.0.0",
  "description": "自动生成每日站会报告",
  "prompt": "你是一个站会助手。根据今天的 commit、issue、和聊天记录生成一份简洁的站会报告。格式：昨日完成 / 今日计划 / 阻塞项。",
  "tools": ["git", "file-read", "browser"],
  "model": "claude-haiku"
}

安装本地技能：

openclaw skill install ./my-skill

8.3 成本控制

  • 日常任务用便宜的模型（DeepSeek、Haiku、Mini）
  • 仅在复杂推理时切换到高级模型（Sonnet、GPT-4o）
  • 启用记忆系统压缩，限制 maxTokens 减少上下文开销
  • 使用 Ollama 本地模型处理非关键任务，零 API 费用
  • 定期审查 openclaw usage 查看费用统计
openclaw usage

8.4 安全最佳实践

  • 永远不要把 .env 提交到 Git（加入 .gitignore）
  • 消息频道设置白名单用户，防止未授权访问
  • 浏览器模式慎用 --headless 外的选项，避免敏感信息泄露
  • 定期轮换 API Key
  • 本地运行优于云端，数据不离机

8.5 部署为系统服务

让 OpenClaw 在后台持续运行，开机自启。

macOS（launchd）：

openclaw service install --platform darwin

Linux（systemd）：

openclaw service install --platform linux

管理服务状态：

openclaw service status
openclaw service restart

第九章 常见问题与排错

9.1 安装问题

权限不足时：

npm install -g openclaw --unsafe-perm

或安装到用户目录：

npm install -g openclaw --prefix ~/.local

Node 版本过旧：

nvm install 20
nvm use 20

9.2 频道连接问题

Telegram Bot 不响应：

curl "https://api.telegram.org/bot你的Token/getMe"

如果返回错误，检查 Bot Token 是否正确。常见原因：

  • Token 拼写错误
  • 未向 Bot 发送过任何消息（需先发送 /start）
  • 防火墙阻止了对 Telegram API 的访问

9.3 网络问题

测试 API 连通性：

curl -I https://api.openai.com/v1/models
curl -I https://api.anthropic.com/v1/messages

如果返回非 200，检查：

  • 代理是否正常工作
  • API Key 是否过期或余额不足
  • 网络防火墙是否限制

9.4 性能问题

  • 响应慢： 换用更快模型（haiku、gpt-4o-mini、deepseek-chat）
  • 内存占用高： 关闭不需要的 Agent，限制记忆容量
  • 浏览器操作慢： 使用 --headless 无头模式
  • 启动慢： 检查是否加载了过多技能，卸载不常用的
openclaw skill list
openclaw skill remove 不用的技能名

附录：命令速查与环境变量

命令速查表

# 安装与初始化
npm install -g openclaw                         # 全局安装
openclaw --version                              # 查看版本
openclaw init <项目名>                          # 初始化项目
openclaw --help                                 # 帮助信息

# 启动与聊天
openclaw start                                  # 启动助手（交互模式）
openclaw chat                                   # 进入聊天
openclaw chat "指令"                            # 单次执行
openclaw chat --model <模型名> "指令"           # 指定模型

# 浏览器操作
openclaw browser "指令"                         # 浏览器自动化
openclaw browser --headless "指令"              # 无头模式

# 记忆系统
openclaw memory list                            # 列出记忆
openclaw memory clear                           # 清空记忆

# 技能管理
openclaw skill list                             # 列出已安装技能
openclaw skill install <技能名>                 # 安装技能
openclaw skill remove <技能名>                  # 移除技能
openclaw skill publish <路径>                   # 发布技能

# 多智能体
openclaw agent list                             # 列出 Agent
openclaw agent start <名称>                     # 启动 Agent
openclaw agent stop <名称>                      # 停止 Agent

# 语音模式
openclaw voice start                            # 启动语音模式
openclaw voice transcribe <音频文件>            # 转录音频

# Cron 定时任务
openclaw cron list                              # 列出定时任务
openclaw cron run "任务名"                       # 手动触发
openclaw cron add                              # 添加定时任务

# 会话管理
openclaw session list                           # 列出会话
openclaw session resume <ID>                    # 恢复会话
openclaw session delete <ID>                    # 删除会话

# 服务管理
openclaw service install                        # 安装为系统服务
openclaw service status                         # 服务状态
openclaw service restart                        # 重启服务
openclaw service uninstall                      # 卸载服务

# 用量统计
openclaw usage                                  # 查看 API 用量

环境变量速查

# 模型 API Key
OPENAI_API_KEY=sk-xxx                           # OpenAI API Key
ANTHROPIC_API_KEY=sk-ant-api03-xxx              # Anthropic API Key
DEEPSEEK_API_KEY=sk-xxx                         # DeepSeek API Key
GOOGLE_API_KEY=AIza-xxx                         # Google Gemini API Key

# 消息频道
TELEGRAM_BOT_TOKEN=xxx:xxx                      # Telegram Bot Token
DISCORD_BOT_TOKEN=xxx                           # Discord Bot Token

# 网络
HTTPS_PROXY=http://127.0.0.1:7890               # HTTP 代理
HTTP_PROXY=http://127.0.0.1:7890                # HTTP 代理

# 自定义
OPENCLAW_CONFIG_PATH=./custom-config.json       # 自定义配置文件路径
OPENCLAW_LOG_LEVEL=debug                        # 日志级别

本教程由 老K学长 整理制作 · ¥9.9 买断制 · 一次购买永久查阅

闲鱼 / 小红书 / B站 / 知乎 搜索「老K学长」

返回首页