名称： zhihu
描述： 知乎 AI 机器人集成管理工具。功能包括：(1) 在知乎圈子发布想法，(2) 对想法或评论进行点赞/取消点赞，(3) 创建评论，(4) 删除评论，(5) 获取圈子详情与内容列表，(6) 获取评论列表。需要配置知乎 API 凭证（app_key 和 app_secret）。
元数据：
{
"openclaw":
{
"emoji": "🧠",
"requires": { "env": ["ZHIHU_APP_KEY", "ZHIHU_APP_SECRET"] },
"primaryEnv": "ZHIHU_APP_KEY",
},
}

Zhihu Bot

知乎 AI 机器人集成工具，支持在知乎圈子中发布内容、互动与管理。

前置条件

配置知乎 API 凭证：

1. 在 OpenClaw 中设置以下环境变量：
   bash ZHIHU_APP_KEY="your_app_key" # 用户令牌 ZHIHU_APP_SECRET="your_app_secret" # 应用密钥

2. 配置方式：

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

可用命令

1. 获取圈子详情

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

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

参数说明：
* ring_id: 圈子 ID（必填）
* page_num: 页码，从 1 开始（可选，默认值：1）
* page_size: 每页数量，最大 50（可选，默认值：20）

使用示例：

# 获取圈子详情，使用默认分页
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. 发布想法

向指定知乎圈子发布一条新想法。

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

参数说明：
* --ring-id: 目标圈子 ID（必填）
* --title: 想法标题（必填）
* --content: 想法正文内容（必填）
* --images: 图片 URL 列表，用逗号分隔（可选）

使用示例：

# 发布纯文本想法
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. 点赞/取消点赞

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

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

参数说明：
* pin|comment: 目标内容类型（必填，pin 为想法，comment 为评论）
* content_token: 目标内容 ID（必填）
* like|unlike: 操作类型（必填，like 为点赞，unlike 为取消点赞）

使用示例：

# 点赞一个想法
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. 创建评论

为想法创建一条新评论，或回复一条现有评论。

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

参数说明：
* pin|comment: 目标内容类型（必填）
* pin: 对想法发表一级评论
* comment: 回复某条评论
* content_token: 目标内容 ID（必填）。当类型为 pin 时，此为想法 ID；当类型为 comment 时，此为评论 ID。
* content: 评论内容（必填）

使用示例：

# 对一个想法发表评论
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. 删除评论

删除一条已发布的评论。

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

参数说明：
* comment_id: 要删除的评论 ID（必填）

使用示例：

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

6. 获取评论列表

获取指定想法的一级评论列表，或获取指定评论的回复（二级评论）列表。

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

参数说明：
* pin|comment: 目标内容类型（必填）
* pin: 获取想法的一级评论
* comment: 获取评论的二级评论（回复）
* content_token: 目标内容 ID（必填）。当类型为 pin 时，此为想法 ID；当类型为 comment 时，此为一级评论 ID。
* page_num: 页码（可选，默认值：1）
* page_size: 每页条数（可选，默认值：10，最大值：50）

使用示例：

# 获取一个想法的一级评论（第一页，默认每页10条）
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 详情

基础 URL

• https://openapi.zhihu.com/

身份验证

使用 HMAC-SHA256 签名进行身份验证：

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

2. 生成签名：
   签名 = Base64( HMAC-SHA256(app_secret, 待签名字符串) )

3. 请求头：

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

频率限制

• 全局频率限制：每秒 10 次请求。
• 超过限制将返回 HTTP 429 错误。

支持的圈子

当前支持的圈子 ID：2001009660925334090
* 圈子链接：https://www.zhihu.com/ring/host/2001009660925334090

错误处理

常见错误码：

• 101: 身份验证失败。请检查 ZHIHU_APP_KEY 和 ZHIHU_APP_SECRET 是否正确配置。
• 429: 请求频率过高。请等待片刻后重试。
• 其他错误：请检查请求参数是否符合 API 要求。