diff --git a/docs/openclaw-claude-cli-box-practice.md b/docs/openclaw-claude-cli-box-practice.md new file mode 100644 index 0000000..7fa9a95 --- /dev/null +++ b/docs/openclaw-claude-cli-box-practice.md @@ -0,0 +1,72 @@ +# 我写了一个小工具,让 OpenClaw 更好地使用 Claude Code + +我平时想把开发活稳定地干完,又想随时在飞书里随手遥控。OpenClaw 的飞书 / IM 体验很好,但用着用着任务会丢;Claude Code 代码强、上下文稳,但 IM 体验弱。于是我写了个小工具 **cli-box**,把两者串起来:OpenClaw 当助理负责调度,Claude Code 当骨干负责干活,飞书把进展推回给我。 + +这是我目前在做、也还在完善的一个实践,整条链路大概是这样: + +```mermaid +flowchart LR + Me([我]) -->|消息| Feishu[飞书] + Feishu -->|调度| OC[OpenClaw
助理] + OC -->|list / type / key / click| CB[cli-box 沙箱] + CB -->|运行| CC[Claude Code
骨干] + CC -->|screenshot / scrollback| Feishu + Feishu -->|推送截图| Me +``` + +*图 1 · 整条链路:我从飞书发消息 → OpenClaw 调度 → cli-box 操作 Claude Code → 截图 / 回读再推回飞书给我。* + +## 遇到的问题 + +我想要的东西其实很简单:能在飞书里随手遥控,把开发活稳定地干完。 + +**OpenClaw(用的 minimax 模型)**:飞书 / IM 的接入生态和体验很好,随手聊、随时收消息。但跑一段时间任务就容易丢,扛不住一段正经的代码开发。 + +**Claude Code**:代码能力强、上下文管理稳、不容易丢,关掉窗口也能用 `claude -r` 接着干。但它在 IM 接入和日常交互体验上弱一截。 + +| | OpenClaw(minimax) | Claude Code | +|:---|:---|:---| +| IM / 飞书接入 | 好 | 弱 | +| 代码开发 | 弱(任务易丢) | 强 | +| 上下文 / 记忆 | 易丢 | 稳,可 `-r` 恢复 | + +单用哪一个都不行——我想在飞书里稳稳地遥控开发,两边都差一口气。 + +## 怎么解决的 + +思路其实很直:不二选一,组合,让各自干擅长的事。让 OpenClaw 当助理(接消息、调度、汇报),Claude Code 当骨干(写码、跑长任务)——这个比喻点到为止,后面就不反复说了。 + +问题是,助理得能"操作"和"查看"骨干,中间缺一个粘合剂。于是我写了 cli-box 这个小工具,给外部提供一组简单 CLI:`list` 管理、`type` / `key` / `click` 操作、`scrollback` 读、`screenshot` 看。 + +这么搭下来,有两个我觉得比较关键的好处: + +**一是对我——交互和可见。** OpenClaw 把 Claude Code 的截图准确方便地推到飞书给我,我们之间就有了交互闭环;更重要的是我能**亲眼看到** Claude 的真实运行状态,而不是只听 OpenClaw 转述。OpenClaw 说不准、给我错误反馈还没法纠正——这个隐患就被绕开了。 + +**二是对 OpenClaw——降低了门槛。** 它只需要会发几条简单 CLI、会看截图和 scrollback,就能驱动 Claude Code 干活。换句话说,**对它背后模型的代码能力、上下文管理、记忆要求都大幅降低了**。真正费脑子的活由 Claude Code 扛,所以 OpenClaw 用相对弱的模型(minimax)也能当好调度。 + +## cli-box 做了什么 + +cli-box 是 macOS 上的一个小沙箱工具:一条命令把任意 CLI(Claude Code、OpenCode、zsh……)跑在各自独立的窗口里,而且这些窗口能被外部程序用简单命令操作和观察。 + +它给外部提供的就这么几类能力: + +| 类别 | 命令 | 干什么 | +|:---|:---|:---| +| 管 | `list` | 列出当前所有沙箱 | +| 操作 | `type` / `key` / `click` | 输入文字 / 按键 / 点坐标 | +| 读 | `scrollback` | 读整段会话纯文本 | +| 看 | `screenshot` | 截当前窗口 | + +它能当粘合剂,靠的是三点:**零侵入**(Claude Code 不用做任何适配,操作都在系统层面完成)、**可观测**(截图 + scrollback 让"看"和"读"都可靠)、**可控**(外部用几条简单 CLI 就能驱动)。 + +目前体会到的好处,也呼应前面那两点:OpenClaw 不必亲自写码,所以对它的模型要求很低,Claude Code 的强项被用在该用的地方;我通过飞书拿到准确的视觉反馈,能及时纠正。 + +## 写在最后 + +cli-box 把 OpenClaw 和 Claude Code 串起来,搭出来的就是这么一个简易但够用的干活方式。 + +说实话,功能仍在完善,这里只是分享当前的形态和思路,不算什么成熟方案。 + +如果你想自己动手配一遍(飞书接入、发图、定时检查这些细节),我写在另一篇里:→ [AI Agent + OpenClaw + 飞书实战工作流](./ai-agent-openclaw-workflow.md)。 + + diff --git a/docs/superpowers/plans/2026-06-25-openclaw-claude-cli-box-practice.md b/docs/superpowers/plans/2026-06-25-openclaw-claude-cli-box-practice.md new file mode 100644 index 0000000..44eb48e --- /dev/null +++ b/docs/superpowers/plans/2026-06-25-openclaw-claude-cli-box-practice.md @@ -0,0 +1,256 @@ +# 《我写了一个小工具,让 OpenClaw 更好地使用 Claude Code》撰写计划 + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. +> +> **本环境注:** subagent 派发不可用(见 memory `feedback-inline-execution`),走 **executing-plans 内联执行**。 + +**Goal:** 在 `docs/` 根目录撰写一篇约 800–1200 字的实践分享 markdown,介绍"用 cli-box 把 OpenClaw 和 Claude Code 串联"的实践。 + +**Architecture:** 单文件 `docs/openclaw-claude-cli-box-practice.md`,结构 = TL;DR + 4 节。视觉 = 1 张 Mermaid 数据流图 + 2 张 markdown 表格。按节拆 5 个 Task,逐节 append 并 commit。 + +**Tech Stack:** Markdown + Mermaid(`flowchart LR`) + +## Global Constraints + +> 来自 spec(`docs/superpowers/specs/2026-06-25-openclaw-claude-cli-box-practice-design.md`,commit fd1383c),逐字约束,每个 Task 隐式遵守。 + +- **调性克制诚实**:`❌ 禁用` 框架 / 强大 / 高效 / 完美 / 终极 / 一站式 / 赋能;`✅ 多用` 实践 / 尝试 / 目前 / 简易 / 够用 / 进行中 / 体会到 +- **角色比喻**(助理 / 骨干 / 老板)全文**最多轻提一次**,不贯穿 +- **收尾**须含"功能仍在完善,本文只分享当前形态与思路" +- **"好处"**一律写成"目前体会到的好处" +- **不讲**:飞书应用配置、发图脚本、cron 细节、授权规则(属 `docs/ai-agent-openclaw-workflow.md`) +- **不放**:命令教程、真实示例截图 / 对话(作者后续自补) +- **产品名大小写**:OpenClaw / Claude Code / cli-box / 飞书(规范写法) +- **语言**:中文 +- **目标文件**:`docs/openclaw-claude-cli-box-practice.md` +- **工作分支**:`docs/introduce_in_openclaw_and_claude`(worktree:`.worktrees/docs-introduce`,基于 `origin/main` @ e79c3ab) +- **两个并重的核心动机**(本文主轴,第 2、3 节都要落到位): + 1. 对我 —— 交互与可见(截图推飞书形成闭环 + 亲眼看 Claude 真实状态,纠正 OpenClaw 转述失真) + 2. 对 OpenClaw / 系统 —— 降低门槛(简单 CLI 驱动 Claude Code → 对模型的代码能力、上下文、记忆要求大幅降低;重活 Claude Code 扛,弱模型也能当调度) + +## 通用验证命令(各 Task 复用) + +```bash +# 1) 禁用词扫描(应无输出) +grep -nE '框架|强大|高效|完美|终极|一站式|赋能' docs/openclaw-claude-cli-box-practice.md + +# 2) 全文字符数(目标 800–1200,Task 5 收尾时核对) +wc -m docs/openclaw-claude-cli-box-practice.md + +# 3) 工作区在正确 worktree +git rev-parse --show-toplevel # 应为 .../cli-box/.worktrees/docs-introduce +git branch --show-current # 应为 docs/introduce_in_openclaw_and_claude +``` + +--- + +## Task 1: 创建文档 + 标题 + TL;DR + 图 1(数据流闭环) + +**Files:** +- Create: `docs/openclaw-claude-cli-box-practice.md` + +**Content brief:** +- 文档顶部标题(一级标题):《我写了一个小工具,让 OpenClaw 更好地使用 Claude Code》 +- 紧接一段 TL;DR(2–3 句,约 80 字),点明三件事:① OpenClaw(IM 好但易丢任务)② Claude Code(代码强且稳、能 `-r` 恢复)③ 用小工具 cli-box 把两者串起来,OpenClaw 当助理调度、Claude Code 当骨干干活,飞书把进展推回给我。定调句:"这是我目前在做、也还在完善的一个实践。" +- 然后放**图 1**(Mermaid),展示完整闭环。用如下语法(可直接粘贴): + +```mermaid +flowchart LR + Me([我]) -->|消息| Feishu[飞书] + Feishu -->|调度| OC[OpenClaw
助理] + OC -->|list / type / key / click| CB[cli-box 沙箱] + CB -->|运行| CC[Claude Code
骨干] + CC -->|screenshot / scrollback| Feishu + Feishu -->|推送截图| Me +``` + +- 图下加一行图注:`图 1 · 整条链路:我从飞书发消息 → OpenClaw 调度 → cli-box 操作 Claude Code → 截图/回读再推回飞书给我。` + +**Steps:** +- [ ] **Step 1:** 创建 `docs/openclaw-claude-cli-box-practice.md`,写入标题 + TL;DR 段 + 图 1 Mermaid + 图注 +- [ ] **Step 2:** 运行 `grep -nE '框架|强大|高效|完美|终极|一站式|赋能' docs/openclaw-claude-cli-box-practice.md`,确认无输出 +- [ ] **Step 3:** Commit + +```bash +git add docs/openclaw-claude-cli-box-practice.md +git commit -m "docs: add article skeleton, TL;DR and data-flow diagram + +Co-Authored-By: Claude " +``` + +**Verification:** +- 标题与 spec 一致;TL;DR 含 OpenClaw / Claude Code / cli-box 三要素 + "进行中"定调 +- 禁用词扫描无输出 +- Mermaid 为合法 `flowchart LR`,6 个节点 + 7 条边,闭合(我 → … → 我) + +--- + +## Task 2: 第 1 节「遇到的问题」 + +**Files:** +- Modify: `docs/openclaw-claude-cli-box-practice.md`(在图 1 后 append) + +**Content brief(约 220 字):** +- 二级标题:`## 遇到的问题` +- 开篇一句:先讲我本来想要什么——"能在飞书里随手遥控,把开发活稳定地干完。" +- 两段对比(各 2–3 句): + - **OpenClaw(用的 minimax 模型)**:飞书 / IM 的接入生态和体验很好,随手聊、随时收消息。但跑一段时间任务容易丢,扛不住一段正经的代码开发。 + - **Claude Code**:代码能力强、上下文管理稳、不容易丢,关掉窗口也能用 `claude -r` 接着干。但它在 IM 接入和日常交互体验上弱一截。 +- 插入**优劣对比表**(markdown 表格,直接用): + +| | OpenClaw(minimax) | Claude Code | +|:---|:---|:---| +| IM / 飞书接入 | 好 | 弱 | +| 代码开发 | 弱(任务易丢) | 强 | +| 上下文 / 记忆 | 易丢 | 稳,可 `-r` 恢复 | + +- 收一句痛点:"单用哪一个都不行——我想在飞书里稳稳地遥控开发,两边都差一口气。" + +**Steps:** +- [ ] **Step 1:** append「遇到的问题」整节(含表格) +- [ ] **Step 2:** 禁用词扫描 + `wc -m` 看累计字符数 +- [ ] **Step 3:** Commit + +```bash +git add docs/openclaw-claude-cli-box-practice.md +git commit -m "docs: add 'the problem' section with comparison table + +Co-Authored-By: Claude " +``` + +**Verification:** +- 三行对比表完整(IM / 代码 / 上下文三维度),措辞克制(无 hype) +- 痛点句点出"单用谁都不行" + +--- + +## Task 3: 第 2 节「怎么解决的」—— 落第一个核心动机 + +**Files:** +- Modify: `docs/openclaw-claude-cli-box-practice.md`(append) + +**Content brief(约 300 字):** +- 二级标题:`## 怎么解决的` +- 思路(2 句):不二选一,组合——让各自干擅长的事。这里**轻提一次**角色比喻:"让 OpenClaw 当助理(接消息、调度、汇报),Claude Code 当骨干(写码、跑长任务)。"——比喻就此打住,后文不再反复用。 +- 引出 cli-box(2 句):助理要能"操作"和"查看"骨干,缺一个粘合剂。于是写了 cli-box 这个小工具,提供一组简单 CLI:`list` 管理、`type`/`key`/`click` 操作、`scrollback` 读、`screenshot` 看。 +- 落**两个并重的好处**(本文主轴,用小标题或加粗分两点写,务必都到位): + 1. **对我 —— 交互和可见**:OpenClaw 把 Claude Code 的截图准确方便地推到飞书给我,我们之间就有了交互闭环;更重要的是我能**亲眼看到** Claude 的真实运行状态,而不是只听 OpenClaw 转述——避免它说不准、给我错误反馈还没法纠正。 + 2. **对 OpenClaw —— 降低了门槛**:它只需要会发几条简单 CLI、会看截图和 scrollback,就能驱动 Claude Code 干活。换句话说,**对它背后模型的代码能力、上下文管理、记忆要求都大幅降低了**;真正费脑子的活由 Claude Code 扛,所以 OpenClaw 用相对弱的模型(minimax)也能当好调度。 + +**Steps:** +- [ ] **Step 1:** append「怎么解决的」整节,确保两个好处都写到位 +- [ ] **Step 2:** 自检——本节同时出现"交互/可见"与"降低门槛/对模型要求"两条线索;禁用词扫描 +- [ ] **Step 3:** Commit + +```bash +git add docs/openclaw-claude-cli-box-practice.md +git commit -m "docs: add 'how I solved it' with the two core motivations + +Co-Authored-By: Claude " +``` + +**Verification:** +- 两个好处都明确写出(不是只写一个) +- "降低对模型代码能力/上下文/记忆要求"这一关键洞察在文中出现 +- 比喻只出现这一次 + +--- + +## Task 4: 第 3 节「cli-box 的机制与好处」—— 落第二个核心动机 + 能力表 + +**Files:** +- Modify: `docs/openclaw-claude-cli-box-practice.md`(append) + +**Content brief(约 320 字):** +- 二级标题:`## cli-box 做了什么` +- 是什么(2 句):cli-box 是 macOS 上的一个小沙箱工具——一条命令把任意 CLI(Claude Code、OpenCode、zsh…)跑在各自独立的窗口里,而且这些窗口能被外部程序用简单命令操作和观察。 +- 能力(配**能力表**,直接用): + +| 类别 | 命令 | 干什么 | +|:---|:---|:---| +| 管 | `list` | 列出当前所有沙箱 | +| 操作 | `type` / `key` / `click` | 输入文字 / 按键 / 点坐标 | +| 读 | `scrollback` | 读整段会话纯文本 | +| 看 | `screenshot` | 截当前窗口 | + +- 为什么它能当粘合剂(3 个短点): + - **零侵入**:Claude Code 不用做任何适配,所有操作都在系统层面完成。 + - **可观测**:截图 + scrollback 让"看"和"读"都可靠。 + - **可控**:外部(OpenClaw)用几条简单 CLI 就能驱动。 +- 收「**目前体会到的好处**」(呼应第 2 节两点,简短): + - **降低门槛**:OpenClaw 不必亲自写码,所以对它的模型要求很低;Claude Code 的强项被用在该用的地方。 + - **可见可控**:我通过飞书拿到准确的视觉反馈,能及时纠正。 + +**Steps:** +- [ ] **Step 1:** append「cli-box 做了什么」整节(含能力表 + 好处) +- [ ] **Step 2:** 禁用词扫描;确认能力表 4 行齐全 +- [ ] **Step 3:** Commit + +```bash +git add docs/openclaw-claude-cli-box-practice.md +git commit -m "docs: add 'what cli-box does' with capability table and benefits + +Co-Authored-By: Claude " +``` + +**Verification:** +- 能力表含 管/操作/读/看 四类 +- "零侵入 / 可观测 / 可控"三点在 +- 好处段落用"目前体会到的好处"措辞,且呼应两个动机 + +--- + +## Task 5: 第 4 节「收尾」+ 全文自检 + Mermaid 校验 + +**Files:** +- Modify: `docs/openclaw-claude-cli-box-practice.md`(append 收尾节) +- (只读)对照 spec + +**Content brief(约 100 字):** +- 二级标题:`## 写在最后` +- 一句总结:"cli-box 把 OpenClaw 和 Claude Code 串起来,搭出来的就是这么一个简易但够用的干活方式。" +- **诚实声明**(必须):"功能仍在完善,这里只是分享当前的形态和思路,不算什么成熟方案。" +- 引导复现(一句 + 链接):"如果你想自己动手配一遍(飞书接入、发图、定时检查的细节),我写在另一篇里:→ [AI Agent + OpenClaw + 飞书实战工作流](./ai-agent-openclaw-workflow.md)。" +- 示例占位(留一行给作者):`` + +**Steps:** +- [ ] **Step 1:** append「写在最后」整节 +- [ ] **Step 2:** 全文检查 —— + - 禁用词扫描(应无输出) + - `wc -m docs/openclaw-claude-cli-box-practice.md`(目标 800–1200 中文字符;若超出 1300 或不足 700,回前面节精简/补充) + - Mermaid 语法:确认图 1 在一个完整 ` ```mermaid ` 代码块内,`flowchart LR` 开头 + - 链接有效:`ls docs/ai-agent-openclaw-workflow.md`(应存在) +- [ ] **Step 3:** Commit + +```bash +git add docs/openclaw-claude-cli-box-practice.md +git commit -m "docs: add closing section and finalize article + +Co-Authored-By: Claude " +``` + +**Verification:** +- 收尾含"功能仍在完善"声明 + workflow 文档链接 + 示例占位 +- 全文 800–1200 字,禁用词 0 命中 +- 5 个 commit(本 Task 是第 5 个),分支 `docs/introduce_in_openclaw_and_claude` ahead origin/main 共 6(spec 1 + 文档 5) +- `git log --oneline e79c3ab..HEAD` 看到 6 个干净 commit + +--- + +## Self-Review(计划自检) + +**1. Spec coverage(spec 每节 → Task):** +- spec §0 TL;DR → Task 1 ✓ +- spec §1 遇到的问题 + 对比表 → Task 2 ✓ +- spec §2 怎么解决 + 两个动机 → Task 3 ✓ +- spec §3 机制 + 能力表 + 好处 → Task 4 ✓ +- spec §4 收尾(诚实声明 + 链接 + 占位)→ Task 5 ✓ +- spec §3 调性约束 → Global Constraints + 每 Task 禁用词扫描 ✓ +- spec §5 图 1 Mermaid → Task 1 ✓ +- spec §8 YAGNI(不讲配置/不放示例)→ Global Constraints ✓ + +**2. Placeholder scan:** 计划内无 TBD/TODO(示例占位 `` 是**有意留给作者**的,不是计划占位);每个 step 有具体内容 / 命令 / 表格 / Mermaid 语法。 + +**3. Type consistency:** 文件名全文统一 `docs/openclaw-claude-cli-box-practice.md`;产品名统一 OpenClaw / Claude Code / cli-box;两处"好处"措辞统一为"目前体会到的好处"。 + +**无问题,可执行。** diff --git a/docs/superpowers/specs/2026-06-25-openclaw-claude-cli-box-practice-design.md b/docs/superpowers/specs/2026-06-25-openclaw-claude-cli-box-practice-design.md new file mode 100644 index 0000000..5887cee --- /dev/null +++ b/docs/superpowers/specs/2026-06-25-openclaw-claude-cli-box-practice-design.md @@ -0,0 +1,114 @@ +--- +title: 《我写了一个小工具,让 OpenClaw 更好地使用 Claude Code》—— 文档设计 +date: 2026-06-25 +status: draft +type: spec +target_doc: docs/openclaw-claude-cli-box-practice.md +--- + +# 设计:《我写了一个小工具,让 OpenClaw 更好地使用 Claude Code》 + +## 1. 背景与目标 + +写一篇 **实践分享类** markdown 文档,介绍作者当前的一个实践:用自研小工具 cli-box 把 OpenClaw 和 Claude Code 串联,搭出一个"简易但够用"的干活方式。 + +**目标**:让读者 5–8 分钟读懂"做了什么、解决了什么问题、cli-box 在其中的角色",产生共鸣或启发,而不是被推销。 + +## 2. 受众与定位 + +- **读者**:对 AI agent / 自动化工作流感兴趣的开发者 +- **定位**:独立实践分享(取向 B),**弱项目宣传** +- **发布位置**:`docs/` 根目录,与 `ai-agent-openclaw-workflow.md` 并列;可外发(博客 / 朋友圈) + +## 3. 写作语气约束(关键) + +功能仍在完善,本文是**阶段性分享**,不是产品发布。语气必须克制、诚实: + +- ✅ 多用:实践、尝试、目前、简易、够用、进行中、体会到 +- ❌ 避免:框架、强大、高效、完美、终极、一站式、赋能 +- 角色比喻(助理 / 骨干 / 老板)**轻提一次**即可,不贯穿全文 +- 收尾须明确"功能仍在完善,本文只分享当前形态与思路" +- "好处"一律写成"目前体会到的好处" + +## 4. 文档结构(大纲) + +### 0. TL;DR +- 一句话:用小工具 cli-box,让"IM 体验好但易丢任务"的 OpenClaw 去调度"代码强且稳"的 Claude Code;OpenClaw 当助理,Claude Code 当骨干,飞书把进展推回给我。 +- 配 **图 1:整体数据流闭环**(Mermaid) +- 定调:"一个进行中的实践" + +### 1. 遇到的问题 +- OpenClaw(用 MiniMax 模型):飞书 / IM 接入生态和体验好,但跑一段时间任务容易丢,扛不住正经代码开发 +- Claude Code:代码能力强、上下文管理稳、不易丢、关掉也能 `-r` 恢复;但 IM 接入 / 体验弱 +- 痛点:单用哪一个都不行——没法"在飞书里稳稳地遥控干开发" +- 配:**优劣对比表**(markdown 表格,不用图) + +### 2. 怎么解决 +- 思路:不二选一,组合——让各自干擅长的事 +- 角色分工(轻提一次):OpenClaw = 助理(接消息 / 调度 / 汇报),Claude Code = 骨干(写码 / 跑长任务) +- 缺一个"粘合剂"让助理能操作骨干 → cli-box +- 闭环:`我 → 飞书 → OpenClaw → cli-box → Claude Code → 截图/scrollback → 飞书 → 我` +- **两个并重的好处(本文核心动机)**: + 1. **对我 —— 交互与可见**:准确方便地截图 → 推飞书 → 形成交互闭环;让我**亲眼看到** Claude 的真实运行状态,避免 OpenClaw 转述失真导致错误反馈无法纠正 + 2. **对 OpenClaw / 系统 —— 降低门槛**:只需简单 CLI(`list` 管 / `type`·`key`·`click` 操作 / `scrollback`·`screenshot` 查看)就能驱动 Claude Code → **对 OpenClaw 背后模型的代码能力、上下文管理、记忆要求都大幅降低**;重活由 Claude Code 扛(强代码 + 稳上下文 + 可恢复),所以 OpenClaw 用相对弱的模型(minimax)也能当好调度 + +### 3. cli-box 的机制与好处 +- 是什么:macOS 上的一个沙箱小工具,一条命令把任意 CLI 跑在独立窗口,且能被外部程序驱动 +- 核心能力(简述,不展开命令细节,配表格): + - 管:`list` + - 操作:`type` / `key` / `click` + - 读:`scrollback` + - 看:`screenshot` +- 为什么适合当粘合剂: + - 零侵入(Claude Code 不用做任何适配) + - 可观测(screenshot + scrollback 让"看"和"读"都可靠) + - 可控(外部用简单 CLI 就能驱动) +- 目前体会到的好处(对应上面两个动机): + - **降低门槛**:OpenClaw 不必亲自写码,只需操作 CLI + 看截图/scrollback —— 因此对它的模型代码能力、上下文管理、记忆要求都很低;Claude Code 的强代码 + 稳上下文 + 可恢复被用在该用的地方 + - **可见可控**:我通过飞书拿到准确的视觉反馈,能及时纠正,而不是盲信 OpenClaw 的转述 + +### 4. 收尾 +- 一句话总结:一个简易但够用的干活方式 +- 诚实声明:功能仍在完善,这里只分享当前形态与思路 +- 想动手复现 → 链接到 `docs/ai-agent-openclaw-workflow.md`(配置 / 踩坑在那篇,本文不重复) +- 示例占位(作者后续自行补充) + +## 5. 图片方案 + +- **图 1(唯一必选 Mermaid)**:整体数据流闭环 + - `我 -- 消息 --> 飞书 --> OpenClaw(助理/调度) --> cli-box(沙箱) --> Claude Code(骨干/执行)` + - `Claude Code -- 截图/scrollback --> 飞书 -- 推送 --> 我` + - 类型:`flowchart LR` +- 其余视觉信息用 **markdown 表格**(优劣对比、cli-box 能力分类),不额外作图 +- 不使用 AI 位图(纯文本模型,且无必要) +- 封面图:暂不需要;若后续要,作者自行处理 + +## 6. 与已有文档的关系 + +| 文档 | 定位 | 本文是否重复 | +|:---|:---|:---| +| `docs/ai-agent-openclaw-workflow.md` | 实操 reference(飞书配置 / 踩坑 / cron 流程) | 否,仅链接 | +| 本文 | 实践分享(为什么做 + 思路 + 机制) | — | + +本文**不**讲:飞书应用配置、发图脚本、cron 细节、授权规则——这些属于 workflow 文档。 + +## 7. 篇幅 + +- 正文约 800–1200 字 +- 1 张 Mermaid + 2 张表格 +- 5–8 分钟读完 + +## 8. 不做什么(YAGNI) + +- ❌ 不放具体命令教程(留给 README 和 workflow 文档) +- ❌ 不放真实示例截图 / 对话(作者后续自行补) +- ❌ 不讲飞书配置 / 踩坑细节 +- ❌ 不拔高为"框架 / 产品",不写路线图式承诺 + +## 9. 验收标准 + +- 读者读完能说清:遇到了什么问题、怎么组合解决的、cli-box 起什么作用 +- 语气克制,无过度宣传感 +- 与 workflow 文档无内容重复,只链接 +- Mermaid 图能在 GitHub 正常渲染 +- 作者只需"补充示例"即可外发