hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-09 07:20:44 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions
oclaw/extensions/api
History
oliver ba3836f00f 初始化：独立 oclaw 仓库首提交 
- 在 oclaw/ 下重新初始化 Git 仓库
- 补齐子仓库 .gitignore，避免提交本地运行态数据（_local、node_modules、logs 等）
- 提交当前工程代码与配置

Made-with: Cursor
2026-04-24 22:31:22 +08:00
..
__init__.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
plugin_api.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
README.md 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00

README.md

API 总览（extensions）

本文是 vendor/openclaw/extensions 的 API 视角重写，中文优先。

extension API 是什么

  • 每个 extension 是一个插件单元，通常通过 openclaw.plugin.json 声明 id、name、configSchema。
  • 代码入口一般通过 index.ts 注册插件行为（如路由注册、事件处理、任务绑定）。
  • api.ts 常用于统一导出插件 SDK 类型或对外公开接口。

统一接入链路

  1. 读取插件配置（含 schema 校验）。
  2. 插件注册阶段挂载能力（HTTP 路由、channel 能力、provider 能力等）。
  3. 运行时把入站事件转换为 TaskFlow 或 channel 消息处理。
  4. 输出日志、错误码、可观测事件用于排障。

当前重点扩展

  • whatsapp：渠道接入、目标规范化、目录/群策略、登录二维码等。
  • webhooks：认证入站 webhook，绑定到指定会话 TaskFlow。

维护建议

  • 业务侧只改本目录说明，不直接改 vendor 源码。
  • 真正改行为时，先在主工程实现适配层，再决定是否回写上游。