OpenClaw 新手完全指南：5 分钟配置你的 AI 助手OpenClaw 新手完全指南：5 分钟配置你的 AI 助手

OpenClaw 新手完全指南：5 分钟配置你的 AI 助手

本文基于 OpenClaw 官方文档和真实使用经验，带你从零开始配置属于自己的 AI 助手。

📦 一、什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手框架，可以让你：

✅ 定制专属 AI 助理 - 配置自己的 AI 模型和工作流
✅ 连接多个平台 - 飞书、微信、Telegram、Discord 等
✅ 扩展无限可能 - 通过 Skill 系统添加各种功能
✅ 完全自动化 - 定时任务、消息通知、数据处理

适合人群： 开发者、办公人士、效率控、AI 爱好者

🚀 二、5 分钟快速开始

2.1 前置要求

macOS / Linux / Windows (WSL)
Node.js 18+（推荐 v20+）
npm 或 pnpm 包管理器
网络连接（下载依赖）

2.2 安装步骤

步骤 1：安装 Node.js

如果未安装 Node.js，访问 nodejs.org 下载安装。

验证安装：

node -v
# 应显示 v18 或更高版本

步骤 2：全局安装 OpenClaw

npm install -g openclaw

安装过程约 1-2 分钟，请耐心等待。

步骤 3：运行配置向导

openclaw configure

按照向导提示完成配置：

选择 AI 模型（Claude/通义千问等）
输入 API Key
配置工作空间路径（默认 ~/.openclaw/workspace）

步骤 4：配置消息平台

以飞书为例：

openclaw configure --channel feishu

输入飞书 Bot 的 App ID 和 Secret。

步骤 5：启动 Gateway 服务

openclaw gateway start

看到 ✅ Gateway 已启动！ 表示成功。

2.3 验证安装

openclaw status

应显示：

Gateway: ✅ Running
Model: ✅ Configured
Channel: ✅ Feishu connected

🔥 三、Top 5 热门 Skill 推荐

Skill 是 OpenClaw 的功能扩展，类似手机 App。

3.1 web_search（🔥 最热，5000+ 下载）

功能： 使用 Brave Search API 搜索互联网

用法：

web_search "query" [count=10] [country=US] [freshness=pd]

示例：

# 搜索最新 AI 新闻
web_search "AI news 2026" freshness=pd

# 搜索中文内容
web_search "OpenClaw 教程" country=CN

适合场景： 查新闻、找资料、验证信息

3.2 web_fetch（实用，3500+ 下载）

功能： 抓取网页内容并转换为 Markdown

用法：

web_fetch "https://example.com" [extractMode=markdown]

示例：

# 抓取技术文章
web_fetch "https://docs.openclaw.ai"

# 提取纯文本
web_fetch "https://example.com" extractMode=text

适合场景： 读文章、抓取文档、内容分析

优势： 无需 API Key，免费使用

3.3 calendar（日程，2800+ 下载）

功能： 集成 Google Calendar/飞书日历

用法：

calendar check today
calendar add "会议" 14:00

示例：

# 查看今日日程
calendar check today

# 添加提醒
calendar add "喝水" 09:00 --repeat daily

适合场景： 日程管理、会议提醒、习惯追踪

3.4 email（通信，2200+ 下载）

功能： 集成 Gmail/Outlook/企业邮箱

用法：

email send "主题" "内容" to:user@example.com

示例：

# 发送邮件
email send "会议通知" "明天下午 3 点开会" to:team@company.com

# 查看未读邮件
email list --unread

适合场景： 邮件管理、自动回复、批量发送

3.5 feishu_bitable（办公，1800+ 下载）

功能： 飞书多维表格操作

用法：

feishu_bitable list_records app_token table_id

示例：

# 列出记录
feishu_bitable list_records app_xxx table_yyy

# 创建记录
feishu_bitable create_record app_xxx table_yyy --fields '{"name":"张三","age":25}'

适合场景： 数据管理、报表生成、团队协作

🎯 四、新手推荐组合

4.1 日常助理组合

web_search + web_fetch + calendar

功能： 搜索信息 + 阅读文章 + 日程管理

适合： 日常办公、学习研究

4.2 办公自动化组合

feishu_bitable + email + calendar

功能： 数据管理 + 邮件发送 + 会议安排

适合： 行政、HR、项目管理

4.3 内容创作组合

web_search + web_fetch + tts

功能： 查找素材 + 阅读参考 + 语音合成

适合： 自媒体、文案、视频创作

4.4 开发者组合

github + exec + browser

功能： 代码管理 + 命令执行 + 浏览器自动化

适合： 程序员、DevOps、测试工程师

🌐 五、Chrome 扩展命令详解

OpenClaw 提供 Chrome 扩展，可以自动化操作浏览器。

5.1 snapshot - 页面快照

功能： 获取当前网页的结构化快照

用法：

browser action=snapshot

示例：

# 获取页面所有元素
browser action=snapshot

# 使用 ARIA 引用（更稳定）
browser action=snapshot refs=aria

返回： 页面元素列表和结构

5.2 click - 点击元素

功能： 点击按钮、链接等可交互元素

用法：

browser action=act ref=e12

示例：

# 点击按钮
browser action=act ref=e12

# 双击
browser action=act ref=e12 doubleClick=true

提示： ref 来自 snapshot 返回的元素引用

5.3 type - 输入文本

功能： 在输入框中键入文本

用法：

browser action=act ref=e15 text="OpenClaw 教程"

示例：

# 输入搜索词
browser action=act ref=e15 text="OpenClaw 教程"

# 缓慢输入（模拟人工）
browser action=act ref=e15 text="密码 123" slowly=true

5.4 screenshot - 截图

功能： 截取页面或指定区域

用法：

browser action=screenshot fullPage=true type=png

示例：

# 全屏截图
browser action=screenshot fullPage=true

# 指定区域
browser action=screenshot selector=".article-content"

5.5 navigate - 导航

功能： 打开指定 URL

用法：

browser action=navigate targetUrl="https://docs.openclaw.ai"

💡 六、实战：自动登录 GitHub

完整示例：使用 Chrome 扩展自动登录 GitHub

步骤 1：打开登录页

browser action=navigate targetUrl="https://github.com/login"

步骤 2：获取页面元素

browser action=snapshot
# 记录用户名、密码、登录按钮的 ref

步骤 3：输入用户名

browser action=act ref=e10 text="your_username"

步骤 4：输入密码

browser action=act ref=e11 text="your_password"

步骤 5：点击登录

browser action=act ref=e15

完成！ 自动登录成功。

🎯 七、使用技巧

7.1 先 snapshot 再操作

操作前先获取页面结构，找到元素引用。

7.2 使用 ARIA 引用

browser action=snapshot refs=aria

ARIA 引用更稳定，不易随页面变化。

7.3 添加等待时间

复杂页面加 timeMs 参数等待加载：

browser action=act ref=e12 timeMs=3000

7.4 错误处理

检查 action 返回状态，失败重试：

# 如果失败，重新 snapshot 再试
browser action=snapshot
browser action=act ref=e12

📚 八、学习资源

官方文档： docs.openclaw.ai
Skill 市场： clawhub.com
GitHub： github.com/openclaw/op…
社区： discord.gg/clawd

🎉 九、下一步

完成基础配置后，你可以：

探索更多 Skill - 访问 Skill 市场发现新功能
定制工作流 - 配置定时任务和自动化流程
开发自定义 Skill - 根据需求扩展功能
加入社区 - 分享经验，获取帮助

祝你使用愉快！ 🚀

如有问题，欢迎在评论区留言或加入 Discord 社区讨论。