夜雨聆风OpenClaw 完整使用手册
文档信息
文档类型: 技术使用手册
适用对象: 开发者、运维人员、AI爱好者
难度等级: 初级～高级
阅读时间: 约30分钟
最后更新: 2026年3月12日
目录
第一部分：入门指南
OpenClaw 简介
系统要求
快速安装
首次使用
第二部分：核心功能
配置详解
技能管理
命令行使用
交互模式
第三部分：高级应用
API 接口
Webhook 配置
定时任务
工作流示例
第四部分：技能大全
文件管理技能
开发工具技能
网络工具技能
办公自动化技能
AI 增强技能
第五部分：附录
常见问题
故障排除
官方资源
更新日志
第一部分：入门指南
OpenClaw 简介
什么是 OpenClaw？ OpenClaw 是一个开源的 AI 助手框架，基于 Node.js 开发，支持插件式技能扩展，可以帮助用户自动化各种任务。
核心特性：
🚀 开源免费：基于 MIT 协议开源
🔧 模块化设计：支持插件式技能扩展
🌐 多平台支持：Windows、macOS、Linux
🤖 AI 驱动：集成主流大语言模型
📚 技能市场：通过 ClawHub 获取社区技能
适用场景：
文件整理和自动化
代码开发和审查
内容创作和优化
数据收集和分析
系统维护和监控
系统要求
操作系统
macOS: macOS 12+ (Intel/Apple Silicon)
Linux: Ubuntu 20.04+, Debian 11+, Fedora 38+
Windows: Windows 10/11（推荐使用 WSL2）
核心依赖
Node.js: v20+（推荐 v22 LTS）
npm: v9+（随 Node.js 安装）
Git: 用于克隆仓库和管理技能（可选但推荐）
存储空间: 至少 2GB 可用空间
网络要求
稳定的网络连接
访问 GitHub 和 npm 仓库
（可选）科学上网环境以访问部分 AI 模型
快速安装
方法一：npm 全局安装（推荐）
# 检查 Node.js 版本
node --version
# 检查 npm 版本
npm --version
# 全局安装 OpenClaw
npm install -g openclaw
# 验证安装
openclaw --version
openclaw help
方法二：Windows WSL 安装
# 安装 WSL2
wsl --install
# 重启后打开 WSL
wsl
# 在 WSL 中安装 OpenClaw
npm install -g openclaw
方法三：Docker 安装
# 拉取镜像
docker pull openclaw/openclaw
# 运行容器
docker run -d \
--name openclaw \
-p 3000:3000 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
首次使用
1. 初始化配置
# 初始化配置
openclaw init
# 创建配置目录
mkdir -p ~/.openclaw/workspace
2. 基础配置文件
创建 ~/.openclaw/config.yaml：
version: "2.0"
workspace_path: "~/.openclaw/workspace"
log_level: "info"
ai:
provider: "openai"
model: "gpt-4"
api_key: "your-api-key-here"
temperature: 0.7
3. 安装第一个技能
# 安装文件整理技能
openclaw skills install file-organizer
# 查看已安装技能
openclaw skills list
4. 运行第一个任务
# 启动交互模式
openclaw
# 或执行单次任务
openclaw run "整理我的下载文件夹"
第二部分：核心功能
配置详解
配置文件结构
~/.openclaw/
├── config.yaml # 主配置文件
├── workspace/ # 工作区
│ ├── skills/ # 技能目录
│ ├── logs/ # 日志目录
│ └── cache/ # 缓存目录
└── config-backup/ # 配置备份
完整配置示例
# OpenClaw 配置文件
version: "2.0"
workspace_path: "~/.openclaw/workspace"
log_level: "info"
# AI 配置
ai:
provider: "openai"
model: "gpt-4"
api_key: "sk-xxx"
temperature: 0.7
max_tokens: 2000
# 技能配置
skills:
enabled: true
auto_update: true
default_skills:
- file_organizer
- code_assistant
# 网络配置
network:
proxy: null
timeout: 30
retry_count: 3
# 日志配置
logging:
file: "~/.openclaw/workspace/logs/openclaw.log"
max_size: "10MB"
max_files: 5
AI 模型配置
# OpenAI 配置
ai:
provider: "openai"
model: "gpt-4"
api_key: "sk-xxx"
# 阿里云百炼配置
ai:
provider: "qwen"
model: "qwen-max"
api_key: "your-aliyun-api-key"
# DeepSeek 配置
ai:
provider: "deepseek"
model: "deepseek-chat"
api_key: "your-deepseek-api-key"
技能管理
基本命令
# 搜索技能
openclaw skills search "文件"
# 查看技能详情
openclaw skills info file-organizer
# 安装技能
openclaw skills install file-organizer
# 查看已安装技能
openclaw skills list
# 更新技能
openclaw skills update file-organizer
openclaw skills update --all
# 卸载技能
openclaw skills uninstall file-organizer
技能配置示例
skills:
file_organizer:
enabled: true
config:
source_dir: "~/Downloads"
rules:
- name: "图片文件"
extensions: [jpg, jpeg, png, gif, webp]
target_dir: "images"
- name: "文档文件"
extensions: [pdf, doc, docx, xls, xlsx]
target_dir: "documents"
options:
create_date_folders: true
delete_empty_folders: true
命令行使用
基本命令
# 查看帮助
openclaw help
openclaw help skills
openclaw help config
# 查看版本
openclaw --version
# 查看状态
openclaw status
# 查看日志
openclaw logs
openclaw logs --tail 100
openclaw logs --follow
# 清理缓存
openclaw cleanup
openclaw cleanup --all
任务执行
# 执行单次任务
openclaw run "整理我的下载文件夹"
openclaw run "搜索最新的AI新闻"
# 带参数执行
openclaw run "整理文件夹" --source ~/Downloads --target ~/Documents
# 执行技能
openclaw skills execute file-organizer --source ~/Downloads
# 批量执行
openclaw run-batch tasks.yaml
配置管理
# 查看配置
openclaw config list
openclaw config get ai.provider
# 设置配置
openclaw config set ai.provider openai
openclaw config set ai.api_key "sk-xxx"
# 导出配置
openclaw config export > config-backup.yaml
# 导入配置
openclaw config import < config-backup.yaml
# 验证配置
openclaw config validate
交互模式
启动交互模式
# 启动基本交互
openclaw
# 启动带日志的交互
openclaw --verbose
# 启动指定工作区的交互
openclaw --workspace ~/my-workspace
交互命令
在交互模式中可以使用的命令：
!help # 查看帮助
!skills # 查看技能列表
!config # 查看配置
!history # 查看历史记录
!clear # 清屏
!exit # 退出
对话示例
你：整理我的下载文件夹
OpenClaw：正在整理下载文件夹...
找到 125 个文件
移动 45 个图片文件到 images/
移动 30 个文档文件到 documents/
整理完成！
你：帮我搜索最新的 AI 新闻
OpenClaw：正在搜索 AI 最新新闻...
1. OpenAI 发布 GPT-4.5 (2026-03-10)
2. Google DeepMind 新突破 (2026-03-09)
3. 国内大模型进展 (2026-03-08)
第三部分：高级应用
API 接口
启动 API 服务
# 启动 API 服务
openclaw api --port 3000
# 带认证的 API
openclaw api --port 3000 --auth-token "my-secret-token"
# 生产环境启动
openclaw api --port 3000 --workers 4 --log-level info
API 端点
健康检查
GET /health
响应：{ "status": "healthy", "version": "2.0.0" }
执行任务
POST /api/v1/run
Content-Type: application/json
{
"command": "整理文件夹",
"args": {
"source": "~/Downloads"
}
}
响应：
{
"success": true,
"result": "整理完成，处理了 125 个文件",
"timestamp": "2026-03-12T10:30:00Z"
}
技能管理
# 获取技能列表
GET /api/v1/skills
# 执行技能
POST /api/v1/skills/{skill_name}/execute
{
"params": { ... }
}
使用 curl 示例
# 健康检查
curl http://localhost:3000/health
# 执行任务
curl -X POST http://localhost:3000/api/v1/run \
-H "Content-Type: application/json" \
-d '{"command": "搜索新闻", "args": {"query": "AI"}}'
# 获取技能列表
curl http://localhost:3000/api/v1/skills
Webhook 配置
Webhook 配置示例
webhooks:
- name: "github_webhook"
url: "http://localhost:8080/webhook/github"
events:
- "push"
- "pull_request"
secret: "github-secret"
enabled: true
- name: "slack_notification"
url: "https://hooks.slack.com/services/xxx"
events:
- "task_completed"
- "error_occurred"
Webhook 事件类型
task_started: 任务开始
task_completed: 任务完成
task_failed: 任务失败
skill_installed: 技能安装
skill_updated: 技能更新
error_occurred: 发生错误
config_changed: 配置变更
定时任务
定时任务配置
schedules:
- name: "daily_backup"
description: "每日备份工作区"
cron: "0 2 * * *" # 每天凌晨2点
command: "backup"
args:
source: "~/.openclaw/workspace"
target: "~/Backups/openclaw"
enabled: true
- name: "weekly_cleanup"
description: "每周清理缓存"
cron: "0 3 * * 0" # 每周日凌晨3点
command: "cleanup"
args:
cache: true
logs: true
管理定时任务
# 查看定时任务
openclaw schedule list
# 添加定时任务
openclaw schedule add \
--name "hourly_check" \
--cron "0 * * * *" \
--command "health_check"
# 启用/禁用定时任务
openclaw schedule enable daily_backup
openclaw schedule disable daily_backup
# 立即执行定时任务
openclaw schedule run daily_backup
# 查看定时任务日志
openclaw schedule logs daily_backup
工作流示例
示例1：文件整理工作流
name: "文件整理工作流"
tasks:
- name: "整理下载文件夹"
command: "skills execute file-organizer"
args:
source_dir: "~/Downloads"
- name: "备份重要文档"
command: "backup"
args:
source: "~/Documents/Important"
target: "~/Backups/Important-{{date}}"
compress: true
- name: "清理临时文件"
command: "cleanup"
args:
paths:
- "~/Downloads/temp"
- "~/Desktop/*.tmp"
age: "7d"
示例2：开发工作流
name: "代码审查和测试"
triggers:
- event: "git_push"
branch: "main"
tasks:
- name: "代码质量检查"
command: "skills execute code-assistant"
args:
action: "review"
files: "{{changed_files}}"
- name: "运行单元测试"
command: "skills execute code-assistant"
args:
action: "test"
command: "npm test"
- name: "安全检查"
command: "skills execute security-scanner"
args:
scan_type: "dependency"
- name: "部署到测试环境"
command: "skills execute deploy-helper"
args:
environment: "staging"
when: "all_previous_passed"
示例3：内容创作工作流
name: "内容创作流程"
tasks:
- name: "收集主题资料"
command: "skills execute web-extractor"
args:
urls:
- "https://example.com/topic1"
- "https://example.com/topic2"
format: "markdown"
- name: "生成文章大纲"
command: "skills execute content-generator"
args:
template: "article_outline"
topic: "OpenClaw 使用教程"
- name: "撰写文章内容"
command: "skills execute content-generator"
args:
template: "article_content"
outline: "{{step2.output}}"
- name: "优化SEO"
command: "skills execute seo-optimizer"
args:
content: "{{step3.output}}"
keywords: ["OpenClaw", "AI助手"]
- name: "生成社交媒体摘要"
command: "skills execute content-generator"
args:
template: "social_media_summary"
article: "{{step4.output}}"
第四部分：技能大全
文件管理技能
1. 文件整理助手 (file-organizer)
功能：自动整理文件夹，按类型分类文件
配置示例：
file_organizer:
source_dir: "~/Downloads"
rules:
- name: "图片文件"
extensions: [jpg, jpeg, png, gif, webp]
target_dir: "images"
- name: "文档文件"
extensions: [pdf, doc, docx, xls, xlsx, ppt, pptx]
target_dir: "documents"
- name: "压缩文件"
extensions: [zip, rar, 7z, tar.gz]
target_dir: "archives"
- name: "安装包"
extensions: [exe, dmg, deb, pkg, msi]
target_dir: "installers"
2. 重复文件查找器 (duplicate-finder)
功能：查找并处理重复文件
配置：
duplicate_finder:
scan_dirs:
- "~/Downloads"
- "~/Documents"
- "~/Pictures"
methods:
- "hash" # 文件哈希
- "size" # 文件大小
- "name" # 文件名
actions:
on_duplicate: "ask" # ask, delete, move, keep
3. 文件批量重命名 (batch-renamer)
功能：批量重命名文件
示例：
# 批量添加前缀
openclaw run "为所有图片添加日期前缀"
# 批量修改扩展名
openclaw run "将所有.txt文件改为.md"
# 使用模板重命名
openclaw skills execute batch-renamer \
--pattern "IMG_{counter:03d}.jpg" \
--start 1
开发工具技能
1. 代码助手 (code-assistant)
功能：代码生成、审查、优化
配置：
code_assistant:
languages:
javascript:
linter: "eslint"
formatter: "prettier"
test_framework: "jest"
python:
linter: "pylint"
formatter: "black"
test_framework: "pytest"
features:
code_generation: true
code_review: true
bug_detection: true
documentation_generation: true
使用示例：
# 生成 React 组件
openclaw run "生成一个带props的React按钮组件"
# 代码审查
openclaw run "审查src/components/Button.js的代码质量"
# 修复 Bug
openclaw run "修复这个函数的Bug: [粘贴代码]"
# 生成文档
openclaw run "为utils/formatDate.js生成JSDoc文档"
2. Git 助手 (git-helper)
功能：Git 操作自动化
配置：
git_helper:
auto_add: true
auto_commit: false
commit_template: |
{{type}}: {{summary}}
{{details}}
commit_types:
feat: "新功能"
fix: "修复Bug"
docs: "文档更新"
style: "代码样式"
3. API 测试工具 (api-tester)
功能：API 测试自动化
配置：
api_tester:
environments:
local:
base_url: "http://localhost:3000"
headers:
Authorization: "Bearer local-token"
staging:
base_url: "https://staging.api.example.com"
headers:
Authorization: "Bearer staging-token"
网络工具技能
1. 网页内容提取器 (web-extractor)
功能：提取网页内容
配置：
web_extractor:
selectors:
article: "article, .post-content, .article-body"
title: "h1, .title, .post-title"
summary: ".summary, .excerpt"
images: "img[src], .article-image"
options:
remove_ads: true
remove_scripts: true
format_output: "markdown"
download_images: false
使用：
# 提取文章内容
openclaw run "提取 https://example.com/article 的文章内容"
# 批量提取
openclaw run "提取这些URL的文章: [URL列表]"
# 保存为Markdown
openclaw run "将文章保存为Markdown文件"
2. RSS 阅读器 (rss-reader)
功能：RSS 订阅管理
配置：
rss_reader:
feeds:
- url: "https://github.blog/feed/"
name: "GitHub Blog"
category: "开发"
- url: "https://openai.com/blog/rss/"
name: "OpenAI Blog"
category: "AI"
- url: "https://news.ycombinator.com/rss"
name: "Hacker News"
category: "科技"
update_interval: "1h"
max_items: 20
notify_new: true
3. 网络监控器 (web-monitor)
功能：网站状态监控
配置：
web_monitor:
sites:
- url: "https://example.com"
name: "主站"
check_interval: "5m"
expected_status: 200
timeout: 10
- url: "https://api.example.com/health"
name: "API健康检查"
check_interval: "1m"
notifications:
email: "admin@example.com"
slack: "#monitoring"
办公自动化技能
1. 文档生成器 (document-generator)
功能：自动化文档生成
模板示例：
document_generator:
templates:
meeting_minutes:
path: "templates/meeting-minutes.md"
variables:
- date
- attendees
- topics
- decisions
- action_items
report:
path: "templates/report.md"
variables:
- title
- author
- date
- sections
- conclusion
使用：
# 生成会议纪要
openclaw run "生成会议纪要，日期：2026-03-12，参会人：张三、李四"
# 生成周报
openclaw run "生成本周工作报告"
# 批量生成文档
openclaw run "为所有项目生成README文件"
2. 表格处理工具 (spreadsheet-processor)
功能：Excel/CSV 文件处理
使用：
# 合并多个CSV文件
openclaw run "合并data/*.csv文件"
# 数据清洗
openclaw run "清理sales.csv中的重复数据"
# 数据转换
openclaw run "将JSON数据转换为Excel表格"
# 数据分析
openclaw run "分析销售数据，生成统计报告"
3. PDF 处理器 (pdf-processor)
功能：PDF 文件处理
功能列表：
PDF 合并/拆分
PDF 转换（PDF ↔ Word/Excel/PPT）
PDF 加密/解密
PDF 水印添加
PDF 内容提取
使用：
# 合并PDF
openclaw run "合并documents/*.pdf文件"
# 提取文本
openclaw run "从contract.pdf中提取所有文本"
# 添加水印
openclaw run "为report.pdf添加'机密'水印"
AI 增强技能
1. 智能摘要器 (smart-summarizer)
功能：文本智能摘要
配置：
smart_summarizer:
models:
default: "gpt-4"
fallback: "gpt-3.5-turbo"
length_options:
brief: "50字以内"
normal: "100-200字"
detailed: "300-500字"
output_formats:
- "bullet_points"
- "paragraph"
- "key_points"
使用：
# 摘要文章
openclaw run "摘要这篇长文章: [文章内容]"
# 会议记录摘要
openclaw run "摘要会议录音文字稿"
# 多文档摘要
openclaw run "摘要这些文档的核心内容"
2. 翻译助手 (translation-assistant)
功能：多语言翻译
支持语言：
中文 ↔ 英文
中文 ↔ 日文
英文 ↔ 法文/德文/西班牙文
等多语言对
使用：
# 翻译文本
openclaw run "将这段中文翻译成英文: [中文文本]"
# 批量翻译
openclaw run "翻译markdown文档中的所有段落"
# 术语统一翻译
openclaw run "使用术语表翻译技术文档"
3. 内容生成器 (content-generator)
功能：AI 内容创作
模板类型：
博客文章
社交媒体帖子
产品描述
邮件模板
广告文案
使用：
# 生成博客文章
openclaw run "写一篇关于OpenClaw的博客文章"
# 生成社交媒体内容
openclaw run "为新产品发布生成Twitter帖子"
# 生成邮件模板
openclaw run "生成客户跟进邮件模板"
第五部分：附录
常见问题
安装问题
Q: npm install 失败怎么办？
A:检查 Node.js 版本：node --version (需要 v20+)
清理 npm 缓存：npm cache clean --force
使用淘宝镜像：npm config set registry https://registry.npmmirror.com
Q: Windows 安装遇到权限问题？
A:以管理员身份运行 PowerShell
或使用 WSL2 安装
使用问题
Q: AI 模型无法连接？
A:检查 API Key 是否正确
确认网络连接
检查模型配置
Q: 技能安装失败？
A:更新技能仓库：openclaw skills update
检查网络连接
查看详细错误：openclaw skills install --verbose
性能问题
Q: OpenClaw 运行缓慢？
A:增加内存分配
清理缓存：openclaw cleanup
禁用不必要的技能
故障排除
环境检查脚本
# 运行环境检查
bash check_env.sh
脚本会检查：
Node.js 版本和安装状态
npm 版本和功能
Git 安装状态
磁盘空间和内存
网络连接状态
OpenClaw 安装状态
配置验证
# 验证配置
openclaw config validate
# 备份配置
openclaw config export > config-backup.yaml
# 恢复配置
openclaw config import < config-backup.yaml
日志查看
# 查看日志
openclaw logs
# 实时查看日志
openclaw logs --follow
# 查看特定级别日志
openclaw logs --level error
# 查看详细日志
openclaw logs --verbose
官方资源
官网: https://openclaw.ai/
文档中心: https://docs.openclaw.ai/
GitHub: https://github.com/openclaw/openclaw
社区资源
技能市场 (ClawHub): https://clawhub.com/
Discord 社区: https://discord.com/invite/clawd
官方博客: https://blog.openclaw.ai/
学习资源
视频教程: YouTube 官方频道
示例项目: GitHub 仓库 examples/
开发者指南: 官方文档开发者部分
安装命令
node --version # 检查 Node.js
npm install -g openclaw # 安装 OpenClaw
openclaw --version # 验证安装
基本命令
openclaw init # 初始化配置
openclaw help # 查看帮助
openclaw status # 查看状态
openclaw cleanup # 清理缓存
技能管理
openclaw skills install file-organizer # 安装技能
openclaw skills list # 查看技能
openclaw skills update --all # 更新技能
openclaw skills uninstall file-organizer # 卸载技能
任务执行
openclaw run "整理文件夹" # 执行任务
openclaw run-batch tasks.yaml # 批量执行
openclaw skills execute file-organizer # 执行技能
配置管理
openclaw config list # 查看配置
openclaw config set ai.provider openai # 设置配置
openclaw config export > backup.yaml # 导出配置
openclaw config import < backup.yaml # 导入配置
提示: OpenClaw 仍在快速发展中，建议定期查看官方文档获取最新信息。
需要MD文档评论区回复666
祝您使用 OpenClaw 愉快！ 🎉