OpenClaw 调用指南(精简自举版)

本页是 Agent 的速查自举卡:完整参数与错误语义见仓库 knowledge-wiki-admin/AGENT_API.md(唯一权威);行为规范同页 §5。 Agent 拥有令牌(x-agent-token 头)后可自动执行下表”Agent 可做”列。

能力速查

想做什么用什么Agent 可做
读文章/目录GET /edit/api/tree、GET /edit/api/file?path=…✅
写/建文章POST /edit/api/file {path, content}✅(提交自动标 🤖)
电路图生成POST /edit/api/circuitikz/import {name, code, dry_run}✅(推荐,先 dry_run)
电路预览渲染POST /edit/api/render-circuit {code}✅
查看待审改动GET /edit/api/review/diff✅
删除/重命名/发布/回滚/拉取—❌ 403(通知人工)

绘图规范(CircuiTikZ 子集)

  • 器件白名单:R C L D LED Dz V I 开关 npn/pnp/nmos/pmos、node[nmos/npn/op amp/ground/vdd/port]。
  • 连线必须正交且精确共点(相对坐标 ++ 优先);1cm=50px,y 轴翻转。
  • l= 值标签、v=/i= 电压电流标记、name= 显式命名(R_D 风格)。
  • 导入必看固定报告:errors / warnings(unmapped|dangling|bulk|style) / stats—— warnings 未清零不算完成;未映射元件会降级为 ⟨未映射⟩ 画布注释。
  • 工程入库后在 md 插入 {circuit-project} 块(slug 取响应字段),构建期自动内联渲染。

收尾闭环(每次任务)

  1. GET /edit/api/review/diff 自查(不碰不该动的文件、diff 符合预期);
  2. 在变更说明里写明改了什么、为什么;
  3. 通知人工审查:人工在 /edit/ 角标(待审 N 🤖M)里看行级 diff 与电路新旧图, 确认后人工点”发布”。发布即基准前移,审查列表自动清空。

相关页面