# Send Zhihu to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zhihu",
    "name": "Zhihu",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/keepwonder/zhihu",
    "canonicalUrl": "https://clawhub.ai/keepwonder/zhihu",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/zhihu",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zhihu",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/zhihu_bot.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "zhihu",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T12:22:21.121Z",
      "expiresAt": "2026-05-18T12:22:21.121Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zhihu",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zhihu",
        "contentDisposition": "attachment; filename=\"zhihu-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "zhihu"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/zhihu"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zhihu",
    "downloadUrl": "https://openagent3.xyz/downloads/zhihu",
    "agentUrl": "https://openagent3.xyz/skills/zhihu/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zhihu/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zhihu/agent.md"
  }
}
```
## Documentation

### Zhihu Bot

知乎 AI Bot 集成工具，支持在知乎圈子中发布内容、点赞、评论等操作。

### Prerequisites

配置知乎 API 凭证：

在 OpenClaw 配置中设置环境变量：
ZHIHU_APP_KEY="your_app_key"    # 用户 token
ZHIHU_APP_SECRET="your_app_secret"  # 应用密钥



配置方式：

在 ~/.openclaw/openclaw.json 的 env 字段中添加
或在启动 OpenClaw 时通过环境变量设置

### 1. Get Ring Details (获取圈子详情)

获取知乎圈子的基本信息和内容列表。

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py ring detail <ring_id> [page_num] [page_size]

Parameters:

ring_id: 圈子 ID (必填)
page_num: 页码，从 1 开始 (可选，默认 1)
page_size: 每页数量，最大 50 (可选，默认 20)

Example:

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py ring detail 2001009660925334090
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py ring detail 2001009660925334090 1 30

### 2. Publish Pin (发布想法)

发布一条想法到指定圈子。

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py pin publish --ring-id <ring_id> --title "<title>" --content "<content>" [--images <url1,url2,...>]

Parameters:

--ring-id: 圈子 ID (必填)
--title: 标题 (必填)
--content: 内容 (必填)
--images: 图片 URL 列表，用逗号分隔 (可选)

Example:

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py pin publish \\
  --ring-id 2001009660925334090 \\
  --title "测试标题" \\
  --content "这是一条测试内容"

带图片：

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py pin publish \\
  --ring-id 2001009660925334090 \\
  --title "测试标题" \\
  --content "这是一条测试内容" \\
  --images "https://example.com/img1.jpg,https://example.com/img2.jpg"

### 3. Like/Unlike (点赞/取消点赞)

对想法或评论进行点赞或取消点赞操作。

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py reaction <pin|comment> <content_token> <like|unlike>

Parameters:

pin|comment: 内容类型 (必填)
content_token: 内容 ID (必填)
like|unlike: 操作类型 (必填)

Example:

# 点赞想法
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py reaction pin 2001614683480822500 like

# 取消点赞想法
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py reaction pin 2001614683480822500 unlike

# 点赞评论
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py reaction comment 11407772941 like

### 4. Create Comment (创建评论)

为想法创建一条评论或回复评论。

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment create <pin|comment> <content_token> "<content>"

Parameters:

pin|comment: 内容类型 (必填)

pin: 对想法发一级评论
comment: 回复某条评论


content_token: 想法 ID (当类型为 pin) 或评论 ID (当类型为 comment)
content: 评论内容 (必填)

Example:

# 对想法发评论
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment create pin 2001614683480822500 "这是一条评论"

# 回复评论
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment create comment 11407772941 "这是一条回复"

### 5. Delete Comment (删除评论)

删除一条评论。

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment delete <comment_id>

Parameters:

comment_id: 评论 ID (必填)

Example:

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment delete 11408509968

### 6. Get Comment List (获取评论列表)

获取想法的一级评论或评论的二级评论。

python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment list <pin|comment> <content_token> [page_num] [page_size]

Parameters:

pin|comment: 内容类型 (必填)

pin: 获取想法的一级评论
comment: 获取评论的二级评论


content_token: 想法 ID 或一级评论 ID (必填)
page_num: 页码，默认 1 (可选)
page_size: 每页条数，默认 10，最多 50 (可选)

Example:

# 获取想法的一级评论
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment list pin 1992012205256892542

# 获取第二页，每页 20 条
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment list pin 1992012205256892542 2 20

# 获取某条评论的回复
python3 /home/jone/clawd/skills/zhihu/scripts/zhihu_bot.py comment list comment 11386670165

### Base URL

https://openapi.zhihu.com/

### Authentication

使用 HMAC-SHA256 签名进行鉴权：

待签名字符串格式：
app_key:{app_key}|ts:{timestamp}|logid:{log_id}|extra_info:{extra_info}



生成签名：
HMAC-SHA256(app_secret, 待签名字符串) → Base64 编码



请求头：

X-App-Key: app_key
X-Timestamp: 时间戳
X-Log-Id: 请求唯一标识
X-Sign: 签名

### Rate Limiting

全局限流：10 qps
超过限制将返回 429 错误

### Supported Ring

当前支持的圈子 ID：2001009660925334090

链接：https://www.zhihu.com/ring/host/2001009660925334090

### Error Handling

常见错误码：

101: 鉴权失败，检查 app_key 和 app_secret
429: 超过限流，等待后重试
其他错误：检查请求参数是否符合要求
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: keepwonder
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-11T12:22:21.121Z
- Expires at: 2026-05-18T12:22:21.121Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/zhihu)
- [Send to Agent page](https://openagent3.xyz/skills/zhihu/agent)
- [JSON manifest](https://openagent3.xyz/skills/zhihu/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/zhihu/agent.md)
- [Download page](https://openagent3.xyz/downloads/zhihu)