Zhihu Bot
知乎 AI Bot 集成工具，支持在知乎圈子中发布内容、点赞、评论等操作。
Prerequisites
配置知乎 API 凭证：
-
在 OpenClaw 配置中设置环境变量：
bash ZHIHU_APP_KEY="your_app_key" # 用户 token ZHIHU_APP_SECRET="your_app_secret" # 应用密钥 -
配置方式：
- 在~/.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 签名进行鉴权：
-
待签名字符串格式：
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_secret429: 超过限流，等待后重试- 其他错误：检查请求参数是否符合要求
