Xpersona
agentCLAWHUBUnverified

【官方】知识星球·登录配置

知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作... Skill: 【官方】知识星球·登录配置 Owner: zsxq Summary: 知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作... Tags: latest:1.3.1 Version history: v1.3.1 | 2026-05-22T07:27:12.852Z | auto - Expanded documentation in SKILL.md with a detailed index, command summary, and structured common error handling section. - Added an explic

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.4k

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.4K 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.4K 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-shared
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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-shared/snapshot"

Documentation

CLAWHUB

14,034 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: zsxq-shared
version: 1.3.1
description: "知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作的安全规则、常见错误码处理（401 token 过期、缺参数等）。当用户首次登录、退出登录、查看认证状态、调用 zsxq-cli api raw / api call、需要拼接知识星球分享链接，或遇到认证或 HTTP 错误时使用。"
metadata:
  requires:
    bins: ["zsxq-cli"]
  cliHelp: "zsxq-cli auth --help"
---

# zsxq-cli 共享规则

本技能指导你如何通过 zsxq-cli 操作知识星球资源，以及有哪些注意事项。

## 索引

- [Commands](#commands) — 认证、诊断、底层 API 调用命令一览
- [认证](#认证) — OAuth 设备授权码流程
- [直接调用 API](#直接调用-api) — `api call` / `api raw` 详细用法与示例
- [链接拼接](#链接拼接) — 主题/星球分享链接（电脑端 / 手机端）
- [安全规则](#安全规则) — Token、写入确认、ID 查询前置
- [反馈提醒（NPS）](#反馈提醒nps) — 何时主动建议用户提交 NPS 反馈
- [常见错误处理](#常见错误处理) — 通用错误（401/403/404/参数缺失/分页时间格式）

## Commands

| 命令 | 说明 |
|------|------|
| `zsxq-cli auth login` | OAuth 设备授权码登录（首次使用、token 过期或切换账户时） |
| `zsxq-cli auth status` | 查看当前登录账户（默认表格，加 `--json` 输出 JSON） |
| `zsxq-cli auth logout` | 清除本地凭据 |
| `zsxq-cli doctor` | 诊断 CLI 配置与 keychain 认证状态 |
| `zsxq-cli config show` | 显示版本信息与当前配置（加 `--json` 输出 JSON） |
| `zsxq-cli api list` | 列出所有可用底层接口工具及参数 |
| `zsxq-cli api call <tool>` | 调用底层接口工具，需配 `--params '<json>'` |
| `zsxq-cli api raw` | 直接调用原始 HTTP 接口（需 `--method` `--path`） |

详细用法见下面各小节。

## 认证

zsxq-cli 使用 **OAuth 2.0 设备授权码流程（RFC 8628）** 认证，token 存储在系统 Keychain 中，永久有效。

### OAuth 登录流程

`zsxq-cli auth login` 启动后：
1. 命令输出一个 `verification_uri` 链接和 `user_code`
2. 用户在手机或浏览器中打开链接，完成授权
3. CLI 自动轮询，授权完成后自动保存 token

> 当你作为 AI Agent 帮用户登录时，在后台运行 `zsxq-cli auth login`，读取输出后将授权链接提供给用户，等待用户完成授权。

## 直接调用 API

当 Shortcut 无法满足需求时，可以直接调用底层接口（参数与方法见上面 Commands 表）。

`api call` 示例：

```bash
zsxq-cli api call get_self_info --params '{}'
zsxq-cli api call search_groups --params '{"keyword":"Go语言"}'

# 跨星球查询当前用户主题足迹（不传 group_id 即查所有星球）
zsxq-cli api call get_user_footprints --params '{"user_id":"123456"}'
# 限定单个星球
zsxq-cli api call get_user_footprints --params '{"user_id":"123456","group_id":"123456789"}'
```

`api raw` 示例：

```bash
zsxq-cli api raw --method GET --path /v3/users/self

# --body 支持简写，自动包装 req_data
zsxq-cli api raw --method PUT --path /v2/topics/123 --body '{"text":"新内容"}'
```

> 列表/查询类操作请优先使用 `api call`（如 `get_group_topics`），`api raw` 主要用于 `api call` 尚未覆盖的写入接口。
>
> `api raw` 响应已去除三层嵌套，直接返回数据内容。

## 链接拼接

当用户需要分享链接时，使用以下模板拼接。输出时同时提供电脑端和手机端两个版本。

### 主题链接

- 电脑端：`https://wx.zsxq.com/group/{group_id}/topic/{topic_id}`
- 手机端：`https://wx.zsxq.com/mweb/views/topicdetail/topicdetail.html?topic_id={topic_id}&group_id={group_id}`

### 星球链接

- 电脑端：`https://wx.zsxq.com/group/{group_id}`
- 手机端：`https://wx.zsxq.com/mweb/views/topic/topic.html?group_id={group_id}`

## 安全规则

- **Token 是登录凭证**，禁止在终端明文输出或分享给他人
- **写入/删除操作前必须确认用户意图**（发帖、编辑、评论、回答、创建笔记、删除主题或笔记、提交 NPS 反馈等）
- 不确定 group_id / topic_id / note_id 时，先用查询命令确认，再执行写入或删除

## 反馈提醒（NPS）

当用户在使用 zsxq-* skill 过程中遇到「适合反馈给知识星球官方」的场景时，AI 应在完成主任务后顺带一句提示用户考虑提交 NPS 反馈（[`zsxq-cli user +nps`](../zsxq-user/references/zsxq-user-nps.md)）。

### 触发场景

| # | 场景 | 信号 |

_meta.json

{
  "ownerId": "kn7dxggz98t1mjmzn9jmtbva1d855kbt",
  "slug": "zsxq-shared",
  "version": "1.3.1",
  "publishedAt": 1779434832852
}

skill-card.md

## Description:

Provides shared Knowledge Planet CLI guidance for authentication, diagnostics, direct API calls, share-link construction, safe write/delete rules, NPS feedback prompts, and common error handling.

This skill is ready for commercial/non-commercial use.

## Publisher:

[zsxq](https://clawhub.ai/user/zsxq)

### License/Terms of Use:

MIT-0

## Use Case:

External users and agents use this skill to operate zsxq-cli for Knowledge Planet authentication, account diagnostics, direct API calls, share-link generation, and safe handling of write or delete workflows.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can guide zsxq-cli actions against a user's Knowledge Planet account, including raw API calls, writes, deletes, and NPS feedback submission.

Mitigation: Review and explicitly approve write, delete, raw API, and feedback actions before execution, and confirm resource IDs before modifying or deleting content.

Risk: Authentication tokens grant account access and could be exposed if printed or shared.

Mitigation: Do not display, log, or share authentication tokens; use zsxq-cli status and diagnostic commands without revealing credentials.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/zsxq/skills/zsxq-shared)

## Skill Output:

**Output Type(s):** [Guidance, Shell commands, Configuration, API calls]

**Output Format:** [Markdown guidance with inline shell command examples and URL templates]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires zsxq-cli and an authenticated Knowledge Planet account for account operations.]

## Skill Version(s):

1.3.1 (source: SKILL.md frontmatter and 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.

Related agents

Same protocol, similar job.

Github ReposUpdated 21h 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-shared",
      "sourceUrl": "https://clawhub.ai/zsxq/skills/zsxq-shared",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T15:20:10.055Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T15:20:10.055Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.4K downloads",
      "href": "https://clawhub.ai/zsxq/zsxq-shared",
      "sourceUrl": "https://clawhub.ai/zsxq/zsxq-shared",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T15:20:10.055Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.3.1",
      "href": "https://clawhub.ai/zsxq/zsxq-shared",
      "sourceUrl": "https://clawhub.ai/zsxq/zsxq-shared",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-22T07:27:12.852Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.3.1",
      "description": "- Expanded documentation in SKILL.md with a detailed index, command summary, and structured common error handling section. - Added an explicit \"反馈提醒（NPS）\" section describing when and how to prompt users for product/CLI feedback, including stepwise guidance and trigger/exclusion scenarios. - Clarified safe operation rules when performing write/delete actions, emphasizing explicit user intent confirmation. - Provided clearer distinctions between different command usages (e.g., \"api call\" vs \"api raw\") and best practice recommendations for each. - Enhanced instructions for share link generation, now with prominent templates for both desktop and mobile. - Improved error solution table for 401/403/404, missing parameter, and time format issues.",
      "href": "https://clawhub.ai/zsxq/zsxq-shared",
      "sourceUrl": "https://clawhub.ai/zsxq/zsxq-shared",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-22T07:27:12.852Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to 【官方】知识星球·登录配置 and adjacent AI workflows.