{"id":48850,"library":"openclaw-channel-octo","title":"OpenClaw Octo Channel Plugin","description":"Octo channel plugin for OpenClaw enabling real-time communication via WuKongIM WebSocket protocol. Current version 1.0.0, stable with no known breaking changes. It acts as a transport layer for OpenClaw, allowing developers to integrate instant messaging features into their applications. Key differentiators: leverages WuKongIM's scalable WebSocket infrastructure, supports TypeScript types, and follows OpenClaw's plugin architecture. Release cadence is initial stable release.","status":"active","version":"1.0.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","typescript"],"install":[{"cmd":"npm install openclaw-channel-octo","lang":"bash","label":"npm"},{"cmd":"yarn add openclaw-channel-octo","lang":"bash","label":"yarn"},{"cmd":"pnpm add openclaw-channel-octo","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required for plugin integration, version >=2026.4.15","package":"openclaw","optional":false}],"imports":[{"note":"ESM-only module; CommonJS require will not work. TypeScript types are bundled.","wrong":"const OctoChannel = require('openclaw-channel-octo').OctoChannel","symbol":"OctoChannel","correct":"import { OctoChannel } from 'openclaw-channel-octo'"},{"note":"Default export is a factory function to create a channel instance. ESM only.","wrong":"const createOctoChannel = require('openclaw-channel-octo')","symbol":"default export (channel factory)","correct":"import createOctoChannel from 'openclaw-channel-octo'"},{"note":"ChannelConfig is a TypeScript type only; use type import to avoid runtime bundling issues.","wrong":"import { ChannelConfig } from 'openclaw-channel-octo'","symbol":"ChannelConfig","correct":"import type { ChannelConfig } from 'openclaw-channel-octo'"}],"quickstart":{"code":"import createOctoChannel from 'openclaw-channel-octo';\nimport { Claw } from 'openclaw';\n\nconst channel = createOctoChannel({\n  url: process.env.WUKONGIM_URL ?? 'wss://example.com/ws',\n  appKey: process.env.WUKONGIM_APP_KEY ?? '',\n  appSecret: process.env.WUKONGIM_APP_SECRET ?? ''\n});\n\nconst claw = new Claw({ channel });\nawait claw.connect();\n\n// Now you can use claw to send/receive messages\nclaw.on('message', (msg) => {\n  console.log('Received:', msg);\n});","lang":"typescript","description":"Shows how to create an Octo channel, connect using OpenClaw, and listen for messages via WuKongIM WebSocket."},"warnings":[{"fix":"Use createOctoChannel(config) to get the channel object.","message":"The default export createOctoChannel is a factory function, not the channel instance. You must call it with config.","severity":"gotcha","affected_versions":"all"},{"fix":"Use import syntax. If using CommonJS, consider dynamic import() or switch to ESM.","message":"This package is ESM-only. Attempting to require() will throw an error.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Ensure openclaw version meets >=2026.4.15.","message":"The peer dependency openclaw must be at least version 2026.4.15. Using an older version may cause runtime errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.0.0':21 'act':29 'allow':36 'applic':45 'architectur':62 'break':26 'cadenc':64 'chang':27 'channel':3,6 'communic':14 'current':19 'develop':37 'differenti':47 'enabl':10 'featur':42 'follow':58 'infrastructur':53 'initi':66 'instant':40 'integr':39 'javascript':69 'key':46 'known':25 'layer':33 'leverag':48 'messag':41 'octo':2,5 'openclaw':1,9,35,59 'plugin':4,7,61 'protocol':18 'real':12 'real-tim':11 'releas':63,68 'scalabl':51 'stabl':22,67 'support':54 'time':13 'transport':32 'type':56 'typescript':55,70 'version':20 'via':15 'websocket':17,52 'wukongim':16,49","created_at":"2026-06-07T16:58:47.464104+00:00","updated_at":"2026-06-07T16:58:47.464104+00:00","problems":[{"fix":"Use import statement or switch to ESM in your project.","cause":"Attempting to use CommonJS require() on an ESM-only package.","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module not supported"},{"fix":"Import default: import createOctoChannel from 'openclaw-channel-octo'","cause":"Using the wrong import (e.g., named import when default import expected).","error":"TypeError: createOctoChannel is not a function"},{"fix":"Install openclaw: npm install openclaw@>=2026.4.15","cause":"Peer dependency openclaw is not installed.","error":"Error: Cannot find module 'openclaw'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"openclaw-channel-octo","openapi_spec":null,"status_page":null,"smithery":null,"categories":["messaging"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}