{"_id":"@agentcorporation/adapter-openclaw-gateway","_rev":"5-7bdd542eed4fb866235e1a575ef3b7d5","name":"@agentcorporation/adapter-openclaw-gateway","dist-tags":{"latest":"0.3.4"},"versions":{"0.3.1":{"name":"@agentcorporation/adapter-openclaw-gateway","version":"0.3.1","license":"MIT","_id":"@agentcorporation/adapter-openclaw-gateway@0.3.1","maintainers":[{"name":"agentcorporation","email":"melaniecooperwork@gmail.com"}],"homepage":"https://github.com/AgenticCompany/company","bugs":{"url":"https://github.com/AgenticCompany/company/issues"},"dist":{"shasum":"93d26c9719c9ede4d29f20cb8b95ec5f6ef717a5","tarball":"https://registry.npmjs.org/@agentcorporation/adapter-openclaw-gateway/-/adapter-openclaw-gateway-0.3.1.tgz","fileCount":46,"integrity":"sha512-84/t1nqlMIWh67QcHTjf+O9+YJiR1bK+MIcuTDCUkeob29jhA5Cn60Zyu/cfIWXKAQnU6HEX0pg9L6+Yk6tWdQ==","signatures":[{"sig":"MEQCIBosKKqMXPbEy5B3LEDJAYGiAS7CU6ILbpluViYsTl8JAiARAGajx/HlyCtqJXWi9gbw35smSLOexeIpMZuDWpNGWA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":141016},"type":"module","exports":{".":"./src/index.ts","./ui":"./src/ui/index.ts","./cli":"./src/cli/index.ts","./server":"./src/server/index.ts"},"gitHead":"b0b2a6a82af0fda218e2bd07bfb7f4b8d5ffd74d","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"agentcorporation","email":"melaniecooperwork@gmail.com"},"repository":{"url":"git+https://github.com/AgenticCompany/company.git","type":"git","directory":"packages/adapters/openclaw-gateway"},"_npmVersion":"10.9.3","description":"This document describes how `@agentcorporation/adapter-openclaw-gateway` invokes OpenClaw over the Gateway protocol.","directories":{},"_nodeVersion":"22.19.0","dependencies":{"ws":"^8.19.0","picocolors":"^1.1.1","@agentcorporation/adapter-utils":"workspace:*"},"publishConfig":{"main":"./dist/index.js","types":"./dist/index.d.ts","access":"public","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./ui":{"types":"./dist/ui/index.d.ts","import":"./dist/ui/index.js"},"./cli":{"types":"./dist/cli/index.d.ts","import":"./dist/cli/index.js"},"./server":{"types":"./dist/server/index.d.ts","import":"./dist/server/index.js"}}},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.18.1","typescript":"^5.7.3","@types/node":"^24.6.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-openclaw-gateway_0.3.1_1776095432103_0.05996103546817544","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@agentcorporation/adapter-openclaw-gateway","version":"0.3.2","license":"MIT","_id":"@agentcorporation/adapter-openclaw-gateway@0.3.2","maintainers":[{"name":"agentcorporations","email":"melaniecooperwork@gmail.com"}],"homepage":"https://github.com/AgenticCompany/company","bugs":{"url":"https://github.com/AgenticCompany/company/issues"},"dist":{"shasum":"f173e25cde2baeec0d963cc510b8205f44ab22a5","tarball":"https://registry.npmjs.org/@agentcorporation/adapter-openclaw-gateway/-/adapter-openclaw-gateway-0.3.2.tgz","fileCount":47,"integrity":"sha512-qp48WOX7ItJSs4w91rkiwDa0pryIvR4X7grX/uOL/xAXpkdv0jUtDxy/hv+tN9bdEipd9yhUs4+D3JpTrJ69tA==","signatures":[{"sig":"MEQCICf4RfK3axHZTQaLkommUonN4jJTFiglDVyUMkb4ofkHAiB9jBEfo2OL3QHPrbwj60p44cHavuBTG59AOx3sRC93OQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":141883},"main":"./dist/index.js","type":"module","_from":"file:agentcorporation-adapter-openclaw-gateway-0.3.2.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./ui":{"types":"./dist/ui/index.d.ts","import":"./dist/ui/index.js"},"./cli":{"types":"./dist/cli/index.d.ts","import":"./dist/cli/index.js"},"./server":{"types":"./dist/server/index.d.ts","import":"./dist/server/index.js"}},"scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"agentcorporations","email":"melaniecooperwork@gmail.com"},"_resolved":"/private/var/folders/m5/v30vrvps0lzccd5ps4dn8yqh0000gn/T/9a58a1da3236b27558fd2cd670b97388/agentcorporation-adapter-openclaw-gateway-0.3.2.tgz","_integrity":"sha512-qp48WOX7ItJSs4w91rkiwDa0pryIvR4X7grX/uOL/xAXpkdv0jUtDxy/hv+tN9bdEipd9yhUs4+D3JpTrJ69tA==","repository":{"url":"git+https://github.com/AgenticCompany/company.git","type":"git","directory":"packages/adapters/openclaw-gateway"},"_npmVersion":"10.9.3","description":"This document describes how `@agentcorporation/adapter-openclaw-gateway` invokes OpenClaw over the Gateway protocol.","directories":{},"_nodeVersion":"22.19.0","dependencies":{"ws":"^8.19.0","picocolors":"^1.1.1","@agentcorporation/adapter-utils":"0.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.18.1","typescript":"^5.7.3","@types/node":"^24.6.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-openclaw-gateway_0.3.2_1776141410008_0.39271442629859665","host":"s3://npm-registry-packages-npm-production"}},"0.3.3":{"name":"@agentcorporation/adapter-openclaw-gateway","version":"0.3.3","license":"MIT","_id":"@agentcorporation/adapter-openclaw-gateway@0.3.3","maintainers":[{"name":"agentcorporations","email":"melaniecooperwork@gmail.com"}],"homepage":"https://github.com/AgenticCompany/company","bugs":{"url":"https://github.com/AgenticCompany/company/issues"},"dist":{"shasum":"e9f38b00aa46bd9e86e7e63a07fd8c2c0b8bef68","tarball":"https://registry.npmjs.org/@agentcorporation/adapter-openclaw-gateway/-/adapter-openclaw-gateway-0.3.3.tgz","fileCount":47,"integrity":"sha512-yZgevcmPdQxzgH/bnBWJtZXplasUin1z341PC+mBT7T46YviUevKF+fadKmUAgAppHwrWnqtduAI8Bbnq/v8nQ==","signatures":[{"sig":"MEUCIQDYtVoj5Za97O4oMQ37tlwRDCATKtTjqL45EipoPJSoYAIgBBKzV/kp+sDGOTvCUvqHWRpxOkjC7QynY2VBqOT99Ls=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":141883},"main":"./dist/index.js","type":"module","_from":"file:agentcorporation-adapter-openclaw-gateway-0.3.3.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./ui":{"types":"./dist/ui/index.d.ts","import":"./dist/ui/index.js"},"./cli":{"types":"./dist/cli/index.d.ts","import":"./dist/cli/index.js"},"./server":{"types":"./dist/server/index.d.ts","import":"./dist/server/index.js"}},"scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"agentcorporations","email":"melaniecooperwork@gmail.com"},"_resolved":"/private/var/folders/m5/v30vrvps0lzccd5ps4dn8yqh0000gn/T/9a7418825bd0af3270b7e2d63583a94a/agentcorporation-adapter-openclaw-gateway-0.3.3.tgz","_integrity":"sha512-yZgevcmPdQxzgH/bnBWJtZXplasUin1z341PC+mBT7T46YviUevKF+fadKmUAgAppHwrWnqtduAI8Bbnq/v8nQ==","repository":{"url":"git+https://github.com/AgenticCompany/company.git","type":"git","directory":"packages/adapters/openclaw-gateway"},"_npmVersion":"10.9.3","description":"This document describes how `@agentcorporation/adapter-openclaw-gateway` invokes OpenClaw over the Gateway protocol.","directories":{},"_nodeVersion":"22.19.0","dependencies":{"ws":"^8.19.0","picocolors":"^1.1.1","@agentcorporation/adapter-utils":"0.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.18.1","typescript":"^5.7.3","@types/node":"^24.6.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-openclaw-gateway_0.3.3_1776142364837_0.9275416574966497","host":"s3://npm-registry-packages-npm-production"}},"0.3.4":{"name":"@agentcorporation/adapter-openclaw-gateway","version":"0.3.4","license":"MIT","homepage":"https://github.com/AgenticCompany/company","bugs":{"url":"https://github.com/AgenticCompany/company/issues"},"repository":{"type":"git","url":"git+https://github.com/AgenticCompany/company.git","directory":"packages/adapters/openclaw-gateway"},"type":"module","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./server":{"types":"./dist/server/index.d.ts","import":"./dist/server/index.js"},"./ui":{"types":"./dist/ui/index.d.ts","import":"./dist/ui/index.js"},"./cli":{"types":"./dist/cli/index.d.ts","import":"./dist/cli/index.js"}},"publishConfig":{"access":"public"},"dependencies":{"picocolors":"^1.1.1","ws":"^8.19.0","@agentcorporation/adapter-utils":"0.3.2"},"devDependencies":{"@types/node":"^24.6.0","@types/ws":"^8.18.1","typescript":"^5.7.3"},"scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"main":"./dist/index.js","types":"./dist/index.d.ts","_id":"@agentcorporation/adapter-openclaw-gateway@0.3.4","description":"This document describes how `@agentcorporation/adapter-openclaw-gateway` invokes OpenClaw over the Gateway protocol.","_integrity":"sha512-g7OPVSVtqOZpdIcpSsKAxnYvdxKxi6G7oEtyBdG8Q2TDIPp5BzpDv/TS1v0zHm3p6/bzexhxvjpCmg9x+03Epw==","_resolved":"/private/var/folders/m5/v30vrvps0lzccd5ps4dn8yqh0000gn/T/2853547a85c4ea6202da47468fc51169/agentcorporation-adapter-openclaw-gateway-0.3.4.tgz","_from":"file:agentcorporation-adapter-openclaw-gateway-0.3.4.tgz","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-g7OPVSVtqOZpdIcpSsKAxnYvdxKxi6G7oEtyBdG8Q2TDIPp5BzpDv/TS1v0zHm3p6/bzexhxvjpCmg9x+03Epw==","shasum":"6d6df48c685b369a2caa28c575f8ff65145e75ba","tarball":"https://registry.npmjs.org/@agentcorporation/adapter-openclaw-gateway/-/adapter-openclaw-gateway-0.3.4.tgz","fileCount":47,"unpackedSize":141883,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC3WQnQ15eduL5YkDcsE0ty/grJmW3Nr5f7sdPuIi9yvAIhAPXxjH5toBPQtCQDpWhxlsIiYO/w9CMhahoVZXBzhvcd"}]},"_npmUser":{"name":"agentcorporations","email":"melaniecooperwork@gmail.com"},"directories":{},"maintainers":[{"name":"agentcorporations","email":"melaniecooperwork@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adapter-openclaw-gateway_0.3.4_1776142509631_0.07856527140283776"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-13T15:50:32.002Z","modified":"2026-04-14T04:55:09.934Z","0.3.1":"2026-04-13T15:50:32.246Z","0.3.2":"2026-04-14T04:36:50.145Z","0.3.3":"2026-04-14T04:52:44.988Z","0.3.4":"2026-04-14T04:55:09.784Z"},"bugs":{"url":"https://github.com/AgenticCompany/company/issues"},"license":"MIT","homepage":"https://github.com/AgenticCompany/company","repository":{"type":"git","url":"git+https://github.com/AgenticCompany/company.git","directory":"packages/adapters/openclaw-gateway"},"description":"This document describes how `@agentcorporation/adapter-openclaw-gateway` invokes OpenClaw over the Gateway protocol.","maintainers":[{"name":"agentcorporations","email":"melaniecooperwork@gmail.com"}],"readme":"# OpenClaw Gateway Adapter\n\nThis document describes how `@agentcorporation/adapter-openclaw-gateway` invokes OpenClaw over the Gateway protocol.\n\n## Transport\n\nThis adapter always uses WebSocket gateway transport.\n\n- URL must be `ws://` or `wss://`\n- Connect flow follows gateway protocol:\n1. receive `connect.challenge`\n2. send `req connect` (protocol/client/auth/device payload)\n3. send `req agent`\n4. wait for completion via `req agent.wait`\n5. stream `event agent` frames into Company logs/transcript parsing\n\n## Auth Modes\n\nGateway credentials can be provided in any of these ways:\n\n- `authToken` / `token` in adapter config\n- `headers.x-openclaw-token`\n- `headers.x-openclaw-auth` (legacy)\n- `password` (shared password mode)\n\nWhen a token is present and `authorization` header is missing, the adapter derives `Authorization: Bearer <token>`.\n\n## Device Auth\n\nBy default the adapter sends a signed `device` payload in `connect` params.\n\n- set `disableDeviceAuth=true` to omit device signing\n- set `devicePrivateKeyPem` to pin a stable signing key\n- without `devicePrivateKeyPem`, the adapter generates an ephemeral Ed25519 keypair per run\n- when `autoPairOnFirstConnect` is enabled (default), the adapter handles one initial `pairing required` by calling `device.pair.list` + `device.pair.approve` over shared auth, then retries once.\n\n## Session Strategy\n\nThe adapter supports the same session routing model as HTTP OpenClaw mode:\n\n- `sessionKeyStrategy=issue|fixed|run`\n- `sessionKey` is used when strategy is `fixed`\n\nResolved session key is sent as `agent.sessionKey`.\n\n## Payload Mapping\n\nThe agent request is built as:\n\n- required fields:\n  - `message` (wake text plus optional `payloadTemplate.message`/`payloadTemplate.text` prefix)\n  - `idempotencyKey` (Company `runId`)\n  - `sessionKey` (resolved strategy)\n- optional additions:\n  - all `payloadTemplate` fields merged in\n  - `agentId` from config if set and not already in template\n\n## Timeouts\n\n- `timeoutSec` controls adapter-level request budget\n- `waitTimeoutMs` controls `agent.wait.timeoutMs`\n\nIf `agent.wait` returns `timeout`, adapter returns `openclaw_gateway_wait_timeout`.\n\n## Log Format\n\nStructured gateway event logs use:\n\n- `[openclaw-gateway] ...` for lifecycle/system logs\n- `[openclaw-gateway:event] run=<id> stream=<stream> data=<json>` for `event agent` frames\n\nUI/CLI parsers consume these lines to render transcript updates.\n","readmeFilename":"README.md"}