Files

Fusion 3c387444d2 test(FN-2712): add runtime e2e and integration coverage

- Add OpenClaw runtime end-to-end tests covering execution flow and runtime contract behavior
- Add OpenClaw integration tests to validate plugin/runtime wiring in engine scenarios
- Add Paperclip runtime end-to-end and integration suites for equivalent cross-runtime coverage
- Update Hermes, OpenClaw, and Paperclip manifest descriptions for consistent runtime metadata

2026-04-27 11:58:31 -07:00

dist

feat(FN-2706): merge fusion/fn-2706 (auto-resolved)

2026-04-27 10:52:46 -07:00

src

feat(FN-2701): route OpenClaw runtime sessions through gateway client

2026-04-27 09:46:25 -07:00

CHANGELOG.md

chore(release): v0.6.0

2026-04-26 21:27:49 -07:00

manifest.json

test(FN-2712): add runtime e2e and integration coverage

2026-04-27 11:58:31 -07:00

package.json

feat(FN-2701): route OpenClaw runtime sessions through gateway client

2026-04-27 09:46:25 -07:00

README.md

feat(FN-2701): route OpenClaw runtime sessions through gateway client

2026-04-27 09:46:25 -07:00

tsconfig.json

feat(FN-2347): add experimental OpenClaw runtime plugin scaffold

2026-04-23 14:03:35 -07:00

vitest.config.ts

feat(FN-2701): route OpenClaw runtime sessions through gateway client

2026-04-27 09:46:25 -07:00

README.md

OpenClaw Runtime Plugin

fusion-plugin-openclaw-runtime provides the openclaw runtime hint for Fusion agents by calling a locally running OpenClaw gateway over HTTP.

Unlike the default runtime, this plugin does not delegate to Fusion's internal pi runtime. It talks directly to OpenClaw's OpenAI-compatible endpoint.

Prerequisites

Install OpenClaw globally:

npm i -g openclaw

Start your OpenClaw gateway with chat-completions endpoint enabled.
Ensure the gateway is reachable from Fusion (default: http://127.0.0.1:18789).

Installation

Option 1: Copy to plugins directory

cp -r fusion-plugin-openclaw-runtime ~/.fusion/plugins/

Option 2: Install via CLI

fn plugin install ./plugins/fusion-plugin-openclaw-runtime

Runtime Metadata

Plugin ID: fusion-plugin-openclaw-runtime
Package name: @fusion-plugin-examples/openclaw-runtime
Runtime ID: openclaw
Runtime name: OpenClaw Runtime
Version: 0.1.0

Plugin Settings

Configure via plugin settings (ctx.settings) or environment variables.

Setting key	Env fallback	Default
`gatewayUrl`	`OPENCLAW_GATEWAY_URL`	`http://127.0.0.1:18789`
`gatewayToken`	`OPENCLAW_GATEWAY_TOKEN`	unset
`agentId`	`OPENCLAW_AGENT_ID`	`main`

Settings take precedence over environment variables.

How Execution Works

For each prompt, the runtime sends a streaming request to:

POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer <gatewayToken> (when configured)
x-openclaw-agent-id: <agentId>

Request payload includes:

model: "openclaw:<agentId>"
stream: true
messages: [...]
user: <stable-session-id> (so repeated turns share a stable gateway session)

Streaming uses SSE (data: ... + [DONE]), with callbacks wired for:

text deltas (choices[0].delta.content)
reasoning deltas (choices[0].delta.reasoning_content)
tool call lifecycle (choices[0].delta.tool_calls)

Agent Configuration

Configure an agent to target OpenClaw via runtimeConfig.runtimeHint:

{
  "name": "OpenClaw Executor",
  "role": "executor",
  "runtimeConfig": {
    "runtimeHint": "openclaw"
  }
}

Notes

This plugin no longer depends on @fusion/engine.
Session cleanup is a no-op client-side; OpenClaw manages gateway sessions.

Local Development

pnpm --filter @fusion-plugin-examples/openclaw-runtime test
pnpm --filter @fusion-plugin-examples/openclaw-runtime build