plurigrid OpenClaw → Goblins Adapter
ElizaOS → OpenClaw Mapping (from elizaOS/openclaw-adapter)
| File | ElizaOS → OpenClaw |
|---|---|
action-to-tool.ts |
Action → Tool (JSON Schema → TypeBox) |
provider-to-hook.ts |
Provider → before_agent_start hook |
service-adapter.ts |
Service → Service (eager start) |
evaluator-to-hook.ts |
Evaluator → lifecycle hooks |
runtime-bridge.ts |
IAgentRuntime → RuntimeBridge shim |
schema-converter.ts |
JSON Schema → TypeBox + wallet schemas |
Critical: RuntimeBridge is a shim, not a full runtime embed.
ElizaOS → Goblins OCapN Mapping
| ElizaOS | Goblins | Why |
|---|---|---|
| Action | ^action-actor | Caps = authority (not ACL) |
| Provider | ^provider-cap | Read-only attenuated ref (POLA) |
| Service | ^service-actor in vat | Isolation via event loop |
| Evaluator | ^guard-actor | Proxy composition |
| IAgentRuntime | ^vat-bridge | Transactional actor state |
| IDatabaseAdapter | Actor state (bcom) | Automatic rollback |
| JSON Schema | Syrup record descriptor | Wire-native |
| OAuth session | CapTP session (Ed25519) | Structural authority |
Security Model Upgrade
MCP/ElizaOS: ambient authority
token → role → permissions → action (confused deputy possible)
Goblins/OCapN: structural authority
ref = authority, POLA (confused deputy impossible by construction)
Usage
(define-values (vat bridge schema session)
(spawn-goblins-adapter "my-agent" settings))
($ bridge register-plugin plugin-spec)
($ bridge invoke "tool-name" params)
($ session mcp-call->deliver sid "tool" params)
Concrete Affordance: Local Files, Upstream Repos, and Testing
Local goblins-adapter.scm Implementation
A full working Guile Scheme implementation exists at three locations:
| Path | Description |
|---|---|
/Users/alice/v/asi/skills/goblins-adapter/goblins-adapter.scm |
Primary copy (511 lines) |
/Users/alice/v/.agents/skills/openclaw-goblins-adapter/goblins-adapter.scm |
Agent-visible copy |
/Users/alice/v/worlds/a/asi/skills/goblins-adapter/goblins-adapter.scm |
World-a copy |
The .scm file implements all 9 components from the mapping table above:
^action-actor, ^provider-cap, ^service-actor, ^guard-actor,
^vat-bridge, ^schema-bridge, ^captp-session-bridge, ^gf3-adapter-enforcer,
and the top-level spawn-goblins-adapter entry point.
Upstream Repositories
# ElizaOS openclaw-adapter (TypeScript, the source material for the mapping)
git clone https://github.com/elizaOS/openclaw-adapter.git
# Guile Goblins (the OCapN actor framework this adapter targets)
git clone https://gitlab.com/spritely/guile-goblins.git
# Goblins documentation / OCapN spec
git clone https://gitlab.com/ocapn/ocapn.git
Install Guile Goblins
# Via Guix (recommended)
guix install guile guile-goblins
# Or via Flox
flox install guile
# Then install Goblins from source:
cd /tmp && git clone https://gitlab.com/spritely/guile-goblins.git
cd guile-goblins && ./configure && make && make install
Testing the Adapter
# Load and test the adapter in Guile REPL
guile -L /Users/alice/v/asi/skills/goblins-adapter/ -l goblins-adapter.scm -c '
(use-modules (goblins))
(define-values (vat bridge schema session gf3)
(spawn-goblins-adapter "test-agent"
(list (cons (quote test-key) "test-val"))))
(display (with-vat vat ($ bridge describe)))
(newline)
(display (with-vat vat ($ gf3 balanced?)))
(newline)
'
Quick Smoke Test (no Goblins required)
If Guile Goblins is not installed, verify the file parses:
guile -c '
(use-modules (ice-9 read))
(call-with-input-file
"/Users/alice/v/asi/skills/goblins-adapter/goblins-adapter.scm"
(lambda (port)
(let loop ((expr (read port)) (count 0))
(if (eof-object? expr)
(format #t "Parsed ~a top-level expressions successfully.~%" count)
(loop (read port) (+ count 1))))))
'
npm Package (ElizaOS side)
# The TypeScript openclaw-adapter (if you need the ElizaOS side)
npm install @elizaos/openclaw-adapter
# or from source:
git clone https://github.com/elizaOS/openclaw-adapter.git
cd openclaw-adapter && npm install && npm run build
ACP atlas
Part of: acp-commons.