Mac 知识库搭建系统
⚠️ **本 skill 包含以下高危能力,使用前请仔细阅读 SKILL.md 顶部「⚠️ CAPABILITIES & RISKS」章节**: - Shell 执行 + 文件读写 + 安装 Homebrew 包(版本固定)+ 下载 Ollama 模型 - 修改 OpenClaw 配置 + 注册持久 cron 任务 + 飞书 webhook 推送 在 Mac Mini (M4) 上快速搭建本地知识库 + RAG 自然语言搜索系统。 适用场景: - 新 Mac 配置知识库:从零开始安装配置 Ollama、embedding模型、定时任务、文档解析 - 遇到 PDF 提取乱码、定时任务超时、skill 加载失败等问题 - 想要建立每日自动分析文档 + 08:00发送摘要到飞书的流程 - 迁移或复现知识库:打包整个 knowledge 目录和配置到新电脑 - **v1.4 新增**:CMap 残缺度自检(不预设来源)+ 50万字完整提取 + OCR fallback 到 .doc 本 skill 会引导完成:目录结构创建、依赖安装、脚本部署、定时任务注册、OpenClaw 配置。 ⚠️ **重要:能力范围** 本 skill 不只是「搭建」,还包含: - 批量 OCR 修复(扫描 summaries/archives 找乱码 + 重新提取) - 目录归档清理(移动重复/孤儿文件到 .trash/) - 自动定时任务(23:00 分析 + 06:00 飞书推送) 使用前请仔细评估批量修改风险。 Skill: Mac 知识库搭建系统 Owner: seairteng Summary: ⚠️ **本 skill 包含以下高危能力,使用前请仔细阅读 SKILL.md 顶部「⚠️ CAPABILITIES & RISKS」章节**: - Shell 执行 + 文件读写 + 安装 Homebrew 包(版本固定)+ 下载 Ollama 模型 - 修改 OpenClaw 配置 + 注册持久 cron 任务 + 飞书 webhook 推送 在 Mac Mini (M4) 上快速搭建本地知识库 + RAG 自然语言搜索系统。 适用场景: - 新 Mac 配置知识库:从零开始安装配置 Ollama、embedding模型、定时任务、文档解析 - 遇到 PDF 提取乱码、定时任务超时、skill 加载失败等问题 - 想要建立每日自动分析文档 + 08:00发送摘要到飞书的流程 - 迁移或复现知识库:打包整个 knowledge 目录和配置
Rank
62
Safety
84
Downloads
1.5k
Updated
Oct 10, 2026
Version
1.4.7
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.5K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.5K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.4.7release · observed Aug 17, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s170wy77rm29wznbver4enx39986fr18:macmini-knowledge-base- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-seairteng-macmini-knowledge-base/snapshot"
Documentation
CLAWHUB
147,170 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: macmini-knowledge-base
version: 1.4.7
description: |
⚠️ **本 skill 包含以下高危能力,使用前请仔细阅读 SKILL.md 顶部「⚠️ CAPABILITIES & RISKS」章节**:
- Shell 执行 + 文件读写 + 安装 Homebrew 包(版本固定)+ 下载 Ollama 模型
- 修改 OpenClaw 配置 + 注册持久 cron 任务 + 飞书 webhook 推送
在 Mac Mini (M4) 上快速搭建本地知识库 + RAG 自然语言搜索系统。
适用场景:
- 新 Mac 配置知识库:从零开始安装配置 Ollama、embedding模型、定时任务、文档解析
- 遇到 PDF 提取乱码、定时任务超时、skill 加载失败等问题
- 想要建立每日自动分析文档 + 08:00发送摘要到飞书的流程
- 迁移或复现知识库:打包整个 knowledge 目录和配置到新电脑
- **v1.4 新增**:CMap 残缺度自检(不预设来源)+ 50万字完整提取 + OCR fallback 到 .doc
本 skill 会引导完成:目录结构创建、依赖安装、脚本部署、定时任务注册、OpenClaw 配置。
⚠️ **重要:能力范围**
本 skill 不只是「搭建」,还包含:
- 批量 OCR 修复(扫描 summaries/archives 找乱码 + 重新提取)
- 目录归档清理(移动重复/孤儿文件到 .trash/)
- 自动定时任务(23:00 分析 + 06:00 飞书推送)
使用前请仔细评估批量修改风险。
---
# Knowledge Base Setup
在 Mac Mini 上快速搭建本地知识库 + RAG 搜索系统。
## ⚠️ 阅读前必读:本 skill 的能力范围
本 skill **不只是"搭建知识库"**,还包含以下高危能力:
**执行能力**:
- 🔧 **Shell 命令执行**(python3 + bash 脚本)
- 📁 **文件读写**(knowledge/, summaries/, archives/, .trash/)
- 📦 **安装 Homebrew 包**(antiword, tesseract, pandoc, libreoffice,**版本固定**)
- ⬇️ **下载 Ollama 模型**(nomic-embed-text, ~274MB)
- ⚙️ **修改 OpenClaw 配置**(~/.openclaw/openclaw.json)
- ⏰ **注册持久 cron 任务**(23:00 + 06:00,**每天自动**)
- 📤 **推送消息到飞书 webhook**
**持久化影响**:
- 知识库目录会被自动分析(每天 23:00)
- 摘要文件会被覆盖写入(OCR 修复时)
- cron 任务永久执行(直到手动 `openclaw cron remove <id>`)
- 失败文件移到 `.trash/`(7 天兜底清理)
**安装流程**:
本 skill 的 setup.sh 是**交互式安装向导**:
- 每个危险操作前会要求 y/N 确认
- 提供 `--dry-run` 选项查看会做什么
- 已安装用户重跑会进入确认模式
**如果不同意上述任何一项,请不要安装本 skill。**
### 结构化权限声明(Structured Permissions)
| 权限 | 必填 | 范围 | 用途 / 风险 |
|------|------|------|-------------|
| `exec` | ✅ | python3 + bash scripts | 文档提取 + 飞书推送 |
| `file_read` | ✅ | `~/.openclaw/workspace/knowledge/` | 读取文档 + summaries |
| `file_write` | ✅ | `summaries/`, `archives/`, `.trash/` | OCR 修复覆盖旧摘要 |
| `install_packages` | ✅ | brew: antiword, tesseract, pandoc, libreoffice | Homebrew 包安装(用户确认)|
| `download_model` | ✅ | ollama: nomic-embed-text (~274MB) | Ollama 模型下载(用户确认)|
| `modify_config` | ✅ | `~/.openclaw/openclaw.json` | 添加 alsoAllow: [exec, process] |
| `register_cron` | ✅ | 23:00 分析 + 06:00 推送 | 持久化定时任务(用户确认)|
| `network` | ✅ | 飞书 webhook + Ollama 下载 | 外部 API 调用 |
**warning**: 本 skill 会自动修改文件、安装包、注册 cron 任务(用户每步都有 y/N 确认)
**disable_command**: `openclaw cron remove <id>`
---
## 核心功能(v2.0)
- **kreuzberg 统一提取层**:PDF / DOCX / XLSX / PPTX / MD / 图片 OCR 全自动路由
- **antiword 极速专线**:.doc 文件专用提取,成功率 85%,169MB 文件 0.02 秒完成
- **智能兜底**:antiword 失败自动走 soffice 转换,60 秒硬超时无误判
- **自动分类**:关键词匹配驱动,中英文双语标签
- **定时任务**:每天 23:00 分析新文档,08:00 发送摘要到飞书
## 🔧 权限声明
本 skill 在使用时需要以下 OpenClaw 工具能力:
```json
{
"tools": {
"alsoAllow": ["exec", "process", "read", "write"]
}
}
```
⚠️ **执行风险**:exec + cron 自动化组合可导致持续命令执行,
请在可信环境(个人 Mac)使用,不要在共享/服务器部署。
## ⚠️ 安全警告:定时任务
本 skill 注册 2 个 cron 任务(23:00 分析 + 06:00 推送),
运行 shell 命令并自动推送消息到飞书。
**潜在风险**:
- 脚本路径被修改 → 自动执行任意命令
- 知识库目录被入侵 → 自动读取/外发
- 飞书 webhook 泄漏 → 自动推送被劫持
**建议**:
- 不要把 `~/.openclaw/workspace/knowledge` 放在共享/多用户目录
- 定期检查 c_meta.json
{
"ownerId": "kn7d38vmg57htam960qsj7wnkh86ewjb",
"slug": "macmini-knowledge-base",
"version": "1.4.7",
"publishedAt": 1786985191922
}CHANGELOG.md
# Changelog ## v1.4.7 (2026-08-17) — SKILL.md version 字段同步 - 修复 SKILL.md 顶部 version 字段(1.4.5 → 1.4.7) - 与 _meta.json version 一致 ## v1.4.6 (2026-08-17) — SKILL.md 修补 - 加"结构化权限声明"表格 - 修复 SKILL.md 顶部 version(1.4.2 → 1.4.5) ## v1.4.5 (2026-08-17) — NVIDIA SkillSpector 完整修复 ### 元数据修复 ### SKILL.md 修复 ### setup.sh 改造(交互式) ## v1.4.4 (2026-08-17) — 仅 SKILL.md 补充 ## v1.4.3 (2026-08-17) — 代码安全修复 ## v1.4.2 (2026-08-17) — 仅元数据更新
skill-card.md
## Description: Mac 知识库搭建系统 helps agents guide setup of a local Mac Mini knowledge base and RAG search workflow, including document extraction, OCR repair, catalog generation, scheduled analysis, and Feishu summary delivery. This skill is ready for commercial/non-commercial use. ## Publisher: [seairteng](https://clawhub.ai/user/seairteng) ### License/Terms of Use: MIT-0 ## Use Case: Developers and personal Mac users use this skill to configure a local knowledge-base workflow on a trusted Mac Mini, process documents into summaries and catalogs, and schedule recurring analysis plus Feishu notifications. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Broad exec/process permissions and persistent cron jobs can allow repeated command execution from the local workspace. Mitigation: Use the skill only on a trusted personal Mac, review the setup plan first, avoid broad default permission changes where possible, and remove unwanted cron entries with openclaw cron remove. Risk: The workflow reads local knowledge-base files and can send summaries through a Feishu webhook. Mitigation: Keep the workspace private, use a dedicated Feishu destination, store the webhook as a secret, and rotate it if it may have been exposed. Risk: The setup process may install Homebrew and Python dependencies and download an Ollama embedding model. Mitigation: Run the documented dry-run path first and install dependencies separately or from pinned trusted sources before enabling automation. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/seairteng/skills/macmini-knowledge-base) - [Ollama download](https://ollama.com/download) ## Skill Output: **Output Type(s):** [text, markdown, code, shell commands, configuration, guidance] **Output Format:** [Markdown guidance with inline shell commands, JSON snippets, and Python code examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [The skill guides interactive setup steps and includes dry-run guidance for the setup script.] ## Skill Version(s): 1.4.7 (source: frontmatter, CHANGELOG, _meta.json, server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/seairteng/skills/macmini-knowledge-base",
"sourceUrl": "https://clawhub.ai/seairteng/skills/macmini-knowledge-base",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T09:13:09.914Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-seairteng-macmini-knowledge-base/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-seairteng-macmini-knowledge-base/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T09:13:09.914Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.5K downloads",
"href": "https://clawhub.ai/seairteng/macmini-knowledge-base",
"sourceUrl": "https://clawhub.ai/seairteng/macmini-knowledge-base",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T09:13:09.914Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.4.7",
"href": "https://clawhub.ai/seairteng/macmini-knowledge-base",
"sourceUrl": "https://clawhub.ai/seairteng/macmini-knowledge-base",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-17T16:46:31.922Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-seairteng-macmini-knowledge-base/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-seairteng-macmini-knowledge-base/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.4.7",
"description": "v1.4.7: SKILL.md version 字段与 _meta.json 同步",
"href": "https://clawhub.ai/seairteng/macmini-knowledge-base",
"sourceUrl": "https://clawhub.ai/seairteng/macmini-knowledge-base",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-17T16:46:31.922Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
