Commit Graph

274 Commits (4329d94de3a71803db177ee50af68eb75d7ea06b)

Author SHA1 Message Date
Peter Steinberger 341e617c84
docs(plugins): refresh bundled plugin runtime docs 8 months ago
Peter Steinberger 922c90e9fa refactor: add approval runtime sdk seam 8 months ago
Peter Steinberger 0d98ce1065 refactor: add diagnostic and error runtime sdk seams 8 months ago
Peter Steinberger 70c2458861 refactor: add host and collection runtime sdk seams 8 months ago
Peter Steinberger c222a44e6f refactor: add retry runtime sdk seam 8 months ago
Peter Steinberger a126d23f0d refactor: add fetch runtime sdk seam 8 months ago
Peter Steinberger 838013c87a refactor: expose webhook request guard sdk seam 8 months ago
Peter Steinberger b9560f4685 docs: clarify legacy provider sdk compat barrels 8 months ago
Peter Steinberger b8069c2bd1 refactor: trim provider model compat seams 8 months ago
Peter Steinberger dd640e3c41 refactor: add focused global singleton sdk seam 8 months ago
Peter Steinberger 0b26e4d72a refactor: split shared provider catalog sdk helpers 8 months ago
Peter Steinberger e951838c33 docs: point sdk overview at provider model shared seam 8 months ago
Peter Steinberger 77d15841d7
refactor: move manifest legacy migration into doctor 8 months ago
Peter Steinberger 42be3fb059
refactor: collapse manifest contract mirrors 8 months ago
Peter Steinberger ba7804df50
refactor: derive bundled contracts from extension manifests 8 months ago
Peter Steinberger c9556c257e
docs: clarify memory plugin adapter ids 8 months ago
Peter Steinberger e0dfc776bb
refactor: move memory flush ownership into memory plugin 8 months ago
Peter Steinberger ab4de18982
fix: auto-load bundled plugin capabilities from config refs 8 months ago
Peter Steinberger a4a00aa1da
feat: pluginize cli inference backends 8 months ago
Tak Hoffman 9f0305420a
docs: add beta blocker contributor guidance (#55199)
* docs: add beta blocker contributor guidance

* fix: tighten beta blocker labeling and flaky config test
8 months ago
Tak Hoffman 68c6abe32b
docs: add beta release testing guidance 8 months ago
Josh Avant 10161c2d79
Plugins: enforce terminal hook decision semantics for tool/message guards (#54241)
* Plugins: enforce terminal hook decision policies

* Tests: assert terminal hook behavior in integration paths

* Docs: clarify terminal hook decision semantics

* Docs: add hook guard semantics to plugin guides

* Tests: isolate outbound format label expectations

* changelog

Signed-off-by: joshavant <830519+joshavant@users.noreply.github.com>

---------

Signed-off-by: joshavant <830519+joshavant@users.noreply.github.com>
8 months ago
Vincent Koc 3fe2f0a550 docs: fix CLI command tree, SDK import path, and tool group listing
- Remove non-existent 'secrets migrate' from CLI command tree
- Add actual secrets subcommands: audit, configure, apply
- Add missing plugin subcommands: inspect, uninstall, update, marketplace list
- Fix plugins info -> inspect (actual command name)
- Add message send and broadcast subcommands to command tree
- Remove misleading deprecated import from sdk-overview
- Add sessions_yield and subagents to group:sessions tool group docs
- Fix formatting
8 months ago
Peter Steinberger 651dc7450b
fix(voice-call): harden webhook pre-auth guards 8 months ago
Vincent Koc 28f48a2dfd style(docs): format sdk entrypoints doc 8 months ago
Vincent Koc afb4b1173b fix(docs): remove duplicate '### Options' headings (MD024) 8 months ago
Vincent Koc a9f4cb7544 fix(docs): rename 'Channel Options' to 'Options' in sdk-entrypoints
This heading labels definePluginEntry options (generic, not channel-specific).
Another agent reverted the previous fix during a merge.
8 months ago
Peter Steinberger 462d7ad9c0
perf: default channel vitest lanes to threads 8 months ago
Vincent Koc 05055e200a fix(docs): remaining code audit fixes
- sdk-entrypoints.md: fix mislabeled 'Channel entry options' heading
  (should be 'Options' — these are definePluginEntry options, not
  channel-specific)
- sdk-overview.md: add 4 missing API object fields (version, description,
  source, rootDir) from OpenClawPluginApi type
8 months ago
Vincent Koc 16de5a7b41 fix(docs): code-verified fixes from deep reference audit
- sdk-runtime.md: add missing required params (runId, timeoutMs) to
  runEmbeddedPiAgent example
- sdk-provider-plugins.md: add missing onModelSelected hook (#22),
  clarify capabilities is data not callable, drop misleading '21' count
8 months ago
Peter Steinberger 5c8ea0a175 refactor: share channel setup status helpers 8 months ago
Peter Steinberger 583bea001c refactor: share parsed channel allowlist prompts 8 months ago
Peter Steinberger 7d032ed38c refactor: add provider onboarding preset appliers 8 months ago
Peter Steinberger 956fe72b39 refactor: extract single-provider plugin entry helper 8 months ago
Vincent Koc 4f0bb7594b fix(plugins): allow media-understanding package suffix 8 months ago
Vincent Koc ca3165a3e7 fix(docs): deduplicate titles across 9 pages
Differentiate titles that were identical across multiple pages:
- Platform pages: add '(Platform)' suffix to distinguish from install guides
- Legacy root-level pages: add '(legacy path)' suffix for files that
  redirect to canonical tools/ paths
- Logging: 'Logging' -> 'Logging Overview' (root) and 'Gateway Logging'
- building-extensions: add '(redirect)' suffix
8 months ago
Vincent Koc d1ad48cb50 fix(docs): align frontmatter titles with H1 headings
- sdk-runtime: 'Plugin SDK Runtime' -> 'Plugin Runtime Helpers'
- sdk-testing: 'SDK Testing' -> 'Plugin Testing'
- sdk-setup: 'Plugin SDK Setup' -> 'Plugin Setup and Config'
8 months ago
Vincent Koc a8e10d9dc4 fix(docs): broken link /configuration -> /gateway/configuration in manifest.md 8 months ago
Vincent Koc 2ef4d472f2 fix(install): restore memory-core workspace link 8 months ago
Vincent Koc dbf3dd6559 docs: update plugin install references for ClawHub-first default
OpenClaw now tries ClawHub before npm for bare plugin specs.
Update install examples and guidance across:
- building-plugins.md: intro and publish step
- sdk-setup.md: publishing section with clawhub:/npm: prefix examples
- tools/plugin.md: CLI reference table
- community.md: submission guidance and quality bar
8 months ago
Vincent Koc 6d9d9319b2 fix(docs): resolve markdownlint regressions 8 months ago
Vincent Koc 1f93a99f47 docs(plugins): overhaul SDK pages with Mintlify components and IA restructure
- Rewrite building-plugins.md as focused quick-start with CardGroup routing
- Rewrite sdk-channel-plugins.md with Steps, CodeGroup, Accordion walkthrough
- Move SDK Migration under Building Plugins nav, rename to "Migrate to SDK"
- Fix code examples and use valid Lucide icons for Mintlify Cards
8 months ago
Vincent Koc 28838802d4
docs(plugins): add SDK reference and how-to guide pages (#52366)
* docs(plugins): add SDK reference and how-to guide pages

Create 7 new plugin SDK documentation pages:
- sdk-overview: import map, registration API reference
- sdk-entrypoints: definePluginEntry/defineChannelPluginEntry reference
- sdk-runtime: api.runtime namespace reference
- sdk-setup: packaging, manifests, config schemas reference
- sdk-channel-plugins: step-by-step channel plugin how-to
- sdk-provider-plugins: step-by-step provider plugin how-to
- sdk-testing: test utilities and patterns reference

Restructure plugin docs navigation with nested groups:
- Top-level: user-facing pages (Install, Community, Bundles)
- Building Plugins: Getting Started, Channel, Provider
- SDK Reference: Overview, Entry Points, Runtime, Setup, Testing, Migration, Manifest, Internals

Revise existing pages for new IA:
- building-plugins.md: tightened as quick-start, routes to detailed guides
- architecture.md: updated info box with links to new guides
- sdk-migration.md: expanded Related section

* docs(plugins): add Mintlify components (Steps, CodeGroup, Tabs, Accordion, CardGroup)

- Channel plugin guide: wrap walkthrough in Steps, use CodeGroup for
  package.json/manifest, Accordion for createChatChannelPlugin details,
  CardGroup for advanced topics
- Provider plugin guide: wrap walkthrough in Steps, use CodeGroup for
  package files, Tabs for hook examples, Accordion for all-hooks reference
- Getting started: use CardGroup for plugin-type picker and next steps,
  CodeGroup for package/manifest
- SDK Overview: wrap subpath tables in AccordionGroup for scannability

* fix(docs): address PR review feedback on plugin SDK pages

- Remove nonexistent api.runtime.channel.handleInboundMessage call,
  replace with realistic webhook pattern and note about channel-specific
  inbound handling (issue a)
- Fix registrationMode values: 'setup' -> 'setup-only' and 'setup-runtime'
  matching actual PluginRegistrationMode type (issue b)
- Fix createOptionalChannelSetupSurface params: channelId -> channel,
  add required label field (issue c)
- Fix broken anchor links: #multi-capability-providers ->
  #step-5-add-extra-capabilities, #plugin-kinds -> #registration-api (issue d)
- Add missing acmeChatApi import in channel plugin example (issue e)
- Fix undefined provider variable in provider test example (issue f)

* fix(docs): use correct createProviderApiKeyAuthMethod options

Replace incorrect params (provider, validate) with actual required fields
(providerId, methodId, optionKey, flagName, promptMessage) matching
src/plugins/provider-api-key-auth.ts.

* fix(docs): address second round of PR review feedback

- Add required model fields (reasoning, input, cost, contextWindow,
  maxTokens) to catalog example (issue b)
- Fix buildChannelConfigSchema to take a Zod schema argument (issue c)
- Replace fabricated setupWizard steps/run with real ChannelSetupWizard
  contract (channel, status, credentials) (issue d)
- Add required sessionFile/workspaceDir to runEmbeddedPiAgent (issue e)
- Fix wrapStreamFn to return StreamFn from ctx.streamFn (issue f)
8 months ago
Onur Solmaz 047485dda6
docs: improve plugin manifest reference (#52393)
* docs: improve plugin manifest reference

* docs: clarify manifest field semantics
8 months ago
Peter Steinberger 05279539a8
docs(plugin-sdk): document public SDK surface 8 months ago
Peter Steinberger bfcfc17a8b refactor: tighten plugin sdk entry surface 8 months ago
Bijin 59c4059647
Add Community plugins - Wecom (#29905)
Merged via squash.

Prepared head SHA: da0f08436c176bc13c87482a7aafbea3af1a2fde
Co-authored-by: sliverp <38134380+sliverp@users.noreply.github.com>
Co-authored-by: frankekn <4488090+frankekn@users.noreply.github.com>
Reviewed-by: @frankekn
8 months ago
Josh Avant 3f7f2c8dc9
Voice Call: enforce spoken-output contract and fix stream TTS silence regression (#51500)
* voice-call: harden streaming startup and fallback behavior

* voice-call: suppress barge-in during intro

* voice-call: skip first-turn auto-response while greeting plays

* Voice-call: improve telephony audio fidelity and pacing

* voice-call: enforce spoken JSON and first-message barge skip

* voice-call: fix silent stream TTS regression

* voice-call: remove TTS timing diagnostics and document stream behavior

* voice-call: fail stream playback when stream sends are dropped

* voice-call: harden spoken contract and initial stream replay

* voice-call: suppress barge transcripts during initial greeting

* voice-call: harden stream fallback and media safety
8 months ago
Peter Steinberger f6b3245a7b fix: pass full sdk gate 8 months ago
Peter Steinberger 62ddc9d9e0 refactor: consolidate plugin sdk surface 8 months ago
Vincent Koc 083f825122 docs: expand community plugins (always visible), add Codex App Server/Lossless Claw/Opik, A-Z order 8 months ago
Vincent Koc 483926a6fb docs: rewrite sdk-migration and bundles, fold agent-tools into building-plugins, remove cookbook from nav, remove dead WeChat listing 8 months ago
Vincent Koc 2e0b445b46 docs: use expandable Accordions for community plugins, keep A-Z order 8 months ago
Tak Hoffman 16e055c083
restore extension-api backward compatibility with migration warning 8 months ago
Vincent Koc e4d0fdcc15 docs: rewrite community plugins page with Cards, Steps, and quality bar table 8 months ago
Vincent Koc a4a5ed8948 docs: retitle plugin internals/agent-tools/cookbook, collapse Browser into Tools, reorder Plugins group 8 months ago
Vincent Koc 5f600e117d docs: restructure Tools & Plugins section, rename building-extensions to building-plugins, rewrite tools landing page and SDK migration 8 months ago
Vincent Koc ad4536fd7e docs: rename Extensions to Plugins, rewrite building guide as capability-agnostic, move voice-call to Channels 8 months ago
Vincent Koc 58889f984f docs: set sidebar title to SDK Migration 8 months ago
Vincent Koc 06311f89e0 docs: escape angle brackets in sdk-migration to fix Mintlify MDX build 8 months ago
Vincent Koc 96e1c37685 docs: improve Building Extensions with Mintlify Steps, Accordion, and Warning components 8 months ago
Vincent Koc 87eeab7034 docs: add plugin SDK migration guide, link deprecation warning to docs 8 months ago
Peter Steinberger 50ce9ac1c6 refactor: privatize bundled sdk facades 8 months ago
Peter Steinberger f6948ce405 refactor: shrink sdk helper surfaces 8 months ago
Bijin 192f859325
Add Community plugins - openclaw-dingtalk (#29913)
Merged via squash.

Prepared head SHA: e8e99997cb83b8f88cc89abb7fc0b96570ef313f
Co-authored-by: sliverp <38134380+sliverp@users.noreply.github.com>
Co-authored-by: frankekn <4488090+frankekn@users.noreply.github.com>
Reviewed-by: @frankekn
8 months ago
Bijin 6cb2fc501a
Community plugins - Add QQbot (#29898)
Merged via squash.

Prepared head SHA: c776a12d15d029e4a4858ba12653ba9bafcf6949
Co-authored-by: sliverp <38134380+sliverp@users.noreply.github.com>
Co-authored-by: frankekn <4488090+frankekn@users.noreply.github.com>
Reviewed-by: @frankekn
8 months ago
Gustavo Madeira Santana a2fa799a5c
Tests: stabilize poll fallback coverage 8 months ago
Peter Steinberger 07d9f725b6 refactor: unify plugin sdk primitives 8 months ago
Peter Steinberger 46f49eb6eb refactor: shrink plugin sdk public surface 8 months ago
Peter Steinberger b9c4db1a77 test: fix stale boundary guardrails 8 months ago
Vincent Koc 7d8d3d9d77 docs: merge duplicate OpenRouter entry, fix broken plugin anchor links 8 months ago
Vincent Koc 67da67b61a
docs: fix tools nav A-Z, split plugin page, consolidate sandbox docs, add OpenShell page (#50055)
* docs: fix A-Z built-in tools nav, split plugin page, consolidate sandbox docs

* docs: add dedicated OpenShell sandbox backend page

* style: format markdown tables

* docs: trim plugin page, restructure available plugins into table + categories
8 months ago
Vincent Koc be3f4a7966 docs: add Building Extensions guide and nav entry 8 months ago
Vincent Koc 2797ae1583 docs: add missing voice-call CLI commands and contract test section to testing 8 months ago
Vincent Koc 3cecbcf8b6 docs: fix curly quotes, non-breaking hyphens, and remaining apostrophes in headings 8 months ago
Vincent Koc bf470b711b docs(plugins): dedup in-process trust refs and add manifest cross-references
- Replace redundant in-process trust statements with cross-references
  to the Execution model section (lines 573, 2436)
- Add CLI reference link from plugin.md CLI section
- Add configuration reference link from manifest.md validation section
- Add provider runtime hooks link from manifest.md providerAuthChoices

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8 months ago
Vincent Koc d2ef865073 docs(plugins): deduplicate and cross-reference plugin capability docs
- Merge hook order + which-hook-to-use into single reference table
- Deduplicate npm spec restrictions (link to CLI reference)
- Deduplicate plugin shapes in cli/plugins.md (link to main definition)
- Add capability-cookbook to docs.json navigation
- Add cross-references: Architecture→Load pipeline, Config→configuration
  reference, Plugin slots→manifest kind, Adding capability→cookbook
- Add missing cursor bundle subtype in 3 locations
- Fix verbose/info→verbose/inspect references
- Remove duplicate "info is alias for inspect" note
- Add missing install command to CLI command summary
- Replace premature "shape" jargon with "pattern" before definition

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8 months ago
Vincent Koc e7422716bb docs(plugins): rename plugins info to plugins inspect across all docs
Update all references from `plugins info` to `plugins inspect` in bundles,
plugin system, and CLI index docs to match the renamed command.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8 months ago
Vincent Koc 681d16a892 docs(manifest): cross-reference public capability model
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8 months ago
Vincent Koc 06459ca0df
Agents: run bundle MCP tools in embedded Pi (#48611)
* Agents: run bundle MCP tools in embedded Pi

* Plugins: fix bundle MCP path resolution

* Plugins: warn on unsupported bundle MCP transports

* Commands: add embedded Pi MCP management

* Config: move MCP management to top-level config
8 months ago
Peter Steinberger 6da9ba3267
docs(plugins): document capability ownership model 8 months ago
Vincent Koc 3832f938fd Docs: use placeholders for marketplace plugin examples 8 months ago
Vincent Koc d896d8e0cd Docs: add Claude marketplace plugin install guidance 8 months ago
Peter Steinberger ae60094fb5
refactor(plugins): move onboarding auth metadata to manifests 8 months ago
Peter Steinberger 8ab01c5c93
refactor(core): land plugin auth and startup cleanup 8 months ago
Peter Steinberger 1f68e6e89c
docs(plugins): unify bundle format explainer 8 months ago
Peter Steinberger dd40741e18
feat(plugins): add compatible bundle support 8 months ago
Peter Steinberger dbef3dfef0
docs(voice-call): clarify allowlist caller ID limits 8 months ago
Vincent Koc 151f26070b docs: context engine 9 months ago
Vincent Koc 7cc3376f07 docs(plugins): add context-engine manifest kind example 9 months ago
Peter Steinberger f9025c3f55 feat(zalouser): add reactions, group context, and receipt acks 9 months ago
Peter Steinberger 208a9b1ad1 docs(zalouser): document js-native migration and breaking change 9 months ago
zzzz 31b1b20b3c docs: add WeChat community plugin listing
Add @icesword760/openclaw-wechat to the community plugins page.
This plugin connects OpenClaw to WeChat personal accounts via
WeChatPadPro (iPad protocol) with support for text, image, and
file exchange.

Co-authored-by: Cursor <cursoragent@cursor.com>
9 months ago
Peter Steinberger 1d28da55a5 fix(voice-call): block Twilio webhook replay and stale transitions 9 months ago
Peter Steinberger 1d8968c8a8 fix(voice-call): harden media stream pre-start websocket handling 9 months ago
Peter Steinberger 0978d63edd docs: add community plugins guide 9 months ago
Sebastian df8f7ff1ab docs(voice-call): document stale call reaper config 9 months ago
Peter Steinberger f47584fec8 refactor(voice-call): centralize Telnyx webhook verification 9 months ago
Peter Steinberger 29b587e73c fix(voice-call): fail closed when Telnyx webhook public key missing 9 months ago
Seb Slight 929a3725d3
docs: canonicalize docs paths and align zh navigation (#11428)
* docs(navigation): canonicalize paths and align zh nav

* chore(docs): remove stray .DS_Store

* docs(scripts): add non-mint docs link audit

* docs(nav): fix zh source paths and preserve legacy redirects (#11428) (thanks @sebslight)

* chore(docs): satisfy lint for docs link audit script (#11428) (thanks @sebslight)
9 months ago
Peter Steinberger a749db9820 fix: harden voice-call webhook verification 10 months ago
Seb Slight abcaa8c7a9
Docs: add nav titles across docs (#5689) 10 months ago
cpojer 8cab78abbc
chore: Run `pnpm format:fix`. 10 months ago
Peter Steinberger 9a7160786a refactor: rename to openclaw 10 months ago
Peter Steinberger 6d16a658e5 refactor: rename clawdbot to moltbot with legacy compat 10 months ago
Peter Steinberger b3a60af71c fix: gate ngrok free-tier bypass to loopback 10 months ago
Peter Steinberger 97200984f8 fix: secure twilio webhook verification 10 months ago
Peter Steinberger 83f92e34af refactor: align voice-call TTS with core config 10 months ago
Peter Steinberger dc07f1e021 fix: keep core tools when allowlist is plugin-only 10 months ago
Peter Steinberger 51a9053387 feat: add OpenProse plugin skills 10 months ago
Peter Steinberger 121ae6036b docs: add matrix crypto setup note 10 months ago
Shadow 2f6d5805de fix: enforce plugin config schemas (#1272) (thanks @thewilloftheshadow)
Co-authored-by: thewilloftheshadow <thewilloftheshadow@users.noreply.github.com>
10 months ago
Peter Steinberger 331b8157b0 docs: clarify plugin agent tool config 10 months ago
Peter Steinberger 6da6582ced feat: add optional plugin tools 10 months ago
Peter Steinberger 6e4d86f426 refactor: require target for message actions 10 months ago
tsu 390bd11f33
feat: add zalouser channel + directory CLI (#1032) (thanks @suminhthanh)
- Unified UX: channels login + message send; no plugin-specific top-level command\n- Added generic directory CLI for channel identity/groups\n- Docs: channel + plugin pages
10 months ago
vrknetha 946b0229e8 Voice Call: add Plivo provider 10 months ago
Peter Steinberger 45c314fbe6 docs(voice-call): expand plugin guide 10 months ago
Peter Steinberger 9f90d0721a docs: note relative plugin install paths 10 months ago
Peter Steinberger 42c17adb5e feat: restore voice-call plugin parity 10 months ago
Peter Steinberger 828d9955f2 docs(voice-call): add Twilio setup guide 10 months ago
Peter Steinberger d97c211e82 docs: make remote host examples generic 10 months ago
Peter Steinberger 07f1280cb0 docs: expand plugin quickstart 10 months ago
Peter Steinberger 720c5b53fd docs: document plugin system 10 months ago