agentCLAWHUBUnverified
【官方】知识星球·主题管理工具
知识星球主题管理：搜索主题、查看主题详情、发布帖子、编辑主题、发表评论、回复某条评论（楼中楼）、回答提问、删除主题；通过 api call 查看主题评论列表、设置精华、设置标签、查看自己提的问题与已回答记录。当用户需要查找内容、发帖、编辑主题、评论、回复评论、回答问题、删除主题、查看主题评论、查看自己的提问记录、... Skill: 【官方】知识星球·主题管理工具 Owner: zsxq Summary: 知识星球主题管理：搜索主题、查看主题详情、发布帖子、编辑主题、发表评论、回复某条评论（楼中楼）、回答提问、删除主题；通过 api call 查看主题评论列表、设置精华、设置标签、查看自己提的问题与已回答记录。当用户需要查找内容、发帖、编辑主题、评论、回复评论、回答问题、删除主题、查看主题评论、查看自己的提问记录、... Tags: latest:1.3.1 Version history: v1.3.1 | 2026-05-22T07:25:05.610Z | auto - Improved and clarified documentation for shortcuts, API calls, and related workflow. - Expanded description to include楼中楼（nested replies
OpenClaw
Rank
62
Safety
84
Downloads
1.3k
Updated
Oct 10, 2026
Version
1.3.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.3K 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.3K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.3.1release · observed May 22, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17dz3yf3n26zg8jbw21a6ae7186nhvm:zsxq-topic- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- 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-zsxq-zsxq-topic/snapshot"
Documentation
CLAWHUB
41,665 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: zsxq-topic
version: 1.3.1
description: "知识星球主题管理：搜索主题、查看主题详情、发布帖子、编辑主题、发表评论、回复某条评论（楼中楼）、回答提问、删除主题；通过 api call 查看主题评论列表、设置精华、设置标签、查看自己提的问题与已回答记录。当用户需要查找内容、发帖、编辑主题、评论、回复评论、回答问题、删除主题、查看主题评论、查看自己的提问记录、或管理主题精华和标签时使用。"
metadata:
requires:
bins: ["zsxq-cli"]
cliHelp: "zsxq-cli topic --help"
---
# topic
> 首次使用或遇到认证错误（401 / token 过期 / `not logged in`）时，先读 [`../zsxq-shared/SKILL.md`](../zsxq-shared/SKILL.md) 了解登录与 API 调用约定。日常调用已登录账户时无需每次重读。
## Core Concepts
- **主题（Topic）**：星球内的内容单元，由 `topic_id` 唯一标识。类型：
- `talk`：普通帖子（图文）
- `q&a`：提问，可被星主回答
- `article`：长文章
- **评论（Comment）**：主题下的回复，由 `comment_id` 标识，支持楼中楼（`replied_comment_id`）。
- **精华（Digested）**：星主可将优质主题设为精华，在星球内突出展示。
## Resource Relationships
```
Group (group_id)
└── Topic (topic_id) — talk / q&a / article
├── Comment (comment_id)
│ └── 楼中楼 Reply (replied_comment_id)
├── Answer（q&a 类型专属）
└── Hashtag 标签列表
```
## Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（`zsxq-cli topic +<verb> [flags]`）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|----------|------|
| [`+search`](references/zsxq-topic-search.md) | 在星球内全文搜索主题，返回 topic_id / 类型 / 标题 / 时间表格 |
| [`+detail`](references/zsxq-topic-detail.md) | 获取单条主题的完整详情（内容、评论数、点赞数、标签等） |
| [`+create`](references/zsxq-topic-create.md) | 在指定星球发布新主题（帖子），需确认内容后执行 |
| [`+edit`](references/zsxq-topic-edit.md) | 编辑自己发布的主题（正文、附件），需确认内容后执行 |
| [`+reply`](references/zsxq-topic-reply.md) | 对主题发表评论，支持楼中楼回复，需确认内容后执行 |
| [`+answer`](references/zsxq-topic-answer.md) | 对提问类主题（q&a）发布官方回答，需确认内容后执行 |
## API（通过 `zsxq-cli api call` 直接调用）
Shortcut 未覆盖的高级操作：
| 工具 | 参数 | 说明 |
|------|------|------|
| `get_topic_comments` | `topic_id`, `limit`, `index` | 获取主题评论列表（分页） |
| `set_topic_digested` | `topic_id`, `digested` | 设置/取消精华（星主权限） |
| `set_topic_tags` | `topic_id`, `titles` | 为主题设置标签（标签名数组） |
| `get_self_question_topics` | `topic_filter`, `count`, `end_time` | 查看自己发起的提问（`unanswered`/`answered`） |
| `get_self_answer_topics` | `topic_filter`, `count`, `end_time` | 查看别人向我发起的提问（`unanswered`/`answered`） |
## 原始 HTTP 调用（`zsxq-cli api raw`）
| 操作 | 命令模板 | 说明 |
|------|----------|------|
| [删除主题](references/zsxq-topic-delete.md) | `api raw --method DELETE --path /v2/topics/<topic_id>` | 删除主题，不可恢复 |_meta.json
{
"ownerId": "kn7dxggz98t1mjmzn9jmtbva1d855kbt",
"slug": "zsxq-topic",
"version": "1.3.1",
"publishedAt": 1779434705610
}references/zsxq-topic-answer.md
# topic +answer（回答提问）
本 skill 对应 shortcut：`zsxq-cli topic +answer`。
对 `q&a` 类型的主题发布**官方回答**。仅适用于问答类主题，且每个问题只能回答一次。
> [!CAUTION]
> 这是**公开写入操作**，且**每个问题只能回答一次**，回答后无法修改。执行前必须向用户确认：
> 1. 目标主题（topic_id）及其问题内容
> 2. 回答的完整内容
> [!IMPORTANT]
> `+answer` 与 `+reply` 的区别：
> - `+answer`：发布"官方回答"，附加在问题下方，标记为已回答（`q&a` 专用，只能用一次）
> - `+reply`：发表普通评论，适用于所有类型主题，可发多条
## 命令
```bash
# 回答一个提问
zsxq-cli topic +answer \
--topic-id 111222333466 \
--text "示例回答内容"
# JSON 格式输出
zsxq-cli topic +answer \
--topic-id 111222333466 \
--text "示例回答内容" \
--json
# 带附件的回答
zsxq-cli topic +answer \
--topic-id 111222333466 \
--text "示例回答内容" \
--files diagram.png
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--topic-id <id>` | **是** | 主题 ID（必须是 `q&a` 类型） |
| `--text <text>` | **是** | 回答正文 |
| `--files <paths>` | 否 | 附件路径，多个用逗号分隔 |
| `--json` | 否 | 输出原始 JSON |
## 推荐工作流
先确认主题类型，再发布：
```bash
# 第一步：确认目标主题是 q&a 类型并核对问题内容
zsxq-cli topic +detail --topic-id 111222333466 --json
# 查看返回 JSON 中的 "type" 是否为 "q&a"
# 第二步：确认无误后发布回答
zsxq-cli topic +answer \
--topic-id 111222333466 \
--text "示例回答内容"
```
如果不知道有哪些待回答的提问，先列一下：
```bash
# 自己发起的未回答提问
zsxq-cli api call get_self_question_topics --params '{"topic_filter":"unanswered","count":20}'
# 别人向我发起的未回答提问
zsxq-cli api call get_self_answer_topics --params '{"topic_filter":"unanswered","count":20}'
```
> `get_self_question_topics` / `get_self_answer_topics` 还支持 `topic_filter:"answered"` 查看已回答记录。
## 失败语义
写入失败即原子回滚 —— 失败不会消耗"每题只能回答一次"的额度，确认参数后可重试。
## 错误说明
| 错误 | 原因 |
|------|------|
| `问题已回答` | 该主题已有官方回答，每题只能回答一次 |
| `topic is not q&a` | 主题类型不是提问，应使用 `+reply` 发评论 |
通用错误（401、`--topic-id is required`、主题不存在等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。
## 参考
- [zsxq-topic-reply](zsxq-topic-reply.md) — 发表普通评论（适用于所有类型）
- [zsxq-topic-detail](zsxq-topic-detail.md) — 查看主题详情和类型
- [zsxq-shared](../../zsxq-shared/SKILL.md)references/zsxq-topic-create.md
# topic +create（发布主题）
本 skill 对应 shortcut：`zsxq-cli topic +create`。
在指定星球内发布一条新主题（帖子）。
> [!CAUTION]
> 这是**公开写入操作** —— 发布后对星球成员可见。执行前必须向用户确认：
> 1. 目标星球（group_id 和星球名称）
> 2. 发布的内容
## 命令
```bash
# 发布一条主题
zsxq-cli topic +create \
--group-id 123456789 \
--text "示例主题正文内容"
# 带附件（图片/文件，逗号分隔）
zsxq-cli topic +create \
--group-id 123456789 \
--text "示例内容" \
--files photo.jpg,report.pdf
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--group-id <id>` | **是** | 目标星球 ID（从 `group +list` 获取） |
| `--text <text>` | **是** | 主题正文内容，支持 `\n` 换行 |
| `--files <paths>` | 否 | 附件路径，多个用逗号分隔（图片/文件） |
| `--json` | 否 | 输出原始 JSON（含新建 topic_id） |
## 输出
成功后输出：
```
✓ Topic created
{
"topic_id": "111222333455",
"title": "示例主题标题",
"create_time": "2026-04-01T15:44:23.555+0800"
}
```
## 推荐工作流
```bash
# 第一步：确认目标星球
zsxq-cli group +list
# 第二步：确认内容无误后执行
zsxq-cli topic +create --group-id <id> --text "内容"
# 第三步：验证发布结果
zsxq-cli topic +detail --topic-id <新建的 topic_id>
```
## 失败语义
写入失败即原子回滚 —— 不会留下空主题或半成品 topic_id。重试前请先确认参数是否合法。
## 错误说明
通用错误（401、`--group-id is required`、星球无权限发帖等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。本命令无特有错误。
## 参考
- [zsxq-topic-reply](zsxq-topic-reply.md) — 对已发主题评论
- [zsxq-group-list](../../zsxq-group/references/zsxq-group-list.md) — 获取 group_id
- [zsxq-shared](../../zsxq-shared/SKILL.md)references/zsxq-topic-delete.md
# topic 删除（通过 api raw） 通过 `zsxq-cli api raw` 删除指定主题。删除后**不可恢复**。 > [!CAUTION] > 这是**不可逆的破坏性操作** —— 删除后主题及其所有评论、回答将永久消失，无法恢复。执行前必须向用户确认： > 1. 目标主题（topic_id）及其内容 > 2. 明确用户确实要删除（而非取消精华、删除评论等其他操作） ## 命令 ```bash # 删除主题 zsxq-cli api raw --method DELETE --path /v2/topics/<topic_id> # 示例 zsxq-cli api raw --method DELETE --path /v2/topics/15522482218442 ``` ## 参数 | 参数 | 必填 | 说明 | |------|------|------| | `<topic_id>` | **是** | 主题 ID（拼接到 URL 路径中） | ## 推荐工作流 ```bash # 第一步：确认主题内容，确保删对目标 zsxq-cli topic +detail --topic-id 15522482218442 # 第二步：向用户确认后执行删除 zsxq-cli api raw --method DELETE --path /v2/topics/15522482218442 ``` ## 失败语义 删除失败即原子回滚 —— 主题保持原状不会被部分删除。 ## 错误说明 | 错误 | 原因 | |----------------|------| | `code: 100262` | 无权限删除该主题（非主题作者或星主） | | `code: 100002` | 主题不存在或已被删除 | 通用错误（401、参数缺失等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。 ## 参考 - [zsxq-topic-edit](zsxq-topic-edit.md) — 删除前若只是想改内容，优先考虑编辑 - [zsxq-topic-detail](zsxq-topic-detail.md) — 删除前确认主题内容 - [zsxq-topic-search](zsxq-topic-search.md) — 搜索主题获取 topic_id - [zsxq-shared](../../zsxq-shared/SKILL.md)
Github ReposUpdated 1d agoRank 70
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!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
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
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
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/zsxq/skills/zsxq-topic",
"sourceUrl": "https://clawhub.ai/zsxq/skills/zsxq-topic",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T16:06:56.604Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-topic/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-topic/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T16:06:56.604Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/zsxq/zsxq-topic",
"sourceUrl": "https://clawhub.ai/zsxq/zsxq-topic",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T16:06:56.604Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.3.1",
"href": "https://clawhub.ai/zsxq/zsxq-topic",
"sourceUrl": "https://clawhub.ai/zsxq/zsxq-topic",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-22T07:25:05.610Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-topic/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-topic/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.3.1",
"description": "- Improved and clarified documentation for shortcuts, API calls, and related workflow. - Expanded description to include楼中楼（nested replies), viewing one’s own question records, and managing digests/tags. - Restructured HTTP API call instructions, making the delete operation more accessible. - Updated login and authentication instructions for clarity. - No changes to core commands or parameters.",
"href": "https://clawhub.ai/zsxq/zsxq-topic",
"sourceUrl": "https://clawhub.ai/zsxq/zsxq-topic",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-22T07:25:05.610Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.