ZeeLin 知乎自动发布 📝#

用户给一个 选题 → 小龙虾 爬取信息、整理成深度有创新的文章 → 展示给用户 → 用户说\\「确定」「发布」\\ → 小龙虾用脚本在知乎写文章页 自动填入标题和正文并点击发布。你只需登录知乎并点一次确定。

---

⚠️ 避免 request timed out（必读）#

严禁在同一轮内既「爬取+成文」又「写文件+exec 发布」。单轮耗时过长会导致 request timed out。

必须拆成两轮：

• 第一轮：只做爬取（web_fetch）+ 成文，把 标题和正文 发给用户，并说明：「请先登录知乎。确认无误后回复 『发布』，我再执行发布。」
• 第二轮：等用户回复「发布」后，只做「将正文写入 /tmp/zhihu_body.md + exec 发布脚本（带 timeout 90000）」，不再重复爬取或成文。

即使用户一次说「爬取最新 AI 动态并发布到知乎」，你也 先只完成爬取和成文并展示，等用户说「发布」后再执行发布。

飞书 / 易超时环境下的「轻量第一轮」：当用户说「爬取最新动态」并写知乎时，第一轮 不要 做大量爬取+整篇长文（容易单轮超时）。改为： 至多 1～2 次 web_fetch，然后产出 短稿（约 500～800 字）或「大纲 + 首段」，先快速回复；并说明：「这是首稿/大纲，需要全文请回复『展开成全文』，要发布请回复『发布』。」用户回复后再补全或发布，可显著降低 request timed out。

---

何时触发#

• 「帮我发一篇知乎」「把这篇发到知乎」
• 「做个知乎选题：XXX」「以 XXX 为题写一篇知乎文章并发布」
• 「帮我写一篇知乎深度文，选题是 XXX，写好我确认后你发」
• 「知乎自动发布」「用小龙虾发知乎」
• 「爬取最新动态，写一篇知乎文章」「爬取最新动态写知乎」「根据最新动态写一篇知乎」

---

知乎 API 在哪调#

• 开放平台： https://dev.zhihu.com/ — 注册应用、OAuth 2.0 获取 access_token。 注意：知乎发布 API 目前仅对内侧用户开放，多数用户无法使用。

• 发布文章接口（内侧）：一般为 POST https://api.zhihu.com/v4/articles。未开放前请用下方「网页端直接发布」。

• 本 skill 发布方式：

  1. API 发布（仅内侧可用）：若环境变量已设置 ZHIHU_ACCESS_TOKEN，使用 scripts/publish_via_api.sh。
  2. 网页端直接发布（推荐）：使用 scripts/publish_article.sh，在 已打开的知乎写文章页 上填表并点击发布；配合 Browser Relay 可大幅缩短耗时、降低 request timed out（见下）。

---

网页端直接发布（Browser Relay，参考 ClawHub zhihu-post）#

与 ClawHub 上的知乎发帖 skill 思路一致： 在网页端直接发布，由 Agent 控制已打开的浏览器标签页完成填表与点击，无需知乎开放 API。

推荐流程（耗时短、不易超时）：

1. 安装 OpenClaw Browser Relay：Chrome 扩展，让 Agent 控制你当前标签页。安装： openclaw browser extension install，在 Chrome 加载该扩展；详见 Chrome extension (browser relay)。
2. 先打开知乎写文章页：在 Chrome 打开 https://www.zhihu.com ，登录后进入「创作」→「写文章」，停留在 空编辑器页（有标题框和正文区）。
3. 挂上 Relay：在该标签页点击扩展图标，使 Badge 显示 ON（表示该页已交给 OpenClaw 控制）。
4. 发布时：用户说「发布」后，用 已打开编辑器页 的方式执行脚本，即传 ZHIHU_ALREADY_ON_EDITOR=1，脚本 不再 打开知乎、不再点击「写文章」，只做：snapshot → 填标题 → 填正文 → 点发布。整体耗时可从 30～90 秒降到约 10～20 秒，显著降低飞书等环境的 request timed out。

exec 示例（已打开写文章页时）：

json

{"tool": "exec", "args": {"command": "ZHIHU_ALREADY_ON_EDITOR=1 bash ~/.openclaw/workspace/skills/zeelin-zhihu-autopost/scripts/publish_article.sh \"文章标题\" /tmp/zhihu_body.md", "timeout": 60000}}

可选：用 browser 工具分步发布（不用 exec 脚本）：若当前已 attach 知乎写文章页，可依次调用： browser snapshot → 从 snapshot 中找标题输入框与正文编辑区的 ref → browser type/fill 填入标题和正文 → browser snapshot 找发布按钮 ref → browser click 发布。每一步为单独工具调用，适合希望完全用 browser 控制的场景。

---

使用前准备（必读）#

1. 用户需先登录知乎（浏览器方式）：用 exec 或 browser 打开 https://www.zhihu.com ，让用户完成登录。若使用 网页端直接发布 + Browser Relay，用户在自己 Chrome 打开知乎写文章页并挂上扩展即可。
2. 可选：若已知「写文章」直达链接，可先打开写文章页；发布时传 ZHIHU_ALREADY_ON_EDITOR=1 可跳过导航，减少超时。

---

工作流程#

Step 1：确认选题#

用户给出选题（一句话或一个方向）。若未给，询问：「请给一个知乎文章选题或方向。」

Step 2：爬取信息并成文#

• 优先用 web_fetch 抓取与选题相关的网页（如科技媒体、知乎话题页等 URL），获取最新内容。若 web_search 不可用（如缺少 Brave API 密钥）， 不要 因此放弃任务：用 web_fetch 抓取你已知的新闻/资讯链接，或基于已有知识成文。

• 整理成一篇 深度、有创新、结构清晰 的文章（建议 1500～4000 字）：

  • 标题：吸引点击、概括主题
  • 正文：分段、小标题、有论据与观点，可适当引用来源

• 不要 在未获得用户确认前就发布。

Step 3：展示并请用户确认#

把 标题 和 正文全文 发给用户，并说明：

「这是根据选题整理的文章。请先登录知乎（若尚未登录）。确认无误后回复 『确定』或『发布』，我会帮你在知乎上自动填入并发布。」

Step 4：用户说「确定」或「发布」后#

4.1 必须先写入正文文件（否则会报「正文文件不存在」）

在调用发布脚本 之前，必须把确认后的 正文全文 写入一个文件，例如 /tmp/zhihu_body.md 或 workspace 内路径（如 ~/.openclaw/workspace/zhihu_draft_body.md）。用 write 工具或 exec 写入均可，确保文件存在且内容为 Markdown 正文。

4.2 再执行发布脚本

先写正文到 /tmp/zhihu_body.md，再 exec 发布脚本。

• 若已配置 ZHIHU_ACCESS_TOKEN（推荐）：用 API 发布，耗时短、不易超时，timeout 可设 15000～30000：

json

{"tool": "exec", "args": {"command": "bash ~/.openclaw/workspace/skills/zeelin-zhihu-autopost/scripts/publish_via_api.sh \"文章标题\" /tmp/zhihu_body.md", "timeout": 30000}}

• 未配置 token：用浏览器脚本。若用户 已打开知乎写文章页并挂上 Browser Relay，用 ZHIHU_ALREADY_ON_EDITOR=1，timeout 可设 60000；否则完整流程需 timeout 90000 或 120000：

json

{"tool": "exec", "args": {"command": "ZHIHU_ALREADY_ON_EDITOR=1 bash ~/.openclaw/workspace/skills/zeelin-zhihu-autopost/scripts/publish_article.sh \"文章标题\" /tmp/zhihu_body.md", "timeout": 60000}}

或（未预先打开写文章页时）：

json

{"tool": "exec", "args": {"command": "bash ~/.openclaw/workspace/skills/zeelin-zhihu-autopost/scripts/publish_article.sh \"文章标题\" /tmp/zhihu_body.md", "timeout": 90000}}

❌ 错误：未先写入文件就直接执行（会报「正文文件不存在」）；或浏览器方式未传 timeout 导致 request timed out。

✅ 正确：先写正文到 /tmp/zhihu_body.md，再 exec；已打开写文章页时加 ZHIHU_ALREADY_ON_EDITOR=1 可缩短耗时。

Step 5：回报结果#

根据 exec 输出告诉用户：发布成功 / 失败；若失败，提示用户检查是否已登录、是否在写文章页，或重试。

---

exec 命令速查#

操作命令与 timeoutAPI 发布（需 ZHIHU_ACCESS_TOKEN，仅内侧可用）bash .../publish_via_api.sh "标题" /tmp/zhihu_body.md，args 加 "timeout": 30000网页端发布（已打开写文章页 + Relay）ZHIHU_ALREADY_ON_EDITOR=1 bash .../publish_article.sh "标题" /tmp/zhihu_body.md，args 加 "timeout": 60000浏览器发布（从零打开页）bash .../publish_article.sh "标题" /tmp/zhihu_body.md，args 加 "timeout": 90000浏览器发布（标题 + stdin）cat body.md | bash .../publish_article.sh "标题" -，args 加 "timeout": 90000

• API 脚本：仅知乎内侧可用；直接 POST 开放平台接口，数秒内完成。
• 网页端直接发布：用户先在 Chrome 打开知乎写文章页并挂上 Browser Relay，再执行脚本时加 ZHIHU_ALREADY_ON_EDITOR=1，只做填表+点击，约 10～20 秒，不易超时。
• 浏览器脚本（从零）：打开知乎创作/写文章页 → 填入标题和正文 → 点击「发布」；耗时长，需 timeout 90000。

---

重要规则#

• 未确认不发布：必须等用户明确说「确定」「发布」后再执行发布脚本。
• 先写文件再发布：执行 publish_article.sh 前， 必须先 将正文写入文件（如 /tmp/zhihu_body.md），再传该路径给脚本，否则会报「正文文件不存在」。
• 发布必须用 exec：用脚本统一完成打开页面、填入、点击发布，不要用 browser 工具一步步手动点。
• 登录由用户完成：不在脚本或 Agent 中输入知乎账号密码；只操作已登录状态下的写文章页。
• 无 web_search 时照常成文：若缺少 Brave Search API 密钥导致 web_search 不可用，用 web_fetch 抓取链接或基于知识成文，不要向用户报「需要 API 密钥」并停止任务。
• 两轮发布防超时：第一轮只成文并展示，等用户说「发布」后第二轮再写文件+exec；不要在同一轮内成文又发布，否则易 request timed out。

---

技术说明#

• 知乎写文章页：通常从 https://www.zhihu.com 进入创作中心 → 写文章；或已知直达链接时直接打开。
• 脚本依赖 openclaw browser：打开页面、snapshot 找元素、type/fill、click 发布。
• 若页面结构变化导致找不到标题/正文/发布按钮，脚本会输出错误信息，便于排查或更新选择器。
• 若脚本报「未找到发布按钮」：通常标题和正文已填入编辑器，请用户在 当前已打开的浏览器页面 中手动点击「发布」或「发表」即可完成发布。