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 取响应字段),构建期自动内联渲染。
收尾闭环(每次任务)
GET /edit/api/review/diff自查(不碰不该动的文件、diff 符合预期);- 在变更说明里写明改了什么、为什么;
- 通知人工审查:人工在 /edit/ 角标(待审 N 🤖M)里看行级 diff 与电路新旧图, 确认后人工点”发布”。发布即基准前移,审查列表自动清空。
相关页面
- 平台方案与决策记录:仓库
EDITOR_PLATFORM_PLAN.md、AGENT_API.md - 内容治理权威:AGENTS(wiki/schema/AGENTS.md)
- 电路块语法与既有范例:16-bit音频CT-ΔΣ调制器设计实例