zhihu（zhihu 开发）

Zhihu Bot

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

Prerequisites

配置知乎 API 凭证：

1. 在 OpenClaw 配置中设置环境变量：

   ZHIHU_APP_KEY="your_app_key"    # 用户 token
   ZHIHU_APP_SECRET="your_app_secret"  # 应用密钥

1. 配置方式：

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

Available Commands

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

API Details

Base URL

• https://openapi.zhihu.com/

Authentication

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

1. 待签名字符串格式：

   app_key:{app_key}|ts:{timestamp}|logid:{log_id}|extra_info:{extra_info}

1. 生成签名：

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

1. 请求头：

- 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: 超过限流，等待后重试
• 其他错误：检查请求参数是否符合要求