{"_id":"@agenthippo-ai/hippoclaw","name":"@agenthippo-ai/hippoclaw","dist-tags":{"latest":"2026.7.28"},"versions":{"2026.7.28":{"name":"@agenthippo-ai/hippoclaw","version":"2026.7.28","description":"Multi-channel AI gateway with extensible messaging integrations","keywords":[],"homepage":"https://github.com/agenthippoai/hippoclaw#readme","bugs":{"url":"https://github.com/agenthippoai/hippoclaw/issues"},"license":"MIT","author":{"name":"AgentHippo","email":"dev@agenthippo.ai"},"repository":{"type":"git","url":"git+https://github.com/agenthippoai/hippoclaw.git"},"bin":{"hippoclaw":"openclaw.mjs","openclaw":"openclaw.mjs"},"directories":{"doc":"docs","test":"test"},"type":"module","main":"dist/index.js","exports":{".":"./dist/index.js","./plugin-sdk":{"types":"./dist/plugin-sdk/index.d.ts","default":"./dist/plugin-sdk/index.js"},"./plugin-sdk/core":{"types":"./dist/plugin-sdk/core.d.ts","default":"./dist/plugin-sdk/core.js"},"./plugin-sdk/compat":{"types":"./dist/plugin-sdk/compat.d.ts","default":"./dist/plugin-sdk/compat.js"},"./plugin-sdk/telegram":{"types":"./dist/plugin-sdk/telegram.d.ts","default":"./dist/plugin-sdk/telegram.js"},"./plugin-sdk/discord":{"types":"./dist/plugin-sdk/discord.d.ts","default":"./dist/plugin-sdk/discord.js"},"./plugin-sdk/slack":{"types":"./dist/plugin-sdk/slack.d.ts","default":"./dist/plugin-sdk/slack.js"},"./plugin-sdk/signal":{"types":"./dist/plugin-sdk/signal.d.ts","default":"./dist/plugin-sdk/signal.js"},"./plugin-sdk/imessage":{"types":"./dist/plugin-sdk/imessage.d.ts","default":"./dist/plugin-sdk/imessage.js"},"./plugin-sdk/whatsapp":{"types":"./dist/plugin-sdk/whatsapp.d.ts","default":"./dist/plugin-sdk/whatsapp.js"},"./plugin-sdk/line":{"types":"./dist/plugin-sdk/line.d.ts","default":"./dist/plugin-sdk/line.js"},"./plugin-sdk/msteams":{"types":"./dist/plugin-sdk/msteams.d.ts","default":"./dist/plugin-sdk/msteams.js"},"./plugin-sdk/acpx":{"types":"./dist/plugin-sdk/acpx.d.ts","default":"./dist/plugin-sdk/acpx.js"},"./plugin-sdk/bluebubbles":{"types":"./dist/plugin-sdk/bluebubbles.d.ts","default":"./dist/plugin-sdk/bluebubbles.js"},"./plugin-sdk/copilot-proxy":{"types":"./dist/plugin-sdk/copilot-proxy.d.ts","default":"./dist/plugin-sdk/copilot-proxy.js"},"./plugin-sdk/device-pair":{"types":"./dist/plugin-sdk/device-pair.d.ts","default":"./dist/plugin-sdk/device-pair.js"},"./plugin-sdk/diagnostics-otel":{"types":"./dist/plugin-sdk/diagnostics-otel.d.ts","default":"./dist/plugin-sdk/diagnostics-otel.js"},"./plugin-sdk/diffs":{"types":"./dist/plugin-sdk/diffs.d.ts","default":"./dist/plugin-sdk/diffs.js"},"./plugin-sdk/feishu":{"types":"./dist/plugin-sdk/feishu.d.ts","default":"./dist/plugin-sdk/feishu.js"},"./plugin-sdk/google-gemini-cli-auth":{"types":"./dist/plugin-sdk/google-gemini-cli-auth.d.ts","default":"./dist/plugin-sdk/google-gemini-cli-auth.js"},"./plugin-sdk/googlechat":{"types":"./dist/plugin-sdk/googlechat.d.ts","default":"./dist/plugin-sdk/googlechat.js"},"./plugin-sdk/irc":{"types":"./dist/plugin-sdk/irc.d.ts","default":"./dist/plugin-sdk/irc.js"},"./plugin-sdk/llm-task":{"types":"./dist/plugin-sdk/llm-task.d.ts","default":"./dist/plugin-sdk/llm-task.js"},"./plugin-sdk/lobster":{"types":"./dist/plugin-sdk/lobster.d.ts","default":"./dist/plugin-sdk/lobster.js"},"./plugin-sdk/matrix":{"types":"./dist/plugin-sdk/matrix.d.ts","default":"./dist/plugin-sdk/matrix.js"},"./plugin-sdk/mattermost":{"types":"./dist/plugin-sdk/mattermost.d.ts","default":"./dist/plugin-sdk/mattermost.js"},"./plugin-sdk/memory-core":{"types":"./dist/plugin-sdk/memory-core.d.ts","default":"./dist/plugin-sdk/memory-core.js"},"./plugin-sdk/memory-lancedb":{"types":"./dist/plugin-sdk/memory-lancedb.d.ts","default":"./dist/plugin-sdk/memory-lancedb.js"},"./plugin-sdk/minimax-portal-auth":{"types":"./dist/plugin-sdk/minimax-portal-auth.d.ts","default":"./dist/plugin-sdk/minimax-portal-auth.js"},"./plugin-sdk/nextcloud-talk":{"types":"./dist/plugin-sdk/nextcloud-talk.d.ts","default":"./dist/plugin-sdk/nextcloud-talk.js"},"./plugin-sdk/nostr":{"types":"./dist/plugin-sdk/nostr.d.ts","default":"./dist/plugin-sdk/nostr.js"},"./plugin-sdk/open-prose":{"types":"./dist/plugin-sdk/open-prose.d.ts","default":"./dist/plugin-sdk/open-prose.js"},"./plugin-sdk/phone-control":{"types":"./dist/plugin-sdk/phone-control.d.ts","default":"./dist/plugin-sdk/phone-control.js"},"./plugin-sdk/qwen-portal-auth":{"types":"./dist/plugin-sdk/qwen-portal-auth.d.ts","default":"./dist/plugin-sdk/qwen-portal-auth.js"},"./plugin-sdk/synology-chat":{"types":"./dist/plugin-sdk/synology-chat.d.ts","default":"./dist/plugin-sdk/synology-chat.js"},"./plugin-sdk/talk-voice":{"types":"./dist/plugin-sdk/talk-voice.d.ts","default":"./dist/plugin-sdk/talk-voice.js"},"./plugin-sdk/test-utils":{"types":"./dist/plugin-sdk/test-utils.d.ts","default":"./dist/plugin-sdk/test-utils.js"},"./plugin-sdk/thread-ownership":{"types":"./dist/plugin-sdk/thread-ownership.d.ts","default":"./dist/plugin-sdk/thread-ownership.js"},"./plugin-sdk/tlon":{"types":"./dist/plugin-sdk/tlon.d.ts","default":"./dist/plugin-sdk/tlon.js"},"./plugin-sdk/twitch":{"types":"./dist/plugin-sdk/twitch.d.ts","default":"./dist/plugin-sdk/twitch.js"},"./plugin-sdk/voice-call":{"types":"./dist/plugin-sdk/voice-call.d.ts","default":"./dist/plugin-sdk/voice-call.js"},"./plugin-sdk/zalo":{"types":"./dist/plugin-sdk/zalo.d.ts","default":"./dist/plugin-sdk/zalo.js"},"./plugin-sdk/zalouser":{"types":"./dist/plugin-sdk/zalouser.d.ts","default":"./dist/plugin-sdk/zalouser.js"},"./plugin-sdk/account-id":{"types":"./dist/plugin-sdk/account-id.d.ts","default":"./dist/plugin-sdk/account-id.js"},"./plugin-sdk/keyed-async-queue":{"types":"./dist/plugin-sdk/keyed-async-queue.d.ts","default":"./dist/plugin-sdk/keyed-async-queue.js"},"./cli-entry":"./openclaw.mjs"},"scripts":{"android:assemble":"cd apps/android && ./gradlew :app:assembleDebug","android:bundle:release":"bun apps/android/scripts/build-release-aab.ts","android:format":"cd apps/android && ./gradlew :app:ktlintFormat :benchmark:ktlintFormat","android:install":"cd apps/android && ./gradlew :app:installDebug","android:lint":"cd apps/android && ./gradlew :app:ktlintCheck :benchmark:ktlintCheck","android:lint:android":"cd apps/android && ./gradlew :app:lintDebug","android:run":"cd apps/android && ./gradlew :app:installDebug && adb shell am start -n ai.openclaw.app/.MainActivity","android:test":"cd apps/android && ./gradlew :app:testDebugUnitTest","android:test:integration":"OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_ANDROID_NODE=1 vitest run --config vitest.live.config.ts src/gateway/android-node.capabilities.live.test.ts","build":"pnpm canvas:a2ui:bundle && node scripts/tsdown-build.mjs && node scripts/copy-plugin-sdk-root-alias.mjs && pnpm build:plugin-sdk:dts && node --import tsx scripts/write-plugin-sdk-entry-dts.ts && node --import tsx scripts/canvas-a2ui-copy.ts && node --import tsx scripts/copy-hook-metadata.ts && node --import tsx scripts/copy-export-html-templates.ts && node --import tsx scripts/write-build-info.ts && node --import tsx scripts/write-cli-startup-metadata.ts && node --import tsx scripts/write-cli-compat.ts","build:docker":"node scripts/tsdown-build.mjs && node scripts/copy-plugin-sdk-root-alias.mjs && pnpm build:plugin-sdk:dts && node --import tsx scripts/write-plugin-sdk-entry-dts.ts && node --import tsx scripts/canvas-a2ui-copy.ts && node --import tsx scripts/copy-hook-metadata.ts && node --import tsx scripts/copy-export-html-templates.ts && node --import tsx scripts/write-build-info.ts && node --import tsx scripts/write-cli-startup-metadata.ts && node --import tsx scripts/write-cli-compat.ts","build:plugin-sdk:dts":"tsc -p tsconfig.plugin-sdk.dts.json","build:strict-smoke":"pnpm canvas:a2ui:bundle && node scripts/tsdown-build.mjs && node scripts/copy-plugin-sdk-root-alias.mjs && pnpm build:plugin-sdk:dts","canvas:a2ui:bundle":"bash scripts/bundle-a2ui.sh","check":"pnpm check:host-env-policy:swift && pnpm format:check && pnpm tsgo && pnpm lint && pnpm lint:tmp:no-random-messaging && pnpm lint:tmp:channel-agnostic-boundaries && pnpm lint:tmp:no-raw-channel-fetch && pnpm lint:agent:ingress-owner && pnpm lint:plugins:no-register-http-handler && pnpm lint:plugins:no-monolithic-plugin-sdk-entry-imports && pnpm lint:webhook:no-low-level-body-read && pnpm lint:auth:no-pairing-store-group && pnpm lint:auth:pairing-account-scope","check:docs":"pnpm format:docs:check && pnpm lint:docs && pnpm docs:check-links","check:host-env-policy:swift":"node scripts/generate-host-env-security-policy-swift.mjs --check","check:loc":"node --import tsx scripts/check-ts-max-loc.ts --max 500","deadcode:ci":"pnpm deadcode:report:ci:knip","deadcode:knip":"pnpm dlx knip --config knip.config.ts --isolate-workspaces --production --no-progress --reporter compact --files --dependencies","deadcode:report":"pnpm deadcode:knip; pnpm deadcode:ts-prune; pnpm deadcode:ts-unused","deadcode:report:ci:knip":"mkdir -p .artifacts/deadcode && pnpm deadcode:knip > .artifacts/deadcode/knip.txt 2>&1 || true","deadcode:report:ci:ts-prune":"mkdir -p .artifacts/deadcode && pnpm deadcode:ts-prune > .artifacts/deadcode/ts-prune.txt 2>&1 || true","deadcode:report:ci:ts-unused":"mkdir -p .artifacts/deadcode && pnpm deadcode:ts-unused > .artifacts/deadcode/ts-unused-exports.txt 2>&1 || true","deadcode:ts-prune":"pnpm dlx ts-prune src extensions scripts","deadcode:ts-unused":"pnpm dlx ts-unused-exports tsconfig.json --ignoreTestFiles --exitWithCount","dev":"node scripts/run-node.mjs","docs:bin":"node scripts/build-docs-list.mjs","docs:check-links":"node scripts/docs-link-audit.mjs","docs:dev":"cd docs && mint dev","docs:list":"node scripts/docs-list.js","docs:spellcheck":"bash scripts/docs-spellcheck.sh","docs:spellcheck:fix":"bash scripts/docs-spellcheck.sh --write","dup:check":"jscpd src extensions test scripts --format typescript,javascript --pattern \"**/*.{ts,tsx,js,mjs,cjs}\" --gitignore --noSymlinks --ignore \"**/node_modules/**,**/dist/**,**/.git/**,**/coverage/**,**/build/**,**/.build/**,**/.artifacts/**\" --min-lines 12 --min-tokens 80 --reporters console","dup:check:json":"jscpd src extensions test scripts --format typescript,javascript --pattern \"**/*.{ts,tsx,js,mjs,cjs}\" --gitignore --noSymlinks --ignore \"**/node_modules/**,**/dist/**,**/.git/**,**/coverage/**,**/build/**,**/.build/**,**/.artifacts/**\" --min-lines 12 --min-tokens 80 --reporters json --output .artifacts/jscpd","format":"oxfmt --write","format:all":"pnpm format && pnpm format:swift","format:check":"oxfmt --check","format:diff":"oxfmt --write && git --no-pager diff","format:docs":"git ls-files 'docs/**/*.md' 'docs/**/*.mdx' 'README.md' | xargs oxfmt --write","format:docs:check":"git ls-files 'docs/**/*.md' 'docs/**/*.mdx' 'README.md' | xargs oxfmt --check","format:fix":"oxfmt --write","format:swift":"swiftformat --lint --config .swiftformat apps/macos/Sources apps/ios/Sources apps/shared/OpenClawKit/Sources","gateway:dev":"OPENCLAW_SKIP_CHANNELS=1 CLAWDBOT_SKIP_CHANNELS=1 node scripts/run-node.mjs --dev gateway","gateway:dev:reset":"OPENCLAW_SKIP_CHANNELS=1 CLAWDBOT_SKIP_CHANNELS=1 node scripts/run-node.mjs --dev gateway --reset","gateway:watch":"node scripts/watch-node.mjs gateway --force","gen:host-env-policy:swift":"node scripts/generate-host-env-security-policy-swift.mjs --write","ghsa:patch":"node scripts/ghsa-patch.mjs","ios:beta":"bash scripts/ios-beta-release.sh","ios:beta:archive":"bash scripts/ios-beta-archive.sh","ios:beta:prepare":"bash scripts/ios-beta-prepare.sh","ios:build":"bash -lc './scripts/ios-configure-signing.sh && ./scripts/ios-write-version-xcconfig.sh && cd apps/ios && xcodegen generate && xcodebuild -project OpenClaw.xcodeproj -scheme OpenClaw -destination \"${IOS_DEST:-platform=iOS Simulator,name=iPhone 17}\" -configuration Debug build'","ios:gen":"bash -lc './scripts/ios-configure-signing.sh && ./scripts/ios-write-version-xcconfig.sh && cd apps/ios && xcodegen generate'","ios:open":"bash -lc './scripts/ios-configure-signing.sh && ./scripts/ios-write-version-xcconfig.sh && cd apps/ios && xcodegen generate && open OpenClaw.xcodeproj'","ios:run":"bash -lc './scripts/ios-configure-signing.sh && ./scripts/ios-write-version-xcconfig.sh && cd apps/ios && xcodegen generate && xcodebuild -project OpenClaw.xcodeproj -scheme OpenClaw -destination \"${IOS_DEST:-platform=iOS Simulator,name=iPhone 17}\" -configuration Debug build && xcrun simctl boot \"${IOS_SIM:-iPhone 17}\" || true && xcrun simctl launch booted ai.openclaw.ios'","lint":"oxlint --type-aware","lint:agent:ingress-owner":"node scripts/check-ingress-agent-owner-context.mjs","lint:all":"pnpm lint && pnpm lint:swift","lint:auth:no-pairing-store-group":"node scripts/check-no-pairing-store-group-auth.mjs","lint:auth:pairing-account-scope":"node scripts/check-pairing-account-scope.mjs","lint:docs":"pnpm dlx markdownlint-cli2","lint:docs:fix":"pnpm dlx markdownlint-cli2 --fix","lint:fix":"oxlint --type-aware --fix && pnpm format","lint:plugins:no-monolithic-plugin-sdk-entry-imports":"node --import tsx scripts/check-no-monolithic-plugin-sdk-entry-imports.ts","lint:plugins:no-register-http-handler":"node scripts/check-no-register-http-handler.mjs","lint:swift":"swiftlint lint --config .swiftlint.yml && (cd apps/ios && swiftlint lint --config .swiftlint.yml)","lint:tmp:channel-agnostic-boundaries":"node scripts/check-channel-agnostic-boundaries.mjs","lint:tmp:no-random-messaging":"node scripts/check-no-random-messaging-tmp.mjs","lint:tmp:no-raw-channel-fetch":"node scripts/check-no-raw-channel-fetch.mjs","lint:ui:no-raw-window-open":"node scripts/check-no-raw-window-open.mjs","lint:webhook:no-low-level-body-read":"node scripts/check-webhook-auth-body-order.mjs","mac:open":"open dist/OpenClaw.app","mac:package":"bash scripts/package-mac-app.sh","mac:restart":"bash scripts/restart-mac.sh","moltbot:rpc":"node scripts/run-node.mjs agent --mode rpc --json","openclaw":"node scripts/run-node.mjs","openclaw:rpc":"node scripts/run-node.mjs agent --mode rpc --json","plugins:sync":"node --import tsx scripts/sync-plugin-versions.ts","protocol:check":"pnpm protocol:gen && pnpm protocol:gen:swift && git diff --exit-code -- dist/protocol.schema.json apps/macos/Sources/OpenClawProtocol/GatewayModels.swift apps/shared/OpenClawKit/Sources/OpenClawProtocol/GatewayModels.swift","protocol:gen":"node --import tsx scripts/protocol-gen.ts","protocol:gen:swift":"node --import tsx scripts/protocol-gen-swift.ts","release:check":"node --import tsx scripts/release-check.ts","release:openclaw:npm:check":"node --import tsx scripts/openclaw-npm-release-check.ts","release:hippoclaw:npm":"bash scripts/publish-hippoclaw-npm.sh","release:hippoclaw:npm:dry-run":"bash scripts/publish-hippoclaw-npm.sh --dry-run","start":"node scripts/run-node.mjs","test":"node scripts/test-parallel.mjs","test:all":"pnpm lint && pnpm build && pnpm test && pnpm test:e2e && pnpm test:live && pnpm test:docker:all","test:auth:compat":"vitest run --config vitest.gateway.config.ts src/gateway/server.auth.compat-baseline.test.ts src/gateway/client.test.ts src/gateway/reconnect-gating.test.ts src/gateway/protocol/connect-error-details.test.ts","test:channels":"vitest run --config vitest.channels.config.ts","test:coverage":"vitest run --config vitest.unit.config.ts --coverage","test:docker:all":"pnpm test:docker:live-models && pnpm test:docker:live-gateway && pnpm test:docker:onboard && pnpm test:docker:gateway-network && pnpm test:docker:qr && pnpm test:docker:doctor-switch && pnpm test:docker:plugins && pnpm test:docker:cleanup","test:docker:cleanup":"bash scripts/test-cleanup-docker.sh","test:docker:doctor-switch":"bash scripts/e2e/doctor-install-switch-docker.sh","test:docker:gateway-network":"bash scripts/e2e/gateway-network-docker.sh","test:docker:live-gateway":"bash scripts/test-live-gateway-models-docker.sh","test:docker:live-models":"bash scripts/test-live-models-docker.sh","test:docker:onboard":"bash scripts/e2e/onboard-docker.sh","test:docker:plugins":"bash scripts/e2e/plugins-docker.sh","test:docker:qr":"bash scripts/e2e/qr-import-docker.sh","test:e2e":"vitest run --config vitest.e2e.config.ts","test:extensions":"vitest run --config vitest.extensions.config.ts","test:fast":"vitest run --config vitest.unit.config.ts","test:force":"node --import tsx scripts/test-force.ts","test:gateway":"vitest run --config vitest.gateway.config.ts --pool=forks","test:install:e2e":"bash scripts/test-install-sh-e2e-docker.sh","test:install:e2e:anthropic":"OPENCLAW_E2E_MODELS=anthropic CLAWDBOT_E2E_MODELS=anthropic bash scripts/test-install-sh-e2e-docker.sh","test:install:e2e:openai":"OPENCLAW_E2E_MODELS=openai CLAWDBOT_E2E_MODELS=openai bash scripts/test-install-sh-e2e-docker.sh","test:install:smoke":"bash scripts/test-install-sh-docker.sh","test:live":"OPENCLAW_LIVE_TEST=1 CLAWDBOT_LIVE_TEST=1 vitest run --config vitest.live.config.ts","test:macmini":"OPENCLAW_TEST_VM_FORKS=0 OPENCLAW_TEST_PROFILE=serial node scripts/test-parallel.mjs","test:parallels:linux":"bash scripts/e2e/parallels-linux-smoke.sh","test:parallels:macos":"bash scripts/e2e/parallels-macos-smoke.sh","test:parallels:windows":"bash scripts/e2e/parallels-windows-smoke.sh","test:perf:budget":"node scripts/test-perf-budget.mjs","test:perf:hotspots":"node scripts/test-hotspots.mjs","test:sectriage":"pnpm exec vitest run --config vitest.gateway.config.ts && vitest run --config vitest.unit.config.ts --exclude src/daemon/launchd.integration.test.ts --exclude src/process/exec.test.ts","test:ui":"pnpm lint:ui:no-raw-window-open && pnpm --dir ui test","test:voicecall:closedloop":"vitest run extensions/voice-call/src/manager.test.ts extensions/voice-call/src/media-stream.test.ts src/plugins/voice-call.plugin.test.ts --maxWorkers=1","test:watch":"vitest","tui":"node scripts/run-node.mjs tui","tui:dev":"OPENCLAW_PROFILE=dev CLAWDBOT_PROFILE=dev node scripts/run-node.mjs --dev tui","ui:build":"node scripts/ui.js build","ui:dev":"node scripts/ui.js dev","ui:install":"node scripts/ui.js install"},"dependencies":{"@agentclientprotocol/sdk":"0.16.1","@aws-sdk/client-bedrock":"^3.1009.0","@buape/carbon":"0.0.0-beta-20260216184201","@clack/prompts":"^1.1.0","@discordjs/voice":"^0.19.1","@grammyjs/runner":"^2.0.3","@grammyjs/transformer-throttler":"^1.2.1","@homebridge/ciao":"^1.3.5","@larksuiteoapi/node-sdk":"^1.59.0","@line/bot-sdk":"^10.6.0","@lydell/node-pty":"1.2.0-beta.3","@mariozechner/pi-agent-core":"0.58.0","@mariozechner/pi-ai":"0.58.0","@mariozechner/pi-coding-agent":"0.58.0","@mariozechner/pi-tui":"0.58.0","@modelcontextprotocol/sdk":"1.27.1","@mozilla/readability":"^0.6.0","@sinclair/typebox":"0.34.48","@slack/bolt":"^4.6.0","@slack/web-api":"^7.15.0","@whiskeysockets/baileys":"7.0.0-rc.9","ajv":"^8.18.0","chalk":"^5.6.2","chokidar":"^5.0.0","cli-highlight":"^2.1.11","commander":"^14.0.3","croner":"^10.0.1","discord-api-types":"^0.38.42","dotenv":"^17.3.1","express":"^5.2.1","file-type":"^21.3.2","grammy":"^1.41.1","hono":"4.12.7","https-proxy-agent":"^8.0.0","ipaddr.js":"^2.3.0","jiti":"^2.6.1","json5":"^2.2.3","jszip":"^3.10.1","linkedom":"^0.18.12","long":"^5.3.2","markdown-it":"^14.1.1","node-edge-tts":"^1.2.10","opusscript":"^0.1.1","osc-progress":"^0.3.0","pdfjs-dist":"^5.5.207","playwright-core":"1.58.2","qrcode-terminal":"^0.12.0","sharp":"^0.34.5","sqlite-vec":"0.1.7-alpha.2","tar":"7.5.11","tslog":"^4.10.2","undici":"^7.24.1","ws":"^8.19.0","yaml":"^2.8.2","zod":"^4.3.6"},"devDependencies":{"@grammyjs/types":"^3.25.0","@lit-labs/signals":"^0.2.0","@lit/context":"^1.1.6","@types/express":"^5.0.6","@types/markdown-it":"^14.1.2","@types/node":"^25.5.0","@types/qrcode-terminal":"^0.12.2","@types/ws":"^8.18.1","@typescript/native-preview":"7.0.0-dev.20260313.1","@vitest/coverage-v8":"^4.1.0","jscpd":"4.0.8","jsdom":"^28.1.0","lit":"^3.3.2","oxfmt":"0.40.0","oxlint":"^1.55.0","oxlint-tsgolint":"^0.16.0","signal-utils":"0.21.1","tsdown":"0.21.2","tsx":"^4.21.0","typescript":"^5.9.3","vitest":"^4.1.0"},"peerDependencies":{"@napi-rs/canvas":"^0.1.89","node-llama-cpp":"3.16.2"},"peerDependenciesMeta":{"node-llama-cpp":{"optional":true}},"engines":{"node":">=22.16.0"},"packageManager":"pnpm@10.23.0","pnpm":{"minimumReleaseAge":2880,"overrides":{"hono":"4.12.7","@hono/node-server":"1.19.10","fast-xml-parser":"5.3.8","request":"npm:@cypress/request@3.0.10","request-promise":"npm:@cypress/request-promise@5.0.0","file-type":"21.3.2","form-data":"2.5.4","minimatch":"10.2.4","qs":"6.14.2","node-domexception":"npm:@nolyfill/domexception@^1.0.28","@sinclair/typebox":"0.34.48","tar":"7.5.11","tough-cookie":"4.1.3"},"onlyBuiltDependencies":["@lydell/node-pty","@matrix-org/matrix-sdk-crypto-nodejs","@napi-rs/canvas","@tloncorp/api","@whiskeysockets/baileys","authenticate-pam","esbuild","koffi","node-llama-cpp","protobufjs","sharp"],"packageExtensions":{"@mariozechner/pi-coding-agent":{"dependencies":{"strip-ansi":"^7.2.0"}}}},"publishConfig":{"access":"public"},"gitHead":"82bd1184b4ebce6b582b81d10092cba4b6dcb6fb","_id":"@agenthippo-ai/hippoclaw@2026.7.28","_nodeVersion":"23.9.0","_npmVersion":"11.10.1","dist":{"integrity":"sha512-56nsNMghj7LMxSzhYY0BCKJtSkYDzwWjfj6Yv8ofGpSJAd91TSgB+ELhdhsEPr+JEF47CtUbyQZv4I/YRtsRNA==","shasum":"a57f5a144fd54c09acf0e59abd36dfcb7af3bee1","tarball":"https://registry.npmjs.org/@agenthippo-ai/hippoclaw/-/hippoclaw-2026.7.28.tgz","fileCount":4752,"unpackedSize":97220802,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCkzrxITqgqbejXQ9/APicSVon+uM1L8lb92VQv5MLDSQIgK8STVVjEq4ySGkBb93bLdTiRwDStb/NzPfSuE7vChhw="}]},"_npmUser":{"name":"dev-agenthippo","email":"dev@agenthippo.ai"},"maintainers":[{"name":"dev-agenthippo","email":"dev@agenthippo.ai"},{"name":"trung-agenthippo","email":"trung@agenthippo.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hippoclaw_2026.7.28_1785269701811_0.6899659701844019"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-28T20:15:01.573Z","2026.7.28":"2026-07-28T20:15:02.454Z","modified":"2026-07-28T20:15:02.721Z"},"maintainers":[{"name":"dev-agenthippo","email":"dev@agenthippo.ai"},{"name":"trung-agenthippo","email":"trung@agenthippo.ai"}],"description":"Multi-channel AI gateway with extensible messaging integrations","homepage":"https://github.com/agenthippoai/hippoclaw#readme","keywords":[],"repository":{"type":"git","url":"git+https://github.com/agenthippoai/hippoclaw.git"},"author":{"name":"AgentHippo","email":"dev@agenthippo.ai"},"bugs":{"url":"https://github.com/agenthippoai/hippoclaw/issues"},"license":"MIT","readme":"# 🦞 OpenClaw — Personal AI Assistant\n\n

\n \n \n \"OpenClaw\"\n \n

\n\n

\n EXFOLIATE! EXFOLIATE!\n

\n\n

\n \"CI\n \"GitHub\n \"Discord\"\n \"MIT\n

\n\n**OpenClaw** is a _personal AI assistant_ you run on your own devices.\nIt answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, BlueBubbles, IRC, Microsoft Teams, Matrix, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, Zalo Personal, WebChat). It can speak and listen on macOS/iOS/Android, and can render a live Canvas you control. The Gateway is just the control plane — the product is the assistant.\n\nIf you want a personal, single-user assistant that feels local, fast, and always-on, this is it.\n\n[Website](https://openclaw.ai) · [Docs](https://docs.openclaw.ai) · [Vision](VISION.md) · [DeepWiki](https://deepwiki.com/openclaw/openclaw) · [Getting Started](https://docs.openclaw.ai/start/getting-started) · [Updating](https://docs.openclaw.ai/install/updating) · [Showcase](https://docs.openclaw.ai/start/showcase) · [FAQ](https://docs.openclaw.ai/help/faq) · [Wizard](https://docs.openclaw.ai/start/wizard) · [Nix](https://github.com/openclaw/nix-openclaw) · [Docker](https://docs.openclaw.ai/install/docker) · [Discord](https://discord.gg/clawd)\n\nPreferred setup: run the onboarding wizard (`openclaw onboard`) in your terminal.\nThe wizard guides you step by step through setting up the gateway, workspace, channels, and skills. The CLI wizard is the recommended path and works on **macOS, Linux, and Windows (via WSL2; strongly recommended)**.\nWorks with npm, pnpm, or bun.\nNew install? Start here: [Getting started](https://docs.openclaw.ai/start/getting-started)\n\n## Sponsors\n\n| OpenAI | Vercel | Blacksmith | Convex |\n| ----------------------------------------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------- |\n| [![OpenAI](docs/assets/sponsors/openai.svg)](https://openai.com/) | [![Vercel](docs/assets/sponsors/vercel.svg)](https://vercel.com/) | [![Blacksmith](docs/assets/sponsors/blacksmith.svg)](https://blacksmith.sh/) | [![Convex](docs/assets/sponsors/convex.svg)](https://www.convex.dev/) |\n\n**Subscriptions (OAuth):**\n\n- **[OpenAI](https://openai.com/)** (ChatGPT/Codex)\n\nModel note: while many providers/models are supported, for the best experience and lower prompt-injection risk use the strongest latest-generation model available to you. See [Onboarding](https://docs.openclaw.ai/start/onboarding).\n\n## Models (selection + auth)\n\n- Models config + CLI: [Models](https://docs.openclaw.ai/concepts/models)\n- Auth profile rotation (OAuth vs API keys) + fallbacks: [Model failover](https://docs.openclaw.ai/concepts/model-failover)\n\n## Install (recommended)\n\nRuntime: **Node ≥22**.\n\n```bash\nnpm install -g openclaw@latest\n# or: pnpm add -g openclaw@latest\n\nopenclaw onboard --install-daemon\n```\n\nThe wizard installs the Gateway daemon (launchd/systemd user service) so it stays running.\n\n## Quick start (TL;DR)\n\nRuntime: **Node ≥22**.\n\nFull beginner guide (auth, pairing, channels): [Getting started](https://docs.openclaw.ai/start/getting-started)\n\n```bash\nopenclaw onboard --install-daemon\n\nopenclaw gateway --port 18789 --verbose\n\n# Send a message\nopenclaw message send --to +1234567890 --message \"Hello from OpenClaw\"\n\n# Talk to the assistant (optionally deliver back to any connected channel: WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/IRC/Microsoft Teams/Matrix/Feishu/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/WebChat)\nopenclaw agent --message \"Ship checklist\" --thinking high\n```\n\nUpgrading? [Updating guide](https://docs.openclaw.ai/install/updating) (and run `openclaw doctor`).\n\n## External agent backends (Agenthippo IDE & CLI)\n\n**HippoClaw** is OpenClaw’s gateway plus **external agent** support: **Agenthippo** can attach from a **VS Code–compatible editor** _or_ from the **Agenthippo CLI**. Both speak the same **gateway WebSocket** protocol, **register** one or more agents, and **handle turns** on the machine where they run instead of using the built-in Pi agent on the gateway.\n\n**How it works**\n\n1. You run the **gateway** as usual (daemon or `openclaw gateway`). It still owns channels, pairing, sessions, and delivery to WhatsApp, Telegram, Slack, Discord, and the rest of the OpenClaw surface.\n2. The **Agenthippo IDE extension** or **Agenthippo CLI** opens a **gateway WebSocket** client and registers agents (IDs use the `ide-` prefix, for example `ide-agenthippo-vscode`). The gateway keeps a small **registry** of which connection owns which agent id.\n3. When a session is routed to such an id, **`agent.run` / chat** are **forwarded** to that client. The **model, credentials, and tool execution** for that turn live on the **IDE or CLI host**; the gateway streams progress back (`agent.stream`-style events) and still ties replies to the right channel/session.\n4. When the client disconnects, those registrations are **removed** so routing does not point at a dead backend.\n\n**Why use it**\n\n- **Keys and models stay on the IDE or CLI machine** for that path—useful when the gateway host should not hold provider credentials for those runs.\n- **IDE:** workspace context (open files, project root) stays in the editor while messages flow through your normal OpenClaw channels.\n- **CLI:** run a headless or scripted external agent (servers, SSH sessions, automation) with the same routing and streaming behavior as the editor.\n- **Several external agents** can register at once (different ids or workspaces) and appear alongside config-defined agents in listings.\n\n**Example (CLI via gateway)**\n\nWith the gateway running and **Agenthippo** (IDE or CLI) connected so `data-analyst` is registered as an external agent, trigger a turn from your dev tree or any machine that can reach the gateway:\n\n```bash\npnpm openclaw agent --agent data-analyst --session-id h3 --message \"double that\"\n```\n\nIf you use a global install, use `openclaw` instead of `pnpm openclaw`. Replace `data-analyst`, `h3`, and the message with your agent id, session id, and prompt. See [CLI: agent](https://docs.openclaw.ai/cli/agent) for flags (`--deliver`, `--thinking`, etc.).\n\n**Repo and upstream**\n\n- This project: [github.com/agenthippoai/hippoclaw](https://github.com/agenthippoai/hippoclaw)\n- Upstream OpenClaw: [github.com/openclaw/openclaw](https://github.com/openclaw/openclaw)\n\nInstall, pairing, and CLI usage are documented with **Agenthippo** (extension and CLI); the gateway behavior above is what HippoClaw exposes on the wire.\n\n## Development channels\n\n- **stable**: tagged releases (`vYYYY.M.D` or `vYYYY.M.D-`), npm dist-tag `latest`.\n- **beta**: prerelease tags (`vYYYY.M.D-beta.N`), npm dist-tag `beta` (macOS app may be missing).\n- **dev**: moving head of `main`, npm dist-tag `dev` (when published).\n\nSwitch channels (git + npm): `openclaw update --channel stable|beta|dev`.\nDetails: [Development channels](https://docs.openclaw.ai/install/development-channels).\n\n## From source (development)\n\nPrefer `pnpm` for builds from source. Bun is optional for running TypeScript directly.\n\n**HippoClaw** (this repo):\n\n```bash\ngit clone https://github.com/agenthippoai/hippoclaw.git\ncd hippoclaw\n\npnpm install\npnpm ui:build # auto-installs UI deps on first run\npnpm build\n\npnpm openclaw onboard --install-daemon\n\n# Dev loop (auto-reload on TS changes)\npnpm gateway:watch\n```\n\nUpstream **OpenClaw** lives at [github.com/openclaw/openclaw](https://github.com/openclaw/openclaw); use that clone if you want vanilla upstream without Agenthippo external-agent routing.\n\nNote: `pnpm openclaw ...` runs TypeScript directly (via `tsx`). `pnpm build` produces `dist/` for running via Node / the packaged `openclaw` binary.\n\n## Security defaults (DM access)\n\nOpenClaw connects to real messaging surfaces. Treat inbound DMs as **untrusted input**.\n\nFull security guide: [Security](https://docs.openclaw.ai/gateway/security)\n\nDefault behavior on Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack:\n\n- **DM pairing** (`dmPolicy=\"pairing\"` / `channels.discord.dmPolicy=\"pairing\"` / `channels.slack.dmPolicy=\"pairing\"`; legacy: `channels.discord.dm.policy`, `channels.slack.dm.policy`): unknown senders receive a short pairing code and the bot does not process their message.\n- Approve with: `openclaw pairing approve ` (then the sender is added to a local allowlist store).\n- Public inbound DMs require an explicit opt-in: set `dmPolicy=\"open\"` and include `\"*\"` in the channel allowlist (`allowFrom` / `channels.discord.allowFrom` / `channels.slack.allowFrom`; legacy: `channels.discord.dm.allowFrom`, `channels.slack.dm.allowFrom`).\n\nRun `openclaw doctor` to surface risky/misconfigured DM policies.\n\n## Highlights\n\n- **[Local-first Gateway](https://docs.openclaw.ai/gateway)** — single control plane for sessions, channels, tools, and events.\n- **[Multi-channel inbox](https://docs.openclaw.ai/channels)** — WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, BlueBubbles (iMessage), iMessage (legacy), IRC, Microsoft Teams, Matrix, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, Zalo Personal, WebChat, macOS, iOS/Android.\n- **[Multi-agent routing](https://docs.openclaw.ai/gateway/configuration)** — route inbound channels/accounts/peers to isolated agents (workspaces + per-agent sessions).\n- **[Voice Wake](https://docs.openclaw.ai/nodes/voicewake) + [Talk Mode](https://docs.openclaw.ai/nodes/talk)** — wake words on macOS/iOS and continuous voice on Android (ElevenLabs + system TTS fallback).\n- **[Live Canvas](https://docs.openclaw.ai/platforms/mac/canvas)** — agent-driven visual workspace with [A2UI](https://docs.openclaw.ai/platforms/mac/canvas#canvas-a2ui).\n- **[First-class tools](https://docs.openclaw.ai/tools)** — browser, canvas, nodes, cron, sessions, and Discord/Slack actions.\n- **[Companion apps](https://docs.openclaw.ai/platforms/macos)** — macOS menu bar app + iOS/Android [nodes](https://docs.openclaw.ai/nodes).\n- **[Onboarding](https://docs.openclaw.ai/start/wizard) + [skills](https://docs.openclaw.ai/tools/skills)** — wizard-driven setup with bundled/managed/workspace skills.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=openclaw/openclaw&type=date&legend=top-left)](https://www.star-history.com/#openclaw/openclaw&type=date&legend=top-left)\n\n## Everything we built so far\n\n### Core platform\n\n- [Gateway WS control plane](https://docs.openclaw.ai/gateway) with sessions, presence, config, cron, webhooks, [Control UI](https://docs.openclaw.ai/web), and [Canvas host](https://docs.openclaw.ai/platforms/mac/canvas#canvas-a2ui).\n- [CLI surface](https://docs.openclaw.ai/tools/agent-send): gateway, agent, send, [wizard](https://docs.openclaw.ai/start/wizard), and [doctor](https://docs.openclaw.ai/gateway/doctor).\n- [Pi agent runtime](https://docs.openclaw.ai/concepts/agent) in RPC mode with tool streaming and block streaming.\n- [Session model](https://docs.openclaw.ai/concepts/session): `main` for direct chats, group isolation, activation modes, queue modes, reply-back. Group rules: [Groups](https://docs.openclaw.ai/channels/groups).\n- [Media pipeline](https://docs.openclaw.ai/nodes/images): images/audio/video, transcription hooks, size caps, temp file lifecycle. Audio details: [Audio](https://docs.openclaw.ai/nodes/audio).\n\n### Channels\n\n- [Channels](https://docs.openclaw.ai/channels): [WhatsApp](https://docs.openclaw.ai/channels/whatsapp) (Baileys), [Telegram](https://docs.openclaw.ai/channels/telegram) (grammY), [Slack](https://docs.openclaw.ai/channels/slack) (Bolt), [Discord](https://docs.openclaw.ai/channels/discord) (discord.js), [Google Chat](https://docs.openclaw.ai/channels/googlechat) (Chat API), [Signal](https://docs.openclaw.ai/channels/signal) (signal-cli), [BlueBubbles](https://docs.openclaw.ai/channels/bluebubbles) (iMessage, recommended), [iMessage](https://docs.openclaw.ai/channels/imessage) (legacy imsg), [IRC](https://docs.openclaw.ai/channels/irc), [Microsoft Teams](https://docs.openclaw.ai/channels/msteams), [Matrix](https://docs.openclaw.ai/channels/matrix), [Feishu](https://docs.openclaw.ai/channels/feishu), [LINE](https://docs.openclaw.ai/channels/line), [Mattermost](https://docs.openclaw.ai/channels/mattermost), [Nextcloud Talk](https://docs.openclaw.ai/channels/nextcloud-talk), [Nostr](https://docs.openclaw.ai/channels/nostr), [Synology Chat](https://docs.openclaw.ai/channels/synology-chat), [Tlon](https://docs.openclaw.ai/channels/tlon), [Twitch](https://docs.openclaw.ai/channels/twitch), [Zalo](https://docs.openclaw.ai/channels/zalo), [Zalo Personal](https://docs.openclaw.ai/channels/zalouser), [WebChat](https://docs.openclaw.ai/web/webchat).\n- [Group routing](https://docs.openclaw.ai/channels/group-messages): mention gating, reply tags, per-channel chunking and routing. Channel rules: [Channels](https://docs.openclaw.ai/channels).\n\n### Apps + nodes\n\n- [macOS app](https://docs.openclaw.ai/platforms/macos): menu bar control plane, [Voice Wake](https://docs.openclaw.ai/nodes/voicewake)/PTT, [Talk Mode](https://docs.openclaw.ai/nodes/talk) overlay, [WebChat](https://docs.openclaw.ai/web/webchat), debug tools, [remote gateway](https://docs.openclaw.ai/gateway/remote) control.\n- [iOS node](https://docs.openclaw.ai/platforms/ios): [Canvas](https://docs.openclaw.ai/platforms/mac/canvas), [Voice Wake](https://docs.openclaw.ai/nodes/voicewake), [Talk Mode](https://docs.openclaw.ai/nodes/talk), camera, screen recording, Bonjour + device pairing.\n- [Android node](https://docs.openclaw.ai/platforms/android): Connect tab (setup code/manual), chat sessions, voice tab, [Canvas](https://docs.openclaw.ai/platforms/mac/canvas), camera/screen recording, and Android device commands (notifications/location/SMS/photos/contacts/calendar/motion/app update).\n- [macOS node mode](https://docs.openclaw.ai/nodes): system.run/notify + canvas/camera exposure.\n\n### Tools + automation\n\n- [Browser control](https://docs.openclaw.ai/tools/browser): dedicated openclaw Chrome/Chromium, snapshots, actions, uploads, profiles.\n- [Canvas](https://docs.openclaw.ai/platforms/mac/canvas): [A2UI](https://docs.openclaw.ai/platforms/mac/canvas#canvas-a2ui) push/reset, eval, snapshot.\n- [Nodes](https://docs.openclaw.ai/nodes): camera snap/clip, screen record, [location.get](https://docs.openclaw.ai/nodes/location-command), notifications.\n- [Cron + wakeups](https://docs.openclaw.ai/automation/cron-jobs); [webhooks](https://docs.openclaw.ai/automation/webhook); [Gmail Pub/Sub](https://docs.openclaw.ai/automation/gmail-pubsub).\n- [Skills platform](https://docs.openclaw.ai/tools/skills): bundled, managed, and workspace skills with install gating + UI.\n\n### Runtime + safety\n\n- [Channel routing](https://docs.openclaw.ai/channels/channel-routing), [retry policy](https://docs.openclaw.ai/concepts/retry), and [streaming/chunking](https://docs.openclaw.ai/concepts/streaming).\n- [Presence](https://docs.openclaw.ai/concepts/presence), [typing indicators](https://docs.openclaw.ai/concepts/typing-indicators), and [usage tracking](https://docs.openclaw.ai/concepts/usage-tracking).\n- [Models](https://docs.openclaw.ai/concepts/models), [model failover](https://docs.openclaw.ai/concepts/model-failover), and [session pruning](https://docs.openclaw.ai/concepts/session-pruning).\n- [Security](https://docs.openclaw.ai/gateway/security) and [troubleshooting](https://docs.openclaw.ai/channels/troubleshooting).\n\n### Ops + packaging\n\n- [Control UI](https://docs.openclaw.ai/web) + [WebChat](https://docs.openclaw.ai/web/webchat) served directly from the Gateway.\n- [Tailscale Serve/Funnel](https://docs.openclaw.ai/gateway/tailscale) or [SSH tunnels](https://docs.openclaw.ai/gateway/remote) with token/password auth.\n- [Nix mode](https://docs.openclaw.ai/install/nix) for declarative config; [Docker](https://docs.openclaw.ai/install/docker)-based installs.\n- [Doctor](https://docs.openclaw.ai/gateway/doctor) migrations, [logging](https://docs.openclaw.ai/logging).\n\n## How it works (short)\n\n```\nWhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / BlueBubbles / IRC / Microsoft Teams / Matrix / Feishu / LINE / Mattermost / Nextcloud Talk / Nostr / Synology Chat / Tlon / Twitch / Zalo / Zalo Personal / WebChat\n │\n ▼\n┌───────────────────────────────┐\n│ Gateway │\n│ (control plane) │\n│ ws://127.0.0.1:18789 │\n└──────────────┬────────────────┘\n │\n ├─ Pi agent (RPC)\n ├─ CLI (openclaw …)\n ├─ WebChat UI\n ├─ macOS app\n └─ iOS / Android nodes\n```\n\n## Key subsystems\n\n- **[Gateway WebSocket network](https://docs.openclaw.ai/concepts/architecture)** — single WS control plane for clients, tools, and events (plus ops: [Gateway runbook](https://docs.openclaw.ai/gateway)).\n- **[Tailscale exposure](https://docs.openclaw.ai/gateway/tailscale)** — Serve/Funnel for the Gateway dashboard + WS (remote access: [Remote](https://docs.openclaw.ai/gateway/remote)).\n- **[Browser control](https://docs.openclaw.ai/tools/browser)** — openclaw‑managed Chrome/Chromium with CDP control.\n- **[Canvas + A2UI](https://docs.openclaw.ai/platforms/mac/canvas)** — agent‑driven visual workspace (A2UI host: [Canvas/A2UI](https://docs.openclaw.ai/platforms/mac/canvas#canvas-a2ui)).\n- **[Voice Wake](https://docs.openclaw.ai/nodes/voicewake) + [Talk Mode](https://docs.openclaw.ai/nodes/talk)** — wake words on macOS/iOS plus continuous voice on Android.\n- **[Nodes](https://docs.openclaw.ai/nodes)** — Canvas, camera snap/clip, screen record, `location.get`, notifications, plus macOS‑only `system.run`/`system.notify`.\n\n## Tailscale access (Gateway dashboard)\n\nOpenClaw can auto-configure Tailscale **Serve** (tailnet-only) or **Funnel** (public) while the Gateway stays bound to loopback. Configure `gateway.tailscale.mode`:\n\n- `off`: no Tailscale automation (default).\n- `serve`: tailnet-only HTTPS via `tailscale serve` (uses Tailscale identity headers by default).\n- `funnel`: public HTTPS via `tailscale funnel` (requires shared password auth).\n\nNotes:\n\n- `gateway.bind` must stay `loopback` when Serve/Funnel is enabled (OpenClaw enforces this).\n- Serve can be forced to require a password by setting `gateway.auth.mode: \"password\"` or `gateway.auth.allowTailscale: false`.\n- Funnel refuses to start unless `gateway.auth.mode: \"password\"` is set.\n- Optional: `gateway.tailscale.resetOnExit` to undo Serve/Funnel on shutdown.\n\nDetails: [Tailscale guide](https://docs.openclaw.ai/gateway/tailscale) · [Web surfaces](https://docs.openclaw.ai/web)\n\n## Remote Gateway (Linux is great)\n\nIt’s perfectly fine to run the Gateway on a small Linux instance. Clients (macOS app, CLI, WebChat) can connect over **Tailscale Serve/Funnel** or **SSH tunnels**, and you can still pair device nodes (macOS/iOS/Android) to execute device‑local actions when needed.\n\n- **Gateway host** runs the exec tool and channel connections by default.\n- **Device nodes** run device‑local actions (`system.run`, camera, screen recording, notifications) via `node.invoke`.\n In short: exec runs where the Gateway lives; device actions run where the device lives.\n\nDetails: [Remote access](https://docs.openclaw.ai/gateway/remote) · [Nodes](https://docs.openclaw.ai/nodes) · [Security](https://docs.openclaw.ai/gateway/security)\n\n## macOS permissions via the Gateway protocol\n\nThe macOS app can run in **node mode** and advertises its capabilities + permission map over the Gateway WebSocket (`node.list` / `node.describe`). Clients can then execute local actions via `node.invoke`:\n\n- `system.run` runs a local command and returns stdout/stderr/exit code; set `needsScreenRecording: true` to require screen-recording permission (otherwise you’ll get `PERMISSION_MISSING`).\n- `system.notify` posts a user notification and fails if notifications are denied.\n- `canvas.*`, `camera.*`, `screen.record`, and `location.get` are also routed via `node.invoke` and follow TCC permission status.\n\nElevated bash (host permissions) is separate from macOS TCC:\n\n- Use `/elevated on|off` to toggle per‑session elevated access when enabled + allowlisted.\n- Gateway persists the per‑session toggle via `sessions.patch` (WS method) alongside `thinkingLevel`, `verboseLevel`, `model`, `sendPolicy`, and `groupActivation`.\n\nDetails: [Nodes](https://docs.openclaw.ai/nodes) · [macOS app](https://docs.openclaw.ai/platforms/macos) · [Gateway protocol](https://docs.openclaw.ai/concepts/architecture)\n\n## Agent to Agent (sessions\\_\\* tools)\n\n- Use these to coordinate work across sessions without jumping between chat surfaces.\n- `sessions_list` — discover active sessions (agents) and their metadata.\n- `sessions_history` — fetch transcript logs for a session.\n- `sessions_send` — message another session; optional reply‑back ping‑pong + announce step (`REPLY_SKIP`, `ANNOUNCE_SKIP`).\n\nDetails: [Session tools](https://docs.openclaw.ai/concepts/session-tool)\n\n## Skills registry (ClawHub)\n\nClawHub is a minimal skill registry. With ClawHub enabled, the agent can search for skills automatically and pull in new ones as needed.\n\n[ClawHub](https://clawhub.com)\n\n## Chat commands\n\nSend these in WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat (group commands are owner-only):\n\n- `/status` — compact session status (model + tokens, cost when available)\n- `/new` or `/reset` — reset the session\n- `/compact` — compact session context (summary)\n- `/think ` — off|minimal|low|medium|high|xhigh (GPT-5.2 + Codex models only)\n- `/verbose on|off`\n- `/usage off|tokens|full` — per-response usage footer\n- `/restart` — restart the gateway (owner-only in groups)\n- `/activation mention|always` — group activation toggle (groups only)\n\n## Apps (optional)\n\nThe Gateway alone delivers a great experience. All apps are optional and add extra features.\n\nIf you plan to build/run companion apps, follow the platform runbooks below.\n\n### macOS (OpenClaw.app) (optional)\n\n- Menu bar control for the Gateway and health.\n- Voice Wake + push-to-talk overlay.\n- WebChat + debug tools.\n- Remote gateway control over SSH.\n\nNote: signed builds required for macOS permissions to stick across rebuilds (see `docs/mac/permissions.md`).\n\n### iOS node (optional)\n\n- Pairs as a node over the Gateway WebSocket (device pairing).\n- Voice trigger forwarding + Canvas surface.\n- Controlled via `openclaw nodes …`.\n\nRunbook: [iOS connect](https://docs.openclaw.ai/platforms/ios).\n\n### Android node (optional)\n\n- Pairs as a WS node via device pairing (`openclaw devices ...`).\n- Exposes Connect/Chat/Voice tabs plus Canvas, Camera, Screen capture, and Android device command families.\n- Runbook: [Android connect](https://docs.openclaw.ai/platforms/android).\n\n## Agent workspace + skills\n\n- Workspace root: `~/.openclaw/workspace` (configurable via `agents.defaults.workspace`).\n- Injected prompt files: `AGENTS.md`, `SOUL.md`, `TOOLS.md`.\n- Skills: `~/.openclaw/workspace/skills//SKILL.md`.\n\n## Configuration\n\nMinimal `~/.openclaw/openclaw.json` (model + defaults):\n\n```json5\n{\n agent: {\n model: \"anthropic/claude-opus-4-6\",\n },\n}\n```\n\n[Full configuration reference (all keys + examples).](https://docs.openclaw.ai/gateway/configuration)\n\n## Security model (important)\n\n- **Default:** tools run on the host for the **main** session, so the agent has full access when it’s just you.\n- **Group/channel safety:** set `agents.defaults.sandbox.mode: \"non-main\"` to run **non‑main sessions** (groups/channels) inside per‑session Docker sandboxes; bash then runs in Docker for those sessions.\n- **Sandbox defaults:** allowlist `bash`, `process`, `read`, `write`, `edit`, `sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`; denylist `browser`, `canvas`, `nodes`, `cron`, `discord`, `gateway`.\n\nDetails: [Security guide](https://docs.openclaw.ai/gateway/security) · [Docker + sandboxing](https://docs.openclaw.ai/install/docker) · [Sandbox config](https://docs.openclaw.ai/gateway/configuration)\n\n### [WhatsApp](https://docs.openclaw.ai/channels/whatsapp)\n\n- Link the device: `pnpm openclaw channels login` (stores creds in `~/.openclaw/credentials`).\n- Allowlist who can talk to the assistant via `channels.whatsapp.allowFrom`.\n- If `channels.whatsapp.groups` is set, it becomes a group allowlist; include `\"*\"` to allow all.\n\n### [Telegram](https://docs.openclaw.ai/channels/telegram)\n\n- Set `TELEGRAM_BOT_TOKEN` or `channels.telegram.botToken` (env wins).\n- Optional: set `channels.telegram.groups` (with `channels.telegram.groups.\"*\".requireMention`); when set, it is a group allowlist (include `\"*\"` to allow all). Also `channels.telegram.allowFrom` or `channels.telegram.webhookUrl` + `channels.telegram.webhookSecret` as needed.\n\n```json5\n{\n channels: {\n telegram: {\n botToken: \"123456:ABCDEF\",\n },\n },\n}\n```\n\n### [Slack](https://docs.openclaw.ai/channels/slack)\n\n- Set `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN` (or `channels.slack.botToken` + `channels.slack.appToken`).\n\n### [Discord](https://docs.openclaw.ai/channels/discord)\n\n- Set `DISCORD_BOT_TOKEN` or `channels.discord.token` (env wins).\n- Optional: set `commands.native`, `commands.text`, or `commands.useAccessGroups`, plus `channels.discord.allowFrom`, `channels.discord.guilds`, or `channels.discord.mediaMaxMb` as needed.\n\n```json5\n{\n channels: {\n discord: {\n token: \"1234abcd\",\n },\n },\n}\n```\n\n### [Signal](https://docs.openclaw.ai/channels/signal)\n\n- Requires `signal-cli` and a `channels.signal` config section.\n\n### [BlueBubbles (iMessage)](https://docs.openclaw.ai/channels/bluebubbles)\n\n- **Recommended** iMessage integration.\n- Configure `channels.bluebubbles.serverUrl` + `channels.bluebubbles.password` and a webhook (`channels.bluebubbles.webhookPath`).\n- The BlueBubbles server runs on macOS; the Gateway can run on macOS or elsewhere.\n\n### [iMessage (legacy)](https://docs.openclaw.ai/channels/imessage)\n\n- Legacy macOS-only integration via `imsg` (Messages must be signed in).\n- If `channels.imessage.groups` is set, it becomes a group allowlist; include `\"*\"` to allow all.\n\n### [Microsoft Teams](https://docs.openclaw.ai/channels/msteams)\n\n- Configure a Teams app + Bot Framework, then add a `msteams` config section.\n- Allowlist who can talk via `msteams.allowFrom`; group access via `msteams.groupAllowFrom` or `msteams.groupPolicy: \"open\"`.\n\n### [WebChat](https://docs.openclaw.ai/web/webchat)\n\n- Uses the Gateway WebSocket; no separate WebChat port/config.\n\nBrowser control (optional):\n\n```json5\n{\n browser: {\n enabled: true,\n color: \"#FF4500\",\n },\n}\n```\n\n## Docs\n\nUse these when you’re past the onboarding flow and want the deeper reference.\n\n- [Start with the docs index for navigation and “what’s where.”](https://docs.openclaw.ai)\n- [Read the architecture overview for the gateway + protocol model.](https://docs.openclaw.ai/concepts/architecture)\n- [Use the full configuration reference when you need every key and example.](https://docs.openclaw.ai/gateway/configuration)\n- [Run the Gateway by the book with the operational runbook.](https://docs.openclaw.ai/gateway)\n- [Learn how the Control UI/Web surfaces work and how to expose them safely.](https://docs.openclaw.ai/web)\n- [Understand remote access over SSH tunnels or tailnets.](https://docs.openclaw.ai/gateway/remote)\n- [Follow the onboarding wizard flow for a guided setup.](https://docs.openclaw.ai/start/wizard)\n- [Wire external triggers via the webhook surface.](https://docs.openclaw.ai/automation/webhook)\n- [Set up Gmail Pub/Sub triggers.](https://docs.openclaw.ai/automation/gmail-pubsub)\n- [Learn the macOS menu bar companion details.](https://docs.openclaw.ai/platforms/mac/menu-bar)\n- [Platform guides: Windows (WSL2)](https://docs.openclaw.ai/platforms/windows), [Linux](https://docs.openclaw.ai/platforms/linux), [macOS](https://docs.openclaw.ai/platforms/macos), [iOS](https://docs.openclaw.ai/platforms/ios), [Android](https://docs.openclaw.ai/platforms/android)\n- [Debug common failures with the troubleshooting guide.](https://docs.openclaw.ai/channels/troubleshooting)\n- [Review security guidance before exposing anything.](https://docs.openclaw.ai/gateway/security)\n\n## Advanced docs (discovery + control)\n\n- [Discovery + transports](https://docs.openclaw.ai/gateway/discovery)\n- [Bonjour/mDNS](https://docs.openclaw.ai/gateway/bonjour)\n- [Gateway pairing](https://docs.openclaw.ai/gateway/pairing)\n- [Remote gateway README](https://docs.openclaw.ai/gateway/remote-gateway-readme)\n- [Control UI](https://docs.openclaw.ai/web/control-ui)\n- [Dashboard](https://docs.openclaw.ai/web/dashboard)\n\n## Operations & troubleshooting\n\n- [Health checks](https://docs.openclaw.ai/gateway/health)\n- [Gateway lock](https://docs.openclaw.ai/gateway/gateway-lock)\n- [Background process](https://docs.openclaw.ai/gateway/background-process)\n- [Browser troubleshooting (Linux)](https://docs.openclaw.ai/tools/browser-linux-troubleshooting)\n- [Logging](https://docs.openclaw.ai/logging)\n\n## Deep dives\n\n- [Agent loop](https://docs.openclaw.ai/concepts/agent-loop)\n- [Presence](https://docs.openclaw.ai/concepts/presence)\n- [TypeBox schemas](https://docs.openclaw.ai/concepts/typebox)\n- [RPC adapters](https://docs.openclaw.ai/reference/rpc)\n- [Queue](https://docs.openclaw.ai/concepts/queue)\n\n## Workspace & skills\n\n- [Skills config](https://docs.openclaw.ai/tools/skills-config)\n- [Default AGENTS](https://docs.openclaw.ai/reference/AGENTS.default)\n- [Templates: AGENTS](https://docs.openclaw.ai/reference/templates/AGENTS)\n- [Templates: BOOTSTRAP](https://docs.openclaw.ai/reference/templates/BOOTSTRAP)\n- [Templates: IDENTITY](https://docs.openclaw.ai/reference/templates/IDENTITY)\n- [Templates: SOUL](https://docs.openclaw.ai/reference/templates/SOUL)\n- [Templates: TOOLS](https://docs.openclaw.ai/reference/templates/TOOLS)\n- [Templates: USER](https://docs.openclaw.ai/reference/templates/USER)\n\n## Platform internals\n\n- [macOS dev setup](https://docs.openclaw.ai/platforms/mac/dev-setup)\n- [macOS menu bar](https://docs.openclaw.ai/platforms/mac/menu-bar)\n- [macOS voice wake](https://docs.openclaw.ai/platforms/mac/voicewake)\n- [iOS node](https://docs.openclaw.ai/platforms/ios)\n- [Android node](https://docs.openclaw.ai/platforms/android)\n- [Windows (WSL2)](https://docs.openclaw.ai/platforms/windows)\n- [Linux app](https://docs.openclaw.ai/platforms/linux)\n\n## Email hooks (Gmail)\n\n- [docs.openclaw.ai/gmail-pubsub](https://docs.openclaw.ai/automation/gmail-pubsub)\n\n## Molty\n\nOpenClaw was built for **Molty**, a space lobster AI assistant. 🦞\nby Peter Steinberger and the community.\n\n- [openclaw.ai](https://openclaw.ai)\n- [soul.md](https://soul.md)\n- [steipete.me](https://steipete.me)\n- [@openclaw](https://x.com/openclaw)\n\n## Community\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines, maintainers, and how to submit PRs.\nAI/vibe-coded PRs welcome! 🤖\n\nSpecial thanks to [Mario Zechner](https://mariozechner.at/) for his support and for\n[pi-mono](https://github.com/badlogic/pi-mono).\nSpecial thanks to Adam Doppelt for lobster.bot.\n\nThanks to all clawtributors:\n\n

\n \"steipete\" \"vincentkoc\" \"vignesh07\" \"obviyus\" \"Mariano \"sebslight\" \"gumadeiras\" \"Takhoffman\" \"thewilloftheshadow\" \"cpojer\"\n \"tyler6204\" \"joshp123\" \"Glucksberg\" \"mcaxtr\" \"quotentiroler\" \"osolmaz\" \"Sid-Qin\" \"joshavant\" \"shakkernerd\" \"bmendonca3\"\n \"mukhtharcm\" \"zerone0x\" \"mcinteerj\" \"ngutman\" \"lailoo\" \"arosstale\" \"rodrigouroz\" \"robbyczgw-cla\" \"Elonito\" \"Clawborn\"\n \"yinghaosang\" \"BunsDev\" \"christianklotz\" \"echoVic\" \"coygeek\" \"roshanasingh4\" \"mneves75\" \"joaohlisboa\" \"bohdanpodvirnyi\" \"nachx639\"\n \"onutc\" \"Verite \"widingmarcus-cyber\" \"akramcodez\" \"aether-ai-agent\" \"bjesuiter\" \"MaudeBot\" \"YuriNachos\" \"chilu18\" \"byungsker\"\n \"dbhurley\" \"JayMishra-source\" \"iHildy\" \"mudrii\" \"dlauer\" \"Solvely-Colin\" \"czekaj\" \"advaitpaliwal\" \"lc0rp\" \"grp06\"\n \"HenryLoenwind\" \"azade-c\" \"Lukavyi\" \"vrknetha\" \"brandonwise\" \"conroywhitney\" \"Tobias \"davidrudduck\" \"xinhuagu\" \"jaydenfyi\"\n \"petter-b\" \"heyhudson\" \"MatthieuBizien\" \"huntharo\" \"omair445\" \"adam91holt\" \"adhitShet\" \"smartprogrammer93\" \"radek-paclt\" \"frankekn\"\n \"bradleypriest\" \"rahthakor\" \"shadril238\" \"VACInc\" \"juanpablodlc\" \"jonisjongithub\" \"magimetal\" \"stakeswky\" \"abhisekbasu1\" \"MisterGuy420\"\n \"hsrvc\" \"nabbilkhan\" \"aldoeliacim\" \"jamesgroat\" \"orlyjamie\" \"Elarwei001\" \"rubyrunsstuff\" \"Phineas1500\" \"meaningfool\" \"sfo2001\"\n \"Marvae\" \"liuy\" \"shtse8\" \"thebenignhacker\" \"carrotRakko\" \"ranausmanai\" \"kevinWangSheng\" \"gregmousseau\" \"rrenamed\" \"akoscz\"\n \"jarvis-medmatic\" \"danielz1z\" \"pandego\" \"xadenryan\" \"NicholasSpisak\" \"graysurf\" \"gupsammy\" \"nyanjou\" \"sibbl\" \"gejifeng\"\n \"ide-rea\" \"leszekszpunar\" \"Yida-Dev\" \"AI-Reviewer-QS\" \"SocialNerd42069\" \"maxsumrall\" \"hougangdev\" \"Minidoracat\" \"AnonO6\" \"sreekaransrinath\"\n \"YuzuruS\" \"riccardogiorato\" \"Bridgerz\" \"Mrseenz\" \"buddyh\" \"Eng. \"peschee\" \"cash-echo-bot\" \"jalehman\" \"zknicker\"\n \"Harald \"taw0002\" \"scald\" \"openperf\" \"BUGKillerKing\" \"Oceanswave\" \"Hiren \"kiranjd\" \"antons\" \"dan-dr\"\n \"jadilson12\" \"sumleo\" \"Whoaa512\" \"luijoc\" \"niceysam\" \"JustYannicc\" \"emanuelst\" \"TsekaLuk\" \"JustasM\" \"loiie45e\"\n \"davidguttman\" \"natefikru\" \"dougvk\" \"koala73\" \"mkbehr\" \"zats\" \"Simone \"openclaw-bot\" \"ENCHIGO\" \"mteam88\"\n \"Blakeshannon\" \"gabriel-trigo\" \"neist\" \"pejmanjohn\" \"durenzidu\" \"Ryan \"hcl\" \"XuHao\" \"benithors\" \"bitfoundry-ai\"\n \"HeMuling\" \"markmusson\" \"ameno-\" \"battman21\" \"BinHPdev\" \"dguido\" \"evalexpr\" \"guirguispierre\" \"henrino3\" \"joeykrug\"\n