ZSXQ Fetch

Use this skill to query the local OpenClaw ZSXQ database for summarization and grounded Q&A.

When to use

• - The user wants summaries of recent ZSXQ posts by time window or by group.
• The user asks questions that should be answered from synced ZSXQ posts or downloaded documents.
• The user wants to inspect downloaded attachments or search document text.
• The user wants to check sync status or manually trigger a sync.

Preconditions

• - The API server is running. Check with:

CODEBLOCK0

If it is not running, start it from the project root:

CODEBLOCK1

The server automatically syncs all subscribed groups in the background every hour (configurable via SYNC_INTERVAL_SECONDS).

Core workflow

1. 1. Query the database directly — do NOT sync before every request. Data is kept fresh by the background auto-sync.
2. Pull only the smallest relevant slice of data.
3. Use /api/v1/topics, /api/v1/documents, and /api/v1/search_documents to answer questions.
4. Summarize with explicit scope: group, time range, or topic.

When to trigger a manual sync

Only trigger a manual sync if:

• - The user explicitly asks for the "latest" or "most recent" content AND
• INLINECODE4 shows the last sync was more than 1 hour ago.

Otherwise, trust the database content.

Useful endpoints

• - Check sync status (always check this first for time-sensitive requests):

CODEBLOCK2

• - Trigger a manual sync (only if data is stale):

CODEBLOCK3

• - Read recent topics:

CODEBLOCK4

• - List groups:

CODEBLOCK5

• - List downloaded documents:

CODEBLOCK6

• - Search document text:

CODEBLOCK7

Summarization pattern

• - Pull recent topics for the requested group or across relevant groups.
• If documents may contain the answer, search them with keywords from the user question.
• Build the answer from retrieved records only. State when the answer is inferred from partial evidence.

Output guidance

• - For update summaries, group findings by topic or theme, not by raw post order.
• For question answering, cite the specific topic text or document match preview used.
• If the database has no relevant records, say so. Only recommend a manual sync if the last sync was more than 1 hour ago.