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:

curl http://127.0.0.1:8000/health

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

uvicorn app.main:app --host 0.0.0.0 --port 8000

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

Core workflow

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
• /api/v1/sync_status 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):

curl "http://127.0.0.1:8000/api/v1/sync_status"

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

curl -X POST "http://127.0.0.1:8000/api/v1/trigger_sync"

• Read recent topics:

curl "http://127.0.0.1:8000/api/v1/topics?group_id=GROUP_ID&limit=50&offset=0"

• List groups:

curl "http://127.0.0.1:8000/api/v1/groups/all"

• List downloaded documents:

curl "http://127.0.0.1:8000/api/v1/documents?group_id=GROUP_ID&limit=50"

• Search document text:

curl "http://127.0.0.1:8000/api/v1/search_documents?q=KEYWORD&group_id=GROUP_ID"

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.