OpenClaw 小白完整教程

推荐方式：Windows 安装包

如果你是普通 Windows 用户，优先用现成安装包最省心。它比手动装 Node、配环境变量更直观，更适合第一次接触 OpenClaw 的人。

官方脚本：适合能接受命令行的人

如果你愿意在 PowerShell 里执行命令，可以直接走官方一键安装脚本。优点是更新更贴近官方流程，缺点是对纯小白不如安装包直观。

iwr -useb https://openclaw.ai/install.ps1 | iex

Mac 安装准备：配置 Homebrew 国内源

Mac 安装 OpenClaw 前需要 Node.js。如果你还没装，推荐用 Homebrew。为了下载快，建议先配置中科大 USTC 源：

export HOMEBREW_INSTALL_FROM_API=1
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"
brew install node

Mac 一键安装命令

装好 Node 后，在 Mac 终端直接运行官方的一键安装脚本。这会自动下载并完成所有配置。

curl -fsSL https://openclaw.bot/install.sh | bash

• 如果遇到内存不足，脚本可能会提示开启 swap 交互内存。
• 安装结束时可直接在终端进入 TUI 聊天界面进行测试。

手动安装：你已经有 Node 环境时再选

npm install -g openclaw@latest

pnpm add -g openclaw

不建议的第一条路：源码安装

源码安装更适合开发者、二开或调试。普通用户第一次上手如果直接走源码，安装过程会更长，变量也更多，不利于快速建立信心。

第一次最该配好的

模型提供商、API Key、默认端口、Daemon。只要这几项没问题，你就已经能进入浏览器开始聊天了。

第一次最容易乱配的

渠道、过多 Skills、端口修改、复杂安全策略。它们都重要，但不需要在第一次上手时全部完成。

先看状态

openclaw status
openclaw gateway status

如果你在 onboarding 里安装了服务，通常这时 Gateway 已经跑起来了。看到状态正常，再进入下一步。

打开 Dashboard

openclaw dashboard

这会打开浏览器里的 Control UI。你也可以直接访问 http://127.0.0.1:18789/。

TUI：终端聊天界面

如果你不想开浏览器，也可以在终端里直接聊天。它更适合服务器、远程机器或喜欢键盘流的人。

openclaw tui

前台调试模式

当你怀疑端口冲突、配置没生效、后台服务没跑起来时，用前台模式最直观，因为报错会直接出现在当前窗口。

openclaw gateway --port 18789 --verbose

浏览器自动化 1：Browser Use

适合做网页测试、表单填写、截图、页面交互和简单数据提取。比“只会打开网页”更进一步，适合让 OpenClaw 真正替你点按钮、走流程。

• 推荐场景：自动打开网站、填写表单、截图留证、抓取页面信息。
• 安装命令：openclaw skills install browser-use
• 示例：让它“打开某后台页面，登录后进入报表页并截图保存”。

浏览器自动化 2：Browser Automation

面向网页导航、点击、提取、截屏、填表等高频自动化任务，适合不想自己写浏览器脚本的人。

• 推荐场景：自动化网页操作、批量采集、按钮点击、流程回放。
• 安装命令：openclaw skills install browser-automation
• 示例：让它“访问活动页面，提取商品标题、价格和链接，整理成表格”。

浏览器自动化 3：Browser Automation (CDP)

适合直接接管本机已登录的 Edge 或 Chrome 浏览器，对需要复用登录态的任务尤其友好。

• 推荐场景：复用本机浏览器会话、操作已登录网站、截图和页面提取。
• 安装命令：openclaw skills install browser-automation-cdp
• 示例：让它“使用当前登录的浏览器进入后台，下载日报并截图确认”。

浏览器自动化补充：Autoglm Browser Agent

这是更偏“浏览器万能代理”的路线，除了搜索和填表，也能处理社交媒体浏览、发帖、评论和在线文档操作。

• 推荐场景：跨网站操作、登录后流程、社交平台浏览与轻交互。
• 安装命令：openclaw skills install autoglm-browser-agent
• 示例：让它“打开小红书搜索某关键词，截取前 5 条热门内容做摘要”。

办公自动化 1：腾讯文档 TENCENT DOCS

这是非常实用的办公类 Skill，覆盖在线文档、表格、幻灯片、思维导图、文件管理、文档搜索和内容上云。

• 推荐场景：写周报、写方案、整理表格、导入导出文件、网页剪藏进文档。
• 安装命令：openclaw skills install tencent-docs
• 示例：让它“新建一个腾讯文档周报模板，把本周工作整理进去并生成目录”。

办公自动化 2：腾讯会议

适合日程协作和会议管理，支持预约、修改、取消会议，查询会议详情、录制与转写，以及 AI 纪要相关能力。

• 推荐场景：创建会议、查会议信息、找录制、拿会议纪要。
• 安装命令：openclaw skills install tencent-meeting-skill
• 示例：让它“帮我预约明天下午 3 点的会议，并整理最近一次会议的纪要要点”。

办公自动化 3：kdocs skill

如果你的团队主要用金山文档/WPS 云文档，这是很值得优先试的办公 Skill，支持云端创建、编辑、搜索和分享多种文档。

• 推荐场景：日报周报、合同处理、报名表、信息收集、知识库管理。
• 安装命令：openclaw skills install kdocs-skill
• 示例：让它“新建一张报名表，包含姓名、电话、公司、报名时间 4 列”。

办公自动化 4：ima-skills

更偏个人笔记和知识库，适合把碎片信息、备忘、资料摘要沉淀下来，做成你的“第二大脑”。

• 推荐场景：记笔记、查笔记、知识库沉淀、长期内容整理。
• 安装命令：openclaw skills install ima-skills
• 示例：让它“把刚才总结的会议结论存进知识库，并按项目名归档”。

自媒体 1：Content Writer 自媒体内容生成器

适合做多平台内容生产，覆盖小红书、知乎、公众号、抖音等平台，适合想用一套工作流同时产出多端文案的人。

• 推荐场景：同一主题改写成多平台版本、做账号矩阵内容。
• 安装命令：openclaw skills install content-writer
• 示例：让它“把一篇产品介绍改写成小红书笔记、公众号短文和抖音口播稿”。

自媒体 2：小红书内容生成引擎

偏小红书运营和增长，能生成高互动内容、选题日历和爆款文案，适合刚开始做小红书账号的人。

• 推荐场景：找选题、写笔记、做月度内容规划。
• 安装命令：openclaw skills install xiaohongshu-growth-engine
• 示例：让它“围绕职场副业，给我生成 7 天的小红书选题和首篇笔记”。

自媒体 3：公众号自动发布

适合已经有现成文章内容的人，能直接把文章推送到微信公众号草稿箱，减少人工复制粘贴。

• 推荐场景：定稿后的文章发布、内容流转到公众号后台。
• 安装命令：openclaw skills install mp-draft-push
• 示例：让它“把我刚写好的文章推送到公众号草稿箱，标题使用最终定稿版本”。

自媒体 4：内容捕手 Content Hunter

偏内容研究和竞品分析，支持抓取小红书、抖音、B 站等平台的热门内容，并自动整理成汇报。

• 推荐场景：热点跟踪、竞品分析、选题素材收集、爆款复盘。
• 安装命令：openclaw skills install content-hunter
• 示例：让它“抓取最近一周职场效率类热门短视频，并整理成选题参考表”。

给某个 Agent 单独装 Skill

如果你不是只有一个 Agent，可以把 Skill 装到特定 Agent 的工作区，避免所有 Agent 都看到同一堆能力。

openclaw skills install <skill-slug> --agent <id>
openclaw skills list --agent <id>

Skills 装到哪里去了

常见位置包括工作区的 skills/、用户目录下的 ~/.openclaw/skills，以及个人或项目级 Agent 技能目录。工作区里的同名 Skill 优先级最高。

Skill 和 Plugin 的区别

Skill 更像“教你怎么做某类任务的能力包”；Plugin 更像“给 OpenClaw 增加新的扩展模块”，例如新渠道、新工具、新语音能力、新媒体能力等。

什么时候才需要 Plugin

当你明确需要某个额外能力，而且这个能力不是简单 Skill 就能解决时，再考虑安装 Plugin。对小白来说，Plugin 优先级通常低于基础使用和 Skills。

接入钉钉机器人

通过官方连接器，让 OpenClaw 直接在钉钉群聊或单聊里回复消息。

openclaw plugins install @dingtalk-real-ai/dingtalk-connector

• **配置修改：** 编辑 ~/.openclaw/openclaw.json，加入 channels/dingtalk-connector 配置。
• **填入凭证：** 填入钉钉应用的 clientId 和 clientSecret，并开启 chatCompletions。
• **注意：** 钉钉应用需申请 Card.Streaming.Write 和 qyapi_robot_sendmsg 权限，且消息模式必须是 Stream 模式。
• **重启服务：** openclaw gateway restart。

接入微信

通过微信插件，OpenClaw 可以直接在微信上接收消息并回复，甚至支持语音转文字。

• **功能特性：** 微信 OpenClaw 插件通常自带语音转换成文字功能，无需额外配置 OpenClaw 的 STT 功能。
• **部署建议：** 建议使用专门的微信机器人连接器（如 wechaty 或相关适配插件）。
• 同样需要修改 openclaw.json 并重启网关生效。

开启语音能力（零成本）

让 OpenClaw 能听懂你的语音，并用语音回复你，支持全局所有通道。

• **听（STT）：** 推荐使用 Groq 提供的免费 API (whisper-large-v3)。在 openclaw.json 中启用 tools.media.audio，并填入 Groq API Key。
• **说（TTS）：** 原生支持微软 Edge TTS（完全免费）。配置 messages.tts.provider="edge"。推荐中文音色：zh-CN-XiaoxiaoNeural。
• **控制命令：** 用 /tts status 查状态，/tts summary off 关掉长回复的语音。

接入视觉与桌面操控（Peekaboo）

想让 Agent 帮你操作电脑？装上 Peekaboo v3，它不仅能像素级截图，还能读取 Mac UI 元素并模拟点击。

brew install steipete/tap/peekaboo

• **作为 Skill 接入：** 将 Peekaboo 作为一个 Skill 接入 OpenClaw，你的 Agent 就拥有了控制 Mac 桌面的能力（Computer Use）。
• **支持 MCP：** 也可以通过 npx -y @steipete/peekaboo mcp 接入其他支持 MCP 的工具。