上一篇链接 https://articles.zsxq.com/id_u3iowjwhtdrs.html
完整技能列表 (Skills)
小龙虾作为个人 AI 助手，具备丰富的技能（Skills）。技能是预定义的能力模块，让 AI 能够执行具体任务。 OpenClaw 完整版内置 51 个技能 + 30+ 扩展插件，以下是完整列表：
📦 一、内置技能 (51个)
📝生产力和笔记(8个)Skill
apple-notes
通过 memo CLI 管理 Apple Notes（创建/查看/编辑/删除/搜索/移动/导出）
apple-reminders
通过 remindctl CLI 管理 Apple Reminders（列表/添加/编辑/完成/删除）
bear-notes
通过 grizzly CLI 创建、搜索、管理 Bear 笔记应用
notion
Notion API - 创建和管理页面、数据库和块
obsidian
使用 obsidian-cli 操作 Obsidian vault（纯 Markdown 笔记）
session-logs
搜索和分析自己的会话日志（使用 jq）
things-mac
通过 things CLI 管理 Things 3（添加/更新项目+待办事项）
trello
通过 Trello REST API 管理看板、列表和卡片
💬通讯和社交(7个)Skill
bird
X/Twitter CLI - 阅读、搜索、发布、互动（通过 cookies 认证）
discord
通过 discord tool 控制 Discord（发消息/反应/贴纸/投票/线程/钉选）
imsg
iMessage/SMS CLI - 列表、历史、监听、发送消息
slack
通过 slack tool 控制 Slack（反应/钉选/发送/编辑/删除消息）
voice-call
通过 OpenClaw voice-call 插件启动语音通话
wacli
WhatsApp CLI - 发送消息、搜索/同步 WhatsApp 历史记录
himalaya
CLI 管理邮件 (IMAP/SMTP) - 列表/读/写/回复/转发/搜索
🎨媒体和内容(9个)Skill
blogwatcher
使用 blogwatcher CLI 监控博客和 RSS/Atom 源更新
camsnap
从 RTSP/ONVIF 相机捕获帧或视频剪辑
gifgrep
搜索 GIF 提供商、下载结果、提取静帧
nano-pdf
使用 nano-pdf CLI 通过自然语言指令编辑 PDF
nano-banana-pro
通过 Gemini 3 Pro Image (Nano Banana Pro) 生成或编辑图像
openai-image-gen
通过 OpenAI Images API 批量生成图像 + index.html 画廊
summarize
从 URL、播客、本地文件总结或提取文本/转录内容
video-frames
使用 ffmpeg 从视频提取帧或短剪辑
gog
Google Workspace CLI - Gmail、Calendar、Drive、Contacts、Sheets、Docs
🏠智能家居和设备控制(6个)Skill
blucli
BluOS CLI - 发现、播放、分组、音量控制
eightctl
控制 Eight Sleep pods（状态/温度/警报/日程）
openhue
通过 OpenHue CLI 控制 Philips Hue 灯光/场景
peekaboo
使用 Peekaboo CLI 捕获和自动化 macOS UI
sonoscli
控制 Sonos 扬声器（发现/状态/播放/音量/分组）
tmux
通过发送击键和爬取窗格输出远程控制 tmux 会话
🎤音频和语音(5个)Skill
openai-whisper
本地语音转文本（Whisper CLI，无需 API 密钥）
openai-whisper-api
通过 OpenAI Audio Transcriptions API 转录音频 (Whisper)
sag
ElevenLabs 文本转语音 - mac 风格的 say UX
sherpa-onnx-tts
本地文本转语音（sherpa-onnx，离线、无需云服务）
songsee
使用 songsee CLI 从音频生成频谱图和特征面板可视化
🤖工具和代理(5个)Skill
clawhub
使用 ClawHub CLI 搜索、安装、更新、发布 agent skills
coding-agent
后台运行 Codex CLI、Claude Code、OpenCode 或 Pi Coding Agent
mcporter
使用 mcporter CLI 列表、配置、认证、调用 MCP 服务器/工具
oracle
oracle CLI 最佳实践（prompt + 文件绑定、引擎、会话、附件）
skill-creator
创建或更新 AgentSkills - 设计、结构、打包 skills
🔐开发和安全(3个)Skill
1password
1Password CLI (op) - 设置、启用集成、登录、读取/注入/运行秘密
github
使用 gh CLI 与 GitHub 交互（issue、PR、CI runs、高级查询）
model-usage
CodexBar CLI 本地成本使用 - 按模型总结使用情况
📍地理位置和食品(3个)Skill
goplaces
Google Places API (New) CLI - 文本搜索、地点详情、解析、评论
local-places
Google Places API 代理 - 在本地主机搜索地点
food-order
Foodora 订单重新订购 + 使用 ordercli 跟踪 ETA/状态
🎮娱乐和其他(5个)Skill
gemini
Gemini CLI - 一次性问答、总结、生成
ordercli
Foodora CLI - 检查过往订单和活跃订单状态
spotify-player
Spotify 播放 - 通过 spogo (首选) 或 spotify_player 终端播放/搜索
weather
获取当前天气和预报（无需 API 密钥）
canvas
创建和编辑草图/图表
二、扩展插件 (Extensions, 30+个)
📱通讯渠道扩展(13个)Extension
telegram
Telegram 消息传递集成
slack
Slack 工作区集成
discord
Discord 服务器集成
WhatsApp 消息传递
signal
Signal 私密消息
imessage
iMessage/iOS 集成
msteams
Microsoft Teams 企业集成
googlechat
Google Chat 工作区集成
line
LINE 消息应用
matrix
Matrix/Synapse 聊天协议
mattermost
Mattermost 开源团队聊天
nextcloud-talk
Nextcloud Talk 自托管聊天
zalo
Zalo 越南消息应用
📡非聊天渠道(4个)Extension
bluebubbles
BlueBubbles iMessage 外部渠道插件
voice-call
语音通话功能
twitch
Twitch 流媒体集成
nostr
Nostr 去中心化协议支持
🧠内存和数据库(3个)Extension
memory-core
核心内存管理基础
memory-lancedb
LanceDB 向量数据库支持
zalouser
Zalo 用户管理
🔑认证和工具(6个)Extension
llm-task
通用 JSON-only LLM 工具 - 从工作流调用的结构化任务
lobster
类型化工作流工具 - 可恢复的审批流程
google-gemini-cli-auth
Gemini CLI 认证集成
google-antigravity-auth
Google Antigravity 认证
minimax-portal-auth
Minimax 门户认证
qwen-portal-auth
Qwen 通义千问门户认证
⚙️系统和其他(4个)Extension
copilot-proxy
GitHub Copilot 代理集成
diagnostics-otel
OpenTelemetry 诊断追踪
tlon
Tlon/Urbit 集成
open-prose
OpenProse VM skill pack（附 /prose 斜杠命令）
三、核心工具 (Core Tools, 25+个)
🌐浏览器和交互(3个)Tool
browser
浏览器自动化（开/关标签页、导航、截图、PDF）
canvas
节点画布控制（显示/隐藏/导航/eval/快照）
image
图像理解和处理
🔄会话和通讯(12个)Tool
agents-list
列出可用代理
cron
安排 cron 定时作业
gateway
网关和节点通信
message
消息发送和管理
nodes
节点发现和管理
tts
文本转语音
web
Web 获取和搜索
session-status
获取会话状态
sessions-history
查询会话历史
sessions-list
列出活跃会话
sessions-send
向其他会话发送消息
sessions-spawn
创建子代理会话
📢渠道特定工具(4个)Tool
discord-actions
Discord 消息操作（反应/钉选/编辑/删除）
slack-actions
Slack 消息操作（反应/钉选/编辑/删除）
telegram-actions
Telegram 消息操作（反应/钉选/编辑/删除）
memory
内存和知识图谱管理
💻Bash 和 Pi 工具(7个)Tool
execTool
执行 shell 命令
processTool
进程管理
pi-tools
核心编码和文件操作
pi-tools.read
文件读取操作
pi-tools.abort
中止操作
pi-tools.policy
工具策略和权限
channel-tools
通道特定操作和消息操作
51
内置 Skills
30+
Extensions
25+
Core Tools
∞
自定义扩展
如何开发自定义技能？
每个技能都是一个标准的 Tool 定义，包含名称、描述和处理函数：
技能文件放置在 skills/ 目录下，每个技能一个文件夹，包含 SKILL.md 描述文件。 详见 技能开发文档
💡 小白入门建议
以上列出了 OpenClaw 完整版的所有技能。作为入门，建议先从以下几个开始：
- weather - 天气查询，已在运行机制章节实现示例
- github - 如果你是开发者，管理 Issue/PR 很实用
- telegram/discord/slack - 选择你常用的通讯渠道
- summarize - 快速总结网页/文章内容
- apple-reminders / things-mac - 待办事项管理
技能详细教程
以下是每个内置技能的详细使用教程，包含安装步骤、命令用法和实际示例。 教程按技能分类排列，方便查找学习。
📝
apple-notes
通过 memo CLI 在 macOS 上管理 Apple Notes 备忘录
macOS Only生产力笔记
📌 功能简介
apple-notes 技能让小龙虾能够直接管理你的 Apple Notes 备忘录应用。 你可以通过自然语言让 AI 帮你创建笔记、搜索笔记、编辑笔记、移动笔记到不同文件夹、甚至导出为 HTML 或 Markdown 格式。
底层使用 memo CLI 工具实现。
🔧 安装步骤
方式一：Homebrew 安装（推荐）
# 添加 tap 源
brew tap antoniorodr/memo
# 安装 memo CLI
brew install antoniorodr/memo/memo
方式二：pip 安装
# 克隆仓库
git clone https://github.com/antoniorodr/memo.git
cd memo
# 安装
pip install .
验证安装
memo --version
# 输出: memo version x.x.x
⚠️ 权限设置
首次运行时，macOS 会提示授权访问 Notes.app。请前往：
系统设置 → 隐私与安全性 → 自动化
勾选允许终端/iTerm 访问 Notes.app
📖 命令参考
memo notes列出所有笔记显示全部笔记列表memo notes -f "文件夹"按文件夹筛选memo notes -f "工作"memo notes -s "关键词"搜索笔记（模糊匹配）memo notes -s "会议"memo notes -a创建新笔记（交互式）打开编辑器输入内容memo notes -a "标题"快速创建带标题的笔记memo notes -a "购物清单"memo notes -e编辑笔记（交互式选择）选择要编辑的笔记memo notes -d删除笔记（交互式选择）选择要删除的笔记memo notes -m移动笔记到其他文件夹选择笔记和目标文件夹memo notes -ex导出笔记为 HTML/Markdown选择笔记并导出
💬 与小龙虾对话示例
示例 1：创建笔记
你： 帮我创建一个笔记，标题是"周末计划"，内容是：1. 去超市购物 2. 看电影 3. 运动健身
小龙虾： 好的，我来帮你创建笔记...
# 小龙虾执行的命令
memo notes -a "周末计划"
示例 2：搜索笔记
你： 找一下我之前写的关于"项目会议"的笔记
小龙虾： 让我搜索一下...
memo notes -s "项目会议"
# 返回匹配的笔记列表
示例 3：查看特定文件夹的笔记
你： 列出"工作"文件夹里的所有笔记
小龙虾： 正在查看工作文件夹...
memo notes -f "工作"
示例 4：导出笔记
你： 把我的"技术笔记"导出为 Markdown 格式
小龙虾： 好的，正在导出...
memo notes -ex
# 选择"技术笔记"并导出为 .md 文件
⚠️ 注意事项
- 仅限 macOS - 此技能依赖 Apple Notes.app，无法在 Windows/Linux 上使用
- 图片限制 - 无法编辑包含图片或附件的笔记
- 交互式命令 - 部分命令（如编辑、删除）需要交互式选择，小龙虾会自动处理
- iCloud 同步 - 笔记会自动同步到 iCloud（如果启用）
🔗 相关技能
apple-remindersnotionobsidianbear-notes
⏰
apple-reminders
通过 remindctl CLI 在 macOS 上管理 Apple 提醒事项
macOS Only生产力待办
📌 功能简介
apple-reminders 技能让小龙虾能够直接管理你的 Apple Reminders 提醒事项应用。 你可以通过自然语言创建提醒、查看今日/本周待办、标记完成、管理提醒列表等。支持日期筛选和多种输出格式。
底层使用 remindctl CLI 工具实现。
🔧 安装步骤
方式一：Homebrew 安装（推荐）
brew install steipete/tap/remindctl
方式二：从源码编译
# 克隆仓库
git clone https://github.com/steipete/remindctl.git
cd remindctl
# 编译
pnpm install && pnpm build
# 二进制文件位于 ./bin/remindctl
验证安装 & 授权
# 检查权限状态
remindctl status
# 请求访问权限
remindctl authorize
⚠️ 权限设置
如果权限被拒绝，请前往：
系统设置 → 隐私与安全性 → 提醒事项
勾选允许终端/remindctl 访问提醒事项
👀 查看提醒
remindctl显示今日提醒（默认）remindctl today今日提醒remindctl tomorrow明日提醒remindctl week本周提醒remindctl overdue已逾期的提醒remindctl upcoming即将到来的提醒remindctl completed已完成的提醒remindctl all所有提醒remindctl 2026-03-15指定日期的提醒
📋 管理列表
remindctl list列出所有列表remindctl list 工作显示"工作"列表中的提醒remindctl list 项目 --create创建新列表"项目"remindctl list 工作 --rename 办公重命名列表remindctl list 临时 --delete删除列表
✏️ 创建与管理提醒
创建提醒
# 快速添加
remindctl add "买牛奶"
# 指定列表和截止日期
remindctl add --title "给妈妈打电话" --list 个人 --due tomorrow
# 指定具体时间
remindctl add --title "开会" --due "2026-03-05 14:00"
编辑提醒
# 通过 ID 编辑标题和截止日期
remindctl edit 1 --title "新标题" --due 2026-03-10
完成提醒
# 标记一个或多个提醒为完成
remindctl complete 1 2 3
删除提醒
# 通过 ID 删除（需要 --force 确认）
remindctl delete 4A83 --force
📤 输出格式
--jsonJSON 格式输出脚本自动化处理--plainTSV 纯文本格式管道处理--quiet只显示数量快速统计
# 示例：获取今日提醒的 JSON
remindctl today --json
📅 支持的日期格式
--due 参数支持以下格式：
- today / tomorrow / yesterday - 相对日期
- 2026-03-15 - 年-月-日
- 2026-03-15 14:30 - 年-月-日 时:分
- 2026-03-15T14:30:00Z - ISO 8601 格式
💬 与小龙虾对话示例
示例 1：创建提醒
你： 提醒我明天下午3点开会
小龙虾： 好的，我来创建提醒...
remindctl add --title "开会" --due "tomorrow 15:00"
示例 2：查看今日待办
你： 我今天有什么待办事项？
小龙虾： 让我查看一下今日提醒...
remindctl today
# 返回今日所有提醒列表
示例 3：查看逾期任务
你： 有没有过期还没完成的任务？
小龙虾： 正在检查逾期提醒...
remindctl overdue
示例 4：标记任务完成
你： 把"买牛奶"这个任务标记为完成
小龙虾： 好的，正在标记完成...
# 先查找任务ID，然后标记完成
remindctl complete 1
示例 5：创建新列表
你： 帮我创建一个叫"健身计划"的提醒列表
小龙虾： 好的，正在创建列表...
remindctl list 健身计划 --create
⚠️ 注意事项
- 仅限 macOS - 此技能依赖 Apple Reminders.app，无法在 Windows/Linux 上使用
- SSH 使用 - 如果通过 SSH 远程运行，需要在运行命令的 Mac 上授权
- iCloud 同步 - 提醒会自动同步到 iCloud（如果启用）
- ID 标识 - 每个提醒都有唯一ID，编辑/完成/删除时需要使用ID
🔗 相关技能
🐻
bear-notes
通过 grizzly CLI 创建、搜索和管理 Bear 笔记
macOS Only生产力笔记
📌 功能简介
bear-notes 技能让小龙虾能够直接管理你的 Bear 笔记应用。 Bear 是 macOS/iOS 上广受欢迎的 Markdown 笔记应用，支持标签管理、富文本编辑和多端同步。 通过此技能，你可以创建笔记、添加标签、追加内容、搜索笔记等。
底层使用 grizzly CLI 工具，通过 Bear 的 x-callback-url 机制实现。
📋 前置要求
- Bear 应用 - 需要已安装并正在运行 Bear app
- Go 环境 - 安装 grizzly 需要 Go 语言环境
- API Token - 部分操作需要 Bear API Token（详见下方）
🔧 安装步骤
步骤一：安装 grizzly CLI
# 使用 Go 安装
go install github.com/tylerwince/grizzly/cmd/grizzly@latest
步骤二：获取 Bear API Token
部分操作（add-text、tags、open-note --selected）需要 API Token：
# 1. 在 Bear 中获取 Token
# 打开 Bear → 帮助 → API Token → 复制 Token
# 2. 保存 Token 到配置文件
mkdir -p ~/.config/grizzly
echo "YOUR_TOKEN_HERE" > ~/.config/grizzly/token
步骤三：创建配置文件（可选）
# ~/.config/grizzly/config.toml
token_file = "~/.config/grizzly/token"
callback_url = "http://127.0.0.1:42123/success"
timeout = "5s"
⚠️ 重要提示
Bear 应用必须正在运行，grizzly 命令才能正常工作。
📖 核心命令
创建笔记
# 通过管道输入内容创建笔记
echo "笔记内容" | grizzly create --title "我的笔记" --tag work
# 创建空白笔记
grizzly create --title "快速笔记" --tag inbox < /dev/null
# 从文件创建笔记
cat notes.md | grizzly create --title "从文件导入" --tag imported
打开/读取笔记
# 通过 ID 打开笔记并获取 JSON 数据
grizzly open-note --id "NOTE_ID" --enable-callback --json
追加内容
# 向已有笔记追加内容（需要 Token）
echo "追加的内容" | grizzly add-text --id "NOTE_ID" --mode append \
--token-file ~/.config/grizzly/token
标签管理
# 列出所有标签（需要 Token）
grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token
# 按标签搜索笔记
grizzly open-tag --name "work" --enable-callback --json
⚙️ 常用参数
--title笔记标题--tag添加标签（可多次使用）--id笔记的唯一标识符--mode追加模式：append（末尾）/ prepend（开头）--enable-callback等待 Bear 响应（读取数据时必须）--json以 JSON 格式输出--token-file指定 API Token 文件路径--dry-run预览 URL，不实际执行--print-url显示 x-callback-url
📁 配置优先级
grizzly 按以下顺序读取配置：
- 命令行参数（最高优先级）
- 环境变量：GRIZZLY_TOKEN_FILE、GRIZZLY_CALLBACK_URL、GRIZZLY_TIMEOUT
- 当前目录的 .grizzly.toml
- ~/.config/grizzly/config.toml
💬 与小龙虾对话示例
示例 1：创建带标签的笔记
你： 帮我在 Bear 里创建一个笔记，标题是"项目计划"，标签是 work，内容是：1. 需求分析 2. 设计方案 3. 开发实现
小龙虾： 好的，正在创建 Bear 笔记...
echo "1. 需求分析\n2. 设计方案\n3. 开发实现" | \
grizzly create --title "项目计划" --tag work
示例 2：查看所有标签
你： 显示我 Bear 里的所有标签
小龙虾： 正在获取标签列表...
grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token
示例 3：搜索特定标签的笔记
你： 找出所有带 "reading" 标签的笔记
小龙虾： 正在搜索...
grizzly open-tag --name "reading" --enable-callback --json
示例 4：向笔记追加内容
你： 在"项目计划"笔记末尾添加：4. 测试验收
小龙虾： 好的，正在追加内容...
# 先找到笔记 ID，然后追加
echo "4. 测试验收" | grizzly add-text --id "NOTE_ID" --mode append \
--token-file ~/.config/grizzly/token
示例 5：快速记录想法
你： 快速记一下：明天要买机票
小龙虾： 已记录到 Bear...
echo "明天要买机票" | grizzly create --title "快速记录" --tag inbox
⚠️ 注意事项
- 仅限 macOS - Bear 是 Apple 生态应用，无法在 Windows/Linux 上使用
- Bear 必须运行 - 执行命令前请确保 Bear app 已打开
- Note ID - 笔记 ID 是 Bear 内部标识符，可通过笔记信息或回调获取
- Token 安全 - API Token 请妥善保管，不要泄露
- 回调模式 - 读取数据时必须使用 --enable-callback 参数
🔗 相关技能
📝
notion
通过 Notion API 创建和管理页面、数据库和块
跨平台生产力笔记
📌 功能简介
notion 技能让小龙虾能够直接操作你的 Notion 工作区。 Notion 是一款强大的全能型工作空间，支持笔记、文档、数据库、项目管理等多种功能。 通过此技能，你可以创建页面、管理数据库（Data Sources）、查询和更新内容等。
底层使用 Notion REST API，支持页面、数据库、块的完整 CRUD 操作。
📋 前置要求
- Notion 账号 - 需要有 Notion 账号并创建工作区
- API Key - 需要创建 Notion Integration 并获取 API Key
- 页面授权 - 需要将目标页面/数据库与 Integration 连接
🔧 设置步骤
步骤一：创建 Notion Integration
- 访问 https://notion.so/my-integrations
- 点击「+ New integration」创建新的集成
- 填写名称（如 "OpenClaw Assistant"），选择关联的工作区
- 创建后复制「Internal Integration Secret」（以 ntn_ 或 secret_ 开头）
步骤二：保存 API Key
# 创建配置目录并保存 API Key
mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
步骤三：授权页面/数据库
- 在 Notion 中打开要操作的页面或数据库
- 点击右上角「...」菜单
- 选择「Connect to」→ 选择你刚创建的 Integration
- 只有被授权的页面才能通过 API 访问
⚠️ 重要提示
每个 API 请求都需要携带 Notion-Version 请求头，当前最新版本为 2025-09-03。
📖 API 基础
所有 API 请求都需要以下 Headers：
# 基础请求格式
NOTION_KEY=$(cat ~/.config/notion/api_key)
curl -X GET "https://api.notion.com/v1/..." \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json"
⚙️ 核心操作
搜索页面和数据库
curl -X POST "https://api.notion.com/v1/search" \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{"query": "搜索关键词"}'
获取页面信息
curl "https://api.notion.com/v1/pages/{page_id}" \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03"
获取页面内容（blocks）
curl "https://api.notion.com/v1/blocks/{page_id}/children" \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03"
在数据库中创建页面
curl -X POST "https://api.notion.com/v1/pages" \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{
"parent": {"database_id": "xxx"},
"properties": {
"Name": {"title": [{"text": {"content": "新条目"}}]},
"Status": {"select": {"name": "Todo"}}
}
}'
查询数据库
curl -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{
"filter": {"property": "Status", "select": {"equals": "Active"}},
"sorts": [{"property": "Date", "direction": "descending"}]
}'
更新页面属性
curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{"properties": {"Status": {"select": {"name": "Done"}}}}'
添加内容块到页面
curl -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{
"children": [{
"object": "block",
"type": "paragraph",
"paragraph": {"rich_text": [{"text": {"content": "Hello"}}]}
}]
}'
📋 属性类型格式
Title{"title": [{"text": {"content": "标题"}}]}Rich text{"rich_text": [{"text": {"content": "内容"}}]}Select{"select": {"name": "选项名"}}Multi-select{"multi_select": [{"name": "A"}, {"name": "B"}]}Date{"date": {"start": "2024-01-15", "end": "2024-01-16"}}Checkbox{"checkbox": true}Number{"number": 42}URL{"url": "https://..."}Email{"email": "a@b.com"}Relation{"relation": [{"id": "page_id"}]}
🔄 API 2025-09-03 版本差异
- Databases → Data Sources - 使用 /data_sources/ 端点查询和检索数据库
- 双 ID 系统 - 每个数据库同时有 database_id 和 data_source_id
- 创建页面时用 database_id：parent: {"database_id": "..."}
- 查询时用 data_source_id：POST /v1/data_sources/{id}/query
- 搜索结果格式 - 数据库返回为 "object": "data_source" 格式
💬 与小龙虾对话示例
示例 1：搜索 Notion 页面
你： 在 Notion 里搜索"项目计划"相关的页面
小龙虾： 正在搜索 Notion...
找到 3 个相关结果：
1. 📄 2024 项目计划 - 最后编辑于 3 天前
2. 📊 Q1 项目计划数据库 - 包含 12 个条目
3. 📝 项目计划会议纪要 - 最后编辑于 1 周前
示例 2：在数据库中添加条目
你： 在任务数据库里添加一个新任务：标题是"完成报告"，状态是"进行中"，截止日期是下周五
小龙虾： 好的，正在创建任务...
✅ 任务创建成功！
标题：完成报告
状态：进行中
截止：2024-03-22
示例 3：查询数据库
你： 显示所有状态为"待办"的任务
小龙虾： 正在查询数据库...
找到 5 个待办任务：
📋 准备周报 - 截止: 明天
📋 代码审查 - 截止: 后天
📋 更新文档 - 无截止日期
...
示例 4：更新任务状态
你： 把"准备周报"这个任务标记为已完成
小龙虾： 好的，正在更新状态...
✅ 任务状态已更新！
"准备周报" 已标记为完成
示例 5：创建新页面并添加内容
你： 在 Notion 里创建一个新页面，标题是"会议纪要"，内容写上今天讨论的三个要点
小龙虾： 好的，正在创建页面...
✅ 页面创建成功！
📄 会议纪要
- 要点 1: ...
- 要点 2: ...
- 要点 3: ...
⚠️ 注意事项
- 授权范围 - API 只能访问已与 Integration 连接的页面/数据库
- 速率限制 - 平均约 3 请求/秒，避免频繁调用
- ID 格式 - 页面/数据库 ID 是 UUID 格式（可带或不带短横线）
- 视图过滤 - API 无法设置数据库视图的过滤器，这是 UI 专属功能
- 内联数据库 - 创建数据库时可用 is_inline: true 嵌入页面中
🔗 相关技能
obsidian
通过 obsidian-cli 操作 Obsidian vault（纯 Markdown 笔记）
跨平台生产力Markdown
📌 功能简介
obsidian 技能让小龙虾能够直接管理你的 Obsidian 笔记库（Vault）。 Obsidian 是一款基于纯 Markdown 文件的知识管理工具，支持双向链接、图谱视图、插件扩展等强大功能。 通过此技能，你可以搜索笔记、创建新笔记、移动/重命名笔记（自动更新链接）、删除笔记等。
底层使用 obsidian-cli 工具，支持 vault 管理和笔记操作。
📁 Vault 结构
Obsidian vault 本质上就是一个普通的文件夹：
*.md笔记文件（纯文本 Markdown，可用任何编辑器打开）.obsidian/配置目录（工作区和插件设置，一般不要手动修改）*.canvas画布文件（JSON 格式）attachments/附件目录（图片、PDF 等，路径可在 Obsidian 设置中配置）
🔧 安装步骤
步骤一：安装 obsidian-cli
# macOS 使用 Homebrew 安装
brew tap yakitrak/yakitrak
brew install obsidian-cli
步骤二：设置默认 Vault
# 设置默认 vault（使用 vault 文件夹名称）
obsidian-cli set-default "MyNotes"
# 验证默认 vault
obsidian-cli print-default
# 只获取 vault 路径
obsidian-cli print-default --path-only
💡 如何找到 Vault
Obsidian 在以下位置记录所有 vault 信息：
~/Library/Application Support/obsidian/obsidian.json
obsidian-cli 会自动读取此文件。Vault 名称通常就是文件夹名称。
📖 核心命令
搜索笔记
# 按笔记名称搜索
obsidian-cli search "关键词"
# 搜索笔记内容（显示匹配片段和行号）
obsidian-cli search-content "关键词"
创建笔记
# 创建笔记并打开
obsidian-cli create "文件夹/新笔记" --content "笔记内容" --open
# 创建空白笔记
obsidian-cli create "快速笔记"
移动/重命名笔记
# 移动笔记（自动更新所有 [[wikilinks]] 和 Markdown 链接）
obsidian-cli move "旧路径/笔记" "新路径/笔记"
✨ 这是 obsidian-cli 相比直接用 mv 命令的最大优势：自动更新整个 vault 中的链接引用！
删除笔记
obsidian-cli delete "路径/笔记"
直接编辑
因为 Obsidian 笔记是纯 Markdown 文件，你也可以直接编辑 .md 文件，Obsidian 会自动同步变更：
# 直接编辑 Markdown 文件
vim ~/MyNotes/日记/2024-03-15.md
⚠️ 注意事项
- 多 Vault 环境 - 很多用户有多个 vault（iCloud/本地、工作/个人），不要硬编码路径，建议用 print-default 获取
- URI 处理器 - 创建笔记需要 Obsidian 已安装并能响应 obsidian:// 协议
- 避免隐藏目录 - 不要通过 CLI 在以 . 开头的目录中创建笔记，Obsidian 可能会拒绝
- 链接更新 - 移动/重命名时 obsidian-cli 会自动更新 [[wikilinks]] 和 Markdown 链接
- 实时同步 - 直接编辑 .md 文件后，Obsidian 会自动检测变更
💬 与小龙虾对话示例
示例 1：搜索笔记
你： 在 Obsidian 里搜索关于"机器学习"的笔记
小龙虾： 正在搜索...
obsidian-cli search-content "机器学习"
找到 4 个相关笔记：
📄 学习笔记/ML基础.md (第 15, 42, 78 行)
📄 项目/推荐系统.md (第 3 行)
📄 读书笔记/深度学习.md (第 8, 23 行)
📄 日记/2024-02-20.md (第 5 行)
示例 2：创建新笔记
你： 在 Obsidian 的"会议纪要"文件夹里创建一个今天的会议记录
小龙虾： 好的，正在创建笔记...
obsidian-cli create "会议纪要/2024-03-15 周会" \
--content "# 周会纪要\n\n## 参会人员\n\n## 讨论内容\n\n## 行动项" \
--open
示例 3：移动并重命名笔记
你： 把"临时笔记"移动到"归档"文件夹，并改名为"2024-Q1总结"
小龙虾： 好的，正在移动并更新所有链接...
obsidian-cli move "临时笔记" "归档/2024-Q1总结"
✅ 笔记已移动
📄 归档/2024-Q1总结.md
🔗 已更新 3 个文件中的链接引用
示例 4：查看当前 Vault 信息
你： 我的 Obsidian 默认 vault 是哪个？
小龙虾： 让我查一下...
obsidian-cli print-default
当前默认 Vault：
名称：MyNotes
路径：/Users/you/Documents/MyNotes
示例 5：快速记录想法
你： 帮我在 Obsidian 记一下：下周要准备年度汇报 PPT
小龙虾： 已记录到 Obsidian...
obsidian-cli create "Inbox/快速记录" \
--content "- [ ] 下周要准备年度汇报 PPT" --open
🔗 相关技能
📜
session-logs
搜索和分析历史会话日志（使用 jq）
跨平台分析历史记录
📌 功能简介
session-logs 技能让小龙虾能够搜索和分析存储在 JSONL 文件中的完整对话历史。 当用户询问之前的对话内容、想回顾历史记录或需要统计使用情况时，可以使用此技能。
底层使用 jq 和 rg (ripgrep) 工具进行 JSON 解析和文本搜索。
📁 日志存储位置
会话日志存储在以下位置：
~/.openclaw/agents/<agentId>/sessions/
sessions.json索引文件，映射会话键（session key）到会话 ID<session-id>.jsonl完整对话记录（每行一个 JSON 对象）
📋 日志结构
每个 .jsonl 文件包含以下字段：
type"session"（元数据）或 "message"（消息）timestampISO 格式时间戳message.role"user"、"assistant" 或 "toolResult"message.content[]内容数组（文本、思考过程、工具调用）message.usage.cost.total该响应的费用
🔍 常用查询命令
列出所有会话（按日期和大小）
for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
size=$(ls -lh "$f" | awk '{print $5}')
echo "$date $size $(basename $f)"
done | sort -r
提取用户消息
jq -r 'select(.message.role == "user") | \
.message.content[]? | select(.type == "text") | .text' \
<session>.jsonl
搜索 AI 回复中的关键词
jq -r 'select(.message.role == "assistant") | \
.message.content[]? | select(.type == "text") | .text' \
<session>.jsonl | rg -i "关键词"
计算会话费用
jq -s '[.[] | .message.usage.cost.total // 0] | add' <session>.jsonl
统计消息数量
jq -s '{
messages: length,
user: [.[] | select(.message.role == "user")] | length,
assistant: [.[] | select(.message.role == "assistant")] | length,
first: .[0].timestamp,
last: .[-1].timestamp
}' <session>.jsonl
工具使用统计
jq -r '.message.content[]? | select(.type == "toolCall") | .name' \
<session>.jsonl | sort | uniq -c | sort -rn
跨所有会话搜索
rg -l "搜索词" ~/.openclaw/agents/<agentId>/sessions/*.jsonl
💬 与小龙虾对话示例
示例 1：查找之前的对话
你： 我之前问过你关于 Python 爬虫的问题，帮我找一下那次对话
小龙虾： 让我搜索一下历史会话...
找到 2 个相关会话：
📄 2024-03-10 - 包含 "Python 爬虫" 关键词
📄 2024-02-28 - 包含 "scrapy" 和 "爬虫" 关键词
要查看具体内容吗？
示例 2：统计使用费用
你： 这个月我花了多少钱在 AI 对话上？
小龙虾： 正在统计费用...
📊 3月份费用统计：
2024-03-15: $0.42
2024-03-14: $0.38
2024-03-13: $0.55
...
本月总计: $8.76
示例 3：查看工具使用情况
你： 上次对话我用了哪些工具？
小龙虾： 让我分析一下...
🔧 上次会话工具使用统计：
15 次 Read (读取文件)
8 次 Edit (编辑文件)
5 次 Bash (命令执行)
3 次 Grep (搜索)
2 次 WebFetch (网页获取)
示例 4：回顾今天的所有对话
你： 总结一下我今天都问了你什么
小龙虾： 正在回顾今天的会话...
📝 今天的对话主题（共 3 个会话）：
1. 9:30 - 讨论 OpenClaw 技能教程编写
2. 14:15 - 询问 Python 数据处理问题
3. 16:40 - 代码审查和 bug 修复
⚠️ 注意事项
- 会话是只追加的 - JSONL 文件每行一个 JSON 对象，不会修改已有内容
- 大文件处理 - 大型会话可能有几 MB，建议用 head/tail 采样
- 索引文件 - sessions.json 映射各渠道（Discord、WhatsApp 等）到会话 ID
- 已删除会话 - 删除的会话文件名会加上 .deleted.<timestamp> 后缀
- 隐私注意 - 会话日志包含完整对话内容，请妥善保管
🔗 相关技能
✅
things-mac
通过 things CLI 管理 Things 3（macOS 任务管理应用）
macOS Only生产力待办
📌 功能简介
things-mac 技能让小龙虾能够直接管理你的 Things 3 任务。 Things 3 是 macOS/iOS 上广受好评的任务管理应用，以简洁优雅的设计著称。 通过此技能，你可以查看收件箱/今日/即将到来的任务、搜索任务、添加新任务、更新任务状态等。
底层使用 things3-cli 工具，支持读取本地数据库和通过 URL Scheme 写入。
🔧 安装步骤
步骤一：安装 things CLI
# 使用 Go 安装（Apple Silicon 推荐）
GOBIN=/opt/homebrew/bin go install \
github.com/ossianhempel/things3-cli/cmd/things@latest
步骤二：授予磁盘访问权限
如果数据库读取失败，需要授予「完全磁盘访问」权限：
- 打开「系统设置」→「隐私与安全性」→「完全磁盘访问」
- 添加「终端」（手动运行时）或「OpenClaw.app」（网关运行时）
步骤三：配置（可选）
# 设置数据库路径（可选）
export THINGSDB="~/Library/Group Containers/.../ThingsData-..."
# 设置 Auth Token（更新任务时需要）
export THINGS_AUTH_TOKEN="your-token-here"
📖 读取命令（只读）
things inbox --limit 50查看收件箱（限制 50 条）things today查看今日任务things upcoming查看即将到来的任务things search "query"搜索任务things projects列出所有项目things areas列出所有区域things tags列出所有标签
✏️ 写入命令
添加任务
# 基础添加
things add "买牛奶"
# 带备注
things add "买牛奶" --notes "2% 脱脂 + 香蕉"
# 指定项目/区域
things add "订机票" --list "旅行计划"
# 指定标签
things add "打电话给牙医" --tags "健康,电话"
# 设置时间和截止日期
things add "写报告" --when today --deadline 2024-03-20
# 带清单项
things add "旅行准备" --checklist-item "护照" --checklist-item "机票"
# 预览模式（不执行）
things --dry-run add "测试任务"
更新任务（需要 Auth Token）
# 先搜索获取任务 ID
things search "牛奶" --limit 5
# 更新标题
things update --id <UUID> --auth-token <TOKEN> "新标题"
# 追加备注
things update --id <UUID> --auth-token <TOKEN> --append-notes "追加内容"
# 标记完成
things update --id <UUID> --auth-token <TOKEN> --completed
# 取消任务
things update --id <UUID> --auth-token <TOKEN> --canceled
💬 与小龙虾对话示例
示例 1：查看今日任务
你： 今天有什么任务？
小龙虾： 让我查一下 Things...
📋 今日任务（共 4 项）：
☐ 完成周报
☐ 代码审查
☐ 下午 3 点开会
☐ 回复邮件
示例 2：添加新任务
你： 帮我在 Things 里添加一个任务：明天下午去取快递
小龙虾： 好的，正在添加任务...
things add "去取快递" --when tomorrow
✅ 任务已添加到 Things！
标题：去取快递
日期：明天
示例 3：搜索任务
你： 搜一下我有没有关于报告的任务
小龙虾： 正在搜索...
things search "报告"
找到 3 个相关任务：
📋 完成周报 - 今天
📋 写季度报告 - 3月20日
📋 提交费用报告 - 下周
示例 4：标记任务完成
你： 把"完成周报"这个任务标记为已完成
小龙虾： 好的，正在更新任务状态...
✅ 任务已完成！
"完成周报" 已标记为已完成
示例 5：添加项目中的任务
你： 在"旅行计划"项目里添加一个任务：预订酒店
小龙虾： 好的，正在添加...
things add "预订酒店" --list "旅行计划"
⚠️ 注意事项
- 仅限 macOS - Things 3 是 Apple 生态应用
- 磁盘权限 - 读取数据库需要完全磁盘访问权限
- Auth Token - 更新/完成任务需要设置 THINGS_AUTH_TOKEN
- 不支持删除 - CLI 不支持删除任务，只能标记为完成或取消
- 预览模式 - 使用 --dry-run 可预览操作而不执行
🔗 相关技能
trello
通过 Trello REST API 管理看板、列表和卡片
跨平台项目管理看板
📌 功能简介
trello 技能让小龙虾能够直接管理你的 Trello 看板。 Trello 是流行的可视化项目管理工具，采用看板（Board）、列表（List）、卡片（Card）的组织方式。 通过此技能，你可以查看看板和卡片、创建新卡片、移动卡片、添加评论、归档卡片等。
底层使用 Trello REST API，通过 curl 和 jq 实现。
🔧 设置步骤
步骤一：获取 API Key
- 访问 https://trello.com/app-key
- 复制显示的 API Key
步骤二：生成 Token
- 在同一页面，点击「Token」链接
- 授权应用访问你的 Trello 账号
- 复制生成的 Token
步骤三：配置环境变量
# 在 .env 或 shell 配置文件中添加
export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"
⚠️ 安全提示
API Key 和 Token 提供对你 Trello 账号的完全访问权限，请妥善保管！
⚙️ 核心操作
列出所有看板
curl -s "https://api.trello.com/1/members/me/boards?\
key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
列出看板中的列表
curl -s "https://api.trello.com/1/boards/{boardId}/lists?\
key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
列出列表中的卡片
curl -s "https://api.trello.com/1/lists/{listId}/cards?\
key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'
创建卡片
curl -s -X POST "https://api.trello.com/1/cards?\
key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "idList={listId}" \
-d "name=卡片标题" \
-d "desc=卡片描述"
移动卡片到另一个列表
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?\
key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "idList={newListId}"
添加评论
curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?\
key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "text=你的评论内容"
归档卡片
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?\
key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "closed=true"
💬 与小龙虾对话示例
示例 1：查看所有看板
你： 显示我的 Trello 看板
小龙虾： 正在获取看板列表...
📋 你的 Trello 看板：
1. 工作任务 (id: abc123)
2. 个人项目 (id: def456)
3. 学习计划 (id: ghi789)
示例 2：创建新卡片
你： 在"工作任务"看板的"待办"列表里创建一个卡片：准备周一会议
小龙虾： 好的，正在创建卡片...
✅ 卡片创建成功！
标题：准备周一会议
列表：待办
看板：工作任务
示例 3：移动卡片
你： 把"准备周一会议"这个卡片移动到"进行中"列表
小龙虾： 好的，正在移动卡片...
✅ 卡片已移动！
"准备周一会议" → 进行中
示例 4：查看列表中的卡片
你： 显示"工作任务"看板的"待办"列表里有什么卡片
小龙虾： 正在获取卡片...
📝 待办列表（共 3 张卡片）：
1. 代码审查
2. 更新文档
3. 修复登录 bug
示例 5：归档卡片
你： 把"修复登录 bug"这个卡片归档
小龙虾： 好的，正在归档...
✅ 卡片已归档！
"修复登录 bug" 已移至归档
⚠️ 注意事项
- ID 获取方式 - 看板/列表/卡片 ID 可以从 Trello URL 或列表命令获取
- 速率限制 - 每 10 秒 300 请求（API Key）/ 100 请求（Token）
- 成员端点限制 - /1/members 端点限制为每 900 秒 100 请求
- 依赖工具 - 需要安装 jq 来解析 JSON 响应
- 凭证安全 - API Key 和 Token 具有完全访问权限，不要泄露
🔗 相关技能
notionthings-macapple-reminders
📱 通讯和社交类 Skills
连接各种社交平台和通讯工具，统一管理你的数字社交生活
共 7 个技能：bird, discord, facebook-mcp, gmail, imessage, slack, telegram
🐦
bird
通过 X/Twitter API 管理推文、搜索内容和发布动态
跨平台社交媒体X/Twitter
📌 功能简介
bird 技能让小龙虾能够直接与 X（原 Twitter） 互动。 你可以搜索推文、查看时间线、发布推文、回复评论、管理关注列表等。 这是管理社交媒体存在的强大工具，让你无需打开应用即可完成日常操作。
底层使用 X API v2，需要开发者账号和 API 密钥。
🔧 设置步骤
步骤一：申请 X 开发者账号
- 访问 X Developer Portal
- 点击「Sign up for Free Account」或升级到 Basic/Pro 计划
- 完成开发者协议和应用信息填写
- 等待审核通过（通常即时）
步骤二：创建应用并获取密钥
- 在 Developer Portal 中点击「+ Add App」
- 选择环境（Development/Production）
- 记录 API Key、API Secret、Bearer Token
- 在 App 设置中生成 Access Token 和 Access Secret
步骤三：配置环境变量
# 在 .env 文件中添加
TWITTER_API_KEY="your-api-key"
TWITTER_API_SECRET="your-api-secret"
TWITTER_ACCESS_TOKEN="your-access-token"
TWITTER_ACCESS_SECRET="your-access-secret"
TWITTER_BEARER_TOKEN="your-bearer-token"
⚠️ API 计划说明
• Free: 每月 1,500 条推文读取，50 条发布
• Basic ($100/月): 10K 读取，3K 发布
• Pro ($5000/月): 1M 读取，300K 发布
⚙️ 核心操作
搜索推文
# 基础搜索
curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
"https://api.twitter.com/2/tweets/search/recent?query=OpenClaw"
# 带更多字段
curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
"https://api.twitter.com/2/tweets/search/recent?\
query=AI&tweet.fields=created_at,author_id,public_metrics"
获取用户时间线
# 获取用户 ID（先根据用户名）
curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
"https://api.twitter.com/2/users/by/username/{username}"
# 获取用户推文
curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
"https://api.twitter.com/2/users/{user_id}/tweets?max_results=10"
发布推文
# 需要 OAuth 1.0a 签名（简化示例）
curl -X POST "https://api.twitter.com/2/tweets" \
-H "Authorization: OAuth oauth_consumer_key=...,..." \
-H "Content-Type: application/json" \
-d '{"text": "Hello from OpenClaw! 🦞"}'
获取我的时间线（Home Timeline）
curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
"https://api.twitter.com/2/users/{my_user_id}/timelines/reverse_chronological"
点赞推文
curl -X POST "https://api.twitter.com/2/users/{my_user_id}/likes" \
-H "Authorization: OAuth ..." \
-H "Content-Type: application/json" \
-d '{"tweet_id": "1234567890"}'
💬 与小龙虾对话示例
示例 1：搜索推文
你： 搜一下最近关于 AI 的热门推文
小龙虾： 正在搜索 X 上关于 AI 的推文...
🔍 找到 10 条相关推文：
1. @elonmusk: "AI is the future..." (❤️ 45K, 🔄 12K)
2. @OpenAI: "Introducing GPT-5..." (❤️ 89K, 🔄 32K)
3. @AnthropicAI: "Claude 4 is here..." (❤️ 23K, 🔄 8K)
...
示例 2：发布推文
你： 帮我发一条推文：今天用 OpenClaw 构建了一个私人 AI 助手，太酷了！
小龙虾： 好的，正在发布推文...
✅ 推文发布成功！
内容：今天用 OpenClaw 构建了一个私人 AI 助手，太酷了！
链接：https://x.com/yourname/status/1234567890
示例 3：查看时间线
你： 显示我的 X 时间线最新动态
小龙虾： 正在获取时间线...
📱 最新时间线（5 条）：
• @friend1: 今天天气真好！(5分钟前)
• @techblog: 新版 Node.js 发布... (15分钟前)
• @developer: 分享一个实用的代码技巧... (30分钟前)
...
示例 4：关注用户
你： 关注 @OpenClawAI
小龙虾： 好的，正在关注...
✅ 已关注 @OpenClawAI！
粉丝数：1.2K | 推文数：156
⚠️ 注意事项
- API 配额 - 免费计划配额有限，注意使用频率
- OAuth 签名 - 发布/点赞等写操作需要 OAuth 1.0a 签名
- 速率限制 - 每 15 分钟窗口有请求限制
- 账号安全 - 妥善保管 API 密钥，不要泄露
- 内容政策 - 遵守 X 的使用条款和内容政策
🔗 相关技能
💬
discord
通过 Discord Bot API 管理服务器、频道和消息
跨平台即时通讯社区
📌 功能简介
discord 技能让小龙虾能够连接到你的 Discord 服务器。 你可以接收和发送消息、管理频道、查看服务器成员、响应命令等。 非常适合将 AI 助手集成到社区服务器或私人群组中。
底层使用 Discord API，通过 Bot Token 进行认证。
🔧 设置步骤
步骤一：创建 Discord 应用
- 访问 Discord Developer Portal
- 点击「New Application」创建新应用
- 为应用命名（如 "OpenClaw Bot"）
步骤二：创建 Bot 并获取 Token
- 在应用页面左侧点击「Bot」
- 点击「Add Bot」确认创建
- 点击「Reset Token」获取 Bot Token（只显示一次！）
- 在「Privileged Gateway Intents」下启用需要的权限
步骤三：邀请 Bot 到服务器
- 在左侧点击「OAuth2」→「URL Generator」
- Scopes 选择「bot」
- Bot Permissions 选择所需权限（Send Messages, Read Messages 等）
- 复制生成的 URL，在浏览器中打开并选择服务器
步骤四：配置环境变量
# 在 .env 文件中添加
DISCORD_BOT_TOKEN="your-bot-token"
DISCORD_APPLICATION_ID="your-app-id"
⚙️ 核心功能
消息接收监听频道中的新消息，自动响应消息发送向指定频道发送文本、嵌入消息斜杠命令响应 /ask, /help 等斜杠命令DM 私聊接收和发送私信成员管理查看服务器成员列表和角色频道管理创建、删除、修改频道
🔌 API 调用示例
发送消息到频道
curl -X POST "https://discord.com/api/v10/channels/{channel_id}/messages" \
-H "Authorization: Bot $DISCORD_BOT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content": "Hello from OpenClaw! 🦞"}'
获取频道消息
curl -s -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
"https://discord.com/api/v10/channels/{channel_id}/messages?limit=10"
获取服务器信息
curl -s -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
"https://discord.com/api/v10/guilds/{guild_id}"
💬 与小龙虾对话示例
示例 1：发送消息
你： 在 #general 频道发一条消息：大家好，我是小龙虾！
小龙虾： 好的，正在发送消息到 Discord...
✅ 消息已发送！
频道：#general
内容：大家好，我是小龙虾！
示例 2：查看最近消息
你： 看一下 #技术讨论 频道的最近消息
小龙虾： 正在获取消息...
📝 #技术讨论 最近 5 条消息：
• developer123 (10分钟前): 有人用过 Rust 吗？
• coder456 (15分钟前): Node.js 22 发布了！
• techguy (30分钟前): 推荐一下好用的 VS Code 插件
...
示例 3：服务器信息
你： 显示 OpenClaw 服务器的信息
小龙虾： 正在获取服务器信息...
🏠 服务器信息：
名称：OpenClaw Community
成员数：1,234
频道数：15
创建时间：2024-01-15
⚠️ 注意事项
- Token 安全 - Bot Token 泄露会导致 Bot 被盗用，绝对不要公开
- Intent 权限 - 读取消息内容需要启用 Message Content Intent
- 速率限制 - Discord 有严格的速率限制，避免频繁请求
- 权限管理 - 确保 Bot 在目标频道有足够权限
- 服务器验证 - 大型服务器可能需要通过 Discord 的 Bot 验证
🔗 相关技能
facebook-mcp
通过 MCP 服务器连接 Facebook 和 Instagram
跨平台社交媒体MCP
📌 功能简介
facebook-mcp 技能通过 Model Context Protocol (MCP) 服务器连接到 Facebook 和 Instagram。 你可以发布动态、查看通知、管理页面、获取好友状态等。
底层使用 Facebook Graph API，通过 MCP 协议提供统一接口。
🔧 设置步骤
步骤一：创建 Facebook 应用
- 访问 Facebook Developer Console
- 点击「创建应用」
- 选择应用类型（「消费者」或「商务」）
- 填写应用名称和联系邮箱
步骤二：配置应用权限
- 在应用面板左侧添加「Facebook 登录」产品
- 获取需要的权限（pages_manage_posts, instagram_basic 等）
- 生成用户访问令牌或页面访问令牌
步骤三：配置 MCP 服务器
# 在 .env 文件中添加
FACEBOOK_ACCESS_TOKEN="your-access-token"
FACEBOOK_PAGE_ID="your-page-id"
INSTAGRAM_BUSINESS_ID="your-instagram-id"
# 在 OpenClaw MCP 配置中添加
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": ["@anthropic/mcp-server-facebook"]
}
}
}
⚠️ 审核要求
大多数 Facebook API 权限需要通过应用审核。个人使用可以在开发模式下测试。
⚙️ 核心功能
发布动态发布文字、图片、链接到个人或页面时间线查看通知获取未读通知列表页面管理管理 Facebook 页面的帖子和互动Instagram 发布发布照片和视频到 Instagram评论回复查看和回复评论数据分析获取帖子互动数据
💬 与小龙虾对话示例
示例 1：发布 Facebook 动态
你： 在我的 Facebook 页面发布：今天学习了 AI 技术，收获满满！
小龙虾： 好的，正在发布到 Facebook...
✅ 动态发布成功！
页面：OpenClaw Official
内容：今天学习了 AI 技术，收获满满！
链接：https://facebook.com/openclaw/posts/123456
示例 2：查看页面数据
你： 看一下我 Facebook 页面最近一周的数据
小龙虾： 正在获取页面分析数据...
📊 页面数据（过去 7 天）：
总触达：12,345
互动数：567
新粉丝：89
最佳帖子：AI 教程分享 (点赞 234)
示例 3：发布 Instagram
你： 把这张图片发到 Instagram，配文：美好的一天！
小龙虾： 好的，正在发布到 Instagram...
✅ Instagram 发布成功！
图片已上传
标题：美好的一天！
链接：https://instagram.com/p/ABC123
⚠️ 注意事项
- 权限审核 - 正式使用需要通过 Facebook 的应用审核
- 令牌过期 - 访问令牌有过期时间，需要定期刷新
- 速率限制 - 遵守 Facebook API 的调用频率限制
- 内容政策 - 发布内容需遵守 Facebook 社区准则
- Instagram 要求 - Instagram API 仅支持商业账号和创作者账号
🔗 相关技能
📧
gmail
通过 Gmail API 管理邮件、发送邮件和搜索邮件
跨平台邮件Google
📌 功能简介
gmail 技能让小龙虾能够直接管理你的 Gmail 邮箱。 你可以查看收件箱、搜索邮件、发送邮件、管理标签、归档和删除邮件等。 这是处理日常邮件的强大助手，让你无需打开邮箱即可完成邮件操作。
底层使用 Gmail API，通过 OAuth 2.0 进行认证。
🔧 设置步骤
步骤一：创建 Google Cloud 项目
- 访问 Google Cloud Console
- 创建新项目或选择现有项目
- 启用 Gmail API（APIs & Services → Library → Gmail API）
步骤二：配置 OAuth 同意屏幕
- 进入「OAuth consent screen」
- 选择「External」用户类型
- 填写应用信息和联系方式
- 添加所需的 Gmail API 范围
步骤三：创建 OAuth 凭据
- 进入「Credentials」→「Create Credentials」→「OAuth client ID」
- 选择「Desktop app」或「Web application」
- 下载 credentials.json 文件
步骤四：配置 OpenClaw
# 将 credentials.json 放到配置目录
cp credentials.json ~/.openclaw/google/
# 首次运行时会要求 OAuth 授权
openclaw gmail auth
⚙️ 核心操作
gmail inbox查看收件箱最新邮件gmail search "query"搜索邮件（支持 Gmail 搜索语法）gmail read <id>阅读指定邮件gmail send发送新邮件gmail reply <id>回复邮件gmail archive <id>归档邮件gmail labels列出所有标签
Gmail 搜索语法示例
# 搜索特定发件人
from:example@gmail.com
# 搜索特定日期范围
after:2024/01/01 before:2024/03/01
# 搜索有附件的邮件
has:attachment filename:pdf
# 搜索未读邮件
is:unread
# 组合搜索
from:boss@company.com is:unread has:attachment
💬 与小龙虾对话示例
示例 1：查看收件箱
你： 看一下我的邮箱有什么新邮件
小龙虾： 正在获取收件箱...
📬 收件箱（5 封未读）：
1. ⭐ from: boss@company.com
项目进度汇报 (今天 14:30)
2. from: newsletter@tech.com
每周技术速递 (今天 09:00)
3. from: friend@gmail.com
周末聚会 (昨天)
示例 2：发送邮件
你： 给 colleague@company.com 发一封邮件，主题是「会议纪要」，内容是今天会议的主要决定...
小龙虾： 好的，正在准备邮件...
✅ 邮件已发送！
主题：会议纪要
发送时间：2024-03-15 15:30
示例 3：搜索邮件
你： 找一下上周老板发给我的带附件的邮件
小龙虾： 正在搜索...
from:boss@company.com has:attachment after:2024/03/08
🔍 找到 2 封邮件：
1. 项目文档 (3月12日) - 附件：project.pdf
2. 季度报告 (3月10日) - 附件：Q1-report.xlsx
示例 4：回复邮件
你： 回复老板的邮件，说收到了，会尽快处理
小龙虾： 好的，正在发送回复...
✅ 回复已发送！
Re: 项目进度汇报
内容：收到，会尽快处理。
⚠️ 注意事项
- OAuth 授权 - 首次使用需要在浏览器中完成 Google 授权
- 敏感范围 - Gmail API 属于敏感范围，可能需要 Google 验证
- 令牌刷新 - 访问令牌会自动刷新，但刷新令牌可能过期
- 配额限制 - 每日有 API 调用配额（默认 10 亿单位/天）
- 邮件格式 - 发送 HTML 邮件需要正确设置 MIME 类型
🔗 相关技能
💬
imessage
通过 AppleScript 在 macOS 上收发 iMessage 消息
macOS Only即时通讯Apple
📌 功能简介
imessage 技能让小龙虾能够直接收发 iMessage 消息。 这是 Apple 生态系统的核心消息服务，让你无需拿起手机即可与朋友和家人交流。 你可以发送消息、查看对话、搜索聊天记录等。
底层通过 AppleScript 与 Messages.app 交互，仅支持 macOS。
📋 前置条件
- macOS 系统（Messages.app 已登录 Apple ID）
- 终端或 OpenClaw.app 需要「自动化」权限
- 如果需要读取消息，需要「完全磁盘访问」权限
🔧 设置步骤
步骤一：授予自动化权限
- 打开「系统设置」→「隐私与安全性」→「自动化」
- 找到「终端」或「OpenClaw」
- 勾选「Messages」权限
步骤二：授予磁盘访问权限（可选，用于读取历史）
- 打开「系统设置」→「隐私与安全性」→「完全磁盘访问」
- 添加「终端」或「OpenClaw.app」
测试连接
# 测试 AppleScript 是否可以访问 Messages
osascript -e 'tell application "Messages" to get name of first chat'
⚙️ 核心操作
发送消息
# 通过 AppleScript 发送消息
osascript -e '
tell application "Messages"
set targetBuddy to buddy "+1234567890" of service "iMessage"
send "Hello from OpenClaw! 🦞" to targetBuddy
end tell
'
列出最近对话
# 获取最近的聊天列表
osascript -e '
tell application "Messages"
get name of chats
end tell
'
读取消息历史（通过数据库）
# 查询 Messages 数据库
sqlite3 ~/Library/Messages/chat.db \
"SELECT text, datetime(date/1000000000 + 978307200, 'unixepoch') \
FROM message ORDER BY date DESC LIMIT 10"
💬 与小龙虾对话示例
示例 1：发送消息
你： 给妈妈发一条 iMessage：今晚回家吃饭
小龙虾： 好的，正在发送 iMessage...
✅ 消息已发送！
收件人：妈妈
内容：今晚回家吃饭
示例 2：查看最近消息
你： 看一下我最近的 iMessage 消息
小龙虾： 正在获取消息...
📱 最近 iMessage 消息：
• 妈妈 (5分钟前): 好的，等你回来
• 同事小李 (1小时前): 文档已经发给你了
• 家庭群 (2小时前): 周末聚会时间确定了
示例 3：搜索聊天记录
你： 搜一下我和小李的聊天里提到「会议」的消息
小龙虾： 正在搜索聊天记录...
🔍 找到 3 条相关消息：
• 3月10日: 明天下午3点有会议
• 3月8日: 会议室在哪？
• 3月5日: 会议结束了
⚠️ 注意事项
- 仅限 macOS - iMessage 功能仅在 macOS 上可用
- 权限敏感 - 需要自动化权限和/或磁盘访问权限
- 联系人匹配 - 发送消息需要使用电话号码或邮箱
- 数据库只读 - 直接读取数据库是只读操作，不会修改消息
- 群组消息 - 群组消息的处理略有不同
🔗 相关技能
slack
通过 Slack API 管理工作区、频道和消息
跨平台团队协作企业
📌 功能简介
slack 技能让小龙虾能够连接到你的 Slack 工作区。 你可以接收和发送消息、管理频道、响应 Slack 命令、查看工作区成员等。 非常适合将 AI 助手集成到团队工作流中。
底层使用 Slack API 和 Socket Mode。
🔧 设置步骤
步骤一：创建 Slack 应用
- 访问 Slack API
- 点击「Create New App」→「From scratch」
- 为应用命名，选择工作区
步骤二：配置权限
- 在左侧菜单点击「OAuth & Permissions」
- 在「Bot Token Scopes」添加所需权限：
channels:history # 读取频道消息
channels:read # 查看频道列表
chat:write # 发送消息
users:read # 查看用户信息
im:history # 读取私聊消息
im:write # 发送私聊消息
步骤三：启用 Socket Mode
- 在左侧菜单点击「Socket Mode」
- 启用 Socket Mode
- 生成 App-Level Token（需要 connections:write 范围）
步骤四：安装应用到工作区
- 回到「OAuth & Permissions」
- 点击「Install to Workspace」
- 复制 Bot User OAuth Token
步骤五：配置环境变量
# 在 .env 文件中添加
SLACK_BOT_TOKEN="xoxb-your-bot-token"
SLACK_APP_TOKEN="xapp-your-app-token"
SLACK_SIGNING_SECRET="your-signing-secret"
⚙️ 核心功能
消息监听实时接收频道和私聊消息消息发送发送文本、Block Kit、附件斜杠命令响应 /ask, /help 等命令频道管理创建、归档、获取频道信息用户查找通过邮箱或 ID 查找用户文件上传上传文件到频道或私聊
🔌 API 调用示例
发送消息
curl -X POST "https://slack.com/api/chat.postMessage" \
-H "Authorization: Bearer $SLACK_BOT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"channel": "C1234567890", "text": "Hello from OpenClaw! 🦞"}'
获取频道消息
curl -s -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
"https://slack.com/api/conversations.history?channel=C1234567890&limit=10"
列出频道
curl -s -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
"https://slack.com/api/conversations.list?types=public_channel,private_channel"
💬 与小龙虾对话示例
示例 1：发送消息到频道
你： 在 Slack 的 #general 频道发一条消息：今天的站会改到下午 3 点
小龙虾： 好的，正在发送消息...
✅ 消息已发送！
频道：#general
内容：今天的站会改到下午 3 点
示例 2：查看频道消息
你： 看一下 #dev-team 频道最近的消息
小龙虾： 正在获取消息...
📝 #dev-team 最近消息：
• @alice (10分钟前): PR 已经提交了，等待 review
• @bob (30分钟前): 新的 API 文档在这里
• @charlie (1小时前): 发现了一个 bug，已经创建了 issue
示例 3：私聊同事
你： 私聊一下 @alice，问她 PR 什么时候可以合并
小龙虾： 好的，正在发送私聊消息...
✅ 私聊消息已发送！
收件人：@alice
内容：Hi Alice，PR 什么时候可以合并？
示例 4：列出频道
你： 显示我加入的 Slack 频道
小龙虾： 正在获取频道列表...
📺 你加入的频道（共 8 个）：
• #general (公开)
• #dev-team (私有)
• #random (公开)
• #announcements (公开)
...
⚠️ 注意事项
- Token 安全 - Bot Token 和 App Token 需要妥善保管
- 权限最小化 - 只申请必要的权限范围
- 速率限制 - 遵守 Slack API 的速率限制（Web API: ~50 请求/分钟）
- Socket Mode - 推荐使用 Socket Mode，无需公网地址
- 频道邀请 - Bot 需要被邀请到私有频道才能访问
🔗 相关技能
✈️
telegram
通过 Telegram Bot API 收发消息和管理群组
跨平台即时通讯Bot
📌 功能简介
telegram 技能是 OpenClaw 最常用的消息通道之一。 Telegram 提供了强大的 Bot API，让你可以创建自己的 AI 助手机器人。 你可以接收和发送消息、管理群组、发送媒体文件、响应内联查询等。
底层使用 Telegram Bot API，通过 Long Polling 或 Webhook 接收消息。
🔧 设置步骤
步骤一：创建 Telegram Bot
- 在 Telegram 中搜索 @BotFather
- 发送 /newbot 命令
- 按提示设置 Bot 名称和用户名
- 记录返回的 Bot Token（格式：123456789:ABCdefGHI...）
步骤二：配置 Bot 设置（可选）
# 在 @BotFather 中可以设置
/setdescription # 设置 Bot 描述
/setabouttext # 设置「关于」文本
/setuserpic # 设置 Bot 头像
/setcommands # 设置命令菜单
步骤三：配置环境变量
# 在 .env 文件中添加
TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklmnOPQrstUVwxyz"
# 可选：设置允许的用户（安全考虑）
TELEGRAM_ALLOWLIST="123456789,987654321"
步骤四：测试 Bot
# 测试 Bot Token 是否有效
curl "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/getMe"
⚙️ 核心功能
消息接收接收私聊和群组消息消息发送发送文本、图片、文件、位置等命令处理响应 /start, /help 等命令内联模式在任意聊天中 @bot 调用键盘菜单自定义回复键盘和内联键盘群组管理管理群组成员和设置
🔌 API 调用示例
发送消息
curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage" \
-H "Content-Type: application/json" \
-d '{"chat_id": 123456789, "text": "Hello from OpenClaw! 🦞"}'
发送图片
curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendPhoto" \
-F "chat_id=123456789" \
-F "photo=@/path/to/image.jpg" \
-F "caption=看看这张图片！"
获取更新（Long Polling）
curl "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/getUpdates?offset=0&limit=10"
设置 Webhook
curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
-d "url=https://your-server.com/webhook/telegram"
💬 与小龙虾对话示例
示例 1：在 Telegram 中对话
你（在 Telegram）： 你好，小龙虾
小龙虾： 你好！我是小龙虾 🦞，你的私人 AI 助手。有什么可以帮你的吗？
示例 2：发送消息到 Telegram
你（在网页）： 通过 Telegram 给我发一条消息：别忘了明天的会议
小龙虾： 好的，正在发送 Telegram 消息...
✅ Telegram 消息已发送！
内容：别忘了明天的会议
示例 3：处理图片
你（在 Telegram 发送图片）： 这是什么？
小龙虾： 让我分析一下这张图片...
🖼️ 图片分析：
这是一只可爱的小猫，看起来是橘猫品种。它正趴在窗台上晒太阳，非常惬意的样子！
示例 4：使用命令
你： /help
小龙虾：
🦞 小龙虾帮助
可用命令：
/start - 开始对话
/help - 显示帮助
/status - 查看状态
/clear - 清除对话历史
或者直接发送消息和我聊天！
⚠️ 注意事项
- Token 安全 - Bot Token 等同于 Bot 的密码，绝不要公开
- 用户白名单 - 建议配置 TELEGRAM_ALLOWLIST 限制访问
- 隐私模式 - 群组中 Bot 默认只接收命令，需要禁用隐私模式才能看到所有消息
- 消息限制 - 单条消息最多 4096 字符
- 速率限制 - 每秒最多 30 条消息（群组 20 条/分钟）
🔗 相关技能
📅 日历和时间管理类 Skills
管理日程、设置提醒、调度定时任务，让时间井井有条
共 4 个技能：apple-calendar, google-calendar, outlook-calendar, cron
📅
apple-calendar
通过 AppleScript 和 icalBuddy 管理 macOS 日历
macOS Only日历Apple
📌 功能简介
apple-calendar 技能让小龙虾能够直接管理你的 macOS 日历应用。 你可以查看即将到来的事件、创建新日程、搜索日历、设置提醒等。 支持 iCloud、Google、Exchange 等多种日历账户同步。
底层通过 icalBuddy CLI 和 AppleScript 与 Calendar.app 交互。
🔧 安装步骤
步骤一：安装 icalBuddy
# 使用 Homebrew 安装
brew install ical-buddy
# 验证安装
icalBuddy -V
步骤二：授予日历访问权限
- 首次运行时系统会请求日历访问权限
- 或手动在「系统设置」→「隐私与安全性」→「日历」中添加「终端」
测试连接
# 列出所有日历
icalBuddy calendars
# 查看今天的事件
icalBuddy -f eventsToday
⚙️ 核心命令
icalBuddy eventsToday查看今天的事件icalBuddy eventsToday+7查看未来 7 天的事件icalBuddy eventsFrom:today to:2024-03-20查看指定日期范围的事件icalBuddy -ic "工作" eventsToday只显示特定日历的事件icalBuddy uncompletedTasks查看未完成的任务icalBuddy calendars列出所有可用日历
通过 AppleScript 创建事件
osascript -e '
tell application "Calendar"
tell calendar "工作"
make new event with properties {
summary: "团队会议",
start date: (current date) + 1 * days,
end date: (current date) + 1 * days + 1 * hours
}
end tell
end tell
'
格式化输出选项
# 简洁输出（适合脚本处理）
icalBuddy -f -nc eventsToday
# 自定义输出格式
icalBuddy -iep "title,datetime" -po "datetime,title" eventsToday
# 分隔符格式
icalBuddy -b "" -ps "|" eventsToday
💬 与小龙虾对话示例
示例 1：查看今天日程
你： 今天有什么日程安排？
小龙虾： 正在查看今天的日历...
📅 今天的日程（共 3 个事件）：
• 09:00 - 10:00 团队晨会 (工作)
• 14:00 - 15:30 项目评审会议 (工作)
• 18:30 - 20:00 健身房 (个人)
示例 2：创建新事件
你： 帮我在日历上添加一个明天下午3点的牙医预约
小龙虾： 好的，正在创建日历事件...
✅ 日历事件已创建！
标题：牙医预约
时间：明天 15:00 - 16:00
日历：个人
示例 3：查看本周日程
你： 看一下这周还有什么安排
小龙虾： 正在获取本周日程...
📅 本周剩余日程：
周三 (3月13日)
• 10:00 产品发布会
周五 (3月15日)
• 15:00 牙医预约
• 19:00 朋友聚餐
示例 4：搜索特定日历
你： 查看我工作日历上的所有会议
小龙虾： 正在搜索工作日历...
icalBuddy -ic "工作" eventsToday+14
📋 工作日历（未来两周 8 个事件）：
• 周一 09:00 团队晨会
• 周一 14:00 项目评审
• 周三 10:00 产品发布会
...
⚠️ 注意事项
- 仅限 macOS - 此技能依赖 macOS Calendar.app
- 权限要求 - 需要授予日历访问权限
- 日历同步 - 支持 iCloud、Google、Exchange 等账户
- 时区处理 - icalBuddy 使用系统时区
- 重复事件 - 重复事件会显示每个实例
🔗 相关技能
google-calendarapple-reminderscron
📆
google-calendar
通过 Google Calendar API 管理日程和事件
跨平台日历Google
📌 功能简介
google-calendar 技能让小龙虾能够直接管理你的 Google 日历。 你可以查看日程、创建事件、更新活动、设置提醒、邀请参与者等。 支持多个日历账户和共享日历。
底层使用 Google Calendar API v3，通过 OAuth 2.0 进行认证。
🔧 设置步骤
步骤一：创建 Google Cloud 项目
- 访问 Google Cloud Console
- 创建新项目或选择现有项目
- 启用 Google Calendar API（APIs & Services → Library）
步骤二：配置 OAuth 同意屏幕
- 进入「OAuth consent screen」
- 选择「External」用户类型
- 填写应用信息
- 添加 Calendar API 范围：https://www.googleapis.com/auth/calendar
步骤三：创建 OAuth 凭据
- 进入「Credentials」→「Create Credentials」→「OAuth client ID」
- 选择「Desktop app」
- 下载 credentials.json 文件
步骤四：配置 OpenClaw
# 将 credentials.json 放到配置目录
cp credentials.json ~/.openclaw/google/
# 或者使用 gcalcli (推荐)
pip install gcalcli
gcalcli init
⚙️ 核心操作 (gcalcli)
gcalcli agenda查看即将到来的事件gcalcli agenda "today" "next week"查看指定日期范围gcalcli calw周视图gcalcli calm月视图gcalcli add交互式添加事件gcalcli quick "会议 明天下午3点"快速添加（自然语言）gcalcli search "关键词"搜索事件
使用 API 直接调用
# 获取日历列表
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" \
"https://www.googleapis.com/calendar/v3/users/me/calendarList"
# 获取事件
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" \
"https://www.googleapis.com/calendar/v3/calendars/primary/events?\
timeMin=$(date -u +%Y-%m-%dT%H:%M:%SZ)&maxResults=10"
# 创建事件
curl -X POST -H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
"https://www.googleapis.com/calendar/v3/calendars/primary/events" \
-d '{"summary": "团队会议", "start": {...}, "end": {...}}'
💬 与小龙虾对话示例
示例 1：查看日程
你： 看一下我 Google 日历这周的安排
小龙虾： 正在获取 Google 日历...
📅 本周 Google 日历事件：
周一
• 09:00 团队周会 (工作)
• 14:00 客户电话 (工作)
周三
• 10:00 产品演示 (工作)
周五
• 16:00 周报 (工作)
示例 2：快速添加事件
你： 在 Google 日历添加：明天下午2点和老板开会
小龙虾： 好的，正在添加事件...
gcalcli quick "和老板开会 明天下午2点"
✅ 事件已添加！
标题：和老板开会
时间：明天 14:00
日历：主日历
示例 3：搜索事件
你： 搜索一下最近有没有关于"发布"的日程
小龙虾： 正在搜索...
🔍 找到 2 个相关事件：
• 3月13日 10:00 产品发布演示
• 3月20日 15:00 新版本发布会议
示例 4：邀请参与者
你： 创建一个周五下午3点的会议，邀请 alice@company.com 和 bob@company.com
小龙虾： 好的，正在创建会议并发送邀请...
✅ 会议已创建！
标题：会议
时间：周五 15:00 - 16:00
参与者：alice@company.com, bob@company.com
已发送日历邀请
⚠️ 注意事项
- OAuth 授权 - 首次使用需要在浏览器中完成授权
- 令牌刷新 - 访问令牌会自动刷新
- 时区设置 - API 使用 UTC，显示时转换为本地时区
- 配额限制 - 每日有 API 调用配额
- 共享日历 - 可以访问有权限的共享日历
🔗 相关技能
apple-calendargmailoutlook-calendar
📬
outlook-calendar
通过 Microsoft Graph API 管理 Outlook/Microsoft 365 日历
跨平台日历Microsoft
📌 功能简介
outlook-calendar 技能让小龙虾能够管理你的 Outlook 或 Microsoft 365 日历。 适合企业用户，支持查看日程、创建会议、管理会议室、发送会议邀请等。 与 Microsoft Teams 无缝集成。
底层使用 Microsoft Graph Calendar API。
🔧 设置步骤
步骤一：注册 Azure AD 应用
- 访问 Azure Portal - App registrations
- 点击「New registration」
- 填写应用名称，选择支持的账户类型
- 设置重定向 URI（如 http://localhost:8080）
步骤二：配置 API 权限
- 在应用页面点击「API permissions」
- 添加「Microsoft Graph」权限：
Calendars.Read # 读取日历
Calendars.ReadWrite # 读写日历
User.Read # 读取用户信息
步骤三：获取客户端密钥
- 点击「Certificates & secrets」
- 创建新的 Client secret
- 记录 Client ID 和 Client Secret
步骤四：配置环境变量
# 在 .env 文件中添加
AZURE_CLIENT_ID="your-client-id"
AZURE_CLIENT_SECRET="your-client-secret"
AZURE_TENANT_ID="your-tenant-id"
⚙️ 核心 API 操作
获取日历事件
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" \
"https://graph.microsoft.com/v1.0/me/calendar/events?\
\$top=10&\$orderby=start/dateTime"
获取今天的事件
START=$(date -u +%Y-%m-%dT00:00:00Z)
END=$(date -u +%Y-%m-%dT23:59:59Z)
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" \
"https://graph.microsoft.com/v1.0/me/calendarview?\
startDateTime=$START&endDateTime=$END"
创建会议
curl -X POST -H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
"https://graph.microsoft.com/v1.0/me/calendar/events" \
-d '{
"subject": "团队会议",
"start": {"dateTime": "2024-03-15T14:00:00", "timeZone": "Asia/Shanghai"},
"end": {"dateTime": "2024-03-15T15:00:00", "timeZone": "Asia/Shanghai"},
"attendees": [{"emailAddress": {"address": "alice@company.com"}}],
"isOnlineMeeting": true,
"onlineMeetingProvider": "teamsForBusiness"
}'
查找空闲时间
curl -X POST -H "Authorization: Bearer $ACCESS_TOKEN" \
"https://graph.microsoft.com/v1.0/me/calendar/getSchedule" \
-d '{"schedules": ["alice@company.com"], ...}'
💬 与小龙虾对话示例
示例 1：查看 Outlook 日程
你： 看一下我 Outlook 日历今天的安排
小龙虾： 正在获取 Outlook 日历...
📅 今日 Outlook 日程：
• 09:00 - 09:30 团队站会 (Teams 会议)
• 11:00 - 12:00 项目讨论 (会议室 A)
• 14:00 - 15:00 客户演示 (Teams 会议)
• 16:30 - 17:00 一对一会议 (Teams 会议)
示例 2：创建 Teams 会议
你： 帮我安排一个明天下午3点的 Teams 会议，邀请 alice 和 bob
小龙虾： 好的，正在创建 Teams 会议...
✅ Teams 会议已创建！
标题：会议
时间：明天 15:00 - 16:00
参与者：alice@company.com, bob@company.com
Teams 链接：https://teams.microsoft.com/meet/...
已发送会议邀请
示例 3：检查同事空闲时间
你： 看一下 alice 明天什么时候有空
小龙虾： 正在查询空闲时间...
📊 alice@company.com 明天的空闲时间：
✓ 09:00 - 10:00 空闲
✗ 10:00 - 11:30 忙碌
✓ 11:30 - 13:00 空闲
✗ 14:00 - 16:00 忙碌
✓ 16:00 - 18:00 空闲
⚠️ 注意事项
- 企业账户 - Microsoft 365 企业版功能更完整
- 管理员同意 - 某些权限可能需要管理员批准
- Teams 集成 - 可以自动创建 Teams 会议链接
- 时区处理 - 需要指定正确的时区
- 会议室预订 - 支持企业会议室资源预订
🔗 相关技能
⏰
cron
使用 OpenClaw 内置调度器安排定时任务和自动化作业
跨平台自动化定时任务
📌 功能简介
cron 技能让小龙虾能够安排定时任务和自动化作业。 你可以设置每日提醒、定时检查、周期性报告等。 支持标准 cron 表达式和人类可读的时间描述。
底层使用 OpenClaw 内置的作业调度器，支持持久化存储。
📖 Cron 表达式语法
┌───────────── 分钟 (0 - 59)
│ ┌─────────── 小时 (0 - 23)
│ │ ┌───────── 日期 (1 - 31)
│ │ │ ┌─────── 月份 (1 - 12)
│ │ │ │ ┌───── 星期几 (0 - 6, 0 = 周日)
│ │ │ │ │
* * * * *
0 9 * * *每天早上 9:000 9 * * 1-5每个工作日早上 9:00*/30 * * * *每 30 分钟0 0 1 * *每月 1 号零点0 18 * * 5每周五下午 6:000 8,12,18 * * *每天 8:00, 12:00, 18:00
⚙️ 核心操作
创建定时任务
# 每天早上 9 点发送天气报告
openclaw cron add "0 9 * * *" "发送今日天气报告到 Telegram"
# 每周一上午 10 点提醒周会
openclaw cron add "0 10 * * 1" "提醒：周会开始了"
# 每小时检查一次邮件
openclaw cron add "0 * * * *" "检查重要邮件"
管理定时任务
# 列出所有定时任务
openclaw cron list
# 删除定时任务
openclaw cron remove <job-id>
# 暂停定时任务
openclaw cron pause <job-id>
# 恢复定时任务
openclaw cron resume <job-id>
# 查看任务执行历史
openclaw cron history <job-id>
使用自然语言
# 支持人类可读的时间描述
openclaw cron add "every day at 9am" "发送日报"
openclaw cron add "every monday at 10:00" "周会提醒"
openclaw cron add "every hour" "检查系统状态"
openclaw cron add "every 30 minutes" "同步数据"
💬 与小龙虾对话示例
示例 1：设置每日提醒
你： 帮我设置一个每天早上8点的提醒，提醒我喝水
小龙虾： 好的，正在创建定时任务...
openclaw cron add "0 8 * * *" "发送消息：记得喝水！💧"
✅ 定时任务已创建！
ID: cron_abc123
时间：每天 08:00
任务：发送提醒"记得喝水！💧"
示例 2：设置工作日提醒
你： 每个工作日下午5点提醒我写日报
小龙虾： 好的，正在设置...
openclaw cron add "0 17 * * 1-5" "提醒：该写日报了！"
✅ 定时任务已创建！
时间：每周一至周五 17:00
下次执行：明天 17:00
示例 3：查看所有定时任务
你： 显示我设置的所有定时任务
小龙虾： 正在获取任务列表...
📋 定时任务列表（共 3 个）：
1. [cron_abc123] 每天 08:00 - 喝水提醒 ✓
2. [cron_def456] 工作日 17:00 - 日报提醒 ✓
3. [cron_ghi789] 每周一 10:00 - 周会提醒 ⏸️(已暂停)
示例 4：设置定时检查
你： 每小时检查一次我的 GitHub 通知
小龙虾： 好的，正在创建定时检查任务...
✅ 定时检查任务已创建！
时间：每小时整点
任务：检查 GitHub 通知并汇报
下次执行：15:00
示例 5：删除定时任务
你： 取消喝水提醒
小龙虾： 好的，正在删除任务...
✅ 定时任务已删除！
已删除：喝水提醒 (每天 08:00)
🚀 高级用法
链式任务
# 每天早上：天气 → 日历 → 汇总消息
openclaw cron add "0 8 * * *" \
"获取今日天气; 获取今日日程; 发送汇总到 Telegram"
条件执行
# 只在有未读邮件时通知
openclaw cron add "*/30 * * * *" \
"检查邮件，如果有未读邮件则发送通知"
任务结果存储
# 查看最近执行结果
openclaw cron history cron_abc123 --limit 5
⚠️ 注意事项
- 网关运行 - 定时任务需要 OpenClaw 网关持续运行
- 时区 - 使用系统本地时区
- 持久化 - 任务配置保存在 ~/.openclaw/cron/
- 错过执行 - 如果网关关闭期间错过执行，不会补执行
- 资源消耗 - 高频任务会增加 API 调用成本
🔗 相关技能
🎨 媒体和内容类 Skills
处理图片、视频、PDF、RSS 订阅，让内容创作和消费更高效
共 9 个技能：blogwatcher, camsnap, gifgrep, nano-pdf, nano-banana-pro, openai-image-gen, summarize, video-frames, gog
📰
blogwatcher
监控博客和 RSS/Atom 源更新，及时获取新内容
跨平台RSS订阅
📌 功能简介
blogwatcher 技能让小龙虾能够监控你关注的博客和 RSS/Atom 订阅源。 当有新文章发布时，自动获取并通知你。支持定时检查、内容摘要、关键词过滤等功能。
底层使用 blogwatcher CLI，支持多种订阅格式和自定义更新频率。
🔧 安装和配置
# 安装 blogwatcher CLI
npm install -g blogwatcher
# 或使用 cargo
cargo install blogwatcher
添加订阅源
# 添加 RSS 源
blogwatcher add https://blog.example.com/feed.xml
# 添加带标签的源
blogwatcher add https://techblog.com/rss --tag tech
# 批量导入 OPML
blogwatcher import subscriptions.opml
⚙️ 核心命令
blogwatcher list列出所有订阅源blogwatcher check检查所有源的更新blogwatcher check --tag tech只检查特定标签的源blogwatcher recent显示最近的文章blogwatcher search "关键词"搜索文章标题blogwatcher remove <url>移除订阅源
💬 与小龙虾对话示例
示例 1：检查博客更新
你： 看看我订阅的博客有什么新文章
小龙虾： 正在检查订阅源更新...
📰 发现 3 篇新文章：
1. Hacker News
AI 编程助手的未来 (2小时前)
2. 阮一峰的博客
科技爱好者周刊 #298 (5小时前)
3. CSS-Tricks
CSS Grid 布局新特性 (1天前)
示例 2：添加新订阅
你： 帮我订阅 https://overreacted.io/rss.xml
小龙虾： 好的，正在添加订阅...
✅ 订阅添加成功！
名称：Overreacted
作者：Dan Abramov
最新文章：A Complete Guide to useEffect
示例 3：搜索文章
你： 搜一下最近有没有关于 React 的文章
小龙虾： 正在搜索...
🔍 找到 5 篇相关文章：
• React 19 新特性预览 - React Blog
• Server Components 深入解析 - Overreacted
• React vs Vue 2024 对比 - Dev.to
...
⚠️ 注意事项
- 检查频率 - 建议每小时检查一次，避免过于频繁
- 订阅格式 - 支持 RSS 2.0、Atom、JSON Feed
- 离线存储 - 文章缓存在本地，支持离线阅读
- OPML 导出 - 可以导出订阅列表用于备份
📹
camsnap
从 RTSP/ONVIF 摄像头捕获图像或视频剪辑
跨平台摄像头监控
📌 功能简介
camsnap 技能让小龙虾能够连接到 IP 摄像头，捕获实时画面或录制视频片段。 支持 RTSP 和 ONVIF 协议，兼容大多数网络摄像头和 NVR 系统。
底层使用 FFmpeg 进行视频流处理。
🔧 安装和配置
# 确保安装了 FFmpeg
brew install ffmpeg # macOS
apt install ffmpeg # Ubuntu/Debian
# 安装 camsnap
npm install -g camsnap
配置摄像头
# 在 ~/.openclaw/camsnap.json 中配置
{
"cameras": {
"front-door": {
"url": "rtsp://admin:password@192.168.1.100:554/stream1",
"name": "前门摄像头"
},
"backyard": {
"url": "rtsp://192.168.1.101:554/live",
"name": "后院摄像头"
}
}
}
⚙️ 核心命令
# 捕获单帧图像
camsnap capture front-door -o snapshot.jpg
# 录制 10 秒视频
camsnap record front-door -d 10 -o clip.mp4
# 从 RTSP URL 直接捕获
camsnap capture "rtsp://192.168.1.100:554/stream"
# 列出配置的摄像头
camsnap list
💬 与小龙虾对话示例
示例 1：查看摄像头画面
你： 看一下前门摄像头现在的画面
小龙虾： 正在捕获前门摄像头画面...
📷 已捕获前门摄像头快照
时间：2024-03-15 14:30:25
分辨率：1920x1080
[图片已发送]
示例 2：录制视频片段
你： 录制后院摄像头 30 秒的视频
小龙虾： 好的，正在录制...
🎬 视频录制完成！
摄像头：后院摄像头
时长：30秒
文件：backyard_20240315_143025.mp4
大小：15.2 MB
示例 3：检查所有摄像头状态
你： 检查一下所有摄像头的状态
小龙虾： 正在检查摄像头连接...
📹 摄像头状态：
✅ front-door (前门摄像头) - 在线
✅ backyard (后院摄像头) - 在线
❌ garage (车库摄像头) - 离线
⚠️ 注意事项
- 网络要求 - 确保能访问摄像头的 RTSP 端口（通常 554）
- 凭据安全 - 摄像头密码应妥善保管
- 带宽考虑 - 高清视频流需要足够的网络带宽
- 隐私合规 - 确保摄像头使用符合当地法规
🎞️
gifgrep
搜索 GIF 图库，下载和提取静帧
跨平台GIF表情包
📌 功能简介
gifgrep 技能让小龙虾能够搜索 Giphy、Tenor 等 GIF 图库， 下载 GIF 动图，提取静帧，或将视频转换为 GIF。非常适合在聊天中发送表情包！
🔧 安装和配置
# 安装 gifgrep
npm install -g gifgrep
# 配置 API 密钥（可选，提高配额）
export GIPHY_API_KEY="your-api-key"
export TENOR_API_KEY="your-api-key"
⚙️ 核心命令
# 搜索 GIF
gifgrep search "thumbs up"
# 下载 GIF
gifgrep download "https://giphy.com/..." -o reaction.gif
# 提取 GIF 的第一帧
gifgrep frame reaction.gif -n 1 -o frame.png
# 获取随机 GIF
gifgrep random "cat"
# 获取热门 GIF
gifgrep trending --limit 10
💬 与小龙虾对话示例
示例 1：搜索 GIF
你： 找一个表示开心的 GIF
小龙虾： 正在搜索 GIF...
🎉 找到 5 个相关 GIF：
1. [开心跳舞的小人]
2. [庆祝撒花]
3. [卡通人物大笑]
...
需要我发送哪一个？
示例 2：发送随机 GIF
你： 发一个猫咪的 GIF
小龙虾： 好的，给你找一个可爱的猫咪 GIF...
🐱 [发送了一个猫咪 GIF]
来源：Giphy
标签：#cat #cute #funny
示例 3：提取 GIF 帧
你： 把这个 GIF 的第 5 帧提取出来
小龙虾： 好的，正在提取帧...
🖼️ 帧提取完成！
帧数：第 5 帧（共 24 帧）
分辨率：480x360
格式：PNG
📄
nano-pdf
使用自然语言指令编辑和处理 PDF 文件
跨平台PDF文档
📌 功能简介
nano-pdf 技能让小龙虾能够使用自然语言处理 PDF 文件。 你可以合并、拆分、旋转、提取页面、添加水印、转换格式等，无需学习复杂的命令。
🔧 安装
# 安装 nano-pdf
npm install -g nano-pdf
# 或使用 pip
pip install nano-pdf
⚙️ 核心功能
合并 PDF将多个 PDF 合并为一个拆分 PDF按页码范围或每页拆分提取页面提取指定页面旋转页面旋转 90/180/270 度添加水印添加文字或图片水印压缩 PDF减小文件大小转换格式PDF 转图片、Word 等
# 命令行示例
nano-pdf merge file1.pdf file2.pdf -o merged.pdf
nano-pdf split document.pdf --pages 1-5 -o part1.pdf
nano-pdf rotate document.pdf --angle 90
nano-pdf watermark document.pdf --text "机密"
nano-pdf compress large.pdf -o small.pdf
💬 与小龙虾对话示例
示例 1：合并 PDF
你： 把这三个 PDF 合并成一个
小龙虾： 好的，正在合并 PDF...
✅ PDF 合并完成！
输入：file1.pdf, file2.pdf, file3.pdf
输出：merged.pdf
总页数：45 页
文件大小：2.3 MB
示例 2：提取页面
你： 从这个 PDF 里提取第 5-10 页
小龙虾： 好的，正在提取页面...
✅ 页面提取完成！
提取范围：第 5-10 页
输出：extracted_pages.pdf
页数：6 页
示例 3：添加水印
你： 给这个 PDF 加上"内部文件"的水印
小龙虾： 好的，正在添加水印...
✅ 水印添加完成！
水印文字：内部文件
位置：居中对角线
透明度：30%
示例 4：压缩 PDF
你： 这个 PDF 太大了，帮我压缩一下
小龙虾： 好的，正在压缩...
✅ PDF 压缩完成！
原始大小：25.6 MB
压缩后：8.2 MB
压缩率：68%
🎨
nano-banana-pro
使用 Google Gemini 生成和编辑图像
跨平台AI 图像Gemini
📌 功能简介
nano-banana-pro 技能使用 Google Gemini 的图像生成能力， 让小龙虾能够根据文字描述生成图像，或者编辑修改现有图片。
底层使用 Gemini Vision Pro API。
🔧 配置
# 在 .env 中配置 Google API Key
GOOGLE_API_KEY="your-google-api-key"
# 获取 API Key: https://makersuite.google.com/app/apikey
💬 与小龙虾对话示例
示例 1：生成图像
你： 帮我生成一张可爱的卡通小龙虾图片
小龙虾： 好的，正在生成图像...
🎨 图像生成完成！
提示词：可爱的卡通小龙虾
分辨率：1024x1024
[图片已生成]
示例 2：编辑图像
你： 把这张图片的背景改成海滩
小龙虾： 好的，正在编辑图像...
✅ 图像编辑完成！
操作：替换背景为海滩场景
[编辑后的图片已发送]
示例 3：风格转换
你： 把这张照片转换成油画风格
小龙虾： 好的，正在转换风格...
🖼️ 风格转换完成！
原始风格：照片
目标风格：油画
[转换后的图片已发送]
⚠️ 注意事项
- API 配额 - Gemini API 有免费配额限制
- 内容政策 - 遵守 Google 的内容生成政策
- 生成时间 - 复杂图像可能需要几秒钟
🖼️
openai-image-gen
使用 OpenAI DALL-E 批量生成图像
跨平台AI 图像DALL-E
📌 功能简介
openai-image-gen 技能使用 OpenAI 的 DALL-E 模型生成图像。 支持批量生成、不同尺寸、风格变化，并自动创建图片画廊。
🔧 配置
# 在 .env 中配置 OpenAI API Key
OPENAI_API_KEY="sk-your-openai-key"
⚙️ 核心命令
# 生成单张图像
openai-image-gen "a cute robot playing piano"
# 批量生成（4张）
openai-image-gen "sunset over mountains" -n 4
# 指定尺寸
openai-image-gen "logo design" --size 1024x1024
# 使用 DALL-E 3
openai-image-gen "detailed artwork" --model dall-e-3
# 生成画廊 HTML
openai-image-gen "various flowers" -n 6 --gallery
💬 与小龙虾对话示例
示例 1：生成图像
你： 用 DALL-E 生成一张"宇宙中的小龙虾"
小龙虾： 好的，正在调用 DALL-E 生成图像...
🎨 DALL-E 图像生成完成！
提示词：宇宙中的小龙虾
模型：DALL-E 3
尺寸：1024x1024
[图片已生成并发送]
示例 2：批量生成
你： 帮我生成 4 张不同风格的 Logo 设计
小龙虾： 好的，正在批量生成...
🎨 批量生成完成！
数量：4 张
已创建画廊：gallery.html
[图片已保存到 ./output/]
💰 价格参考
DALL-E 31024x1024$0.040DALL-E 31024x1792$0.080DALL-E 21024x1024$0.020
summarize
从 URL、播客、文件中总结和提取内容
跨平台AI 总结内容
📌 功能简介
summarize 技能让小龙虾能够快速总结各种内容来源： 网页文章、YouTube 视频、播客音频、本地文档等。节省你的阅读和观看时间！
📋 支持的内容类型
网页 URL自动提取文章内容并总结YouTube提取字幕/转录并总结播客语音转文字后总结PDF提取文本并总结本地文件支持 txt, md, docx 等
⚙️ 核心命令
# 总结网页文章
summarize https://example.com/article
# 总结 YouTube 视频
summarize https://youtube.com/watch?v=xxx
# 总结本地文件
summarize document.pdf
# 指定总结长度
summarize article.txt --length short
# 提取关键要点
summarize meeting.mp3 --format bullets
💬 与小龙虾对话示例
示例 1：总结网页
你： 帮我总结一下这篇文章 https://example.com/ai-trends-2024
小龙虾： 正在读取并总结文章...
📝 文章总结：
标题：2024 AI 发展趋势
来源：TechBlog
阅读时间：约 12 分钟
核心要点：
1. 多模态 AI 成为主流
2. AI Agent 应用爆发
3. 本地化部署需求增长
4. AI 安全和伦理受到重视
示例 2：总结 YouTube 视频
你： 这个 YouTube 视频讲了什么？ https://youtube.com/watch?v=xxx
小龙虾： 正在获取视频字幕并总结...
🎬 视频总结：
标题：如何构建 AI 助手
时长：45 分钟
作者：Tech Tutorial
主要内容：
视频介绍了从零开始构建 AI 助手的完整流程，包括选择模型、设计对话流程、集成 API 等步骤...
示例 3：总结会议录音
你： 帮我总结一下今天的会议录音
小龙虾： 正在转录并总结会议内容...
🎙️ 会议总结：
时长：32 分钟
参与者：Alice, Bob, Charlie
讨论要点：
1. Q1 项目进度回顾
2. 新功能开发计划
3. 资源分配调整
行动项：
• Alice 完成设计稿 (3月20日)
• Bob 准备技术方案 (3月18日)
🎬
video-frames
使用 FFmpeg 从视频提取帧或剪辑片段
跨平台视频FFmpeg
📌 功能简介
video-frames 技能使用 FFmpeg 处理视频文件。 你可以提取特定时间点的帧、生成缩略图、裁剪视频片段、转换格式等。
🔧 安装
# 安装 FFmpeg
brew install ffmpeg # macOS
apt install ffmpeg # Ubuntu
choco install ffmpeg # Windows
⚙️ 核心命令
# 提取特定时间点的帧
video-frames extract video.mp4 --time 00:01:30 -o frame.jpg
# 每 10 秒提取一帧
video-frames extract video.mp4 --interval 10 -o frames/
# 裁剪视频片段
video-frames clip video.mp4 --start 00:05:00 --end 00:05:30 -o clip.mp4
# 生成缩略图网格
video-frames thumbnails video.mp4 --grid 4x4 -o preview.jpg
# 转换为 GIF
video-frames gif video.mp4 --start 00:00:05 --duration 3 -o animation.gif
💬 与小龙虾对话示例
示例 1：提取视频帧
你： 从这个视频的 1 分 30 秒处截取一张图片
小龙虾： 好的，正在提取帧...
🖼️ 帧提取完成！
时间点：01:30.000
分辨率：1920x1080
输出：frame_01_30.jpg
示例 2：裁剪视频
你： 把这个视频从第 5 分钟到第 8 分钟剪出来
小龙虾： 好的，正在裁剪视频...
✂️ 视频裁剪完成！
原时长：15:30
裁剪范围：05:00 - 08:00
新时长：3:00
输出：clip_05_08.mp4
示例 3：转换为 GIF
你： 把视频前 5 秒转成 GIF
小龙虾： 好的，正在转换...
🎞️ GIF 转换完成！
时长：5 秒
帧率：15 fps
大小：2.3 MB
输出：animation.gif
🔷
gog
Google Workspace CLI - 统一管理 Gmail、Calendar、Drive、Sheets 等
跨平台Google办公套件
📌 功能简介
gog (Google Workspace CLI) 是一个统一的命令行工具， 让小龙虾能够管理整个 Google 生态系统：Gmail、Calendar、Drive、Contacts、Sheets、Docs 等。
🔧 安装和配置
# 安装 gog CLI
npm install -g gog-cli
# 首次使用需要授权
gog auth login
📋 支持的服务
Gmailgog mail收发邮件、搜索、标签管理Calendargog cal日程管理、事件创建Drivegog drive文件上传下载、共享Contactsgog contacts联系人管理Sheetsgog sheets电子表格读写Docsgog docs文档创建编辑
⚙️ 常用命令示例
# Gmail
gog mail inbox # 查看收件箱
gog mail send -t user@email.com # 发送邮件
# Calendar
gog cal today # 今日日程
gog cal add "会议" tomorrow 2pm # 添加事件
# Drive
gog drive list # 列出文件
gog drive upload file.pdf # 上传文件
gog drive download "file-id" # 下载文件
# Sheets
gog sheets read "sheet-id" A1:D10 # 读取数据
gog sheets write "sheet-id" A1 "Hello" # 写入数据
💬 与小龙虾对话示例
示例 1：综合查询
你： 看一下我今天的邮件和日程
小龙虾： 正在获取 Google Workspace 信息...
📬 Gmail（3 封未读）：
• 项目更新通知 - PM
• 周报提醒 - HR
• 会议邀请 - Alice
📅 今日日程：
• 10:00 团队周会
• 14:00 客户电话
• 16:00 代码评审
示例 2：上传文件到 Drive
你： 把这个 PDF 上传到我的 Google Drive
小龙虾： 好的，正在上传到 Drive...
✅ 文件上传成功！
文件名：report.pdf
大小：2.5 MB
位置：My Drive
链接：https://drive.google.com/file/d/xxx
示例 3：读取 Sheets 数据
你： 读一下销售报表的前 10 行数据
小龙虾： 正在读取 Google Sheets...
📊 销售报表数据：
| 日期 | 产品 | 销量 | 金额 |
|------|------|------|------|
| 3/1 | A | 100 | ¥5000 |
| 3/2 | B | 85 | ¥4250 |
| 3/3 | A | 120 | ¥6000 |
...
⚠️ 注意事项
- OAuth 授权 - 首次使用各服务需要单独授权
- 权限范围 - 只申请必要的权限
- 配额限制 - Google API 有每日调用限额
- 企业账户 - 某些功能可能需要 Workspace 企业版
