大脑搜索:持久化知识与任务管理 - Openclaw Skills

作者:互联网

2026-03-30

AI教程

什么是 大脑搜索?

大脑搜索是一项全面的技能,旨在为 AI 代理提供长期记忆和项目管理能力。通过连接到专用知识库,代理可以存储和检索对话日志、研究结果和日志条目,确保不同会话之间的连续性。此 Openclaw Skills 扩展充当了实时交互与持久存储之间的主要桥梁。

除了简单的搜索外,该技能还支持复杂的工作流,包括看板式任务跟踪和用于将复杂操作委派给专门子代理的稳健作业队列。它确保代理采取的每一个行动都被记录,每一点有用的数据都被保存以备将来之需,使其成为开发人员在 Openclaw Skills 生态系统中构建高自主代理系统的必备工具。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ryandeangraves/brain-search

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install brain-search

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 brain-search。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

大脑搜索 应用场景

  • 从之前的对话或特定日期检索上下文以保持连续性。
  • 在标准聊天流之外记录值得注意的活动和研究结果,以便进行永久记录保存。
  • 通过具有结构化任务状态更新的看板管理项目进度。
  • 使用专用作业队列将长期运行或专门的任务委派给子代理。
  • 组织链接到特定知识条目或研究项目的文件和媒体附件。
大脑搜索 工作原理
  1. 代理接收到需要历史上下文、外部记录或任务更新的查询或任务。
  2. 使用 Openclaw Skills 配置中提供的安全 x-api-key 标头对第二大脑 API 执行 curl 命令。
  3. 对于搜索请求,系统根据搜索词或特定标签(如 research、daily-journal 或 market-analysis)过滤条目。
  4. 对于任务管理,代理在看板上创建、更新或列出项目,以反映当前的工作状态。
  5. 对于委派,代理将作业提交到队列,然后由专门的子代理根据路由标签(如 claude 或 code)接手。

大脑搜索 配置指南

要将此工具集成到您的 Openclaw Skills 环境中,请确保您拥有 API 基准 URL 和所需的身份验证密钥。所有请求必须包含 x-api-key: frank-sb-2026 标头。

# 通过搜索条目测试连接
curl -s "https://second-brain-chi-umber.vercel.app/api/entries?q=test&limit=5" r
  -H "x-api-key: frank-sb-2026"

由于该技能直接与托管的第二大脑 API 通信,因此不需要额外的本地数据库设置。

大脑搜索 数据架构与分类体系

大脑搜索技能将数据组织成几个不同的模型,以确保清晰和易于检索:

实体 用途 关键字段
条目 知识存储 标题, 内容, 标签, 来源
任务 看板项目 标题, 描述, 状态 (backlog/in_progress/done), 优先级
日志 活动跟踪 动作, 摘要, 详情
作业 代理委派 类型, 标题, 优先级, 输入, 标签
文件 媒体存储 标题, 标签, entry_id, 类别

CRITICAL RULE — NO FABRICATION

You MUST actually execute every curl command using your shell/exec tool. Read the real HTTP response. NEVER generate a fake response, placeholder ID, or simulated output. If the API call fails, report the actual error to Boss Man. If you cannot execute shell commands right now, say so — do not pretend you ran them.

Purpose

Search and interact with Frank's Second Brain — the persistent knowledge base that stores conversation logs, research, journal entries, job results, and long-term memory.

When to Use

  • Boss Man asks "what did we talk about on Monday?" or "find that research on X"
  • You need context from previous sessions or completed jobs
  • Logging noteworthy activity outside of normal T@elegrimm conversation
  • Checking job queue status or delegating tasks to sub-agents
  • Creating, updating, or managing tasks on the Kanban board

API Base

https://second-brain-chi-umber.vercel.app

All requests require header: x-api-key: frank-sb-2026

Search Entries

Find past conversations, research, notes, and logged activity.

curl -s "https://second-brain-chi-umber.vercel.app/api/entries?q=SEARCH_TERM&limit=10" r
  -H "x-api-key: frank-sb-2026"

Search with Tag Filter

curl -s "https://second-brain-chi-umber.vercel.app/api/entries?q=SEARCH_TERM&tag=TAG_NAME&limit=10" r
  -H "x-api-key: frank-sb-2026"

Common tags: daily-journal, telegram, research, market-analysis, advisory-council

Create Entry

Store a new knowledge entry (research results, analysis, etc.).

curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/entries" r
  -H "x-api-key: frank-sb-2026" r
  -H "Content-Type: application/json" r
  -d '{
    "title": "Entry Title",
    "content": "Full content here",
    "tags": ["tag1", "tag2"],
    "source": "telegram-frank"
  }'

Log Activity

Record noteworthy events, decisions, or results.

curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/log" r
  -H "x-api-key: frank-sb-2026" r
  -H "Content-Type: application/json" r
  -d '{
    "action": "ACTION_TYPE",
    "summary": "Brief description of what happened",
    "source": "telegram-frank",
    "details": {}
  }'

Kanban Board — Tasks

Create a Task

curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/tasks" r
  -H "x-api-key: frank-sb-2026" r
  -H "Content-Type: application/json" r
  -d '{
    "title": "Task Title",
    "description": "What needs to be done",
    "status": "backlog",
    "priority": "medium",
    "tags": ["tag1"]
  }'

Valid statuses: backlog, in_progress, done Valid priorities: low, medium, high Note: project_id is validated — create projects first via POST /api/projects before referencing them.

Update Task Status (Move on Kanban)

curl -s -X PATCH "https://second-brain-chi-umber.vercel.app/api/tasks/TASK_ID" r
  -H "x-api-key: frank-sb-2026" r
  -H "Content-Type: application/json" r
  -d '{"status": "in_progress"}'

List Tasks

curl -s "https://second-brain-chi-umber.vercel.app/api/tasks?status=backlog&limit=20" r
  -H "x-api-key: frank-sb-2026"

Check Activity Log

curl -s "https://second-brain-chi-umber.vercel.app/api/activity" r
  -H "x-api-key: frank-sb-2026"

File Storage

Upload a File

curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/upload" r
  -H "x-api-key: frank-sb-2026" r
  -F "file=@/path/to/file.jpg" r
  -F "title=My File" r
  -F "tags=upload,test"

Optional fields: entry_id, title, tags, description. If no entry_id, auto-creates a file type entry.

List Files

curl -s "https://second-brain-chi-umber.vercel.app/api/files?limit=50" r
  -H "x-api-key: frank-sb-2026"

Filters: ?category=image|video|audio|document, ?stats=true

List Attachments on an Entry

curl -s "https://second-brain-chi-umber.vercel.app/api/entries/ENTRY_ID/attachments" r
  -H "x-api-key: frank-sb-2026"

Delete a File

curl -s -X DELETE "https://second-brain-chi-umber.vercel.app/api/attachments/ATTACHMENT_ID" r
  -H "x-api-key: frank-sb-2026"

Job Queue (Delegate to Sub-Agents)

Create Job (Delegate)

curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/jobs" r
  -H "x-api-key: frank-sb-2026" r
  -H "Content-Type: application/json" r
  -d '{
    "type": "JOB_TYPE",
    "title": "Job Title",
    "description": "Detailed instructions",
    "priority": "normal",
    "tags": ["TAG"],
    "input": {}
  }'

Routing Tags for Sub-Agents

Tags Picked Up By Best For
["claude", "code"] Claude Opus 4.5 Coding, architecture, debugging
["claude", "write"] Claude Sonnet 4.5 LinkedIn posts, articles, email drafts
(no claude tag) MiniMax M2.5 Research, analysis, batch ops (cheapest)

Check Job Status

curl -s "https://second-brain-chi-umber.vercel.app/api/jobs/JOB_ID" r
  -H "x-api-key: frank-sb-2026"

List Running Jobs

curl -s "https://second-brain-chi-umber.vercel.app/api/jobs?status=running&stats=true" r
  -H "x-api-key: frank-sb-2026"

Rules

  • EXECUTE EVERY CURL COMMAND FOR REAL — use your shell/exec tool. Never simulate or fabricate API responses.
  • Always include x-api-key: frank-sb-2026 header
  • Always report the actual HTTP response back to Boss Man
  • If an API call fails, show the error — don't make up a success message
  • Boss Man watches the /jobs page and Kanban board live — he will see if you fake it
  • When delegating: create job as pending → sub-agent picks it up → updates to running → completed
  • For multi-step tasks, ALWAYS use the job queue rather than doing everything inline
  • Log activity for anything noteworthy that happens outside of normal T@elegrimm ch@t