Registry / devops / paperclip-adapter-picoclaw

paperclip-adapter-picoclaw

library0.5.4jsnpmunverified

External adapter for the Paperclip AI framework that connects to PicoClaw devices using the Pico Protocol over WebSocket. Version 0.5.4 is the current stable release. Use for integrating robotic/control hardware with Paperclip-based AI agents. No active release cadence. Key differentiator: it bridges Paperclip AI agents with physical PicoClaw devices.

devops

npm install paperclip-adapter-picoclaw

package ↗

INSTALL

IMPORT

SIG · PAPERCLIP-ADAPTER-

paperclip-adapter-picoclaw

devopsjavascriptv0.5.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

PicoClawAdapter

✓ import { PicoClawAdapter } from 'paperclip-adapter-picoclaw'

✗ const PicoClawAdapter = require('paperclip-adapter-picoclaw')

Module is ESM-first; CommonJS require may not work without bundler. TypeScript types are included.

PicoClawConfig

✓ import { PicoClawConfig } from 'paperclip-adapter-picoclaw'

✗ import PicoClawConfig from 'paperclip-adapter-picoclaw'

Named export, not default export.

default

✓ import PicoClawAdapter from 'paperclip-adapter-picoclaw'

✗ import { PicoClawAdapter as default } from 'paperclip-adapter-picoclaw'

There is a default export (likely the adapter class constructor) alongside named exports. Both work.

Shows how to import and instantiate the adapter, connect to a PicoClaw WebSocket, send a command, and disconnect.

import { createAdapter } from '@paperclipai/adapter-utils'; import PicoClawAdapter from 'paperclip-adapter-picoclaw'; const adapter = createAdapter(new PicoClawAdapter({ websocketUrl: process.env.PICO_WS_URL ?? 'ws://localhost:8080', deviceId: process.env.DEVICE_ID ?? 'picoclaw-1' })); await adapter.connect(); const status = await adapter.sendCommand('STATUS'); console.log('Device status:', status); await adapter.disconnect();

Debug

Known issues

breakingWebSocket URL must include protocol (ws:// or wss://) – missing protocol causes connection failure.

fix

Pass full URL with ws:// or wss:// prefix in config.

affects: >=0.1.0

gotchaAdapter assumes WebSocket server follows Pico Protocol exactly – deviations cause undefined behavior.

fix

Ensure server implements Pico Protocol spec; use validation tools.

affects: all

gotchaPeer dependency @paperclipai/adapter-utils must be installed manually (not auto-installed by npm).

fix

Run 'npm install @paperclipai/adapter-utils' as a direct dependency.

affects: >=0.1.0

deprecatedThe `connect` method returns a promise; using it without await may cause race conditions.

fix

Always await connect() before sending commands.

affects: >=0.5.0

gotchaTypeScript types are marked as internal; some interfaces may change between minor versions.

fix

Pin the minor version to avoid unexpected type changes.

affects: >=0.4.0

Errors

Common errors & fixes

Module not found: Can't resolve '@paperclipai/adapter-utils'

Peer dependency not installed

fix

npm install @paperclipai/adapter-utils

Error: CONNECT_ERROR: Unreachable WebSocket server

WebSocket URL is incorrect or server not running

fix

Check the websocketUrl config and ensure the server is accessible.

TypeError: adapter.sendCommand is not a function

Adapter not properly initialized (missing createAdapter call)

fix

Use createAdapter() from @paperclipai/adapter-utils to wrap the adapter.

Error: Invalid command format

Command string does not comply with Pico Protocol

fix

Ensure command is a string following the protocol (e.g., uppercase, no spaces).

Upgrade

Version history

0.5.4latest on npm

Audit

Dependencies

@paperclipai/adapter-utilsrequiredpeer dependency required for adapter base functionality

Agent activity

4 hits · last 30 days

node

Resources

packagepaperclip-adapter-picoclaw ↗