OpenClaw 安装文件与目录结构总览
OpenClaw 安装文件汇总
一、核心安装文件(npm全局安装)
| 文件名/目录 | 位置 | 解释 |
|---|---|---|
openclaw | ~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/bin/ | 主CLI可执行文件 |
package.json | ~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/ | npm包信息与依赖 |
docs/ | ~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/docs/ | 官方文档目录 |
skills/ | ~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/skills/ | 内置技能库目录 |
src/ | ~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/src/ | 源代码目录 |
二、用户配置目录(首次运行后创建)
| 文件名/目录 | 位置 | 解释 |
|---|---|---|
config/ | ~/.openclaw/config/ | 配置文件目录 |
models.json | ~/.openclaw/config/models.json | 模型配置(API密钥、端点等) |
providers.json | ~/.openclaw/config/providers.json | 服务提供商配置 |
channels.json | ~/.openclaw/config/channels.json | 消息频道配置 |
workspace/ | ~/.openclaw/workspace/ | 用户工作空间根目录 |
logs/ | ~/.openclaw/logs/ | 系统日志目录 |
data/ | ~/.openclaw/data/ | 应用数据存储目录 |
三、工作空间文件(助手个性化)
| 文件名 | 位置 | 解释 |
|---|---|---|
SOUL.md | ~/.openclaw/workspace/SOUL.md | 助手"灵魂"文件(个性、行为准则) |
USER.md | ~/.openclaw/workspace/USER.md | 用户信息文件 |
IDENTITY.md | ~/.openclaw/workspace/IDENTITY.md | 助手身份定义(名称、表情等) |
TOOLS.md | ~/.openclaw/workspace/TOOLS.md | 本地工具配置笔记 |
MEMORY.md | ~/.openclaw/workspace/MEMORY.md | 助手长期记忆(仅主会话加载) |
AGENTS.md | ~/.openclaw/workspace/AGENTS.md | 工作空间使用指南 |
HEARTBEAT.md | ~/.openclaw/workspace/HEARTBEAT.md | 心跳任务清单 |
BOOTSTRAP.md | ~/.openclaw/workspace/BOOTSTRAP.md | 首次启动引导文件(完成后删除) |
memory/ | ~/.openclaw/workspace/memory/ | 每日记忆文件目录 |
YYYY-MM-DD.md | ~/.openclaw/workspace/memory/YYYY-MM-DD.md | 每日记忆文件(按日期) |
四、环境与运行时文件
| 文件名 | 位置 | 解释 |
|---|---|---|
.openclawrc | ~/.openclawrc 或 ~/.config/openclaw/config.json | 环境配置文件 |
| 环境变量 | 系统环境 | OPENCLAW_WORKSPACE, OPENCLAW_MODEL等 |
| PID文件 | 系统临时目录 | 网关守护进程的进程ID文件 |
| 会话缓存 | 系统临时目录 | 运行时会话状态缓存 |
五、技能文件(示例)
| 技能名 | 位置 | 解释 |
|---|---|---|
1password/ | ~/.nvm/.../openclaw/skills/1password/ | 1Password CLI集成技能 |
weather/ | ~/.nvm/.../openclaw/skills/weather/ | 天气查询技能 |
obsidian/ | ~/.nvm/.../openclaw/skills/obsidian/ | Obsidian笔记技能 |
SKILL.md | 各技能目录下的SKILL.md | 技能使用说明文档 |
六、当前你的安装状态
| 项目 | 状态 | 说明 |
|---|---|---|
| 安装版本 | 2026.3.2 (85377a2) | 最新稳定版 |
| Node版本 | v22.22.1 | 通过nvm管理 |
| 工作空间 | 已初始化 | 包含所有模板文件 |
| 模型配置 | 已配置 | DeepSeek Chat API |
| 技能加载 | 正常 | 内置技能可用 |
| API问题 | Amazon Bedrock缺失 | 不影响核心功能 |
七、重要路径总结
- CLI命令:
~/.nvm/versions/node/v22.22.1/bin/openclaw - 配置目录:
~/.openclaw/config/ - 工作空间:
~/.openclaw/workspace/ - 技能目录:
~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/skills/ - 日志目录:
~/.openclaw/logs/
OpenClaw 技能(Skills)技术说明列表
技能概览
OpenClaw 技能是模块化的功能扩展,每个技能提供特定领域的工具和自动化能力。
技能安装方法
技能来源分为三类:随 OpenClaw 内置、通过 ClawHub 安装、额外包或手动安装。下表说明对应关系与安装方式。
| 来源 | 说明 | 安装方式 |
|---|---|---|
| openclaw-bundled | 随 npm install -g openclaw 一起安装,位于 openclaw/skills/ 下 | 升级 OpenClaw 即更新:npm update -g openclaw |
| openclaw-extra | 飞书等扩展技能包,需单独安装 | 使用 npm 安装对应包,或从 ClawHub 安装 |
| ClawHub 市场 | 社区/官方在 clawhub.com 发布的技能 | 使用 clawhub CLI 搜索、安装、更新 |
1. 使用 ClawHub 安装与更新技能
ClawHub 是 OpenClaw 的技能市场,用法与 npm 类似。需先确保已安装 clawhub CLI(通常随 OpenClaw 或单独安装)。
## 搜索技能(按关键词)
clawhub search weather
clawhub search feishu
## 安装指定技能到 OpenClaw 技能目录
clawhub install <skill-name>
## 更新已安装技能到最新版本
clawhub update <skill-name>
## 更新所有已通过 ClawHub 安装的技能
clawhub update --all
## 列出已安装技能(或使用 openclaw 自带的列表)
openclaw skills list安装后技能会出现在 OpenClaw 的加载路径中(一般为全局 openclaw/skills/ 或用户覆盖目录),下次启动会话即可使用。
2. 安装 openclaw-extra(如飞书套件)
飞书文档、云盘、权限、知识库、任务、加急等技能属于 openclaw-extra,需单独安装对应 npm 包(包名以 openclaw-extra- 或项目约定为准)。示例:
## 若存在飞书扩展包(包名以官方仓库为准)
npm install -g openclaw-extra-feishu
## 安装后,技能目录通常位于该包下的 skills/ 或由 OpenClaw 配置指向具体包名与安装路径以 OpenClaw 官方文档 或 ClawHub 说明为准。安装完成后用 openclaw skills list 确认是否出现 feishu-doc、feishu-drive 等。
3. 手动安装或链接技能目录
若你本地有技能目录(例如自己用 skill-creator 创建的,或从别处克隆的仓库),可将其放到 OpenClaw 能扫描到的位置:
## 方式 A:复制到 OpenClaw 内置技能目录(需写权限)
OPENCLAW_SKILLS="$HOME/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/skills"
cp -r /path/to/my-skill "$OPENCLAW_SKILLS/"
## 方式 B:若 OpenClaw 支持自定义技能路径(通过环境变量或配置)
export OPENCLAW_SKILLS_EXTRA="/path/to/my-skills"
## 将 my-skill 放在 /path/to/my-skills/my-skill/ 下,内含 SKILL.md每个技能目录内需包含 SKILL.md,OpenClaw 通过该文件识别技能与使用说明。
4. 安装后验证
## 列出当前可用的技能(含内置与已安装)
openclaw skills list
## 查看某技能的说明文档
cat "$(npm root -g)/openclaw/skills/weather/SKILL.md"
## 或按你的 Node 路径:~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/skills/<skill>/SKILL.md许多技能依赖系统已安装的 CLI(如 op、ffmpeg、gh)。若列表显示「已加载」但使用时报错,请检查对应 CLI 是否在 PATH 中:
which op ffmpeg gh gog # 按需替换为技能所需命令5. 内置技能没有安装全时怎么办
「内置技能」指来源为 openclaw-bundled 的技能。若列表里很多显示为 missing,通常有两种情况,按下面顺序处理即可。
情况一:技能目录本身不存在(npm 包里没有或未同步)
先保证 OpenClaw 和技能目录完整:
## 1. 升级到最新版,确保内置技能目录完整
npm update -g openclaw
## 2. 用 ClawHub 把缺失的 bundled 技能补装到本地(技能名与汇总表一致)
clawhub install apple-notes
clawhub install apple-reminders
clawhub install github
## … 按需对每个 missing 的技能执行 clawhub install <技能名>
## 3. 或一次性搜索并安装(按 ClawHub 返回的包名安装)
clawhub search openclaw
clawhub install <包名>情况二:技能目录已有,但显示为 missing(多因依赖 CLI 未装)
很多 bundled 技能依赖系统里的对应 CLI,未安装时会被判为不可用。安装对应依赖后即可变为 ready:
## 示例:常见技能与所需 CLI(macOS 可用 brew 安装)
brew install 1password-cli # 1password
brew install ffmpeg # video-frames
brew install gh # github, gh-issues
# memo、remindctl、things、grizzly 等需在 App Store 或各自官网安装
# 具体每个技能依赖见该技能目录下的 SKILL.md 或文档推荐流程小结
- 运行
openclaw skills list(或当前环境下的等价命令)看哪些是 missing。 - 若缺失的是「技能目录」:用
npm update -g openclaw+clawhub install <技能名>补全。 - 若缺失的是「依赖 CLI」:按该技能的 SKILL.md 或上表安装对应命令行工具,再查一次列表确认变为 ready。
6. 常见问题
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 技能汇总表里显示「missing」 | 未安装该技能或对应 CLI | 用 clawhub install <name> 安装技能;用 brew/system 安装缺失 CLI |
clawhub 命令不存在 | 未安装 ClawHub CLI | npm install -g clawhub 或按官方文档安装 |
| 飞书类技能不出现 | 未安装 openclaw-extra 飞书包 | 安装对应 npm 包并在 OpenClaw 配置中启用/指向其 skills 目录 |
| 安装后仍不加载 | 技能目录无 SKILL.md 或路径未在 OpenClaw 扫描范围内 | 检查目录结构并确认 OPENCLAW_SKILLS / 配置中的技能路径 |
| 升级 OpenClaw 后部分技能消失 | 依赖内置目录,被覆盖或重置 | 用 clawhub update --all 或重新 clawhub install;自定义技能放在 OPENCLAW_SKILLS_EXTRA 等独立目录 |
技能汇总表(57 项)
| 技能 | 说明 | 来源 | 使用方法说明 |
|---|---|---|---|
| feishu-doc 飞书文档 | 飞书文档读写与评论管理 | openclaw-extra | 用户提到飞书文档、云文档、docx 链接或文档评论时使用 |
| feishu-drive 飞书云盘 | 飞书云盘文件管理 | openclaw-extra | 用户提到云空间、文件夹、云盘时使用 |
| feishu-perm 飞书权限 | 飞书文档与文件权限管理 | openclaw-extra | 用户提到分享、权限、协作者时使用 |
| feishu-wiki 飞书知识库 | 飞书知识库导航 | openclaw-extra | 用户提到知识库、wiki 或 wiki 链接时使用 |
| feishu-task 飞书任务 | 飞书任务、任务列表、子任务、评论与附件管理 | openclaw-extra | 用户提到任务、任务列表、子任务、任务评论/附件/链接时使用 |
| feishu-urgent 飞书加急 | 飞书加急消息(buzz)通知 | openclaw-extra | 用户提到消息加急、buzz、提醒或升级时使用 |
| 1password | 1Password CLI (op) 的安装与使用 | openclaw-bundled | 安装 CLI、桌面集成、登录(单/多账号)、通过 op 读取/注入/运行密钥时使用 |
| apple-notes 苹果备忘录 | 通过 memo CLI 管理 Apple 备忘录(创建、查看、编辑、删除、搜索、移动、导出) | openclaw-bundled | 用户要求添加笔记、列出/搜索笔记或管理笔记文件夹时使用 |
| apple-reminders 苹果提醒 | 通过 remindctl 管理 Apple 提醒(列表、添加、编辑、完成、删除),支持列表、日期筛选、JSON/纯文本输出 | openclaw-bundled | 用户要求管理提醒、待办或提醒列表时使用 |
| bear-notes Bear 笔记 | 通过 grizzly CLI 创建、搜索、管理 Bear 笔记 | openclaw-bundled | 用户提到 Bear 或 Bear 笔记时使用 |
| blogwatcher 博客监控 | 使用 blogwatcher CLI 监控博客与 RSS/Atom 源更新 | openclaw-bundled | 用户要求监控博客、RSS 或订阅更新时使用 |
| blucli | BluOS CLI (blu):发现、播放、分组、音量 | openclaw-bundled | 用户提到 BluOS、Blu 音箱或多房间音频时使用 |
| bluebubbles | 通过 BlueBubbles 发送或管理 iMessage | openclaw-bundled | 需要发 iMessage 时使用;通过通用消息工具,channel=bluebubbles |
| camsnap | 从 RTSP/ONVIF 摄像头抓取帧或片段 | openclaw-bundled | 用户提到摄像头、监控、RTSP、ONVIF 或抓帧时使用 |
| clawhub | 使用 ClawHub CLI 在 clawhub.com 搜索、安装、更新、发布 Agent 技能 | openclaw-bundled | 需要按需拉取新技能、同步到最新/指定版本或发布技能包时使用 |
| coding-agent 编程代理 | 通过后台进程将编程任务委托给 Codex、Claude Code 或 Pi | openclaw-bundled | 开发新功能/应用、审查 PR、重构大代码库、需文件探索的迭代编码时使用;不用于简单单行修复、仅读代码、~/clawd 工作区;需支持 pty:true 的 bash |
| discord | 通过消息工具 (channel=discord) 进行 Discord 操作 | openclaw-bundled | 用户提到 Discord、频道或机器人时使用 |
| eightctl | 控制 Eight Sleep 床垫:状态、温度、闹钟、日程 | openclaw-bundled | 用户提到 Eight Sleep、床垫温度或睡眠设备时使用 |
| gemini | Gemini CLI:一次性问答、摘要与生成 | openclaw-bundled | 用户要求用 Gemini 做问答、总结或生成时使用 |
| gh-issues | 拉取 GitHub issues、派生子代理实现修复并开 PR、监控并处理 PR 评论 | openclaw-bundled | 使用 /gh-issues [owner/repo] 及 –label、–limit、–milestone、–assignee、–fork、–watch、–reviews-only、–cron、–dry-run、–model、–notify-channel 等参数 |
| gifgrep | 用 CLI/TUI 搜索 GIF 源、下载结果、提取静帧/表 | openclaw-bundled | 用户要求搜索 GIF、下载动图或提取帧时使用 |
| github | 通过 gh CLI:issues、PR、CI、代码审查、API 查询 | openclaw-bundled | 查 PR/CI、创建/评论 issue、筛选 PR/issue、查看 run 日志时使用;不用于复杂 Web 操作、跨多仓库批量、gh 未登录时 |
| gog Google 工作区 | Gmail、日历、Drive、通讯录、Sheets、Docs 的 CLI | openclaw-bundled | 用户提到 Gmail、日历、Drive、文档、表格时使用 |
| goplaces | 通过 goplaces CLI 调用 Google Places API (New):文本搜索、地点详情、解析、评论 | openclaw-bundled | 需要人类可读的地点查询或脚本用 JSON 时使用 |
| healthcheck 健康检查 | 主机安全加固与风险偏好配置 | openclaw-bundled | 用户询问安全审计、防火墙/SSH/更新加固、风险态势、暴露审查、OpenClaw 定时任务或版本状态时使用 |
| himalaya | 通过 IMAP/SMTP 管理邮件的 CLI:列出、读、写、回复、转发、搜索、整理,支持多账号与 MML | openclaw-bundled | 用户要求用终端管理邮箱、查信、发信时使用 |
| imsg | iMessage/SMS CLI:列出会话、历史,通过 Messages.app 发消息 | openclaw-bundled | 用户要求发 iMessage、查聊天记录时使用(非 BlueBubbles 场景) |
| mcporter | 使用 mcporter CLI 列出、配置、鉴权并直接调用 MCP 服务器/工具(HTTP 或 stdio) | openclaw-bundled | 需要调用 MCP、编辑 MCP 配置或生成 CLI/类型时使用 |
| model-usage 模型用量 | 用 CodexBar CLI 本地成本数据汇总 Codex/Claude 按模型用量 | openclaw-bundled | 用户问 codexbar 模型级用量/成本或需要可脚本化的按模型汇总时使用 |
| nano-banana-pro | 通过 Gemini 3 Pro Image 生成或编辑图片 | openclaw-bundled | 用户要求用 Nano Banana Pro 做图或改图时使用 |
| nano-pdf | 使用 nano-pdf CLI 用自然语言指令编辑 PDF | openclaw-bundled | 用户要求用自然语言修改 PDF 时使用 |
| notion | Notion API:创建和管理页面、数据库、块 | openclaw-bundled | 用户提到 Notion、页面、数据库或块时使用 |
| obsidian | 通过 obsidian-cli 操作 Obsidian 仓库(纯 Markdown)并做自动化 | openclaw-bundled | 用户提到 Obsidian、 vault、笔记库时使用 |
| openai-image-gen | 通过 OpenAI Images API 批量生成图片;随机提示采样 + index.html 图库 | openclaw-bundled | 用户要求批量出图或建图库时使用 |
| openai-whisper | 使用 Whisper CLI 本地语音转文字(无需 API 密钥) | openclaw-bundled | 用户要求本地转写音频时使用 |
| openai-whisper-api | 通过 OpenAI 音频转录 API (Whisper) 转写音频 | openclaw-bundled | 用户要求用云端 Whisper 转写时使用 |
| openhue | 通过 OpenHue CLI 控制飞利浦 Hue 灯与场景 | openclaw-bundled | 用户提到 Hue、智能灯、场景时使用 |
| oracle | 使用 oracle CLI 的最佳实践(提示与文件打包、引擎、会话、文件附件) | openclaw-bundled | 复杂提示、多文件打包、会话或附件模式时使用 |
| ordercli | 仅 Foodora 的 CLI:历史订单与当前订单状态(Deliveroo 开发中) | openclaw-bundled | 用户问 Foodora 订单、外卖状态时使用 |
| peekaboo | 使用 Peekaboo CLI 截取并自动化 macOS 界面 | openclaw-bundled | 用户要求截屏、UI 自动化、macOS 界面操作时使用 |
| sag | ElevenLabs 文本转语音,mac 风格 say 体验 | openclaw-bundled | 用户要求 TTS、朗读或 ElevenLabs 时使用 |
| session-logs 会话日志 | 使用 jq 搜索与分析自己的会话日志(较早/父级对话) | openclaw-bundled | 用户要求查历史会话、分析对话时使用 |
| sherpa-onnx-tts | 通过 sherpa-onnx 本地文本转语音(离线、无云) | openclaw-bundled | 用户要求离线 TTS、不联网朗读时使用 |
| skill-creator 技能创建器 | 创建或更新 AgentSkills,含脚本、引用与资源的设计与打包 | openclaw-bundled | 用户要设计、结构化或打包新技能时使用 |
| slack | 通过 slack 工具从 OpenClaw 控制 Slack | openclaw-bundled | 用户提到 Slack、反应、置顶频道/DM 时使用 |
| songsee | 使用 songsee CLI 从音频生成频谱图与特征面板可视化 | openclaw-bundled | 用户要求音频可视化、频谱图时使用 |
| sonoscli | 控制 Sonos 音箱:发现/状态/播放/音量/分组 | openclaw-bundled | 用户提到 Sonos、多房间播放时使用 |
| spotify-player | 通过 spogo(优先)或 spotify_player 在终端控制 Spotify 播放与搜索 | openclaw-bundled | 用户要求用终端控制 Spotify 时使用 |
| summarize | 对 URL、播客、本地文件做摘要或提取文本/转录 | openclaw-bundled | 用户要求「转写这个 YouTube/视频」或摘要链接/播客时使用 |
| things-mac | 通过 things CLI 管理 Things 3(URL 添加/更新项目与待办;本地读/搜/列) | openclaw-bundled | 用户要求往 Things 加任务、列收件箱/今天/即将到来、搜索任务或查看项目/区域/标签时使用 |
| tmux | 通过发送按键并抓取 pane 输出远程控制 tmux 会话 | openclaw-bundled | 用户要求控制 tmux、在 pane 里跑交互式 CLI 时使用 |
| trello | 通过 Trello REST API 管理看板、列表、卡片 | openclaw-bundled | 用户提到 Trello、看板、卡片时使用 |
| video-frames | 使用 ffmpeg 从视频中提取帧或短视频片段 | openclaw-bundled | 用户要求从视频提帧、剪片段时使用 |
| voice-call 语音通话 | 通过 OpenClaw voice-call 插件发起语音通话 | openclaw-bundled | 用户要求发起语音通话时使用 |
| wacli | 通过 wacli CLI 发 WhatsApp 或搜索/同步 WhatsApp 历史(非普通用户聊天) | openclaw-bundled | 用户要求发 WhatsApp、查历史或同步时使用 |
| weather 天气 | 通过 wttr.in 或 Open-Meteo 获取当前天气与预报 | openclaw-bundled | 用户问某地天气、温度、预报时使用;不用于历史天气、预警或详细气象分析;无需 API 密钥 |
| xurl X/Twitter | 对 X (Twitter) API 做认证请求的 CLI:发推、回复、引用、搜索、读推、关注、DM、上传媒体等 | openclaw-bundled | 用户提到发推、搜推、X API、Twitter 时使用 |
详细技能说明
1. 1password
作用: 安全地管理和注入密码、密钥等敏感信息 使用方法:
## 安装 op CLI
brew install --cask 1password-cli
## 登录 1Password
op account add
## 读取密码
op item get "GitHub" --fields password配置: 需要 1Password 账户,桌面应用集成或服务账户令牌
2. clawhub
作用: OpenClaw 技能市场,类似 npm 但针对技能 使用方法:
## 搜索技能
clawhub search weather
## 安装技能
clawhub install weather
## 更新技能
clawhub update weather配置: 需要 clawhub.com 访问,可能需登录
3. gifgrep
作用: 从多个 GIF 提供商搜索、下载和处理 GIF 使用方法:
## 搜索 GIF
gifgrep search "cat dancing"
## 下载结果
gifgrep download --id 12345
## 提取帧
gifgrep frames --input cat.gif --output frames/配置: 可能需要 API 密钥(Tenor、Giphy 等)
4. gog
作用: Google Workspace 全套工具 CLI 集成 使用方法:
## 查看 Gmail
gog mail list --unread
## 日历事件
gog calendar events --today
## Drive 文件
gog drive list --folder root配置: 需要 Google Cloud 项目,OAuth 2.0 凭据
5. healthcheck
作用: 系统安全硬化和风险配置检查 使用方法:
## 运行安全检查
healthcheck audit
## 检查防火墙
healthcheck firewall
## 查看风险容忍度
healthcheck risk配置: 需要系统权限,可配置 cron 定期检查
6. mcporter
作用: 模型上下文协议(MCP)服务器管理 使用方法:
## 列出 MCP 服务器
mcporter list
## 调用服务器工具
mcporter call --server filesystem --tool read_file --args '{"path":"/tmp/test.txt"}'
## 生成类型定义
mcporter types --server filesystem --output ./types.ts配置: 需要 MCP 服务器配置(HTTP 或 stdio)
7. obsidian
作用: Obsidian 笔记库的 CLI 自动化 使用方法:
## 列出笔记
obsidian list --vault personal
## 创建笔记
obsidian create --title "会议记录" --vault work
## 搜索内容
obsidian search "TODO" --vault personal配置: 需要 Obsidian 安装,指定库路径
8. openhue
作用: Philips Hue 智能灯光系统控制 使用方法:
## 发现 Hue Bridge
openhue discover
## 列出灯光
openhue lights list
## 控制灯光
openhue lights set --id 1 --on --brightness 80 --color "#FF5500"
## 创建场景
openhue scenes create --name "阅读模式" --lights 1,2,3 --brightness 60配置: 需要 Hue Bridge IP 和 API 用户名
9. oracle
作用: 高级提示工程和文件处理工具 使用方法:
## 复杂提示处理
oracle prompt --file requirements.txt --engine gpt-4
## 文件打包
oracle bundle --input ./src --output bundle.json
## 会话管理
oracle session --name project-analysis --attach ./docs/配置: 无特殊依赖,支持多种 LLM 引擎
10. ordercli
作用: 外卖平台订单管理(目前支持 Foodora) 使用方法:
## 查看历史订单
ordercli history --limit 10
## 当前订单状态
ordercli status
## 订单详情
ordercli detail --order-id 123456配置: 需要外卖平台账户登录(Foodora)
11. skill-creator
作用: 创建、开发和发布 OpenClaw 技能 使用方法:
## 创建新技能
skill-creator init --name my-skill --description "我的自定义技能"
## 添加工具
skill-creator add-tool --name fetch-data --description "获取数据"
## 打包发布
skill-creator pack --output ./dist/配置: 需要 Node.js,了解技能结构
12. video-frames
作用: 从视频文件中提取帧或短片段 使用方法:
## 提取关键帧
video-frames extract --input video.mp4 --output frames/ --method keyframes
## 创建缩略图
video-frames thumbnail --input video.mp4 --time 00:01:30
## 提取片段
video-frames clip --input video.mp4 --start 00:00:10 --duration 5配置: 需要 ffmpeg 安装
13. wacli
作用: WhatsApp 消息自动化(非普通聊天) 使用方法:
## 发送消息
wacli send --to "+1234567890" --message "Hello"
## 搜索历史
wacli search --query "重要会议" --limit 20
## 同步联系人
wacli contacts sync配置: 需要 WhatsApp Web 连接,QR 码登录
14. weather
作用: 天气查询和预报 使用方法:
## 当前天气
weather current --location "Shanghai"
## 天气预报
weather forecast --location "Beijing" --days 3
## 详细报告
weather detail --location "New York" --units metric配置: 使用 wttr.in 或 Open-Meteo,无需 API 密钥
技能使用通用模式
1. 技能激活
大多数技能在相关上下文中自动激活,或通过读取技能目录中的 SKILL.md 文件。
2. 配置检查
## 检查技能是否可用
openclaw skills list
## 查看特定技能文档
cat ~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/skills/weather/SKILL.md3. 权限要求
- 🔓 无特殊权限: weather, oracle, gifgrep
- 🔐 需要配置: 1password, gog, openhue, wacli
- ⚠️ 需要系统权限: healthcheck, video-frames (ffmpeg)
- 🌐 需要网络: 所有涉及外部服务的技能
4. 错误处理
## 常见错误
## 1. 缺少依赖: 安装所需 CLI 工具
## 2. 配置缺失: 检查 ~/.openclaw/config/
## 3. 权限不足: 检查文件权限或使用 sudo
## 4. 网络问题: 检查连接和 API 密钥5. 技能开发
## 基于现有技能学习
cp -r ~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/skills/weather/ ./my-skill/
## 修改并测试
cd my-skill
## 编辑 SKILL.md 和工具文件推荐技能组合
基础日常使用
- weather - 天气查询
- obsidian - 笔记管理
- 1password - 密码管理
智能家居自动化
- openhue - 灯光控制
- weather + openhue - 根据天气自动调整灯光
工作效率套件
- gog - Google Workspace
- obsidian - 知识管理
- oracle - 复杂任务处理
开发者工具集
- skill-creator - 技能开发
- mcporter - MCP 集成
- video-frames - 媒体处理
故障排除
技能不工作?
- 检查依赖:
which op,which ffmpeg等 - 检查配置:
ls -la ~/.openclaw/config/ - 查看日志:
tail -f ~/.openclaw/logs/skills.log - 更新技能:
clawhub update [skill-name]
需要新技能?
- 搜索市场:
clawhub search [keyword] - 自行开发: 使用 skill-creator
- 请求功能: https://github.com/openclaw/openclaw/issues
安全注意事项
| 技能 | 风险等级 | 建议 |
|---|---|---|
| 1password | 高 | 保护主密码,定期轮换令牌 |
| gog | 中 | 使用最小权限 OAuth 范围 |
| wacli | 中 | 使用备用 WhatsApp 账号 |
| openhue | 低 | 限制本地网络访问 |
| weather | 低 | 无敏感数据 |
相关阅读
- 虎嗅网:AI助手OpenClaw的实践与应用 - 关于OpenClaw在实际场景中的应用案例和深度分析
