@takibeiy/moltbot_cn 2026.2.1 → 2026.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +315 -200
- package/README.md +82 -472
- package/assets/chrome-extension/README.md +5 -5
- package/assets/chrome-extension/background.js +5 -5
- package/assets/chrome-extension/manifest.json +3 -3
- package/assets/chrome-extension/options.html +5 -5
- package/assets/chrome-extension/options.js +1 -1
- package/dist/acp/client.d.ts +16 -0
- package/dist/acp/client.js +12 -9
- package/dist/acp/commands.d.ts +2 -0
- package/dist/acp/event-mapper.d.ts +10 -0
- package/dist/acp/event-mapper.js +22 -11
- package/dist/acp/index.d.ts +4 -0
- package/dist/acp/meta.d.ts +3 -0
- package/dist/acp/meta.js +12 -6
- package/dist/acp/server.d.ts +3 -0
- package/dist/acp/server.js +4 -4
- package/dist/acp/session-mapper.d.ts +22 -0
- package/dist/acp/session-mapper.js +8 -4
- package/dist/acp/session.d.ts +16 -0
- package/dist/acp/session.js +10 -5
- package/dist/acp/translator.d.ts +36 -0
- package/dist/acp/translator.js +35 -19
- package/dist/acp/types.d.ts +25 -0
- package/dist/acp/types.js +2 -2
- package/dist/agents/agent-paths.d.ts +2 -0
- package/dist/agents/agent-paths.js +11 -8
- package/dist/agents/agent-scope.d.ts +35 -0
- package/dist/agents/agent-scope.js +25 -13
- package/dist/agents/anthropic-payload-log.d.ts +16 -0
- package/dist/agents/anthropic-payload-log.js +20 -12
- package/dist/agents/apply-patch-update.d.ts +8 -0
- package/dist/agents/apply-patch-update.js +13 -7
- package/dist/agents/apply-patch.d.ts +24 -0
- package/dist/agents/apply-patch.js +25 -13
- package/dist/agents/auth-health.d.ts +37 -0
- package/dist/agents/auth-health.js +18 -10
- package/dist/agents/auth-profiles/constants.d.ts +20 -0
- package/dist/agents/auth-profiles/constants.js +1 -0
- package/dist/agents/auth-profiles/display.d.ts +7 -0
- package/dist/agents/auth-profiles/display.js +3 -3
- package/dist/agents/auth-profiles/doctor.d.ts +8 -0
- package/dist/agents/auth-profiles/doctor.js +5 -3
- package/dist/agents/auth-profiles/external-cli-sync.d.ts +7 -0
- package/dist/agents/auth-profiles/external-cli-sync.js +41 -9
- package/dist/agents/auth-profiles/oauth.d.ts +12 -0
- package/dist/agents/auth-profiles/oauth.js +26 -14
- package/dist/agents/auth-profiles/order.d.ts +8 -0
- package/dist/agents/auth-profiles/order.js +29 -16
- package/dist/agents/auth-profiles/paths.d.ts +4 -0
- package/dist/agents/auth-profiles/paths.js +5 -4
- package/dist/agents/auth-profiles/profiles.d.ts +18 -0
- package/dist/agents/auth-profiles/profiles.js +8 -4
- package/dist/agents/auth-profiles/repair.d.ts +14 -0
- package/dist/agents/auth-profiles/repair.js +26 -13
- package/dist/agents/auth-profiles/session-override.d.ts +18 -0
- package/dist/agents/auth-profiles/session-override.js +13 -7
- package/dist/agents/auth-profiles/store.d.ts +10 -0
- package/dist/agents/auth-profiles/store.js +30 -15
- package/dist/agents/auth-profiles/types.d.ts +58 -0
- package/dist/agents/auth-profiles/usage.d.ts +47 -0
- package/dist/agents/auth-profiles/usage.js +22 -11
- package/dist/agents/auth-profiles.d.ts +11 -0
- package/dist/agents/bash-process-registry.d.ts +68 -0
- package/dist/agents/bash-process-registry.js +18 -9
- package/dist/agents/bash-tools.d.ts +4 -0
- package/dist/agents/bash-tools.exec.d.ts +54 -0
- package/dist/agents/bash-tools.exec.js +107 -63
- package/dist/agents/bash-tools.process.d.ts +7 -0
- package/dist/agents/bash-tools.process.js +17 -9
- package/dist/agents/bash-tools.shared.d.ts +46 -0
- package/dist/agents/bash-tools.shared.js +30 -16
- package/dist/agents/bedrock-discovery.d.ts +9 -0
- package/dist/agents/bedrock-discovery.js +26 -14
- package/dist/agents/bootstrap-files.d.ts +25 -0
- package/dist/agents/bootstrap-files.js +3 -2
- package/dist/agents/bootstrap-hooks.d.ts +10 -0
- package/dist/agents/cache-trace.d.ts +51 -0
- package/dist/agents/cache-trace.js +33 -20
- package/dist/agents/channel-tools.d.ts +27 -0
- package/dist/agents/channel-tools.js +18 -9
- package/dist/agents/chutes-oauth.d.ts +46 -0
- package/dist/agents/chutes-oauth.js +14 -7
- package/dist/agents/claude-cli-runner.d.ts +1 -0
- package/dist/agents/cli-backends.d.ts +8 -0
- package/dist/agents/cli-backends.js +12 -6
- package/dist/agents/cli-credentials.d.ts +82 -0
- package/dist/agents/cli-credentials.js +92 -21
- package/dist/agents/cli-runner/helpers.d.ts +76 -0
- package/dist/agents/cli-runner/helpers.js +102 -54
- package/dist/agents/cli-runner.d.ts +39 -0
- package/dist/agents/cli-runner.js +14 -9
- package/dist/agents/cli-session.d.ts +3 -0
- package/dist/agents/cli-session.js +8 -4
- package/dist/agents/compaction.d.ts +61 -0
- package/dist/agents/compaction.js +12 -6
- package/dist/agents/context-window-guard.d.ts +24 -0
- package/dist/agents/context-window-guard.js +8 -4
- package/dist/agents/context.d.ts +1 -0
- package/dist/agents/context.js +9 -7
- package/dist/agents/date-time.d.ts +13 -0
- package/dist/agents/date-time.js +28 -14
- package/dist/agents/defaults.d.ts +3 -0
- package/dist/agents/docs-path.d.ts +6 -0
- package/dist/agents/docs-path.js +7 -5
- package/dist/agents/failover-error.d.ts +33 -0
- package/dist/agents/failover-error.js +48 -24
- package/dist/agents/identity-avatar.d.ts +15 -0
- package/dist/agents/identity-avatar.js +4 -2
- package/dist/agents/identity-file.d.ts +12 -0
- package/dist/agents/identity-file.js +20 -10
- package/dist/agents/identity.d.ts +20 -0
- package/dist/agents/identity.js +11 -6
- package/dist/agents/lanes.d.ts +3 -0
- package/dist/agents/live-auth-keys.d.ts +3 -0
- package/dist/agents/live-auth-keys.js +38 -20
- package/dist/agents/live-model-filter.d.ts +5 -0
- package/dist/agents/live-model-filter.js +2 -1
- package/dist/agents/memory-search.d.ts +66 -0
- package/dist/agents/memory-search.js +15 -5
- package/dist/agents/minimax-vlm.d.ts +7 -0
- package/dist/agents/minimax-vlm.js +7 -4
- package/dist/agents/model-auth.d.ts +36 -0
- package/dist/agents/model-auth.js +38 -18
- package/dist/agents/model-catalog.d.ts +25 -0
- package/dist/agents/model-catalog.js +17 -14
- package/dist/agents/model-compat.d.ts +2 -0
- package/dist/agents/model-compat.js +4 -2
- package/dist/agents/model-fallback.d.ts +49 -0
- package/dist/agents/model-fallback.js +41 -21
- package/dist/agents/model-scan.d.ts +63 -0
- package/dist/agents/model-scan.js +47 -24
- package/dist/agents/model-selection.d.ts +88 -0
- package/dist/agents/model-selection.js +59 -29
- package/dist/agents/models-config.d.ts +5 -0
- package/dist/agents/models-config.js +14 -9
- package/dist/agents/models-config.providers.d.ts +23 -0
- package/dist/agents/models-config.providers.js +88 -53
- package/dist/agents/openclaw-tools.d.ts +40 -0
- package/dist/agents/openclaw-tools.js +121 -0
- package/dist/agents/opencode-zen-models.d.ts +43 -0
- package/dist/agents/pi-embedded-block-chunker.d.ts +17 -0
- package/dist/agents/pi-embedded-block-chunker.js +32 -16
- package/dist/agents/pi-embedded-helpers/bootstrap.d.ts +28 -0
- package/dist/agents/pi-embedded-helpers/bootstrap.js +18 -9
- package/dist/agents/pi-embedded-helpers/errors.d.ts +45 -0
- package/dist/agents/pi-embedded-helpers/errors.js +107 -54
- package/dist/agents/pi-embedded-helpers/google.d.ts +8 -0
- package/dist/agents/pi-embedded-helpers/google.js +2 -1
- package/dist/agents/pi-embedded-helpers/images.d.ts +20 -0
- package/dist/agents/pi-embedded-helpers/images.js +12 -6
- package/dist/agents/pi-embedded-helpers/messaging-dedupe.d.ts +10 -0
- package/dist/agents/pi-embedded-helpers/messaging-dedupe.js +10 -5
- package/dist/agents/pi-embedded-helpers/openai.d.ts +9 -0
- package/dist/agents/pi-embedded-helpers/openai.js +13 -7
- package/dist/agents/pi-embedded-helpers/thinking.d.ts +5 -0
- package/dist/agents/pi-embedded-helpers/thinking.js +10 -5
- package/dist/agents/pi-embedded-helpers/turns.d.ts +20 -0
- package/dist/agents/pi-embedded-helpers/types.d.ts +5 -0
- package/dist/agents/pi-embedded-helpers.d.ts +11 -0
- package/dist/agents/pi-embedded-messaging.d.ts +8 -0
- package/dist/agents/pi-embedded-messaging.js +8 -4
- package/dist/agents/pi-embedded-runner/abort.d.ts +1 -0
- package/dist/agents/pi-embedded-runner/abort.js +4 -2
- package/dist/agents/pi-embedded-runner/cache-ttl.d.ts +9 -0
- package/dist/agents/pi-embedded-runner/cache-ttl.js +11 -6
- package/dist/agents/pi-embedded-runner/compact.d.ts +48 -0
- package/dist/agents/pi-embedded-runner/compact.js +32 -25
- package/dist/agents/pi-embedded-runner/extensions.d.ts +12 -0
- package/dist/agents/pi-embedded-runner/extensions.js +6 -3
- package/dist/agents/pi-embedded-runner/extra-params.d.ts +21 -0
- package/dist/agents/pi-embedded-runner/extra-params.js +6 -3
- package/dist/agents/pi-embedded-runner/google.d.ts +39 -0
- package/dist/agents/pi-embedded-runner/google.js +18 -10
- package/dist/agents/pi-embedded-runner/history.d.ts +12 -0
- package/dist/agents/pi-embedded-runner/history.js +14 -7
- package/dist/agents/pi-embedded-runner/lanes.d.ts +3 -0
- package/dist/agents/pi-embedded-runner/logger.d.ts +1 -0
- package/dist/agents/pi-embedded-runner/model.d.ts +22 -0
- package/dist/agents/pi-embedded-runner/model.js +10 -7
- package/dist/agents/pi-embedded-runner/run/attempt.d.ts +5 -0
- package/dist/agents/pi-embedded-runner/run/attempt.js +52 -38
- package/dist/agents/pi-embedded-runner/run/images.d.ts +83 -0
- package/dist/agents/pi-embedded-runner/run/images.js +29 -16
- package/dist/agents/pi-embedded-runner/run/params.d.ts +109 -0
- package/dist/agents/pi-embedded-runner/run/payloads.d.ts +34 -0
- package/dist/agents/pi-embedded-runner/run/payloads.js +26 -13
- package/dist/agents/pi-embedded-runner/run/types.d.ts +126 -0
- package/dist/agents/pi-embedded-runner/run.d.ts +3 -0
- package/dist/agents/pi-embedded-runner/run.js +18 -11
- package/dist/agents/pi-embedded-runner/runs.d.ts +14 -0
- package/dist/agents/pi-embedded-runner/runs.js +10 -5
- package/dist/agents/pi-embedded-runner/sandbox-info.d.ts +4 -0
- package/dist/agents/pi-embedded-runner/sandbox-info.js +2 -1
- package/dist/agents/pi-embedded-runner/session-manager-cache.d.ts +2 -0
- package/dist/agents/pi-embedded-runner/session-manager-cache.js +11 -6
- package/dist/agents/pi-embedded-runner/session-manager-init.d.ts +17 -0
- package/dist/agents/pi-embedded-runner/system-prompt.d.ts +47 -0
- package/dist/agents/pi-embedded-runner/tool-split.d.ts +11 -0
- package/dist/agents/pi-embedded-runner/types.d.ts +70 -0
- package/dist/agents/pi-embedded-runner/utils.d.ts +8 -0
- package/dist/agents/pi-embedded-runner/utils.js +9 -5
- package/dist/agents/pi-embedded-runner.d.ts +12 -0
- package/dist/agents/pi-embedded-subscribe.d.ts +20 -0
- package/dist/agents/pi-embedded-subscribe.handlers.d.ts +2 -0
- package/dist/agents/pi-embedded-subscribe.handlers.lifecycle.d.ts +8 -0
- package/dist/agents/pi-embedded-subscribe.handlers.messages.d.ts +12 -0
- package/dist/agents/pi-embedded-subscribe.handlers.messages.js +52 -17
- package/dist/agents/pi-embedded-subscribe.handlers.tools.d.ts +18 -0
- package/dist/agents/pi-embedded-subscribe.handlers.tools.js +10 -5
- package/dist/agents/pi-embedded-subscribe.handlers.types.d.ts +107 -0
- package/dist/agents/pi-embedded-subscribe.js +64 -27
- package/dist/agents/pi-embedded-subscribe.raw-stream.d.ts +1 -0
- package/dist/agents/pi-embedded-subscribe.raw-stream.js +4 -3
- package/dist/agents/pi-embedded-subscribe.tools.d.ts +6 -0
- package/dist/agents/pi-embedded-subscribe.tools.js +59 -30
- package/dist/agents/pi-embedded-subscribe.types.d.ts +44 -0
- package/dist/agents/pi-embedded-utils.d.ts +38 -0
- package/dist/agents/pi-embedded-utils.js +66 -33
- package/dist/agents/pi-embedded.d.ts +2 -0
- package/dist/agents/pi-extensions/compaction-safeguard-runtime.d.ts +5 -0
- package/dist/agents/pi-extensions/compaction-safeguard.d.ts +22 -0
- package/dist/agents/pi-extensions/compaction-safeguard.js +26 -14
- package/dist/agents/pi-extensions/context-pruning/extension.d.ts +2 -0
- package/dist/agents/pi-extensions/context-pruning/extension.js +4 -2
- package/dist/agents/pi-extensions/context-pruning/pruner.d.ts +10 -0
- package/dist/agents/pi-extensions/context-pruning/pruner.js +64 -32
- package/dist/agents/pi-extensions/context-pruning/runtime.d.ts +9 -0
- package/dist/agents/pi-extensions/context-pruning/settings.d.ts +44 -0
- package/dist/agents/pi-extensions/context-pruning/settings.js +4 -2
- package/dist/agents/pi-extensions/context-pruning/tools.d.ts +2 -0
- package/dist/agents/pi-extensions/context-pruning/tools.js +16 -8
- package/dist/agents/pi-extensions/context-pruning.d.ts +10 -0
- package/dist/agents/pi-model-discovery.d.ts +4 -0
- package/dist/agents/pi-model-discovery.js +10 -0
- package/dist/agents/pi-settings.d.ts +19 -0
- package/dist/agents/pi-tool-definition-adapter.d.ts +7 -0
- package/dist/agents/pi-tool-definition-adapter.js +4 -2
- package/dist/agents/pi-tools.abort.d.ts +2 -0
- package/dist/agents/pi-tools.abort.js +16 -8
- package/dist/agents/pi-tools.d.ts +63 -0
- package/dist/agents/pi-tools.js +21 -14
- package/dist/agents/pi-tools.policy.d.ts +37 -0
- package/dist/agents/pi-tools.policy.js +56 -29
- package/dist/agents/pi-tools.read.d.ts +35 -0
- package/dist/agents/pi-tools.read.js +25 -14
- package/dist/agents/pi-tools.schema.d.ts +3 -0
- package/dist/agents/pi-tools.schema.js +26 -13
- package/dist/agents/pi-tools.types.d.ts +2 -0
- package/dist/agents/pty-dsr.d.ts +5 -0
- package/dist/agents/pty-keys.d.ts +13 -0
- package/dist/agents/pty-keys.js +30 -15
- package/dist/agents/sandbox/browser-bridges.d.ts +5 -0
- package/dist/agents/sandbox/browser.d.ts +8 -0
- package/dist/agents/sandbox/browser.js +28 -17
- package/dist/agents/sandbox/config-hash.d.ts +9 -0
- package/dist/agents/sandbox/config-hash.js +14 -8
- package/dist/agents/sandbox/config.d.ts +22 -0
- package/dist/agents/sandbox/config.js +2 -1
- package/dist/agents/sandbox/constants.d.ts +19 -0
- package/dist/agents/sandbox/constants.js +7 -7
- package/dist/agents/sandbox/context.d.ts +12 -0
- package/dist/agents/sandbox/context.js +9 -5
- package/dist/agents/sandbox/docker.d.ts +28 -0
- package/dist/agents/sandbox/docker.js +59 -35
- package/dist/agents/sandbox/manage.d.ts +13 -0
- package/dist/agents/sandbox/prune.d.ts +3 -0
- package/dist/agents/sandbox/prune.js +6 -3
- package/dist/agents/sandbox/registry.d.ts +30 -0
- package/dist/agents/sandbox/registry.js +8 -4
- package/dist/agents/sandbox/runtime-status.d.ts +18 -0
- package/dist/agents/sandbox/runtime-status.js +16 -9
- package/dist/agents/sandbox/shared.d.ts +4 -0
- package/dist/agents/sandbox/shared.js +8 -4
- package/dist/agents/sandbox/tool-policy.d.ts +4 -0
- package/dist/agents/sandbox/tool-policy.js +18 -9
- package/dist/agents/sandbox/types.d.ts +73 -0
- package/dist/agents/sandbox/types.docker.d.ts +25 -0
- package/dist/agents/sandbox/workspace.d.ts +1 -0
- package/dist/agents/sandbox-paths.d.ts +16 -0
- package/dist/agents/sandbox-paths.js +4 -2
- package/dist/agents/sandbox.d.ts +8 -0
- package/dist/agents/schema/clean-for-gemini.d.ts +2 -0
- package/dist/agents/schema/clean-for-gemini.js +58 -29
- package/dist/agents/schema/typebox.d.ts +14 -0
- package/dist/agents/session-slug.d.ts +1 -0
- package/dist/agents/session-slug.js +10 -5
- package/dist/agents/session-tool-result-guard-wrapper.d.ts +14 -0
- package/dist/agents/session-tool-result-guard.d.ts +21 -0
- package/dist/agents/session-tool-result-guard.js +15 -8
- package/dist/agents/session-transcript-repair.d.ts +19 -0
- package/dist/agents/session-transcript-repair.js +15 -8
- package/dist/agents/session-write-lock.d.ts +21 -0
- package/dist/agents/session-write-lock.js +22 -12
- package/dist/agents/shell-utils.d.ts +6 -0
- package/dist/agents/shell-utils.js +14 -7
- package/dist/agents/skills/bundled-dir.d.ts +1 -0
- package/dist/agents/skills/bundled-dir.js +7 -4
- package/dist/agents/skills/config.d.ts +14 -0
- package/dist/agents/skills/config.js +41 -21
- package/dist/agents/skills/env-overrides.d.ts +10 -0
- package/dist/agents/skills/env-overrides.js +18 -9
- package/dist/agents/skills/frontmatter.d.ts +6 -0
- package/dist/agents/skills/frontmatter.js +45 -20
- package/dist/agents/skills/plugin-skills.d.ts +5 -0
- package/dist/agents/skills/plugin-skills.js +14 -7
- package/dist/agents/skills/refresh.d.ts +19 -0
- package/dist/agents/skills/refresh.js +11 -6
- package/dist/agents/skills/serialize.d.ts +1 -0
- package/dist/agents/skills/serialize.js +2 -1
- package/dist/agents/skills/types.d.ts +80 -0
- package/dist/agents/skills/workspace.d.ts +49 -0
- package/dist/agents/skills/workspace.js +31 -19
- package/dist/agents/skills-install.d.ts +16 -0
- package/dist/agents/skills-install.js +40 -20
- package/dist/agents/skills-status.d.ts +55 -0
- package/dist/agents/skills-status.js +26 -13
- package/dist/agents/skills.d.ts +7 -0
- package/dist/agents/subagent-announce-queue.d.ts +22 -0
- package/dist/agents/subagent-announce-queue.js +16 -8
- package/dist/agents/subagent-announce.d.ts +28 -0
- package/dist/agents/subagent-announce.js +56 -29
- package/dist/agents/subagent-registry.d.ts +35 -0
- package/dist/agents/subagent-registry.js +58 -30
- package/dist/agents/subagent-registry.store.d.ts +5 -0
- package/dist/agents/subagent-registry.store.js +12 -6
- package/dist/agents/synthetic-models.d.ts +153 -0
- package/dist/agents/synthetic-models.js +8 -0
- package/dist/agents/system-prompt-params.d.ts +29 -0
- package/dist/agents/system-prompt-params.js +10 -5
- package/dist/agents/system-prompt-report.d.ts +20 -0
- package/dist/agents/system-prompt-report.js +12 -6
- package/dist/agents/system-prompt.d.ts +73 -0
- package/dist/agents/system-prompt.js +55 -34
- package/dist/agents/test-helpers/fast-coding-tools.d.ts +1 -0
- package/dist/agents/test-helpers/fast-core-tools.d.ts +1 -0
- package/dist/agents/timeout.d.ts +8 -0
- package/dist/agents/timeout.js +4 -2
- package/dist/agents/tool-call-id.d.ts +17 -0
- package/dist/agents/tool-call-id.js +34 -17
- package/dist/agents/tool-display.d.ts +15 -0
- package/dist/agents/tool-display.js +48 -24
- package/dist/agents/tool-images.d.ts +19 -0
- package/dist/agents/tool-images.js +18 -10
- package/dist/agents/tool-policy.d.ts +36 -0
- package/dist/agents/tool-policy.js +26 -14
- package/dist/agents/tool-summaries.d.ts +2 -0
- package/dist/agents/tool-summaries.js +2 -1
- package/dist/agents/tools/agent-step.d.ts +12 -0
- package/dist/agents/tools/agent-step.js +8 -7
- package/dist/agents/tools/agents-list-tool.d.ts +6 -0
- package/dist/agents/tools/agents-list-tool.js +9 -4
- package/dist/agents/tools/browser-tool.d.ts +5 -0
- package/dist/agents/tools/browser-tool.js +26 -19
- package/dist/agents/tools/browser-tool.schema.d.ts +50 -0
- package/dist/agents/tools/canvas-tool.d.ts +2 -0
- package/dist/agents/tools/canvas-tool.js +3 -2
- package/dist/agents/tools/common.d.ts +52 -0
- package/dist/agents/tools/common.js +20 -10
- package/dist/agents/tools/cron-tool.d.ts +6 -0
- package/dist/agents/tools/cron-tool.js +24 -14
- package/dist/agents/tools/discord-actions-guild.d.ts +4 -0
- package/dist/agents/tools/discord-actions-guild.js +4 -2
- package/dist/agents/tools/discord-actions-messaging.d.ts +4 -0
- package/dist/agents/tools/discord-actions-messaging.js +4 -3
- package/dist/agents/tools/discord-actions-moderation.d.ts +4 -0
- package/dist/agents/tools/discord-actions.d.ts +3 -0
- package/dist/agents/tools/gateway-tool.d.ts +6 -0
- package/dist/agents/tools/gateway-tool.js +3 -2
- package/dist/agents/tools/gateway.d.ts +14 -0
- package/dist/agents/tools/image-tool.d.ts +26 -0
- package/dist/agents/tools/image-tool.helpers.d.ts +21 -0
- package/dist/agents/tools/image-tool.helpers.js +4 -2
- package/dist/agents/tools/image-tool.js +27 -17
- package/dist/agents/tools/memory-tool.d.ts +10 -0
- package/dist/agents/tools/memory-tool.js +9 -5
- package/dist/agents/tools/message-tool.d.ts +16 -0
- package/dist/agents/tools/message-tool.js +20 -13
- package/dist/agents/tools/nodes-tool.d.ts +6 -0
- package/dist/agents/tools/nodes-tool.js +14 -14
- package/dist/agents/tools/nodes-utils.d.ts +20 -0
- package/dist/agents/tools/nodes-utils.js +20 -11
- package/dist/agents/tools/session-status-tool.d.ts +6 -0
- package/dist/agents/tools/session-status-tool.js +22 -12
- package/dist/agents/tools/sessions-announce-target.d.ts +5 -0
- package/dist/agents/tools/sessions-announce-target.js +4 -3
- package/dist/agents/tools/sessions-helpers.d.ts +90 -0
- package/dist/agents/tools/sessions-helpers.js +71 -38
- package/dist/agents/tools/sessions-history-tool.d.ts +5 -0
- package/dist/agents/tools/sessions-history-tool.js +4 -4
- package/dist/agents/tools/sessions-list-tool.d.ts +5 -0
- package/dist/agents/tools/sessions-list-tool.js +17 -11
- package/dist/agents/tools/sessions-send-helpers.d.ts +34 -0
- package/dist/agents/tools/sessions-send-helpers.js +12 -6
- package/dist/agents/tools/sessions-send-tool.a2a.d.ts +12 -0
- package/dist/agents/tools/sessions-send-tool.a2a.js +4 -3
- package/dist/agents/tools/sessions-send-tool.d.ts +7 -0
- package/dist/agents/tools/sessions-send-tool.js +15 -15
- package/dist/agents/tools/sessions-spawn-tool.d.ts +15 -0
- package/dist/agents/tools/sessions-spawn-tool.js +16 -12
- package/dist/agents/tools/slack-actions.d.ts +15 -0
- package/dist/agents/tools/slack-actions.js +14 -7
- package/dist/agents/tools/telegram-actions.d.ts +9 -0
- package/dist/agents/tools/telegram-actions.js +3 -2
- package/dist/agents/tools/tts-tool.d.ts +7 -0
- package/dist/agents/tools/tts-tool.js +2 -1
- package/dist/agents/tools/web-fetch-utils.d.ts +18 -0
- package/dist/agents/tools/web-fetch-utils.js +6 -3
- package/dist/agents/tools/web-fetch.d.ts +25 -0
- package/dist/agents/tools/web-fetch.js +31 -16
- package/dist/agents/tools/web-search.d.ts +22 -0
- package/dist/agents/tools/web-search.js +55 -31
- package/dist/agents/tools/web-shared.d.ts +17 -0
- package/dist/agents/tools/web-shared.js +8 -4
- package/dist/agents/tools/web-tools.d.ts +2 -0
- package/dist/agents/tools/whatsapp-actions.d.ts +3 -0
- package/dist/agents/transcript-policy.d.ts +23 -0
- package/dist/agents/transcript-policy.js +11 -6
- package/dist/agents/usage.d.ts +35 -0
- package/dist/agents/usage.js +10 -5
- package/dist/agents/venice-models.d.ts +238 -0
- package/dist/agents/workspace-templates.d.ts +6 -0
- package/dist/agents/workspace-templates.js +53 -0
- package/dist/agents/workspace.d.ts +33 -0
- package/dist/agents/workspace.js +27 -17
- package/dist/auto-reply/chunk.d.ts +45 -0
- package/dist/auto-reply/chunk.js +62 -31
- package/dist/auto-reply/command-auth.d.ts +16 -0
- package/dist/auto-reply/command-auth.js +18 -9
- package/dist/auto-reply/command-detection.d.ts +13 -0
- package/dist/auto-reply/command-detection.js +20 -10
- package/dist/auto-reply/commands-args.d.ts +3 -0
- package/dist/auto-reply/commands-args.js +22 -11
- package/dist/auto-reply/commands-registry.d.ts +54 -0
- package/dist/auto-reply/commands-registry.data.d.ts +3 -0
- package/dist/auto-reply/commands-registry.data.js +8 -5
- package/dist/auto-reply/commands-registry.js +95 -48
- package/dist/auto-reply/commands-registry.types.d.ts +66 -0
- package/dist/auto-reply/dispatch.d.ts +27 -0
- package/dist/auto-reply/dispatch.js +1 -1
- package/dist/auto-reply/envelope.d.ts +59 -0
- package/dist/auto-reply/envelope.js +36 -19
- package/dist/auto-reply/group-activation.d.ts +6 -0
- package/dist/auto-reply/group-activation.js +10 -5
- package/dist/auto-reply/heartbeat.d.ts +26 -0
- package/dist/auto-reply/heartbeat.js +18 -9
- package/dist/auto-reply/inbound-debounce.d.ts +16 -0
- package/dist/auto-reply/inbound-debounce.js +10 -5
- package/dist/auto-reply/media-note.d.ts +2 -0
- package/dist/auto-reply/media-note.js +6 -3
- package/dist/auto-reply/model.d.ts +8 -0
- package/dist/auto-reply/model.js +2 -1
- package/dist/auto-reply/reply/abort.d.ts +20 -0
- package/dist/auto-reply/reply/abort.js +26 -14
- package/dist/auto-reply/reply/agent-runner-execution.d.ts +48 -0
- package/dist/auto-reply/reply/agent-runner-execution.js +24 -13
- package/dist/auto-reply/reply/agent-runner-helpers.d.ts +17 -0
- package/dist/auto-reply/reply/agent-runner-helpers.js +10 -5
- package/dist/auto-reply/reply/agent-runner-memory.d.ts +20 -0
- package/dist/auto-reply/reply/agent-runner-memory.js +8 -4
- package/dist/auto-reply/reply/agent-runner-payloads.d.ts +25 -0
- package/dist/auto-reply/reply/agent-runner-payloads.js +2 -1
- package/dist/auto-reply/reply/agent-runner-utils.d.ts +30 -0
- package/dist/auto-reply/reply/agent-runner-utils.js +10 -5
- package/dist/auto-reply/reply/agent-runner.d.ts +37 -0
- package/dist/auto-reply/reply/agent-runner.js +14 -8
- package/dist/auto-reply/reply/audio-tags.d.ts +1 -0
- package/dist/auto-reply/reply/bash-command.d.ts +19 -0
- package/dist/auto-reply/reply/bash-command.js +32 -17
- package/dist/auto-reply/reply/block-reply-coalescer.d.ts +15 -0
- package/dist/auto-reply/reply/block-reply-coalescer.js +10 -5
- package/dist/auto-reply/reply/block-reply-pipeline.d.ts +31 -0
- package/dist/auto-reply/reply/block-reply-pipeline.js +22 -11
- package/dist/auto-reply/reply/block-streaming.d.ts +17 -0
- package/dist/auto-reply/reply/block-streaming.js +6 -3
- package/dist/auto-reply/reply/body.d.ts +11 -0
- package/dist/auto-reply/reply/body.js +2 -1
- package/dist/auto-reply/reply/commands-allowlist.d.ts +2 -0
- package/dist/auto-reply/reply/commands-allowlist.js +46 -27
- package/dist/auto-reply/reply/commands-approve.d.ts +2 -0
- package/dist/auto-reply/reply/commands-approve.js +7 -4
- package/dist/auto-reply/reply/commands-bash.d.ts +2 -0
- package/dist/auto-reply/reply/commands-bash.js +2 -1
- package/dist/auto-reply/reply/commands-compact.d.ts +2 -0
- package/dist/auto-reply/reply/commands-compact.js +8 -4
- package/dist/auto-reply/reply/commands-config.d.ts +3 -0
- package/dist/auto-reply/reply/commands-config.js +11 -7
- package/dist/auto-reply/reply/commands-context-report.d.ts +3 -0
- package/dist/auto-reply/reply/commands-context-report.js +14 -11
- package/dist/auto-reply/reply/commands-context.d.ts +12 -0
- package/dist/auto-reply/reply/commands-core.d.ts +2 -0
- package/dist/auto-reply/reply/commands-core.js +36 -32
- package/dist/auto-reply/reply/commands-info.d.ts +10 -0
- package/dist/auto-reply/reply/commands-info.js +23 -12
- package/dist/auto-reply/reply/commands-models.d.ts +8 -0
- package/dist/auto-reply/reply/commands-models.js +19 -11
- package/dist/auto-reply/reply/commands-plugin.d.ts +13 -0
- package/dist/auto-reply/reply/commands-plugin.js +4 -2
- package/dist/auto-reply/reply/commands-session.d.ts +7 -0
- package/dist/auto-reply/reply/commands-session.js +40 -23
- package/dist/auto-reply/reply/commands-status.d.ts +24 -0
- package/dist/auto-reply/reply/commands-status.js +8 -5
- package/dist/auto-reply/reply/commands-subagents.d.ts +13 -0
- package/dist/auto-reply/reply/commands-subagents.js +38 -24
- package/dist/auto-reply/reply/commands-tts.d.ts +2 -0
- package/dist/auto-reply/reply/commands-tts.js +10 -5
- package/dist/auto-reply/reply/commands-types.d.ts +59 -0
- package/dist/auto-reply/reply/commands.d.ts +4 -0
- package/dist/auto-reply/reply/config-commands.d.ts +15 -0
- package/dist/auto-reply/reply/config-commands.js +8 -4
- package/dist/auto-reply/reply/config-value.d.ts +4 -0
- package/dist/auto-reply/reply/config-value.js +10 -5
- package/dist/auto-reply/reply/debug-commands.d.ts +16 -0
- package/dist/auto-reply/reply/debug-commands.js +8 -4
- package/dist/auto-reply/reply/directive-handling.auth.d.ts +19 -0
- package/dist/auto-reply/reply/directive-handling.auth.js +24 -12
- package/dist/auto-reply/reply/directive-handling.d.ts +6 -0
- package/dist/auto-reply/reply/directive-handling.fast-lane.d.ts +47 -0
- package/dist/auto-reply/reply/directive-handling.impl.d.ts +35 -0
- package/dist/auto-reply/reply/directive-handling.impl.js +28 -14
- package/dist/auto-reply/reply/directive-handling.model-picker.d.ts +13 -0
- package/dist/auto-reply/reply/directive-handling.model-picker.js +12 -6
- package/dist/auto-reply/reply/directive-handling.model.d.ts +41 -0
- package/dist/auto-reply/reply/directive-handling.model.js +25 -13
- package/dist/auto-reply/reply/directive-handling.parse.d.ts +62 -0
- package/dist/auto-reply/reply/directive-handling.parse.js +2 -1
- package/dist/auto-reply/reply/directive-handling.persist.d.ts +37 -0
- package/dist/auto-reply/reply/directive-handling.queue-validation.d.ts +10 -0
- package/dist/auto-reply/reply/directive-handling.queue-validation.js +2 -1
- package/dist/auto-reply/reply/directive-handling.shared.d.ts +16 -0
- package/dist/auto-reply/reply/directive-handling.shared.js +9 -5
- package/dist/auto-reply/reply/directives.d.ts +38 -0
- package/dist/auto-reply/reply/directives.js +20 -10
- package/dist/auto-reply/reply/dispatch-from-config.d.ts +16 -0
- package/dist/auto-reply/reply/dispatch-from-config.js +46 -13
- package/dist/auto-reply/reply/exec/directive.d.ts +20 -0
- package/dist/auto-reply/reply/exec/directive.js +30 -15
- package/dist/auto-reply/reply/exec.d.ts +1 -0
- package/dist/auto-reply/reply/followup-runner.d.ts +16 -0
- package/dist/auto-reply/reply/followup-runner.js +11 -6
- package/dist/auto-reply/reply/get-reply-directives-apply.d.ts +64 -0
- package/dist/auto-reply/reply/get-reply-directives-apply.js +2 -2
- package/dist/auto-reply/reply/get-reply-directives-utils.d.ts +2 -0
- package/dist/auto-reply/reply/get-reply-directives.d.ts +90 -0
- package/dist/auto-reply/reply/get-reply-directives.js +4 -2
- package/dist/auto-reply/reply/get-reply-inline-actions.d.ts +59 -0
- package/dist/auto-reply/reply/get-reply-inline-actions.js +15 -10
- package/dist/auto-reply/reply/get-reply-run.d.ts +68 -0
- package/dist/auto-reply/reply/get-reply-run.js +3 -3
- package/dist/auto-reply/reply/get-reply.d.ts +4 -0
- package/dist/auto-reply/reply/get-reply.js +4 -4
- package/dist/auto-reply/reply/groups.d.ts +16 -0
- package/dist/auto-reply/reply/groups.js +14 -8
- package/dist/auto-reply/reply/history.d.ts +72 -0
- package/dist/auto-reply/reply/history.js +22 -11
- package/dist/auto-reply/reply/inbound-context.d.ts +8 -0
- package/dist/auto-reply/reply/inbound-context.js +4 -2
- package/dist/auto-reply/reply/inbound-dedupe.d.ts +8 -0
- package/dist/auto-reply/reply/inbound-dedupe.js +6 -3
- package/dist/auto-reply/reply/inbound-sender-meta.d.ts +5 -0
- package/dist/auto-reply/reply/inbound-sender-meta.js +12 -6
- package/dist/auto-reply/reply/inbound-text.d.ts +1 -0
- package/dist/auto-reply/reply/line-directives.d.ts +22 -0
- package/dist/auto-reply/reply/line-directives.js +6 -3
- package/dist/auto-reply/reply/memory-flush.d.ts +23 -0
- package/dist/auto-reply/reply/memory-flush.js +12 -6
- package/dist/auto-reply/reply/mentions.d.ts +18 -0
- package/dist/auto-reply/reply/mentions.js +13 -7
- package/dist/auto-reply/reply/model-selection.d.ts +50 -0
- package/dist/auto-reply/reply/model-selection.js +77 -40
- package/dist/auto-reply/reply/normalize-reply.d.ts +13 -0
- package/dist/auto-reply/reply/normalize-reply.js +16 -7
- package/dist/auto-reply/reply/provider-dispatcher.d.ts +19 -0
- package/dist/auto-reply/reply/queue/cleanup.d.ts +6 -0
- package/dist/auto-reply/reply/queue/cleanup.js +2 -1
- package/dist/auto-reply/reply/queue/directive.d.ts +15 -0
- package/dist/auto-reply/reply/queue/directive.js +24 -12
- package/dist/auto-reply/reply/queue/drain.d.ts +2 -0
- package/dist/auto-reply/reply/queue/drain.js +12 -6
- package/dist/auto-reply/reply/queue/enqueue.d.ts +3 -0
- package/dist/auto-reply/reply/queue/enqueue.js +10 -5
- package/dist/auto-reply/reply/queue/normalize.d.ts +3 -0
- package/dist/auto-reply/reply/queue/normalize.js +22 -11
- package/dist/auto-reply/reply/queue/settings.d.ts +2 -0
- package/dist/auto-reply/reply/queue/settings.js +4 -2
- package/dist/auto-reply/reply/queue/state.d.ts +19 -0
- package/dist/auto-reply/reply/queue/state.js +4 -2
- package/dist/auto-reply/reply/queue/types.d.ts +84 -0
- package/dist/auto-reply/reply/queue.d.ts +8 -0
- package/dist/auto-reply/reply/reply-directives.d.ts +14 -0
- package/dist/auto-reply/reply/reply-dispatcher.d.ts +49 -0
- package/dist/auto-reply/reply/reply-dispatcher.js +18 -6
- package/dist/auto-reply/reply/reply-elevated.d.ts +23 -0
- package/dist/auto-reply/reply/reply-elevated.js +40 -21
- package/dist/auto-reply/reply/reply-inline.d.ts +8 -0
- package/dist/auto-reply/reply/reply-inline.js +8 -4
- package/dist/auto-reply/reply/reply-payloads.d.ts +22 -0
- package/dist/auto-reply/reply/reply-payloads.js +18 -9
- package/dist/auto-reply/reply/reply-reference.d.ts +20 -0
- package/dist/auto-reply/reply/reply-reference.js +6 -3
- package/dist/auto-reply/reply/reply-tags.d.ts +6 -0
- package/dist/auto-reply/reply/reply-threading.d.ts +9 -0
- package/dist/auto-reply/reply/reply-threading.js +8 -4
- package/dist/auto-reply/reply/response-prefix-template.d.ts +51 -0
- package/dist/auto-reply/reply/response-prefix-template.js +4 -2
- package/dist/auto-reply/reply/route-reply.d.ts +56 -0
- package/dist/auto-reply/reply/route-reply.js +4 -2
- package/dist/auto-reply/reply/session-reset-model.d.ts +24 -0
- package/dist/auto-reply/reply/session-reset-model.js +25 -13
- package/dist/auto-reply/reply/session-updates.d.ts +34 -0
- package/dist/auto-reply/reply/session-updates.js +33 -17
- package/dist/auto-reply/reply/session-usage.d.ts +13 -0
- package/dist/auto-reply/reply/session-usage.js +2 -1
- package/dist/auto-reply/reply/session.d.ts +26 -0
- package/dist/auto-reply/reply/session.js +12 -8
- package/dist/auto-reply/reply/stage-sandbox-media.d.ts +9 -0
- package/dist/auto-reply/reply/stage-sandbox-media.js +40 -12
- package/dist/auto-reply/reply/streaming-directives.d.ts +10 -0
- package/dist/auto-reply/reply/streaming-directives.js +4 -2
- package/dist/auto-reply/reply/subagents-utils.d.ts +9 -0
- package/dist/auto-reply/reply/subagents-utils.js +19 -10
- package/dist/auto-reply/reply/test-ctx.d.ts +2 -0
- package/dist/auto-reply/reply/typing-mode.d.ts +27 -0
- package/dist/auto-reply/reply/typing-mode.js +22 -11
- package/dist/auto-reply/reply/typing.d.ts +17 -0
- package/dist/auto-reply/reply/typing.js +40 -20
- package/dist/auto-reply/reply.d.ts +6 -0
- package/dist/auto-reply/send-policy.d.ts +6 -0
- package/dist/auto-reply/send-policy.js +14 -7
- package/dist/auto-reply/skill-commands.d.ts +18 -0
- package/dist/auto-reply/skill-commands.js +27 -14
- package/dist/auto-reply/status.d.ts +53 -0
- package/dist/auto-reply/status.js +68 -36
- package/dist/auto-reply/templating.d.ts +132 -0
- package/dist/auto-reply/templating.js +10 -5
- package/dist/auto-reply/thinking.d.ts +22 -0
- package/dist/auto-reply/thinking.js +82 -41
- package/dist/auto-reply/tokens.d.ts +3 -0
- package/dist/auto-reply/tokens.js +4 -2
- package/dist/auto-reply/tool-meta.d.ts +8 -0
- package/dist/auto-reply/tool-meta.js +30 -15
- package/dist/auto-reply/types.d.ts +55 -0
- package/dist/browser/bridge-server.d.ts +17 -0
- package/dist/browser/bridge-server.js +2 -1
- package/dist/browser/cdp.d.ts +123 -0
- package/dist/browser/cdp.helpers.d.ts +9 -0
- package/dist/browser/cdp.helpers.js +12 -6
- package/dist/browser/cdp.js +30 -15
- package/dist/browser/chrome.d.ts +20 -0
- package/dist/browser/chrome.executables.d.ts +9 -0
- package/dist/browser/chrome.executables.js +98 -49
- package/dist/browser/chrome.js +34 -24
- package/dist/browser/chrome.profile-decoration.d.ts +10 -0
- package/dist/browser/chrome.profile-decoration.js +11 -8
- package/dist/browser/client-actions-core.d.ts +143 -0
- package/dist/browser/client-actions-core.js +2 -1
- package/dist/browser/client-actions-observe.d.ts +68 -0
- package/dist/browser/client-actions-observe.js +22 -11
- package/dist/browser/client-actions-state.d.ts +90 -0
- package/dist/browser/client-actions-state.js +12 -6
- package/dist/browser/client-actions-types.d.ts +18 -0
- package/dist/browser/client-actions.d.ts +4 -0
- package/dist/browser/client-fetch.d.ts +3 -0
- package/dist/browser/client-fetch.js +3 -3
- package/dist/browser/client.d.ts +147 -0
- package/dist/browser/client.js +24 -12
- package/dist/browser/config.d.ts +39 -0
- package/dist/browser/config.js +24 -18
- package/dist/browser/constants.d.ts +8 -0
- package/dist/browser/constants.js +3 -3
- package/dist/browser/control-service.d.ts +5 -0
- package/dist/browser/control-service.js +9 -5
- package/dist/browser/extension-relay.d.ts +14 -0
- package/dist/browser/extension-relay.js +51 -27
- package/dist/browser/profiles-service.d.ts +25 -0
- package/dist/browser/profiles-service.js +5 -4
- package/dist/browser/profiles.d.ts +30 -0
- package/dist/browser/profiles.js +13 -7
- package/dist/browser/pw-ai-module.d.ts +6 -0
- package/dist/browser/pw-ai-module.js +10 -5
- package/dist/browser/pw-ai.d.ts +2 -0
- package/dist/browser/pw-role-snapshot.d.ts +35 -0
- package/dist/browser/pw-role-snapshot.js +60 -30
- package/dist/browser/pw-session.d.ts +135 -0
- package/dist/browser/pw-session.js +52 -26
- package/dist/browser/pw-tools-core.activity.d.ts +21 -0
- package/dist/browser/pw-tools-core.activity.js +4 -2
- package/dist/browser/pw-tools-core.d.ts +8 -0
- package/dist/browser/pw-tools-core.downloads.d.ts +34 -0
- package/dist/browser/pw-tools-core.downloads.js +19 -10
- package/dist/browser/pw-tools-core.interactions.d.ts +112 -0
- package/dist/browser/pw-tools-core.interactions.js +21 -13
- package/dist/browser/pw-tools-core.responses.d.ts +13 -0
- package/dist/browser/pw-tools-core.responses.js +18 -10
- package/dist/browser/pw-tools-core.shared.d.ts +6 -0
- package/dist/browser/pw-tools-core.shared.js +2 -1
- package/dist/browser/pw-tools-core.snapshot.d.ts +64 -0
- package/dist/browser/pw-tools-core.snapshot.js +2 -1
- package/dist/browser/pw-tools-core.state.d.ts +46 -0
- package/dist/browser/pw-tools-core.state.js +13 -7
- package/dist/browser/pw-tools-core.storage.d.ts +47 -0
- package/dist/browser/pw-tools-core.storage.js +6 -3
- package/dist/browser/pw-tools-core.trace.d.ts +12 -0
- package/dist/browser/routes/agent.act.d.ts +3 -0
- package/dist/browser/routes/agent.act.js +80 -41
- package/dist/browser/routes/agent.act.shared.d.ts +10 -0
- package/dist/browser/routes/agent.act.shared.js +4 -2
- package/dist/browser/routes/agent.d.ts +3 -0
- package/dist/browser/routes/agent.debug.d.ts +3 -0
- package/dist/browser/routes/agent.debug.js +21 -11
- package/dist/browser/routes/agent.shared.d.ts +9 -0
- package/dist/browser/routes/agent.shared.js +6 -3
- package/dist/browser/routes/agent.snapshot.d.ts +3 -0
- package/dist/browser/routes/agent.snapshot.js +22 -11
- package/dist/browser/routes/agent.storage.d.ts +3 -0
- package/dist/browser/routes/agent.storage.js +80 -40
- package/dist/browser/routes/basic.d.ts +3 -0
- package/dist/browser/routes/basic.js +4 -2
- package/dist/browser/routes/dispatcher.d.ts +15 -0
- package/dist/browser/routes/dispatcher.js +4 -2
- package/dist/browser/routes/index.d.ts +3 -0
- package/dist/browser/routes/tabs.d.ts +3 -0
- package/dist/browser/routes/tabs.js +36 -18
- package/dist/browser/routes/types.d.ts +15 -0
- package/dist/browser/routes/utils.d.ts +15 -0
- package/dist/browser/routes/utils.js +6 -3
- package/dist/browser/screenshot.d.ts +9 -0
- package/dist/browser/screenshot.js +1 -1
- package/dist/browser/server-context.d.ts +3 -0
- package/dist/browser/server-context.js +45 -27
- package/dist/browser/server-context.types.d.ts +78 -0
- package/dist/browser/server.d.ts +3 -0
- package/dist/browser/server.js +12 -7
- package/dist/browser/target-id.d.ts +11 -0
- package/dist/browser/target-id.js +8 -4
- package/dist/browser/trash.d.ts +1 -0
- package/dist/build-info.json +3 -3
- package/dist/canvas-host/a2ui/.bundle.hash +1 -1
- package/dist/canvas-host/a2ui/a2ui.bundle.js +38 -28
- package/dist/canvas-host/a2ui/index.html +28 -28
- package/dist/canvas-host/a2ui.d.ts +6 -0
- package/dist/canvas-host/a2ui.js +24 -22
- package/dist/canvas-host/server.d.ts +36 -0
- package/dist/canvas-host/server.js +72 -53
- package/dist/channels/ack-reactions.d.ts +29 -0
- package/dist/channels/ack-reactions.js +32 -16
- package/dist/channels/allowlist-match.d.ts +10 -0
- package/dist/channels/allowlists/resolve-utils.d.ts +6 -0
- package/dist/channels/allowlists/resolve-utils.js +4 -2
- package/dist/channels/channel-config.d.ts +39 -0
- package/dist/channels/channel-config.js +14 -7
- package/dist/channels/chat-type.d.ts +2 -0
- package/dist/channels/chat-type.js +8 -4
- package/dist/channels/command-gating.d.ts +20 -0
- package/dist/channels/command-gating.js +6 -3
- package/dist/channels/conversation-label.d.ts +2 -0
- package/dist/channels/conversation-label.js +24 -12
- package/dist/channels/dock.d.ts +36 -0
- package/dist/channels/dock.js +14 -8
- package/dist/channels/location.d.ts +21 -0
- package/dist/channels/location.js +2 -1
- package/dist/channels/logging.d.ts +20 -0
- package/dist/channels/mention-gating.d.ts +27 -0
- package/dist/channels/plugins/actions/discord/handle-action.d.ts +3 -0
- package/dist/channels/plugins/actions/discord/handle-action.guild-admin.d.ts +9 -0
- package/dist/channels/plugins/actions/discord/handle-action.js +7 -4
- package/dist/channels/plugins/actions/discord.d.ts +2 -0
- package/dist/channels/plugins/actions/discord.js +22 -11
- package/dist/channels/plugins/actions/signal.d.ts +2 -0
- package/dist/channels/plugins/actions/signal.js +16 -8
- package/dist/channels/plugins/actions/telegram.d.ts +2 -0
- package/dist/channels/plugins/actions/telegram.js +18 -9
- package/dist/channels/plugins/agent-tools/whatsapp-login.d.ts +2 -0
- package/dist/channels/plugins/allowlist-match.d.ts +2 -0
- package/dist/channels/plugins/bluebubbles-actions.d.ts +48 -0
- package/dist/channels/plugins/catalog.d.ts +35 -0
- package/dist/channels/plugins/catalog.js +34 -21
- package/dist/channels/plugins/channel-config.d.ts +2 -0
- package/dist/channels/plugins/config-helpers.d.ts +14 -0
- package/dist/channels/plugins/config-helpers.js +5 -3
- package/dist/channels/plugins/config-schema.d.ts +3 -0
- package/dist/channels/plugins/config-writes.d.ts +7 -0
- package/dist/channels/plugins/config-writes.js +8 -4
- package/dist/channels/plugins/directory-config.d.ts +16 -0
- package/dist/channels/plugins/directory-config.js +28 -15
- package/dist/channels/plugins/group-mentions.d.ts +28 -0
- package/dist/channels/plugins/group-mentions.js +36 -18
- package/dist/channels/plugins/helpers.d.ts +8 -0
- package/dist/channels/plugins/helpers.js +2 -2
- package/dist/channels/plugins/index.d.ts +8 -0
- package/dist/channels/plugins/index.js +8 -5
- package/dist/channels/plugins/load.d.ts +2 -0
- package/dist/channels/plugins/load.js +4 -2
- package/dist/channels/plugins/media-limits.d.ts +9 -0
- package/dist/channels/plugins/media-limits.js +2 -1
- package/dist/channels/plugins/message-action-names.d.ts +2 -0
- package/dist/channels/plugins/message-actions.d.ts +7 -0
- package/dist/channels/plugins/message-actions.js +10 -5
- package/dist/channels/plugins/normalize/discord.d.ts +2 -0
- package/dist/channels/plugins/normalize/discord.js +8 -4
- package/dist/channels/plugins/normalize/imessage.d.ts +2 -0
- package/dist/channels/plugins/normalize/imessage.js +14 -7
- package/dist/channels/plugins/normalize/signal.d.ts +2 -0
- package/dist/channels/plugins/normalize/signal.js +12 -6
- package/dist/channels/plugins/normalize/slack.d.ts +2 -0
- package/dist/channels/plugins/normalize/slack.js +10 -5
- package/dist/channels/plugins/normalize/telegram.d.ts +2 -0
- package/dist/channels/plugins/normalize/telegram.js +14 -7
- package/dist/channels/plugins/normalize/whatsapp.d.ts +2 -0
- package/dist/channels/plugins/normalize/whatsapp.js +8 -4
- package/dist/channels/plugins/onboarding/channel-access.d.ts +31 -0
- package/dist/channels/plugins/onboarding/channel-access.js +6 -4
- package/dist/channels/plugins/onboarding/discord.d.ts +2 -0
- package/dist/channels/plugins/onboarding/discord.js +11 -6
- package/dist/channels/plugins/onboarding/helpers.d.ts +3 -0
- package/dist/channels/plugins/onboarding/helpers.js +6 -4
- package/dist/channels/plugins/onboarding/imessage.d.ts +2 -0
- package/dist/channels/plugins/onboarding/imessage.js +13 -7
- package/dist/channels/plugins/onboarding/signal.d.ts +2 -0
- package/dist/channels/plugins/onboarding/signal.js +21 -12
- package/dist/channels/plugins/onboarding/slack.d.ts +2 -0
- package/dist/channels/plugins/onboarding/slack.js +11 -8
- package/dist/channels/plugins/onboarding/telegram.d.ts +2 -0
- package/dist/channels/plugins/onboarding/telegram.js +14 -9
- package/dist/channels/plugins/onboarding/whatsapp.d.ts +2 -0
- package/dist/channels/plugins/onboarding/whatsapp.js +27 -18
- package/dist/channels/plugins/onboarding-types.d.ts +77 -0
- package/dist/channels/plugins/outbound/discord.d.ts +2 -0
- package/dist/channels/plugins/outbound/imessage.d.ts +2 -0
- package/dist/channels/plugins/outbound/load.d.ts +2 -0
- package/dist/channels/plugins/outbound/load.js +4 -2
- package/dist/channels/plugins/outbound/signal.d.ts +2 -0
- package/dist/channels/plugins/outbound/slack.d.ts +2 -0
- package/dist/channels/plugins/outbound/telegram.d.ts +2 -0
- package/dist/channels/plugins/outbound/telegram.js +6 -3
- package/dist/channels/plugins/outbound/whatsapp.d.ts +2 -0
- package/dist/channels/plugins/outbound/whatsapp.js +1 -1
- package/dist/channels/plugins/pairing-message.d.ts +1 -0
- package/dist/channels/plugins/pairing-message.js +1 -1
- package/dist/channels/plugins/pairing.d.ts +16 -0
- package/dist/channels/plugins/pairing.js +2 -1
- package/dist/channels/plugins/setup-helpers.d.ts +13 -0
- package/dist/channels/plugins/setup-helpers.js +10 -5
- package/dist/channels/plugins/slack.actions.d.ts +2 -0
- package/dist/channels/plugins/slack.actions.js +12 -6
- package/dist/channels/plugins/status-issues/bluebubbles.d.ts +2 -0
- package/dist/channels/plugins/status-issues/bluebubbles.js +9 -5
- package/dist/channels/plugins/status-issues/discord.d.ts +2 -0
- package/dist/channels/plugins/status-issues/discord.js +18 -9
- package/dist/channels/plugins/status-issues/shared.d.ts +10 -0
- package/dist/channels/plugins/status-issues/telegram.d.ts +2 -0
- package/dist/channels/plugins/status-issues/telegram.js +14 -7
- package/dist/channels/plugins/status-issues/whatsapp.d.ts +2 -0
- package/dist/channels/plugins/status-issues/whatsapp.js +8 -5
- package/dist/channels/plugins/status.d.ts +10 -0
- package/dist/channels/plugins/types.adapters.d.ts +294 -0
- package/dist/channels/plugins/types.core.d.ts +311 -0
- package/dist/channels/plugins/types.d.ts +6 -0
- package/dist/channels/plugins/types.plugin.d.ts +53 -0
- package/dist/channels/plugins/whatsapp-heartbeat.d.ts +11 -0
- package/dist/channels/plugins/whatsapp-heartbeat.js +5 -3
- package/dist/channels/registry.d.ts +16 -0
- package/dist/channels/registry.js +8 -7
- package/dist/channels/reply-prefix.d.ts +15 -0
- package/dist/channels/sender-identity.d.ts +2 -0
- package/dist/channels/sender-identity.js +4 -2
- package/dist/channels/sender-label.d.ts +9 -0
- package/dist/channels/sender-label.js +14 -7
- package/dist/channels/session.d.ts +18 -0
- package/dist/channels/session.js +2 -1
- package/dist/channels/targets.d.ts +25 -0
- package/dist/channels/typing.d.ts +10 -0
- package/dist/channels/web/index.d.ts +1 -0
- package/dist/cli/acp-cli.d.ts +2 -0
- package/dist/cli/acp-cli.js +2 -2
- package/dist/cli/argv.d.ts +16 -0
- package/dist/cli/argv.js +40 -21
- package/dist/cli/banner.d.ts +12 -0
- package/dist/cli/banner.js +28 -20
- package/dist/cli/browser-cli-actions-input/register.d.ts +3 -0
- package/dist/cli/browser-cli-actions-input/register.element.d.ts +3 -0
- package/dist/cli/browser-cli-actions-input/register.element.js +6 -3
- package/dist/cli/browser-cli-actions-input/register.files-downloads.d.ts +3 -0
- package/dist/cli/browser-cli-actions-input/register.files-downloads.js +2 -2
- package/dist/cli/browser-cli-actions-input/register.form-wait-eval.d.ts +3 -0
- package/dist/cli/browser-cli-actions-input/register.navigation.d.ts +3 -0
- package/dist/cli/browser-cli-actions-input/shared.d.ts +19 -0
- package/dist/cli/browser-cli-actions-input/shared.js +4 -2
- package/dist/cli/browser-cli-actions-input.d.ts +1 -0
- package/dist/cli/browser-cli-actions-observe.d.ts +3 -0
- package/dist/cli/browser-cli-actions-observe.js +1 -1
- package/dist/cli/browser-cli-debug.d.ts +3 -0
- package/dist/cli/browser-cli-debug.js +1 -1
- package/dist/cli/browser-cli-examples.d.ts +2 -0
- package/dist/cli/browser-cli-examples.js +29 -29
- package/dist/cli/browser-cli-extension.d.ts +10 -0
- package/dist/cli/browser-cli-extension.js +8 -7
- package/dist/cli/browser-cli-inspect.d.ts +3 -0
- package/dist/cli/browser-cli-manage.d.ts +3 -0
- package/dist/cli/browser-cli-manage.js +4 -4
- package/dist/cli/browser-cli-shared.d.ts +16 -0
- package/dist/cli/browser-cli-shared.js +4 -2
- package/dist/cli/browser-cli-state.cookies-storage.d.ts +3 -0
- package/dist/cli/browser-cli-state.d.ts +3 -0
- package/dist/cli/browser-cli-state.js +2 -1
- package/dist/cli/browser-cli.d.ts +2 -0
- package/dist/cli/browser-cli.js +5 -5
- package/dist/cli/channel-auth.d.ts +9 -0
- package/dist/cli/channel-options.d.ts +2 -0
- package/dist/cli/channel-options.js +4 -3
- package/dist/cli/channels-cli.d.ts +2 -0
- package/dist/cli/channels-cli.js +2 -2
- package/dist/cli/cli-name.d.ts +3 -0
- package/dist/cli/cli-name.js +12 -12
- package/dist/cli/cli-utils.d.ts +18 -0
- package/dist/cli/cli-utils.js +11 -0
- package/dist/cli/command-format.d.ts +1 -0
- package/dist/cli/command-format.js +8 -6
- package/dist/cli/command-options.d.ts +2 -0
- package/dist/cli/completion-cli.d.ts +3 -0
- package/dist/cli/completion-cli.js +372 -0
- package/dist/cli/config-cli.d.ts +2 -0
- package/dist/cli/config-cli.js +46 -25
- package/dist/cli/cron-cli/register.cron-add.d.ts +4 -0
- package/dist/cli/cron-cli/register.cron-add.js +9 -5
- package/dist/cli/cron-cli/register.cron-edit.d.ts +2 -0
- package/dist/cli/cron-cli/register.cron-edit.js +27 -14
- package/dist/cli/cron-cli/register.cron-simple.d.ts +2 -0
- package/dist/cli/cron-cli/register.d.ts +2 -0
- package/dist/cli/cron-cli/register.js +1 -1
- package/dist/cli/cron-cli/shared.d.ts +7 -0
- package/dist/cli/cron-cli/shared.js +50 -25
- package/dist/cli/cron-cli.d.ts +1 -0
- package/dist/cli/daemon-cli/install.d.ts +2 -0
- package/dist/cli/daemon-cli/install.js +9 -6
- package/dist/cli/daemon-cli/lifecycle.d.ts +10 -0
- package/dist/cli/daemon-cli/lifecycle.js +25 -13
- package/dist/cli/daemon-cli/probe.d.ts +14 -0
- package/dist/cli/daemon-cli/register.d.ts +2 -0
- package/dist/cli/daemon-cli/register.js +1 -1
- package/dist/cli/daemon-cli/response.d.ts +26 -0
- package/dist/cli/daemon-cli/runners.d.ts +3 -0
- package/dist/cli/daemon-cli/shared.d.ts +22 -0
- package/dist/cli/daemon-cli/shared.js +51 -33
- package/dist/cli/daemon-cli/status.d.ts +2 -0
- package/dist/cli/daemon-cli/status.gather.d.ts +89 -0
- package/dist/cli/daemon-cli/status.gather.js +9 -9
- package/dist/cli/daemon-cli/status.print.d.ts +4 -0
- package/dist/cli/daemon-cli/status.print.js +13 -19
- package/dist/cli/daemon-cli/types.d.ts +23 -0
- package/dist/cli/daemon-cli.d.ts +3 -0
- package/dist/cli/deps.d.ts +18 -0
- package/dist/cli/devices-cli.d.ts +2 -0
- package/dist/cli/devices-cli.js +10 -6
- package/dist/cli/directory-cli.d.ts +2 -0
- package/dist/cli/directory-cli.js +22 -12
- package/dist/cli/dns-cli.d.ts +2 -0
- package/dist/cli/dns-cli.js +30 -18
- package/dist/cli/docs-cli.d.ts +2 -0
- package/dist/cli/docs-cli.js +2 -2
- package/dist/cli/exec-approvals-cli.d.ts +2 -0
- package/dist/cli/exec-approvals-cli.js +17 -11
- package/dist/cli/gateway-cli/call.d.ts +11 -0
- package/dist/cli/gateway-cli/dev.d.ts +3 -0
- package/dist/cli/gateway-cli/dev.js +15 -9
- package/dist/cli/gateway-cli/discover.d.ts +10 -0
- package/dist/cli/gateway-cli/discover.js +6 -3
- package/dist/cli/gateway-cli/register.d.ts +2 -0
- package/dist/cli/gateway-cli/register.js +38 -20
- package/dist/cli/gateway-cli/run-loop.d.ts +6 -0
- package/dist/cli/gateway-cli/run.d.ts +2 -0
- package/dist/cli/gateway-cli/run.js +13 -12
- package/dist/cli/gateway-cli/shared.d.ts +9 -0
- package/dist/cli/gateway-cli/shared.js +25 -15
- package/dist/cli/gateway-cli.d.ts +1 -0
- package/dist/cli/gateway-rpc.d.ts +13 -0
- package/dist/cli/help-format.d.ts +5 -0
- package/dist/cli/help-format.js +2 -1
- package/dist/cli/hooks-cli.d.ts +32 -0
- package/dist/cli/hooks-cli.js +25 -16
- package/dist/cli/logs-cli.d.ts +2 -0
- package/dist/cli/logs-cli.js +19 -11
- package/dist/cli/memory-cli.d.ts +11 -0
- package/dist/cli/memory-cli.js +63 -19
- package/dist/cli/models-cli.d.ts +2 -0
- package/dist/cli/models-cli.js +21 -9
- package/dist/cli/node-cli/daemon.d.ts +24 -0
- package/dist/cli/node-cli/daemon.js +37 -21
- package/dist/cli/node-cli/register.d.ts +2 -0
- package/dist/cli/node-cli/register.js +4 -4
- package/dist/cli/node-cli.d.ts +1 -0
- package/dist/cli/nodes-camera.d.ts +26 -0
- package/dist/cli/nodes-canvas.d.ts +10 -0
- package/dist/cli/nodes-cli/a2ui-jsonl.d.ts +6 -0
- package/dist/cli/nodes-cli/a2ui-jsonl.js +2 -1
- package/dist/cli/nodes-cli/cli-utils.d.ts +9 -0
- package/dist/cli/nodes-cli/cli-utils.js +2 -1
- package/dist/cli/nodes-cli/format.d.ts +5 -0
- package/dist/cli/nodes-cli/format.js +11 -6
- package/dist/cli/nodes-cli/register.camera.d.ts +2 -0
- package/dist/cli/nodes-cli/register.camera.js +8 -7
- package/dist/cli/nodes-cli/register.canvas.d.ts +2 -0
- package/dist/cli/nodes-cli/register.canvas.js +9 -6
- package/dist/cli/nodes-cli/register.d.ts +2 -0
- package/dist/cli/nodes-cli/register.invoke.d.ts +2 -0
- package/dist/cli/nodes-cli/register.invoke.js +20 -13
- package/dist/cli/nodes-cli/register.js +1 -1
- package/dist/cli/nodes-cli/register.location.d.ts +2 -0
- package/dist/cli/nodes-cli/register.location.js +1 -1
- package/dist/cli/nodes-cli/register.notify.d.ts +2 -0
- package/dist/cli/nodes-cli/register.pairing.d.ts +2 -0
- package/dist/cli/nodes-cli/register.pairing.js +3 -3
- package/dist/cli/nodes-cli/register.screen.d.ts +2 -0
- package/dist/cli/nodes-cli/register.screen.js +2 -2
- package/dist/cli/nodes-cli/register.status.d.ts +2 -0
- package/dist/cli/nodes-cli/register.status.js +51 -35
- package/dist/cli/nodes-cli/rpc.d.ts +8 -0
- package/dist/cli/nodes-cli/rpc.js +14 -8
- package/dist/cli/nodes-cli/types.d.ts +92 -0
- package/dist/cli/nodes-cli.d.ts +1 -0
- package/dist/cli/nodes-run.d.ts +3 -0
- package/dist/cli/nodes-run.js +8 -4
- package/dist/cli/nodes-screen.d.ts +18 -0
- package/dist/cli/nodes-screen.js +1 -1
- package/dist/cli/outbound-send-deps.d.ts +10 -0
- package/dist/cli/pairing-cli.d.ts +2 -0
- package/dist/cli/pairing-cli.js +10 -7
- package/dist/cli/parse-duration.d.ts +4 -0
- package/dist/cli/parse-duration.js +6 -3
- package/dist/cli/parse-timeout.d.ts +1 -0
- package/dist/cli/parse-timeout.js +4 -2
- package/dist/cli/plugin-registry.d.ts +1 -0
- package/dist/cli/plugin-registry.js +4 -3
- package/dist/cli/plugins-cli.d.ts +14 -0
- package/dist/cli/plugins-cli.js +27 -15
- package/dist/cli/ports.d.ts +20 -0
- package/dist/cli/ports.js +10 -7
- package/dist/cli/profile-utils.d.ts +2 -0
- package/dist/cli/profile-utils.js +8 -4
- package/dist/cli/profile.d.ts +14 -0
- package/dist/cli/profile.js +20 -14
- package/dist/cli/program/build-program.d.ts +2 -0
- package/dist/cli/program/build-program.js +1 -1
- package/dist/cli/program/command-registry.d.ts +21 -0
- package/dist/cli/program/command-registry.js +14 -7
- package/dist/cli/program/config-guard.d.ts +5 -0
- package/dist/cli/program/config-guard.js +5 -4
- package/dist/cli/program/context.d.ts +7 -0
- package/dist/cli/program/help.d.ts +3 -0
- package/dist/cli/program/help.js +18 -13
- package/dist/cli/program/helpers.d.ts +3 -0
- package/dist/cli/program/helpers.js +8 -4
- package/dist/cli/program/message/helpers.d.ts +8 -0
- package/dist/cli/program/message/helpers.js +1 -1
- package/dist/cli/program/message/register.broadcast.d.ts +3 -0
- package/dist/cli/program/message/register.discord-admin.d.ts +3 -0
- package/dist/cli/program/message/register.emoji-sticker.d.ts +4 -0
- package/dist/cli/program/message/register.permissions-search.d.ts +4 -0
- package/dist/cli/program/message/register.pins.d.ts +3 -0
- package/dist/cli/program/message/register.poll.d.ts +3 -0
- package/dist/cli/program/message/register.reactions.d.ts +3 -0
- package/dist/cli/program/message/register.read-edit-delete.d.ts +3 -0
- package/dist/cli/program/message/register.send.d.ts +3 -0
- package/dist/cli/program/message/register.thread.d.ts +3 -0
- package/dist/cli/program/preaction.d.ts +2 -0
- package/dist/cli/program/preaction.js +13 -9
- package/dist/cli/program/register.agent.d.ts +4 -0
- package/dist/cli/program/register.agent.js +17 -14
- package/dist/cli/program/register.configure.d.ts +2 -0
- package/dist/cli/program/register.configure.js +1 -1
- package/dist/cli/program/register.maintenance.d.ts +2 -0
- package/dist/cli/program/register.maintenance.js +4 -4
- package/dist/cli/program/register.message.d.ts +3 -0
- package/dist/cli/program/register.message.js +6 -6
- package/dist/cli/program/register.onboard.d.ts +2 -0
- package/dist/cli/program/register.onboard.js +12 -7
- package/dist/cli/program/register.setup.d.ts +2 -0
- package/dist/cli/program/register.setup.js +4 -4
- package/dist/cli/program/register.status-health-sessions.d.ts +2 -0
- package/dist/cli/program/register.status-health-sessions.js +13 -13
- package/dist/cli/program/register.subclis.d.ts +11 -0
- package/dist/cli/program/register.subclis.js +25 -5
- package/dist/cli/program.d.ts +2 -0
- package/dist/cli/progress.d.ts +24 -0
- package/dist/cli/progress.js +31 -16
- package/dist/cli/prompt.d.ts +1 -0
- package/dist/cli/prompt.js +7 -4
- package/dist/cli/route.d.ts +1 -0
- package/dist/cli/route.js +12 -8
- package/dist/cli/run-main.d.ts +3 -0
- package/dist/cli/run-main.js +16 -10
- package/dist/cli/sandbox-cli.d.ts +2 -0
- package/dist/cli/sandbox-cli.js +20 -20
- package/dist/cli/security-cli.d.ts +2 -0
- package/dist/cli/security-cli.js +21 -13
- package/dist/cli/skills-cli.d.ts +29 -0
- package/dist/cli/skills-cli.js +17 -13
- package/dist/cli/system-cli.d.ts +2 -0
- package/dist/cli/system-cli.js +11 -6
- package/dist/cli/tagline.d.ts +12 -0
- package/dist/cli/tagline.js +22 -15
- package/dist/cli/tui-cli.d.ts +2 -0
- package/dist/cli/tui-cli.js +1 -1
- package/dist/cli/update-cli.d.ts +20 -0
- package/dist/cli/update-cli.js +97 -74
- package/dist/cli/wait.d.ts +1 -0
- package/dist/cli/webhooks-cli.d.ts +2 -0
- package/dist/cli/webhooks-cli.js +17 -12
- package/dist/commands/agent/delivery.d.ts +19 -0
- package/dist/commands/agent/delivery.js +27 -14
- package/dist/commands/agent/run-context.d.ts +2 -0
- package/dist/commands/agent/run-context.js +10 -5
- package/dist/commands/agent/session-store.d.ts +17 -0
- package/dist/commands/agent/session-store.js +2 -1
- package/dist/commands/agent/session.d.ts +33 -0
- package/dist/commands/agent/session.js +2 -1
- package/dist/commands/agent/types.d.ts +75 -0
- package/dist/commands/agent-via-gateway.d.ts +42 -0
- package/dist/commands/agent-via-gateway.js +12 -8
- package/dist/commands/agent.d.ts +7 -0
- package/dist/commands/agent.js +12 -9
- package/dist/commands/agents.bindings.d.ts +27 -0
- package/dist/commands/agents.bindings.js +14 -7
- package/dist/commands/agents.command-shared.d.ts +4 -0
- package/dist/commands/agents.command-shared.js +1 -1
- package/dist/commands/agents.commands.add.d.ts +14 -0
- package/dist/commands/agents.commands.add.js +11 -7
- package/dist/commands/agents.commands.delete.d.ts +8 -0
- package/dist/commands/agents.commands.delete.js +4 -2
- package/dist/commands/agents.commands.identity.d.ts +14 -0
- package/dist/commands/agents.commands.identity.js +12 -6
- package/dist/commands/agents.commands.list.d.ts +7 -0
- package/dist/commands/agents.commands.list.js +12 -7
- package/dist/commands/agents.config.d.ts +37 -0
- package/dist/commands/agents.config.js +8 -4
- package/dist/commands/agents.d.ts +6 -0
- package/dist/commands/agents.providers.d.ts +20 -0
- package/dist/commands/agents.providers.js +12 -6
- package/dist/commands/auth-choice-options.d.ts +25 -0
- package/dist/commands/auth-choice-options.js +49 -34
- package/dist/commands/auth-choice-prompt.d.ts +8 -0
- package/dist/commands/auth-choice-prompt.js +2 -2
- package/dist/commands/auth-choice.api-key.d.ts +6 -0
- package/dist/commands/auth-choice.api-key.js +4 -2
- package/dist/commands/auth-choice.apply.anthropic.d.ts +2 -0
- package/dist/commands/auth-choice.apply.api-providers.d.ts +2 -0
- package/dist/commands/auth-choice.apply.api-providers.js +69 -16
- package/dist/commands/auth-choice.apply.copilot-proxy.d.ts +2 -0
- package/dist/commands/auth-choice.apply.d.ts +22 -0
- package/dist/commands/auth-choice.apply.github-copilot.d.ts +2 -0
- package/dist/commands/auth-choice.apply.github-copilot.js +2 -1
- package/dist/commands/auth-choice.apply.google-antigravity.d.ts +2 -0
- package/dist/commands/auth-choice.apply.google-gemini-cli.d.ts +2 -0
- package/dist/commands/auth-choice.apply.js +2 -1
- package/dist/commands/auth-choice.apply.minimax.d.ts +2 -0
- package/dist/commands/auth-choice.apply.minimax.js +20 -1
- package/dist/commands/auth-choice.apply.oauth.d.ts +2 -0
- package/dist/commands/auth-choice.apply.oauth.js +2 -2
- package/dist/commands/auth-choice.apply.openai.d.ts +2 -0
- package/dist/commands/auth-choice.apply.openai.js +4 -3
- package/dist/commands/auth-choice.apply.plugin-provider.d.ts +9 -0
- package/dist/commands/auth-choice.apply.plugin-provider.js +8 -6
- package/dist/commands/auth-choice.apply.qwen-portal.d.ts +2 -0
- package/dist/commands/auth-choice.d.ts +3 -0
- package/dist/commands/auth-choice.default-model.d.ts +15 -0
- package/dist/commands/auth-choice.model-check.d.ts +6 -0
- package/dist/commands/auth-choice.preferred-provider.d.ts +2 -0
- package/dist/commands/auth-choice.preferred-provider.js +3 -1
- package/dist/commands/auth-token.d.ts +9 -0
- package/dist/commands/auth-token.js +4 -2
- package/dist/commands/channels/add-mutators.d.ts +46 -0
- package/dist/commands/channels/add-mutators.js +2 -1
- package/dist/commands/channels/add.d.ts +39 -0
- package/dist/commands/channels/add.js +10 -5
- package/dist/commands/channels/capabilities.d.ts +9 -0
- package/dist/commands/channels/capabilities.js +51 -26
- package/dist/commands/channels/list.d.ts +6 -0
- package/dist/commands/channels/list.js +8 -4
- package/dist/commands/channels/logs.d.ts +7 -0
- package/dist/commands/channels/logs.js +15 -8
- package/dist/commands/channels/remove.d.ts +9 -0
- package/dist/commands/channels/remove.js +8 -6
- package/dist/commands/channels/resolve.d.ts +9 -0
- package/dist/commands/channels/resolve.js +15 -8
- package/dist/commands/channels/shared.d.ts +20 -0
- package/dist/commands/channels/shared.js +3 -2
- package/dist/commands/channels/status.d.ts +8 -0
- package/dist/commands/channels/status.js +18 -10
- package/dist/commands/channels.d.ts +14 -0
- package/dist/commands/chutes-oauth.d.ts +21 -0
- package/dist/commands/chutes-oauth.js +15 -8
- package/dist/commands/cleanup-utils.d.ts +13 -0
- package/dist/commands/cleanup-utils.js +8 -4
- package/dist/commands/configure.channels.d.ts +3 -0
- package/dist/commands/configure.channels.js +6 -4
- package/dist/commands/configure.commands.d.ts +4 -0
- package/dist/commands/configure.d.ts +4 -0
- package/dist/commands/configure.daemon.d.ts +8 -0
- package/dist/commands/configure.daemon.js +6 -5
- package/dist/commands/configure.gateway-auth.d.ts +12 -0
- package/dist/commands/configure.gateway-auth.js +3 -2
- package/dist/commands/configure.gateway.d.ts +7 -0
- package/dist/commands/configure.gateway.js +9 -6
- package/dist/commands/configure.shared.d.ts +18 -0
- package/dist/commands/configure.wizard.d.ts +3 -0
- package/dist/commands/configure.wizard.js +25 -24
- package/dist/commands/daemon-install-helpers.d.ts +22 -0
- package/dist/commands/daemon-install-helpers.js +6 -5
- package/dist/commands/daemon-runtime.d.ts +8 -0
- package/dist/commands/dashboard.d.ts +6 -0
- package/dist/commands/dashboard.js +2 -2
- package/dist/commands/docs.d.ts +2 -0
- package/dist/commands/docs.js +18 -12
- package/dist/commands/doctor-auth.d.ts +9 -0
- package/dist/commands/doctor-auth.js +28 -17
- package/dist/commands/doctor-config-flow.d.ts +13 -0
- package/dist/commands/doctor-config-flow.js +76 -43
- package/dist/commands/doctor-format.d.ts +8 -0
- package/dist/commands/doctor-format.js +22 -14
- package/dist/commands/doctor-gateway-daemon-flow.d.ts +11 -0
- package/dist/commands/doctor-gateway-daemon-flow.js +27 -16
- package/dist/commands/doctor-gateway-health.d.ts +9 -0
- package/dist/commands/doctor-gateway-health.js +1 -1
- package/dist/commands/doctor-gateway-services.d.ts +5 -0
- package/dist/commands/doctor-gateway-services.js +92 -75
- package/dist/commands/doctor-install.d.ts +1 -0
- package/dist/commands/doctor-install.js +4 -2
- package/dist/commands/doctor-legacy-config.d.ts +5 -0
- package/dist/commands/doctor-platform-notes.d.ts +11 -0
- package/dist/commands/doctor-platform-notes.js +61 -13
- package/dist/commands/doctor-prompter.d.ts +24 -0
- package/dist/commands/doctor-prompter.js +26 -15
- package/dist/commands/doctor-sandbox.d.ts +5 -0
- package/dist/commands/doctor-sandbox.js +16 -10
- package/dist/commands/doctor-security.d.ts +2 -0
- package/dist/commands/doctor-security.js +16 -12
- package/dist/commands/doctor-state-integrity.d.ts +10 -0
- package/dist/commands/doctor-state-integrity.js +40 -22
- package/dist/commands/doctor-state-migrations.d.ts +2 -0
- package/dist/commands/doctor-ui.d.ts +3 -0
- package/dist/commands/doctor-ui.js +6 -4
- package/dist/commands/doctor-update.d.ts +18 -0
- package/dist/commands/doctor-update.js +13 -10
- package/dist/commands/doctor-workspace-status.d.ts +4 -0
- package/dist/commands/doctor-workspace-status.js +2 -2
- package/dist/commands/doctor-workspace.d.ts +10 -0
- package/dist/commands/doctor-workspace.js +7 -28
- package/dist/commands/doctor.d.ts +3 -0
- package/dist/commands/doctor.js +15 -14
- package/dist/commands/gateway-status/helpers.d.ts +72 -0
- package/dist/commands/gateway-status/helpers.js +26 -14
- package/dist/commands/gateway-status.d.ts +11 -0
- package/dist/commands/gateway-status.js +39 -18
- package/dist/commands/google-gemini-model-default.d.ts +6 -0
- package/dist/commands/google-gemini-model-default.js +2 -1
- package/dist/commands/health-format.d.ts +3 -0
- package/dist/commands/health-format.js +4 -2
- package/dist/commands/health.d.ts +63 -0
- package/dist/commands/health.js +70 -37
- package/dist/commands/message-format.d.ts +11 -0
- package/dist/commands/message-format.js +34 -17
- package/dist/commands/message.d.ts +3 -0
- package/dist/commands/model-picker.d.ts +31 -0
- package/dist/commands/model-picker.js +69 -35
- package/dist/commands/models/aliases.d.ts +7 -0
- package/dist/commands/models/aliases.js +2 -1
- package/dist/commands/models/auth-order.d.ts +15 -0
- package/dist/commands/models/auth-order.js +12 -7
- package/dist/commands/models/auth.d.ts +18 -0
- package/dist/commands/models/auth.js +22 -15
- package/dist/commands/models/fallbacks.d.ts +8 -0
- package/dist/commands/models/fallbacks.js +10 -5
- package/dist/commands/models/image-fallbacks.d.ts +8 -0
- package/dist/commands/models/image-fallbacks.js +10 -5
- package/dist/commands/models/list.auth-overview.d.ts +9 -0
- package/dist/commands/models/list.auth-overview.js +4 -2
- package/dist/commands/models/list.configured.d.ts +5 -0
- package/dist/commands/models/list.configured.js +8 -4
- package/dist/commands/models/list.d.ts +2 -0
- package/dist/commands/models/list.format.d.ts +12 -0
- package/dist/commands/models/list.format.js +24 -12
- package/dist/commands/models/list.list-command.d.ts +8 -0
- package/dist/commands/models/list.list-command.js +11 -6
- package/dist/commands/models/list.probe.d.ts +49 -0
- package/dist/commands/models/list.probe.js +42 -24
- package/dist/commands/models/list.registry.d.ts +18 -0
- package/dist/commands/models/list.registry.js +17 -11
- package/dist/commands/models/list.status-command.d.ts +13 -0
- package/dist/commands/models/list.status-command.js +91 -49
- package/dist/commands/models/list.table.d.ts +6 -0
- package/dist/commands/models/list.table.js +2 -1
- package/dist/commands/models/list.types.d.ts +41 -0
- package/dist/commands/models/scan.d.ts +15 -0
- package/dist/commands/models/scan.js +26 -14
- package/dist/commands/models/set-image.d.ts +2 -0
- package/dist/commands/models/set-image.js +2 -1
- package/dist/commands/models/set.d.ts +2 -0
- package/dist/commands/models/set.js +2 -1
- package/dist/commands/models/shared.d.ts +34 -0
- package/dist/commands/models/shared.js +29 -7
- package/dist/commands/models.d.ts +10 -0
- package/dist/commands/node-daemon-install-helpers.d.ts +22 -0
- package/dist/commands/node-daemon-install-helpers.js +3 -2
- package/dist/commands/node-daemon-runtime.d.ts +9 -0
- package/dist/commands/oauth-env.d.ts +1 -0
- package/dist/commands/oauth-flow.d.ts +21 -0
- package/dist/commands/oauth-flow.js +2 -1
- package/dist/commands/onboard-auth.config-core.d.ts +31 -0
- package/dist/commands/onboard-auth.config-core.js +70 -26
- package/dist/commands/onboard-auth.config-minimax.d.ts +11 -0
- package/dist/commands/onboard-auth.config-opencode.d.ts +3 -0
- package/dist/commands/onboard-auth.credentials.d.ts +18 -0
- package/dist/commands/onboard-auth.credentials.js +19 -7
- package/dist/commands/onboard-auth.d.ts +7 -0
- package/dist/commands/onboard-auth.js +3 -3
- package/dist/commands/onboard-auth.models.d.ts +48 -0
- package/dist/commands/onboard-auth.models.js +2 -26
- package/dist/commands/onboard-channels.d.ts +12 -0
- package/dist/commands/onboard-channels.js +45 -28
- package/dist/commands/onboard-helpers.d.ts +81 -0
- package/dist/commands/onboard-helpers.js +57 -30
- package/dist/commands/onboard-hooks.d.ts +4 -0
- package/dist/commands/onboard-hooks.js +5 -5
- package/dist/commands/onboard-interactive.d.ts +3 -0
- package/dist/commands/onboard-non-interactive/api-keys.d.ts +16 -0
- package/dist/commands/onboard-non-interactive/api-keys.js +10 -5
- package/dist/commands/onboard-non-interactive/local/auth-choice.d.ts +10 -0
- package/dist/commands/onboard-non-interactive/local/auth-choice.js +79 -32
- package/dist/commands/onboard-non-interactive/local/daemon-install.d.ts +10 -0
- package/dist/commands/onboard-non-interactive/local/daemon-install.js +3 -2
- package/dist/commands/onboard-non-interactive/local/gateway-config.d.ts +17 -0
- package/dist/commands/onboard-non-interactive/local/gateway-config.js +6 -3
- package/dist/commands/onboard-non-interactive/local/output.d.ts +19 -0
- package/dist/commands/onboard-non-interactive/local/output.js +2 -1
- package/dist/commands/onboard-non-interactive/local/skills-config.d.ts +8 -0
- package/dist/commands/onboard-non-interactive/local/skills-config.js +2 -1
- package/dist/commands/onboard-non-interactive/local/workspace.d.ts +7 -0
- package/dist/commands/onboard-non-interactive/local.d.ts +8 -0
- package/dist/commands/onboard-non-interactive/local.js +6 -4
- package/dist/commands/onboard-non-interactive/remote.d.ts +8 -0
- package/dist/commands/onboard-non-interactive/remote.js +2 -2
- package/dist/commands/onboard-non-interactive.d.ts +3 -0
- package/dist/commands/onboard-non-interactive.js +1 -1
- package/dist/commands/onboard-remote.d.ts +3 -0
- package/dist/commands/onboard-remote.js +11 -6
- package/dist/commands/onboard-skills.d.ts +4 -0
- package/dist/commands/onboard-skills.js +20 -11
- package/dist/commands/onboard-types.d.ts +62 -0
- package/dist/commands/onboard.d.ts +4 -0
- package/dist/commands/onboard.js +4 -4
- package/dist/commands/onboarding/__tests__/test-utils.d.ts +4 -0
- package/dist/commands/onboarding/plugin-install.d.ts +21 -0
- package/dist/commands/onboarding/plugin-install.js +15 -9
- package/dist/commands/onboarding/registry.d.ts +6 -0
- package/dist/commands/onboarding/registry.js +1 -1
- package/dist/commands/onboarding/types.d.ts +1 -0
- package/dist/commands/openai-codex-model-default.d.ts +6 -0
- package/dist/commands/openai-codex-model-default.js +8 -4
- package/dist/commands/opencode-zen-model-default.d.ts +6 -0
- package/dist/commands/opencode-zen-model-default.js +2 -1
- package/dist/commands/reset.d.ts +9 -0
- package/dist/commands/reset.js +8 -6
- package/dist/commands/sandbox-display.d.ts +13 -0
- package/dist/commands/sandbox-display.js +1 -1
- package/dist/commands/sandbox-explain.d.ts +8 -0
- package/dist/commands/sandbox-explain.js +26 -14
- package/dist/commands/sandbox-formatters.d.ts +25 -0
- package/dist/commands/sandbox-formatters.js +6 -3
- package/dist/commands/sandbox.d.ts +15 -0
- package/dist/commands/sessions.d.ts +6 -0
- package/dist/commands/sessions.js +37 -19
- package/dist/commands/setup.d.ts +4 -0
- package/dist/commands/setup.js +1 -1
- package/dist/commands/signal-install.d.ts +8 -0
- package/dist/commands/signal-install.js +4 -3
- package/dist/commands/status-all/agents.d.ts +16 -0
- package/dist/commands/status-all/channels.d.ts +19 -0
- package/dist/commands/status-all/channels.js +58 -30
- package/dist/commands/status-all/diagnosis.d.ts +62 -0
- package/dist/commands/status-all/diagnosis.js +9 -5
- package/dist/commands/status-all/format.d.ts +7 -0
- package/dist/commands/status-all/format.js +20 -10
- package/dist/commands/status-all/gateway.d.ts +10 -0
- package/dist/commands/status-all/gateway.js +20 -10
- package/dist/commands/status-all/report-lines.d.ts +44 -0
- package/dist/commands/status-all/report-lines.js +7 -4
- package/dist/commands/status-all.d.ts +4 -0
- package/dist/commands/status-all.js +51 -31
- package/dist/commands/status.agent-local.d.ts +16 -0
- package/dist/commands/status.command.d.ts +9 -0
- package/dist/commands/status.command.js +53 -34
- package/dist/commands/status.d.ts +3 -0
- package/dist/commands/status.daemon.d.ts +9 -0
- package/dist/commands/status.daemon.js +1 -1
- package/dist/commands/status.format.d.ts +13 -0
- package/dist/commands/status.format.js +22 -11
- package/dist/commands/status.gateway-probe.d.ts +11 -0
- package/dist/commands/status.gateway-probe.js +6 -4
- package/dist/commands/status.link-channel.d.ts +10 -0
- package/dist/commands/status.link-channel.js +2 -1
- package/dist/commands/status.scan.d.ts +46 -0
- package/dist/commands/status.scan.js +11 -7
- package/dist/commands/status.summary.d.ts +2 -0
- package/dist/commands/status.summary.js +23 -12
- package/dist/commands/status.types.d.ts +58 -0
- package/dist/commands/status.update.d.ts +16 -0
- package/dist/commands/status.update.js +26 -15
- package/dist/commands/systemd-linger.d.ts +21 -0
- package/dist/commands/systemd-linger.js +12 -6
- package/dist/commands/uninstall.d.ts +12 -0
- package/dist/commands/uninstall.js +17 -11
- package/dist/compat/legacy-names.d.ts +8 -0
- package/dist/compat/legacy-names.js +8 -6
- package/dist/config/agent-dirs.d.ts +14 -0
- package/dist/config/agent-dirs.js +4 -2
- package/dist/config/agent-limits.d.ts +5 -0
- package/dist/config/cache-utils.d.ts +6 -0
- package/dist/config/channel-capabilities.d.ts +6 -0
- package/dist/config/channel-capabilities.js +6 -3
- package/dist/config/commands.d.ts +16 -0
- package/dist/config/commands.js +18 -9
- package/dist/config/config-paths.d.ts +10 -0
- package/dist/config/config-paths.js +6 -3
- package/dist/config/config.d.ts +7 -0
- package/dist/config/config.js +1 -1
- package/dist/config/defaults.d.ts +18 -0
- package/dist/config/defaults.js +75 -38
- package/dist/config/env-substitution.d.ts +35 -0
- package/dist/config/env-vars.d.ts +2 -0
- package/dist/config/env-vars.js +8 -4
- package/dist/config/group-policy.d.ts +44 -0
- package/dist/config/group-policy.js +28 -14
- package/dist/config/includes.d.ts +32 -0
- package/dist/config/includes.js +1 -1
- package/dist/config/io.d.ts +36 -0
- package/dist/config/io.js +37 -23
- package/dist/config/legacy-migrate.d.ts +5 -0
- package/dist/config/legacy-migrate.js +2 -1
- package/dist/config/legacy.d.ts +6 -0
- package/dist/config/legacy.js +6 -3
- package/dist/config/legacy.migrations.d.ts +1 -0
- package/dist/config/legacy.migrations.part-1.d.ts +2 -0
- package/dist/config/legacy.migrations.part-1.js +66 -33
- package/dist/config/legacy.migrations.part-2.d.ts +2 -0
- package/dist/config/legacy.migrations.part-2.js +36 -18
- package/dist/config/legacy.migrations.part-3.d.ts +2 -0
- package/dist/config/legacy.migrations.part-3.js +20 -10
- package/dist/config/legacy.rules.d.ts +2 -0
- package/dist/config/legacy.shared.d.ts +18 -0
- package/dist/config/legacy.shared.js +22 -11
- package/dist/config/logging.d.ts +8 -0
- package/dist/config/markdown-tables.d.ts +7 -0
- package/dist/config/markdown-tables.js +8 -4
- package/dist/config/merge-config.d.ts +7 -0
- package/dist/config/merge-patch.d.ts +1 -0
- package/dist/config/normalize-paths.d.ts +8 -0
- package/dist/config/normalize-paths.js +16 -8
- package/dist/config/paths.d.ts +57 -0
- package/dist/config/paths.js +79 -59
- package/dist/config/plugin-auto-enable.d.ts +10 -0
- package/dist/config/plugin-auto-enable.js +79 -40
- package/dist/config/port-defaults.d.ts +13 -0
- package/dist/config/port-defaults.js +2 -1
- package/dist/config/runtime-overrides.d.ts +15 -0
- package/dist/config/runtime-overrides.js +6 -3
- package/dist/config/schema.d.ts +39 -0
- package/dist/config/schema.js +53 -29
- package/dist/config/sessions/group.d.ts +11 -0
- package/dist/config/sessions/group.js +12 -6
- package/dist/config/sessions/main-session.d.ts +43 -0
- package/dist/config/sessions/main-session.js +10 -5
- package/dist/config/sessions/metadata.d.ts +16 -0
- package/dist/config/sessions/metadata.js +50 -25
- package/dist/config/sessions/paths.d.ts +11 -0
- package/dist/config/sessions/paths.js +4 -2
- package/dist/config/sessions/reset.d.ts +43 -0
- package/dist/config/sessions/reset.js +29 -15
- package/dist/config/sessions/session-key.d.ts +8 -0
- package/dist/config/sessions/session-key.js +10 -5
- package/dist/config/sessions/store.d.ts +38 -0
- package/dist/config/sessions/store.js +32 -15
- package/dist/config/sessions/transcript.d.ts +18 -0
- package/dist/config/sessions/transcript.js +20 -12
- package/dist/config/sessions/types.d.ts +146 -0
- package/dist/config/sessions/types.js +2 -1
- package/dist/config/sessions.d.ts +9 -0
- package/dist/config/talk.d.ts +11 -0
- package/dist/config/talk.js +6 -3
- package/dist/config/telegram-custom-commands.d.ts +24 -0
- package/dist/config/telegram-custom-commands.js +2 -1
- package/dist/config/types.agent-defaults.d.ts +248 -0
- package/dist/config/types.agents.d.ts +75 -0
- package/dist/config/types.approvals.d.ts +26 -0
- package/dist/config/types.auth.d.ts +28 -0
- package/dist/config/types.base.d.ts +149 -0
- package/dist/config/types.browser.d.ts +41 -0
- package/dist/config/types.channels.d.ts +34 -0
- package/dist/config/types.cron.d.ts +5 -0
- package/dist/config/types.d.ts +28 -0
- package/dist/config/types.discord.d.ts +145 -0
- package/dist/config/types.gateway.d.ts +220 -0
- package/dist/config/types.googlechat.d.ts +98 -0
- package/dist/config/types.hooks.d.ts +106 -0
- package/dist/config/types.imessage.d.ts +67 -0
- package/dist/config/types.js +1 -1
- package/dist/config/types.messages.d.ts +104 -0
- package/dist/config/types.models.d.ts +47 -0
- package/dist/config/types.msteams.d.ts +94 -0
- package/dist/config/types.node-host.d.ts +10 -0
- package/dist/config/types.openclaw.d.ts +106 -0
- package/dist/config/types.openclaw.js +1 -0
- package/dist/config/types.plugins.d.ts +32 -0
- package/dist/config/types.queue.d.ts +13 -0
- package/dist/config/types.sandbox.d.ts +76 -0
- package/dist/config/types.signal.d.ts +84 -0
- package/dist/config/types.skills.d.ts +28 -0
- package/dist/config/types.slack.d.ts +136 -0
- package/dist/config/types.telegram.d.ts +148 -0
- package/dist/config/types.tools.d.ts +435 -0
- package/dist/config/types.tts.d.ts +78 -0
- package/dist/config/types.whatsapp.d.ts +147 -0
- package/dist/config/validation.d.ts +17 -0
- package/dist/config/validation.js +32 -17
- package/dist/config/version.d.ts +8 -0
- package/dist/config/version.js +18 -11
- package/dist/config/zod-schema.agent-defaults.d.ts +242 -0
- package/dist/config/zod-schema.agent-runtime.d.ts +812 -0
- package/dist/config/zod-schema.agent-runtime.js +7 -3
- package/dist/config/zod-schema.agents.d.ts +487 -0
- package/dist/config/zod-schema.approvals.d.ts +15 -0
- package/dist/config/zod-schema.channels.d.ts +6 -0
- package/dist/config/zod-schema.core.d.ts +647 -0
- package/dist/config/zod-schema.core.js +4 -2
- package/dist/config/zod-schema.d.ts +2989 -0
- package/dist/config/zod-schema.hooks.d.ts +78 -0
- package/dist/config/zod-schema.js +12 -7
- package/dist/config/zod-schema.providers-core.d.ts +2671 -0
- package/dist/config/zod-schema.providers-core.js +19 -7
- package/dist/config/zod-schema.providers-whatsapp.d.ts +228 -0
- package/dist/config/zod-schema.providers-whatsapp.js +9 -5
- package/dist/config/zod-schema.providers.d.ts +1620 -0
- package/dist/config/zod-schema.providers.js +2 -2
- package/dist/config/zod-schema.session.d.ts +171 -0
- package/dist/control-ui/apple-touch-icon.png +0 -0
- package/dist/control-ui/assets/index-BKPyesll.css +1 -0
- package/dist/control-ui/assets/index-kjHVNdSc.js +3898 -0
- package/dist/control-ui/assets/index-kjHVNdSc.js.map +1 -0
- package/dist/control-ui/favicon-32.png +0 -0
- package/dist/control-ui/favicon.svg +22 -0
- package/dist/control-ui/index.html +7 -5
- package/dist/cron/isolated-agent/delivery-target.d.ts +13 -0
- package/dist/cron/isolated-agent/helpers.d.ts +23 -0
- package/dist/cron/isolated-agent/helpers.js +10 -5
- package/dist/cron/isolated-agent/run.d.ts +19 -0
- package/dist/cron/isolated-agent/run.js +6 -4
- package/dist/cron/isolated-agent/session.d.ts +14 -0
- package/dist/cron/isolated-agent.d.ts +1 -0
- package/dist/cron/normalize.d.ts +9 -0
- package/dist/cron/normalize.js +28 -14
- package/dist/cron/parse.d.ts +1 -0
- package/dist/cron/parse.js +10 -5
- package/dist/cron/payload-migration.d.ts +3 -0
- package/dist/cron/payload-migration.js +2 -1
- package/dist/cron/run-log.d.ts +23 -0
- package/dist/cron/run-log.js +17 -9
- package/dist/cron/schedule.d.ts +2 -0
- package/dist/cron/schedule.js +4 -2
- package/dist/cron/service/jobs.d.ts +13 -0
- package/dist/cron/service/jobs.js +51 -26
- package/dist/cron/service/locked.d.ts +2 -0
- package/dist/cron/service/normalize.d.ts +17 -0
- package/dist/cron/service/normalize.js +22 -11
- package/dist/cron/service/ops.d.ts +39 -0
- package/dist/cron/service/ops.js +8 -5
- package/dist/cron/service/state.d.ts +86 -0
- package/dist/cron/service/store.d.ts +4 -0
- package/dist/cron/service/store.js +10 -5
- package/dist/cron/service/timer.d.ts +18 -0
- package/dist/cron/service/timer.js +24 -12
- package/dist/cron/service.d.ts +44 -0
- package/dist/cron/store.d.ts +6 -0
- package/dist/cron/store.js +3 -2
- package/dist/cron/types.d.ts +93 -0
- package/dist/daemon/constants.d.ts +30 -0
- package/dist/daemon/constants.js +33 -32
- package/dist/daemon/diagnostics.d.ts +1 -0
- package/dist/daemon/diagnostics.js +4 -2
- package/dist/daemon/inspect.d.ts +13 -0
- package/dist/daemon/inspect.js +112 -48
- package/dist/daemon/launchd-plist.d.ts +15 -0
- package/dist/daemon/launchd-plist.js +8 -4
- package/dist/daemon/launchd.d.ts +76 -0
- package/dist/daemon/launchd.js +24 -16
- package/dist/daemon/node-service.d.ts +2 -0
- package/dist/daemon/node-service.js +15 -15
- package/dist/daemon/paths.d.ts +3 -0
- package/dist/daemon/paths.js +9 -6
- package/dist/daemon/program-args.d.ts +23 -0
- package/dist/daemon/program-args.js +23 -12
- package/dist/daemon/runtime-parse.d.ts +1 -0
- package/dist/daemon/runtime-parse.js +6 -3
- package/dist/daemon/runtime-paths.d.ts +27 -0
- package/dist/daemon/runtime-paths.js +8 -4
- package/dist/daemon/schtasks.d.ts +39 -0
- package/dist/daemon/schtasks.js +40 -23
- package/dist/daemon/service-audit.d.ts +37 -0
- package/dist/daemon/service-audit.js +28 -15
- package/dist/daemon/service-env.d.ts +27 -0
- package/dist/daemon/service-env.js +43 -30
- package/dist/daemon/service-runtime.d.ts +13 -0
- package/dist/daemon/service.d.ts +38 -0
- package/dist/daemon/systemd-hints.d.ts +4 -0
- package/dist/daemon/systemd-hints.js +3 -2
- package/dist/daemon/systemd-linger.d.ts +15 -0
- package/dist/daemon/systemd-linger.js +4 -2
- package/dist/daemon/systemd-unit.d.ts +11 -0
- package/dist/daemon/systemd-unit.js +17 -9
- package/dist/daemon/systemd.d.ts +57 -0
- package/dist/daemon/systemd.js +43 -25
- package/dist/discord/accounts.d.ts +17 -0
- package/dist/discord/accounts.js +9 -5
- package/dist/discord/api.d.ts +11 -0
- package/dist/discord/api.js +12 -6
- package/dist/discord/audit.d.ts +29 -0
- package/dist/discord/audit.js +17 -9
- package/dist/discord/chunk.d.ts +20 -0
- package/dist/discord/chunk.js +34 -17
- package/dist/discord/directory-live.d.ts +4 -0
- package/dist/discord/directory-live.js +14 -7
- package/dist/discord/gateway-logging.d.ts +8 -0
- package/dist/discord/gateway-logging.js +6 -3
- package/dist/discord/index.d.ts +2 -0
- package/dist/discord/monitor/allow-list.d.ts +126 -0
- package/dist/discord/monitor/allow-list.js +61 -33
- package/dist/discord/monitor/exec-approvals.d.ts +70 -0
- package/dist/discord/monitor/exec-approvals.js +31 -16
- package/dist/discord/monitor/format.d.ts +13 -0
- package/dist/discord/monitor/format.js +6 -3
- package/dist/discord/monitor/listeners.d.ts +49 -0
- package/dist/discord/monitor/listeners.js +19 -10
- package/dist/discord/monitor/message-handler.d.ts +26 -0
- package/dist/discord/monitor/message-handler.js +16 -8
- package/dist/discord/monitor/message-handler.preflight.d.ts +3 -0
- package/dist/discord/monitor/message-handler.preflight.js +58 -28
- package/dist/discord/monitor/message-handler.preflight.types.d.ts +86 -0
- package/dist/discord/monitor/message-handler.process.d.ts +2 -0
- package/dist/discord/monitor/message-handler.process.js +21 -18
- package/dist/discord/monitor/message-utils.d.ts +31 -0
- package/dist/discord/monitor/message-utils.js +38 -19
- package/dist/discord/monitor/native-command.d.ts +20 -0
- package/dist/discord/monitor/native-command.js +50 -32
- package/dist/discord/monitor/presence-cache.d.ts +9 -0
- package/dist/discord/monitor/provider.d.ts +13 -0
- package/dist/discord/monitor/provider.js +44 -23
- package/dist/discord/monitor/reply-context.d.ts +13 -0
- package/dist/discord/monitor/reply-context.js +15 -8
- package/dist/discord/monitor/reply-delivery.d.ts +18 -0
- package/dist/discord/monitor/reply-delivery.js +8 -4
- package/dist/discord/monitor/sender-identity.d.ts +31 -0
- package/dist/discord/monitor/sender-identity.js +45 -0
- package/dist/discord/monitor/system-events.d.ts +2 -0
- package/dist/discord/monitor/threading.d.ts +101 -0
- package/dist/discord/monitor/threading.js +32 -16
- package/dist/discord/monitor/typing.d.ts +5 -0
- package/dist/discord/monitor/typing.js +2 -1
- package/dist/discord/monitor.d.ts +10 -0
- package/dist/discord/monitor.gateway.d.ts +12 -0
- package/dist/discord/monitor.gateway.js +4 -2
- package/dist/discord/pluralkit.d.ts +26 -0
- package/dist/discord/pluralkit.js +27 -0
- package/dist/discord/probe.d.ts +29 -0
- package/dist/discord/probe.js +12 -6
- package/dist/discord/resolve-channels.d.ts +15 -0
- package/dist/discord/resolve-channels.js +26 -20
- package/dist/discord/resolve-users.d.ts +14 -0
- package/dist/discord/resolve-users.js +18 -9
- package/dist/discord/send.channels.d.ts +17 -0
- package/dist/discord/send.channels.js +26 -13
- package/dist/discord/send.d.ts +8 -0
- package/dist/discord/send.emojis-stickers.d.ts +4 -0
- package/dist/discord/send.guild.d.ts +24 -0
- package/dist/discord/send.messages.d.ts +18 -0
- package/dist/discord/send.messages.js +12 -6
- package/dist/discord/send.outbound.d.ts +22 -0
- package/dist/discord/send.permissions.d.ts +4 -0
- package/dist/discord/send.permissions.js +7 -4
- package/dist/discord/send.reactions.d.ts +15 -0
- package/dist/discord/send.reactions.js +8 -4
- package/dist/discord/send.shared.d.ts +69 -0
- package/dist/discord/send.shared.js +16 -8
- package/dist/discord/send.types.d.ts +130 -0
- package/dist/discord/send.types.js +2 -1
- package/dist/discord/targets.d.ts +18 -0
- package/dist/discord/targets.js +4 -2
- package/dist/discord/token.d.ts +11 -0
- package/dist/discord/token.js +10 -5
- package/dist/entry.js +23 -14
- package/dist/gateway/assistant-identity.d.ts +12 -0
- package/dist/gateway/assistant-identity.js +18 -9
- package/dist/gateway/auth.d.ts +36 -0
- package/dist/gateway/auth.js +40 -20
- package/dist/gateway/boot.d.ts +16 -0
- package/dist/gateway/boot.js +5 -3
- package/dist/gateway/call.d.ts +40 -0
- package/dist/gateway/call.js +13 -7
- package/dist/gateway/chat-abort.d.ts +44 -0
- package/dist/gateway/chat-abort.js +10 -5
- package/dist/gateway/chat-attachments.d.ts +35 -0
- package/dist/gateway/chat-attachments.js +14 -7
- package/dist/gateway/chat-sanitize.d.ts +3 -0
- package/dist/gateway/chat-sanitize.js +24 -12
- package/dist/gateway/client.d.ts +61 -0
- package/dist/gateway/client.js +36 -19
- package/dist/gateway/config-reload.d.ts +38 -0
- package/dist/gateway/config-reload.js +20 -10
- package/dist/gateway/control-ui-shared.d.ts +9 -0
- package/dist/gateway/control-ui-shared.js +20 -10
- package/dist/gateway/control-ui.d.ts +25 -0
- package/dist/gateway/control-ui.js +27 -15
- package/dist/gateway/device-auth.d.ts +12 -0
- package/dist/gateway/exec-approval-manager.d.ts +27 -0
- package/dist/gateway/exec-approval-manager.js +2 -1
- package/dist/gateway/hooks-mapping.d.ts +62 -0
- package/dist/gateway/hooks-mapping.js +53 -27
- package/dist/gateway/hooks.d.ts +59 -0
- package/dist/gateway/hooks.js +29 -14
- package/dist/gateway/http-common.d.ts +9 -0
- package/dist/gateway/http-utils.d.ts +15 -0
- package/dist/gateway/http-utils.js +21 -11
- package/dist/gateway/live-image-probe.d.ts +1 -0
- package/dist/gateway/live-image-probe.js +10 -5
- package/dist/gateway/net.d.ts +35 -0
- package/dist/gateway/net.js +57 -29
- package/dist/gateway/node-command-policy.d.ts +13 -0
- package/dist/gateway/node-command-policy.js +26 -13
- package/dist/gateway/node-registry.d.ts +60 -0
- package/dist/gateway/node-registry.js +10 -5
- package/dist/gateway/open-responses.schema.d.ts +765 -0
- package/dist/gateway/openai-http.d.ts +9 -0
- package/dist/gateway/openai-http.js +35 -19
- package/dist/gateway/openresponses-http.d.ts +23 -0
- package/dist/gateway/openresponses-http.js +42 -24
- package/dist/gateway/probe.d.ts +26 -0
- package/dist/gateway/probe.js +4 -2
- package/dist/gateway/protocol/client-info.d.ts +53 -0
- package/dist/gateway/protocol/client-info.js +9 -7
- package/dist/gateway/protocol/index.d.ts +607 -0
- package/dist/gateway/protocol/index.js +2 -1
- package/dist/gateway/protocol/schema/agent.d.ts +71 -0
- package/dist/gateway/protocol/schema/agents-models-skills.d.ts +61 -0
- package/dist/gateway/protocol/schema/channels.d.ts +105 -0
- package/dist/gateway/protocol/schema/config.d.ts +51 -0
- package/dist/gateway/protocol/schema/cron.d.ts +327 -0
- package/dist/gateway/protocol/schema/devices.d.ts +38 -0
- package/dist/gateway/protocol/schema/error-codes.d.ts +14 -0
- package/dist/gateway/protocol/schema/exec-approvals.d.ts +162 -0
- package/dist/gateway/protocol/schema/frames.d.ts +163 -0
- package/dist/gateway/protocol/schema/logs-chat.d.ts +45 -0
- package/dist/gateway/protocol/schema/nodes.d.ts +64 -0
- package/dist/gateway/protocol/schema/primitives.d.ts +4 -0
- package/dist/gateway/protocol/schema/protocol-schemas.d.ts +3 -0
- package/dist/gateway/protocol/schema/protocol-schemas.js +1 -1
- package/dist/gateway/protocol/schema/sessions.d.ts +62 -0
- package/dist/gateway/protocol/schema/snapshot.d.ts +63 -0
- package/dist/gateway/protocol/schema/types.d.ts +108 -0
- package/dist/gateway/protocol/schema/wizard.d.ts +86 -0
- package/dist/gateway/protocol/schema.d.ts +16 -0
- package/dist/gateway/server/__tests__/test-utils.d.ts +2 -0
- package/dist/gateway/server/close-reason.d.ts +1 -0
- package/dist/gateway/server/close-reason.js +4 -2
- package/dist/gateway/server/health-state.d.ts +11 -0
- package/dist/gateway/server/health-state.js +1 -1
- package/dist/gateway/server/hooks.d.ts +12 -0
- package/dist/gateway/server/http-listen.d.ts +6 -0
- package/dist/gateway/server/plugins-http.d.ts +10 -0
- package/dist/gateway/server/plugins-http.js +4 -2
- package/dist/gateway/server/tls.d.ts +7 -0
- package/dist/gateway/server/ws-connection/message-handler.d.ts +42 -0
- package/dist/gateway/server/ws-connection/message-handler.js +22 -13
- package/dist/gateway/server/ws-connection.d.ts +30 -0
- package/dist/gateway/server/ws-connection.js +6 -3
- package/dist/gateway/server/ws-types.d.ts +8 -0
- package/dist/gateway/server-broadcast.d.ts +12 -0
- package/dist/gateway/server-broadcast.js +10 -5
- package/dist/gateway/server-browser.d.ts +4 -0
- package/dist/gateway/server-browser.js +5 -3
- package/dist/gateway/server-channels.d.ts +24 -0
- package/dist/gateway/server-channels.js +14 -7
- package/dist/gateway/server-chat.d.ts +34 -0
- package/dist/gateway/server-chat.js +20 -10
- package/dist/gateway/server-close.d.ts +47 -0
- package/dist/gateway/server-constants.d.ts +10 -0
- package/dist/gateway/server-constants.js +6 -4
- package/dist/gateway/server-cron.d.ts +15 -0
- package/dist/gateway/server-cron.js +1 -1
- package/dist/gateway/server-discovery-runtime.d.ts +20 -0
- package/dist/gateway/server-discovery-runtime.js +12 -4
- package/dist/gateway/server-discovery.d.ts +16 -0
- package/dist/gateway/server-discovery.js +22 -14
- package/dist/gateway/server-http.d.ts +51 -0
- package/dist/gateway/server-http.js +29 -16
- package/dist/gateway/server-lanes.d.ts +2 -0
- package/dist/gateway/server-maintenance.d.ts +36 -0
- package/dist/gateway/server-maintenance.js +8 -5
- package/dist/gateway/server-methods/agent-job.d.ts +13 -0
- package/dist/gateway/server-methods/agent-job.js +21 -13
- package/dist/gateway/server-methods/agent-timestamp.d.ts +27 -0
- package/dist/gateway/server-methods/agent-timestamp.js +62 -0
- package/dist/gateway/server-methods/agent.d.ts +2 -0
- package/dist/gateway/server-methods/agent.js +10 -4
- package/dist/gateway/server-methods/agents.d.ts +2 -0
- package/dist/gateway/server-methods/browser.d.ts +2 -0
- package/dist/gateway/server-methods/browser.js +24 -12
- package/dist/gateway/server-methods/channels.d.ts +19 -0
- package/dist/gateway/server-methods/channels.js +5 -3
- package/dist/gateway/server-methods/chat.d.ts +2 -0
- package/dist/gateway/server-methods/chat.js +18 -8
- package/dist/gateway/server-methods/config.d.ts +2 -0
- package/dist/gateway/server-methods/config.js +8 -6
- package/dist/gateway/server-methods/connect.d.ts +2 -0
- package/dist/gateway/server-methods/cron.d.ts +2 -0
- package/dist/gateway/server-methods/devices.d.ts +2 -0
- package/dist/gateway/server-methods/exec-approval.d.ts +6 -0
- package/dist/gateway/server-methods/exec-approvals.d.ts +2 -0
- package/dist/gateway/server-methods/exec-approvals.js +4 -2
- package/dist/gateway/server-methods/health.d.ts +2 -0
- package/dist/gateway/server-methods/logs.d.ts +2 -0
- package/dist/gateway/server-methods/logs.js +8 -5
- package/dist/gateway/server-methods/models.d.ts +2 -0
- package/dist/gateway/server-methods/nodes.d.ts +2 -0
- package/dist/gateway/server-methods/nodes.helpers.d.ts +14 -0
- package/dist/gateway/server-methods/nodes.helpers.js +5 -3
- package/dist/gateway/server-methods/nodes.js +15 -9
- package/dist/gateway/server-methods/send.d.ts +2 -0
- package/dist/gateway/server-methods/send.js +17 -10
- package/dist/gateway/server-methods/sessions.d.ts +2 -0
- package/dist/gateway/server-methods/sessions.js +8 -4
- package/dist/gateway/server-methods/skills.d.ts +2 -0
- package/dist/gateway/server-methods/skills.js +20 -11
- package/dist/gateway/server-methods/system.d.ts +2 -0
- package/dist/gateway/server-methods/talk.d.ts +2 -0
- package/dist/gateway/server-methods/tts.d.ts +2 -0
- package/dist/gateway/server-methods/types.d.ts +87 -0
- package/dist/gateway/server-methods/update.d.ts +2 -0
- package/dist/gateway/server-methods/update.js +3 -3
- package/dist/gateway/server-methods/usage.d.ts +2 -0
- package/dist/gateway/server-methods/usage.js +11 -6
- package/dist/gateway/server-methods/voicewake.d.ts +2 -0
- package/dist/gateway/server-methods/web.d.ts +2 -0
- package/dist/gateway/server-methods/wizard.d.ts +2 -0
- package/dist/gateway/server-methods-list.d.ts +2 -0
- package/dist/gateway/server-methods.d.ts +5 -0
- package/dist/gateway/server-methods.js +14 -7
- package/dist/gateway/server-mobile-nodes.d.ts +2 -0
- package/dist/gateway/server-mobile-nodes.js +2 -1
- package/dist/gateway/server-model-catalog.d.ts +4 -0
- package/dist/gateway/server-node-events-types.d.ts +36 -0
- package/dist/gateway/server-node-events.d.ts +2 -0
- package/dist/gateway/server-node-events.js +30 -15
- package/dist/gateway/server-node-subscriptions.d.ts +18 -0
- package/dist/gateway/server-node-subscriptions.js +22 -11
- package/dist/gateway/server-plugins.d.ts +17 -0
- package/dist/gateway/server-plugins.js +2 -2
- package/dist/gateway/server-reload-handlers.d.ts +46 -0
- package/dist/gateway/server-reload-handlers.js +7 -7
- package/dist/gateway/server-restart-sentinel.d.ts +5 -0
- package/dist/gateway/server-restart-sentinel.js +2 -1
- package/dist/gateway/server-runtime-config.d.ts +28 -0
- package/dist/gateway/server-runtime-config.js +3 -3
- package/dist/gateway/server-runtime-state.d.ts +64 -0
- package/dist/gateway/server-runtime-state.js +5 -4
- package/dist/gateway/server-session-key.d.ts +1 -0
- package/dist/gateway/server-session-key.js +2 -1
- package/dist/gateway/server-shared.d.ts +7 -0
- package/dist/gateway/server-startup-log.d.ts +12 -0
- package/dist/gateway/server-startup.d.ts +29 -0
- package/dist/gateway/server-startup.js +7 -7
- package/dist/gateway/server-tailscale.d.ts +10 -0
- package/dist/gateway/server-utils.d.ts +2 -0
- package/dist/gateway/server-utils.js +4 -2
- package/dist/gateway/server-wizard-sessions.d.ts +6 -0
- package/dist/gateway/server-wizard-sessions.js +6 -3
- package/dist/gateway/server-ws-runtime.d.ts +28 -0
- package/dist/gateway/server.d.ts +3 -0
- package/dist/gateway/server.impl.d.ts +54 -0
- package/dist/gateway/server.impl.js +27 -24
- package/dist/gateway/session-utils.d.ts +53 -0
- package/dist/gateway/session-utils.fs.d.ts +11 -0
- package/dist/gateway/session-utils.fs.js +69 -35
- package/dist/gateway/session-utils.js +71 -36
- package/dist/gateway/session-utils.types.d.ts +79 -0
- package/dist/gateway/sessions-patch.d.ts +17 -0
- package/dist/gateway/sessions-patch.js +39 -20
- package/dist/gateway/sessions-resolve.d.ts +13 -0
- package/dist/gateway/test-helpers.e2e.d.ts +22 -0
- package/dist/gateway/test-helpers.e2e.js +8 -4
- package/dist/gateway/test-helpers.mocks.d.ts +62 -0
- package/dist/gateway/test-helpers.mocks.js +36 -22
- package/dist/gateway/test-helpers.openai-mock.d.ts +6 -0
- package/dist/gateway/test-helpers.openai-mock.js +14 -7
- package/dist/gateway/test-helpers.server.d.ts +79 -0
- package/dist/gateway/test-helpers.server.js +71 -50
- package/dist/gateway/tools-invoke-http.d.ts +7 -0
- package/dist/gateway/tools-invoke-http.js +59 -14
- package/dist/gateway/ws-log.d.ts +4 -0
- package/dist/gateway/ws-log.js +88 -45
- package/dist/gateway/ws-logging.d.ts +4 -0
- package/dist/globals.js +6 -3
- package/dist/hooks/bundled/boot-md/HOOK.md +3 -3
- package/dist/hooks/bundled/boot-md/handler.d.ts +3 -0
- package/dist/hooks/bundled/command-logger/HOOK.md +12 -12
- package/dist/hooks/bundled/command-logger/handler.d.ts +30 -0
- package/dist/hooks/bundled/command-logger/handler.js +3 -2
- package/dist/hooks/bundled/session-memory/HOOK.md +30 -7
- package/dist/hooks/bundled/session-memory/handler.d.ts +12 -0
- package/dist/hooks/bundled/session-memory/handler.js +20 -13
- package/dist/hooks/bundled/soul-evil/HOOK.md +5 -5
- package/dist/hooks/bundled/soul-evil/handler.d.ts +3 -0
- package/dist/hooks/bundled/soul-evil/handler.js +10 -5
- package/dist/hooks/bundled-dir.d.ts +1 -0
- package/dist/hooks/bundled-dir.js +10 -6
- package/dist/hooks/config.d.ts +12 -0
- package/dist/hooks/config.js +30 -16
- package/dist/hooks/frontmatter.d.ts +5 -0
- package/dist/hooks/frontmatter.js +31 -13
- package/dist/hooks/gmail-ops.d.ts +41 -0
- package/dist/hooks/gmail-ops.js +11 -7
- package/dist/hooks/gmail-setup-utils.d.ts +15 -0
- package/dist/hooks/gmail-setup-utils.js +47 -24
- package/dist/hooks/gmail-watcher.d.ts +25 -0
- package/dist/hooks/gmail-watcher.js +12 -7
- package/dist/hooks/gmail.d.ts +69 -0
- package/dist/hooks/gmail.js +6 -3
- package/dist/hooks/hooks-status.d.ts +57 -0
- package/dist/hooks/hooks-status.js +12 -7
- package/dist/hooks/hooks.d.ts +5 -0
- package/dist/hooks/install.d.ts +42 -0
- package/dist/hooks/install.js +15 -12
- package/dist/hooks/installs.d.ts +6 -0
- package/dist/hooks/internal-hooks.d.ts +95 -0
- package/dist/hooks/internal-hooks.js +7 -4
- package/dist/hooks/llm-slug-generator.d.ts +11 -0
- package/dist/hooks/llm-slug-generator.js +2 -2
- package/dist/hooks/loader.d.ts +27 -0
- package/dist/hooks/loader.js +4 -4
- package/dist/hooks/plugin-hooks.d.ts +9 -0
- package/dist/hooks/plugin-hooks.js +4 -3
- package/dist/hooks/soul-evil.d.ts +42 -0
- package/dist/hooks/soul-evil.js +32 -16
- package/dist/hooks/types.d.ts +62 -0
- package/dist/hooks/workspace.d.ts +20 -0
- package/dist/hooks/workspace.js +33 -21
- package/dist/imessage/accounts.d.ts +16 -0
- package/dist/imessage/accounts.js +9 -5
- package/dist/imessage/client.d.ts +46 -0
- package/dist/imessage/client.js +20 -10
- package/dist/imessage/index.d.ts +3 -0
- package/dist/imessage/monitor/deliver.d.ts +12 -0
- package/dist/imessage/monitor/deliver.js +2 -1
- package/dist/imessage/monitor/monitor-provider.d.ts +2 -0
- package/dist/imessage/monitor/monitor-provider.js +37 -21
- package/dist/imessage/monitor/runtime.d.ts +4 -0
- package/dist/imessage/monitor/types.d.ts +37 -0
- package/dist/imessage/monitor.d.ts +2 -0
- package/dist/imessage/probe.d.ts +12 -0
- package/dist/imessage/probe.js +2 -1
- package/dist/imessage/send.d.ts +18 -0
- package/dist/imessage/send.js +8 -5
- package/dist/imessage/targets.d.ts +39 -0
- package/dist/imessage/targets.js +46 -23
- package/dist/index.js +5 -5
- package/dist/infra/agent-events.d.ts +21 -0
- package/dist/infra/agent-events.js +2 -1
- package/dist/infra/archive.d.ts +16 -0
- package/dist/infra/archive.js +9 -5
- package/dist/infra/backoff.d.ts +8 -0
- package/dist/infra/backoff.js +3 -2
- package/dist/infra/binaries.d.ts +3 -0
- package/dist/infra/bonjour-ciao.d.ts +1 -0
- package/dist/infra/bonjour-discovery.d.ts +26 -0
- package/dist/infra/bonjour-discovery.js +133 -72
- package/dist/infra/bonjour-errors.d.ts +1 -0
- package/dist/infra/bonjour.d.ts +19 -0
- package/dist/infra/bonjour.js +21 -14
- package/dist/infra/brew.d.ts +8 -0
- package/dist/infra/brew.js +8 -4
- package/dist/infra/canvas-host-url.d.ts +11 -0
- package/dist/infra/canvas-host-url.js +22 -11
- package/dist/infra/channel-activity.d.ts +18 -0
- package/dist/infra/channel-activity.js +6 -3
- package/dist/infra/channel-summary.d.ts +7 -0
- package/dist/infra/channel-summary.js +26 -13
- package/dist/infra/channels-status-issues.d.ts +2 -0
- package/dist/infra/channels-status-issues.js +4 -2
- package/dist/infra/clipboard.d.ts +1 -0
- package/dist/infra/clipboard.js +2 -1
- package/dist/infra/control-ui-assets.d.ts +11 -0
- package/dist/infra/control-ui-assets.js +23 -10
- package/dist/infra/dedupe.d.ts +11 -0
- package/dist/infra/dedupe.js +4 -2
- package/dist/infra/device-auth-store.d.ts +23 -0
- package/dist/infra/device-auth-store.js +21 -11
- package/dist/infra/device-identity.d.ts +11 -0
- package/dist/infra/device-identity.js +1 -1
- package/dist/infra/device-pairing.d.ts +96 -0
- package/dist/infra/device-pairing.js +58 -31
- package/dist/infra/diagnostic-events.d.ts +121 -0
- package/dist/infra/diagnostic-flags.d.ts +4 -0
- package/dist/infra/diagnostic-flags.js +23 -12
- package/dist/infra/dotenv.d.ts +3 -0
- package/dist/infra/dotenv.js +4 -3
- package/dist/infra/env-file.d.ts +9 -0
- package/dist/infra/env-file.js +4 -2
- package/dist/infra/env.d.ts +11 -0
- package/dist/infra/env.js +10 -5
- package/dist/infra/errors.d.ts +3 -0
- package/dist/infra/errors.js +8 -4
- package/dist/infra/exec-approval-forwarder.d.ts +44 -0
- package/dist/infra/exec-approval-forwarder.js +52 -26
- package/dist/infra/exec-approvals.d.ts +153 -0
- package/dist/infra/exec-approvals.js +112 -57
- package/dist/infra/exec-host.d.ts +37 -0
- package/dist/infra/exec-host.js +6 -3
- package/dist/infra/exec-safety.d.ts +1 -0
- package/dist/infra/exec-safety.js +20 -10
- package/dist/infra/fetch.d.ts +2 -0
- package/dist/infra/fetch.js +8 -4
- package/dist/infra/format-duration.d.ts +10 -0
- package/dist/infra/format-duration.js +6 -3
- package/dist/infra/fs-safe.d.ts +16 -0
- package/dist/infra/fs-safe.js +2 -1
- package/dist/infra/gateway-lock.d.ts +18 -0
- package/dist/infra/gateway-lock.js +24 -16
- package/dist/infra/git-commit.d.ts +4 -0
- package/dist/infra/git-commit.js +8 -4
- package/dist/infra/heartbeat-events.d.ts +20 -0
- package/dist/infra/heartbeat-runner.d.ts +44 -0
- package/dist/infra/heartbeat-runner.js +68 -35
- package/dist/infra/heartbeat-visibility.d.ts +17 -0
- package/dist/infra/heartbeat-wake.d.ts +20 -0
- package/dist/infra/heartbeat-wake.js +6 -3
- package/dist/infra/is-main.d.ts +8 -0
- package/dist/infra/is-main.js +2 -1
- package/dist/infra/json-file.d.ts +2 -0
- package/dist/infra/json-file.js +2 -1
- package/dist/infra/machine-name.d.ts +1 -0
- package/dist/infra/machine-name.js +7 -4
- package/dist/infra/net/ssrf.d.ts +24 -0
- package/dist/infra/net/ssrf.js +39 -20
- package/dist/infra/node-pairing.d.ts +62 -0
- package/dist/infra/node-pairing.js +14 -8
- package/dist/infra/node-shell.d.ts +1 -0
- package/dist/infra/openclaw-root.d.ts +5 -0
- package/dist/infra/openclaw-root.js +60 -0
- package/dist/infra/os-summary.d.ts +7 -0
- package/dist/infra/os-summary.js +4 -2
- package/dist/infra/outbound/agent-delivery.d.ts +32 -0
- package/dist/infra/outbound/agent-delivery.js +4 -2
- package/dist/infra/outbound/channel-adapters.d.ts +6 -0
- package/dist/infra/outbound/channel-adapters.js +2 -1
- package/dist/infra/outbound/channel-selection.d.ts +11 -0
- package/dist/infra/outbound/channel-selection.js +12 -6
- package/dist/infra/outbound/channel-target.d.ts +6 -0
- package/dist/infra/outbound/channel-target.js +2 -1
- package/dist/infra/outbound/deliver.d.ts +69 -0
- package/dist/infra/outbound/deliver.js +9 -5
- package/dist/infra/outbound/directory-cache.d.ts +21 -0
- package/dist/infra/outbound/directory-cache.js +6 -3
- package/dist/infra/outbound/envelope.d.ts +16 -0
- package/dist/infra/outbound/format.d.ts +39 -0
- package/dist/infra/outbound/format.js +12 -6
- package/dist/infra/outbound/message-action-runner.d.ts +73 -0
- package/dist/infra/outbound/message-action-runner.js +61 -34
- package/dist/infra/outbound/message-action-spec.d.ts +5 -0
- package/dist/infra/outbound/message-action-spec.js +10 -5
- package/dist/infra/outbound/message.d.ts +76 -0
- package/dist/infra/outbound/message.js +2 -1
- package/dist/infra/outbound/outbound-policy.d.ts +31 -0
- package/dist/infra/outbound/outbound-policy.js +33 -17
- package/dist/infra/outbound/outbound-send-service.d.ts +58 -0
- package/dist/infra/outbound/outbound-send-service.js +2 -1
- package/dist/infra/outbound/outbound-session.d.ts +31 -0
- package/dist/infra/outbound/outbound-session.js +73 -37
- package/dist/infra/outbound/payloads.d.ts +16 -0
- package/dist/infra/outbound/payloads.js +14 -7
- package/dist/infra/outbound/target-errors.d.ts +6 -0
- package/dist/infra/outbound/target-errors.js +2 -1
- package/dist/infra/outbound/target-normalization.d.ts +4 -0
- package/dist/infra/outbound/target-normalization.js +2 -1
- package/dist/infra/outbound/target-resolver.d.ts +53 -0
- package/dist/infra/outbound/target-resolver.js +63 -32
- package/dist/infra/outbound/targets.d.ts +65 -0
- package/dist/infra/outbound/targets.js +7 -4
- package/dist/infra/path-env.d.ts +13 -0
- package/dist/infra/path-env.js +21 -14
- package/dist/infra/ports-format.d.ts +5 -0
- package/dist/infra/ports-format.js +7 -4
- package/dist/infra/ports-inspect.d.ts +2 -0
- package/dist/infra/ports-inspect.js +57 -29
- package/dist/infra/ports-lsof.d.ts +2 -0
- package/dist/infra/ports-lsof.js +2 -1
- package/dist/infra/ports-types.d.ts +17 -0
- package/dist/infra/ports.d.ts +14 -0
- package/dist/infra/ports.js +8 -5
- package/dist/infra/provider-usage.auth.d.ts +11 -0
- package/dist/infra/provider-usage.auth.js +74 -18
- package/dist/infra/provider-usage.d.ts +4 -0
- package/dist/infra/provider-usage.fetch.antigravity.d.ts +2 -0
- package/dist/infra/provider-usage.fetch.antigravity.js +30 -15
- package/dist/infra/provider-usage.fetch.claude.d.ts +2 -0
- package/dist/infra/provider-usage.fetch.claude.js +17 -9
- package/dist/infra/provider-usage.fetch.codex.d.ts +2 -0
- package/dist/infra/provider-usage.fetch.codex.js +2 -1
- package/dist/infra/provider-usage.fetch.copilot.d.ts +2 -0
- package/dist/infra/provider-usage.fetch.d.ts +7 -0
- package/dist/infra/provider-usage.fetch.gemini.d.ts +2 -0
- package/dist/infra/provider-usage.fetch.gemini.js +10 -5
- package/dist/infra/provider-usage.fetch.minimax.d.ts +2 -0
- package/dist/infra/provider-usage.fetch.minimax.js +31 -16
- package/dist/infra/provider-usage.fetch.shared.d.ts +1 -0
- package/dist/infra/provider-usage.fetch.zai.d.ts +2 -0
- package/dist/infra/provider-usage.fetch.zai.js +6 -3
- package/dist/infra/provider-usage.format.d.ts +13 -0
- package/dist/infra/provider-usage.format.js +22 -11
- package/dist/infra/provider-usage.load.d.ts +12 -0
- package/dist/infra/provider-usage.load.js +11 -3
- package/dist/infra/provider-usage.shared.d.ts +8 -0
- package/dist/infra/provider-usage.shared.js +6 -2
- package/dist/infra/provider-usage.types.d.ts +17 -0
- package/dist/infra/restart-sentinel.d.ts +50 -0
- package/dist/infra/restart-sentinel.js +7 -4
- package/dist/infra/restart.d.ts +28 -0
- package/dist/infra/restart.js +20 -12
- package/dist/infra/retry-policy.d.ts +25 -0
- package/dist/infra/retry-policy.js +2 -1
- package/dist/infra/retry.d.ts +21 -0
- package/dist/infra/retry.js +8 -4
- package/dist/infra/runtime-guard.d.ts +20 -0
- package/dist/infra/runtime-guard.js +16 -9
- package/dist/infra/session-cost-usage.d.ts +36 -0
- package/dist/infra/session-cost-usage.js +32 -17
- package/dist/infra/shell-env.d.ts +33 -0
- package/dist/infra/shell-env.js +20 -12
- package/dist/infra/skills-remote.d.ts +24 -0
- package/dist/infra/skills-remote.js +45 -24
- package/dist/infra/ssh-config.d.ts +12 -0
- package/dist/infra/ssh-config.js +12 -6
- package/dist/infra/ssh-tunnel.d.ts +21 -0
- package/dist/infra/ssh-tunnel.js +23 -8
- package/dist/infra/state-migrations.d.ts +87 -0
- package/dist/infra/state-migrations.fs.d.ts +14 -0
- package/dist/infra/state-migrations.fs.js +5 -3
- package/dist/infra/state-migrations.js +143 -54
- package/dist/infra/system-events.d.ts +16 -0
- package/dist/infra/system-events.js +13 -7
- package/dist/infra/system-presence.d.ts +45 -0
- package/dist/infra/system-presence.js +27 -15
- package/dist/infra/tailnet.d.ts +7 -0
- package/dist/infra/tailnet.js +14 -7
- package/dist/infra/tailscale.d.ts +34 -0
- package/dist/infra/tailscale.js +32 -17
- package/dist/infra/tls/fingerprint.d.ts +1 -0
- package/dist/infra/tls/gateway.d.ts +16 -0
- package/dist/infra/tls/gateway.js +3 -2
- package/dist/infra/transport-ready.d.ts +16 -0
- package/dist/infra/transport-ready.js +8 -4
- package/dist/infra/unhandled-rejections.d.ts +15 -0
- package/dist/infra/unhandled-rejections.js +26 -16
- package/dist/infra/update-channels.d.ts +26 -0
- package/dist/infra/update-channels.js +10 -5
- package/dist/infra/update-check.d.ts +68 -0
- package/dist/infra/update-check.js +23 -12
- package/dist/infra/update-global.d.ts +15 -0
- package/dist/infra/update-global.js +41 -19
- package/dist/infra/update-runner.d.ts +58 -0
- package/dist/infra/update-runner.js +68 -38
- package/dist/infra/update-startup.d.ts +16 -0
- package/dist/infra/update-startup.js +18 -12
- package/dist/infra/voicewake.d.ts +7 -0
- package/dist/infra/voicewake.js +1 -1
- package/dist/infra/warnings.d.ts +1 -0
- package/dist/infra/warnings.js +5 -3
- package/dist/infra/widearea-dns.d.ts +27 -0
- package/dist/infra/widearea-dns.js +38 -17
- package/dist/infra/ws.d.ts +2 -0
- package/dist/infra/ws.js +6 -3
- package/dist/infra/wsl.d.ts +2 -0
- package/dist/infra/wsl.js +2 -1
- package/dist/line/accounts.d.ts +10 -0
- package/dist/line/accounts.js +2 -1
- package/dist/line/auto-reply-delivery.d.ts +49 -0
- package/dist/line/auto-reply-delivery.js +4 -2
- package/dist/line/bot-access.d.ts +15 -0
- package/dist/line/bot-access.js +12 -6
- package/dist/line/bot-handlers.d.ts +13 -0
- package/dist/line/bot-handlers.js +9 -5
- package/dist/line/bot-message-context.d.ts +102 -0
- package/dist/line/bot-message-context.js +2 -1
- package/dist/line/bot.d.ts +24 -0
- package/dist/line/config-schema.d.ts +62 -0
- package/dist/line/download.d.ts +7 -0
- package/dist/line/download.js +2 -2
- package/dist/line/flex-templates.d.ts +195 -0
- package/dist/line/flex-templates.js +4 -2
- package/dist/line/http-registry.d.ts +12 -0
- package/dist/line/http-registry.js +4 -2
- package/dist/line/index.d.ts +16 -0
- package/dist/line/markdown-to-line.d.ts +72 -0
- package/dist/line/markdown-to-line.js +22 -13
- package/dist/line/monitor.d.ts +28 -0
- package/dist/line/monitor.js +14 -11
- package/dist/line/probe.d.ts +2 -0
- package/dist/line/probe.js +4 -2
- package/dist/line/reply-chunks.d.ts +24 -0
- package/dist/line/rich-menu.d.ts +126 -0
- package/dist/line/rich-menu.js +2 -1
- package/dist/line/send.d.ts +118 -0
- package/dist/line/send.js +8 -4
- package/dist/line/signature.d.ts +1 -0
- package/dist/line/template-messages.d.ts +119 -0
- package/dist/line/types.d.ts +121 -0
- package/dist/line/webhook.d.ts +19 -0
- package/dist/line/webhook.js +2 -1
- package/dist/link-understanding/apply.d.ts +10 -0
- package/dist/link-understanding/defaults.d.ts +2 -0
- package/dist/link-understanding/detect.d.ts +3 -0
- package/dist/link-understanding/detect.js +14 -7
- package/dist/link-understanding/format.d.ts +4 -0
- package/dist/link-understanding/format.js +2 -1
- package/dist/link-understanding/index.d.ts +4 -0
- package/dist/link-understanding/runner.d.ts +11 -0
- package/dist/link-understanding/runner.js +15 -8
- package/dist/logger.js +2 -1
- package/dist/logging/config.d.ts +4 -0
- package/dist/logging/config.js +5 -3
- package/dist/logging/console.d.ts +19 -0
- package/dist/logging/console.js +21 -11
- package/dist/logging/diagnostic.d.ts +58 -0
- package/dist/logging/diagnostic.js +12 -6
- package/dist/logging/levels.d.ts +4 -0
- package/dist/logging/logger.d.ts +42 -0
- package/dist/logging/logger.js +18 -12
- package/dist/logging/parse-log-line.d.ts +9 -0
- package/dist/logging/parse-log-line.js +4 -2
- package/dist/logging/redact.d.ts +9 -0
- package/dist/logging/redact.js +18 -9
- package/dist/logging/state.d.ts +17 -0
- package/dist/logging/subsystem.d.ts +16 -0
- package/dist/logging/subsystem.js +36 -19
- package/dist/macos/gateway-daemon.d.ts +2 -0
- package/dist/macos/gateway-daemon.js +14 -9
- package/dist/macos/relay-smoke.d.ts +3 -0
- package/dist/macos/relay-smoke.js +5 -3
- package/dist/macos/relay.d.ts +2 -0
- package/dist/macos/relay.js +8 -7
- package/dist/markdown/code-spans.d.ts +10 -0
- package/dist/markdown/fences.d.ts +10 -0
- package/dist/markdown/fences.js +2 -1
- package/dist/markdown/frontmatter.d.ts +2 -0
- package/dist/markdown/frontmatter.js +20 -10
- package/dist/markdown/ir.d.ts +32 -0
- package/dist/markdown/ir.js +88 -45
- package/dist/markdown/render.d.ts +18 -0
- package/dist/markdown/render.js +70 -37
- package/dist/markdown/tables.d.ts +2 -0
- package/dist/markdown/tables.js +8 -4
- package/dist/media/audio-tags.d.ts +10 -0
- package/dist/media/audio.d.ts +4 -0
- package/dist/media/audio.js +4 -2
- package/dist/media/constants.d.ts +7 -0
- package/dist/media/constants.js +12 -6
- package/dist/media/fetch.d.ts +19 -0
- package/dist/media/fetch.js +16 -8
- package/dist/media/host.d.ts +11 -0
- package/dist/media/host.js +4 -3
- package/dist/media/image-ops.d.ts +39 -0
- package/dist/media/image-ops.js +20 -12
- package/dist/media/input-files.d.ts +76 -0
- package/dist/media/input-files.js +10 -6
- package/dist/media/mime.d.ts +15 -0
- package/dist/media/mime.js +30 -14
- package/dist/media/parse.d.ts +8 -0
- package/dist/media/parse.js +32 -22
- package/dist/media/server.d.ts +5 -0
- package/dist/media/server.js +10 -6
- package/dist/media/store.d.ts +18 -0
- package/dist/media/store.js +8 -5
- package/dist/media-understanding/apply.d.ts +19 -0
- package/dist/media-understanding/apply.js +288 -3
- package/dist/media-understanding/attachments.d.ts +43 -0
- package/dist/media-understanding/attachments.js +42 -23
- package/dist/media-understanding/concurrency.d.ts +1 -0
- package/dist/media-understanding/concurrency.js +4 -2
- package/dist/media-understanding/defaults.d.ts +10 -0
- package/dist/media-understanding/errors.d.ts +6 -0
- package/dist/media-understanding/format.d.ts +7 -0
- package/dist/media-understanding/format.js +6 -3
- package/dist/media-understanding/index.d.ts +4 -0
- package/dist/media-understanding/providers/anthropic/index.d.ts +2 -0
- package/dist/media-understanding/providers/deepgram/audio.d.ts +4 -0
- package/dist/media-understanding/providers/deepgram/audio.js +4 -2
- package/dist/media-understanding/providers/deepgram/index.d.ts +2 -0
- package/dist/media-understanding/providers/google/audio.d.ts +3 -0
- package/dist/media-understanding/providers/google/audio.js +2 -1
- package/dist/media-understanding/providers/google/index.d.ts +2 -0
- package/dist/media-understanding/providers/google/video.d.ts +3 -0
- package/dist/media-understanding/providers/google/video.js +2 -1
- package/dist/media-understanding/providers/groq/index.d.ts +2 -0
- package/dist/media-understanding/providers/image.d.ts +2 -0
- package/dist/media-understanding/providers/image.js +6 -6
- package/dist/media-understanding/providers/index.d.ts +4 -0
- package/dist/media-understanding/providers/index.js +2 -1
- package/dist/media-understanding/providers/minimax/index.d.ts +2 -0
- package/dist/media-understanding/providers/openai/audio.d.ts +3 -0
- package/dist/media-understanding/providers/openai/audio.js +4 -2
- package/dist/media-understanding/providers/openai/index.d.ts +2 -0
- package/dist/media-understanding/providers/shared.d.ts +3 -0
- package/dist/media-understanding/providers/shared.js +4 -2
- package/dist/media-understanding/resolve.d.ts +44 -0
- package/dist/media-understanding/resolve.js +22 -11
- package/dist/media-understanding/runner.d.ts +34 -0
- package/dist/media-understanding/runner.js +158 -81
- package/dist/media-understanding/scope.d.ts +9 -0
- package/dist/media-understanding/scope.js +14 -7
- package/dist/media-understanding/types.d.ts +92 -0
- package/dist/media-understanding/video.d.ts +2 -0
- package/dist/memory/batch-gemini.d.ts +55 -0
- package/dist/memory/batch-gemini.js +21 -12
- package/dist/memory/batch-openai.d.ts +45 -0
- package/dist/memory/batch-openai.js +17 -9
- package/dist/memory/embeddings-gemini.d.ts +13 -0
- package/dist/memory/embeddings-gemini.js +17 -9
- package/dist/memory/embeddings-openai.d.ts +13 -0
- package/dist/memory/embeddings-openai.js +6 -3
- package/dist/memory/embeddings.d.ts +36 -0
- package/dist/memory/embeddings.js +13 -8
- package/dist/memory/headers-fingerprint.d.ts +1 -0
- package/dist/memory/headers-fingerprint.js +4 -2
- package/dist/memory/hybrid.d.ts +34 -0
- package/dist/memory/hybrid.js +5 -3
- package/dist/memory/index.d.ts +2 -0
- package/dist/memory/internal.d.ts +26 -0
- package/dist/memory/internal.js +80 -29
- package/dist/memory/manager-cache-key.d.ts +6 -0
- package/dist/memory/manager-cache-key.js +3 -2
- package/dist/memory/manager-search.d.ts +60 -0
- package/dist/memory/manager-search.js +7 -4
- package/dist/memory/manager.d.ts +200 -0
- package/dist/memory/manager.js +235 -100
- package/dist/memory/memory-schema.d.ts +10 -0
- package/dist/memory/memory-schema.js +2 -1
- package/dist/memory/node-llama.d.ts +8 -0
- package/dist/memory/openai-batch.d.ts +1 -0
- package/dist/memory/provider-key.d.ts +14 -0
- package/dist/memory/provider-key.js +1 -1
- package/dist/memory/search-manager.d.ts +10 -0
- package/dist/memory/session-files.d.ts +12 -0
- package/dist/memory/session-files.js +18 -9
- package/dist/memory/sqlite-vec.d.ts +9 -0
- package/dist/memory/sqlite.d.ts +1 -0
- package/dist/memory/status-format.d.ts +28 -0
- package/dist/memory/status-format.js +10 -5
- package/dist/memory/sync-memory-files.d.ts +29 -0
- package/dist/memory/sync-memory-files.js +3 -2
- package/dist/memory/sync-session-files.d.ts +29 -0
- package/dist/memory/sync-session-files.js +2 -1
- package/dist/node-host/config.d.ts +17 -0
- package/dist/node-host/runner.d.ts +37 -0
- package/dist/node-host/runner.js +99 -57
- package/dist/pairing/pairing-labels.d.ts +2 -0
- package/dist/pairing/pairing-messages.d.ts +6 -0
- package/dist/pairing/pairing-messages.js +2 -2
- package/dist/pairing/pairing-store.d.ts +46 -0
- package/dist/pairing/pairing-store.js +34 -18
- package/dist/plugin-sdk/index.d.ts +99 -0
- package/dist/plugins/bundled-dir.d.ts +1 -0
- package/dist/plugins/bundled-dir.js +9 -5
- package/dist/plugins/cli.d.ts +3 -0
- package/dist/plugins/cli.js +2 -2
- package/dist/plugins/commands.d.ts +78 -0
- package/dist/plugins/commands.js +10 -5
- package/dist/plugins/config-schema.d.ts +2 -0
- package/dist/plugins/config-schema.js +2 -1
- package/dist/plugins/config-state.d.ts +33 -0
- package/dist/plugins/config-state.js +81 -6
- package/dist/plugins/discovery.d.ts +22 -0
- package/dist/plugins/discovery.js +36 -23
- package/dist/plugins/enable.d.ts +7 -0
- package/dist/plugins/enable.js +2 -1
- package/dist/plugins/hook-runner-global.d.ts +31 -0
- package/dist/plugins/hooks.d.ts +41 -0
- package/dist/plugins/hooks.js +12 -8
- package/dist/plugins/http-path.d.ts +1 -0
- package/dist/plugins/http-path.js +2 -1
- package/dist/plugins/http-registry.d.ts +13 -0
- package/dist/plugins/http-registry.js +1 -1
- package/dist/plugins/install.d.ts +60 -0
- package/dist/plugins/install.js +15 -12
- package/dist/plugins/installs.d.ts +6 -0
- package/dist/plugins/loader.d.ts +14 -0
- package/dist/plugins/loader.js +12 -13
- package/dist/plugins/manifest-registry.d.ts +33 -0
- package/dist/plugins/manifest-registry.js +14 -9
- package/dist/plugins/manifest.d.ts +64 -0
- package/dist/plugins/manifest.js +10 -10
- package/dist/plugins/providers.d.ts +6 -0
- package/dist/plugins/providers.js +2 -2
- package/dist/plugins/registry.d.ts +130 -0
- package/dist/plugins/registry.js +7 -5
- package/dist/plugins/runtime/index.d.ts +3 -0
- package/dist/plugins/runtime/index.js +24 -23
- package/dist/plugins/runtime/native-deps.d.ts +8 -0
- package/dist/plugins/runtime/types.d.ts +314 -0
- package/dist/plugins/runtime.d.ts +5 -0
- package/dist/plugins/runtime.js +1 -1
- package/dist/plugins/schema-validator.d.ts +10 -0
- package/dist/plugins/schema-validator.js +4 -2
- package/dist/plugins/services.d.ts +10 -0
- package/dist/plugins/services.js +3 -2
- package/dist/plugins/slots.d.ts +24 -0
- package/dist/plugins/slots.js +7 -4
- package/dist/plugins/status.d.ts +9 -0
- package/dist/plugins/status.js +2 -2
- package/dist/plugins/tools.d.ts +13 -0
- package/dist/plugins/tools.js +14 -8
- package/dist/plugins/types.d.ts +381 -0
- package/dist/plugins/update.d.ts +44 -0
- package/dist/plugins/update.js +25 -14
- package/dist/process/child-process-bridge.d.ts +8 -0
- package/dist/process/command-queue.d.ts +12 -0
- package/dist/process/command-queue.js +8 -4
- package/dist/process/exec.d.ts +22 -0
- package/dist/process/exec.js +14 -7
- package/dist/process/lanes.d.ts +6 -0
- package/dist/process/spawn-utils.d.ts +26 -0
- package/dist/process/spawn-utils.js +14 -7
- package/dist/providers/github-copilot-auth.d.ts +5 -0
- package/dist/providers/github-copilot-models.d.ts +3 -0
- package/dist/providers/github-copilot-models.js +2 -1
- package/dist/providers/github-copilot-token.d.ts +19 -0
- package/dist/providers/github-copilot-token.js +6 -3
- package/dist/providers/qwen-portal-oauth.d.ts +2 -0
- package/dist/providers/qwen-portal-oauth.js +1 -1
- package/dist/routing/bindings.d.ts +11 -0
- package/dist/routing/bindings.js +37 -19
- package/dist/routing/resolve-route.d.ts +36 -0
- package/dist/routing/resolve-route.js +34 -17
- package/dist/routing/session-key.d.ts +45 -0
- package/dist/routing/session-key.js +32 -16
- package/dist/security/audit-extra.d.ts +43 -0
- package/dist/security/audit-extra.js +124 -67
- package/dist/security/audit-fs.d.ts +44 -0
- package/dist/security/audit-fs.js +12 -6
- package/dist/security/audit.d.ts +55 -0
- package/dist/security/audit.js +67 -40
- package/dist/security/external-content.d.ts +62 -0
- package/dist/security/external-content.js +6 -3
- package/dist/security/fix.d.ts +34 -0
- package/dist/security/fix.js +54 -29
- package/dist/security/windows-acl.d.ts +37 -0
- package/dist/security/windows-acl.js +30 -15
- package/dist/sessions/level-overrides.d.ts +10 -0
- package/dist/sessions/level-overrides.js +6 -3
- package/dist/sessions/model-overrides.d.ts +14 -0
- package/dist/sessions/send-policy.d.ts +11 -0
- package/dist/sessions/send-policy.js +28 -14
- package/dist/sessions/session-key-utils.d.ts +8 -0
- package/dist/sessions/session-key-utils.js +22 -11
- package/dist/sessions/session-label.d.ts +9 -0
- package/dist/sessions/session-label.js +2 -1
- package/dist/sessions/transcript-events.d.ts +7 -0
- package/dist/sessions/transcript-events.js +2 -1
- package/dist/shared/text/reasoning-tags.d.ts +6 -0
- package/dist/shared/text/reasoning-tags.js +52 -7
- package/dist/signal/accounts.d.ts +17 -0
- package/dist/signal/accounts.js +9 -5
- package/dist/signal/client.d.ts +32 -0
- package/dist/signal/client.js +10 -5
- package/dist/signal/daemon.d.ts +18 -0
- package/dist/signal/daemon.js +20 -10
- package/dist/signal/format.d.ts +17 -0
- package/dist/signal/format.js +17 -10
- package/dist/signal/identity.d.ts +23 -0
- package/dist/signal/identity.js +18 -9
- package/dist/signal/index.d.ts +5 -0
- package/dist/signal/monitor/event-handler.d.ts +5 -0
- package/dist/signal/monitor/event-handler.js +41 -22
- package/dist/signal/monitor/event-handler.types.d.ts +117 -0
- package/dist/signal/monitor.d.ts +23 -0
- package/dist/signal/monitor.js +27 -14
- package/dist/signal/probe.d.ts +8 -0
- package/dist/signal/probe.js +4 -2
- package/dist/signal/reaction-level.d.ts +24 -0
- package/dist/signal/send-reactions.d.ts +32 -0
- package/dist/signal/send-reactions.js +20 -10
- package/dist/signal/send.d.ts +24 -0
- package/dist/signal/send.js +24 -12
- package/dist/signal/sse-reconnect.d.ts +13 -0
- package/dist/signal/sse-reconnect.js +8 -4
- package/dist/slack/accounts.d.ts +32 -0
- package/dist/slack/accounts.js +9 -5
- package/dist/slack/actions.d.ts +53 -0
- package/dist/slack/actions.js +4 -2
- package/dist/slack/channel-migration.d.ts +20 -0
- package/dist/slack/channel-migration.js +18 -9
- package/dist/slack/client.d.ts +4 -0
- package/dist/slack/directory-live.d.ts +4 -0
- package/dist/slack/directory-live.js +21 -11
- package/dist/slack/format.d.ts +7 -0
- package/dist/slack/format.js +6 -3
- package/dist/slack/http/index.d.ts +1 -0
- package/dist/slack/http/registry.d.ts +12 -0
- package/dist/slack/http/registry.js +4 -2
- package/dist/slack/index.d.ts +6 -0
- package/dist/slack/monitor/allow-list.d.ts +20 -0
- package/dist/slack/monitor/allow-list.js +8 -4
- package/dist/slack/monitor/auth.d.ts +10 -0
- package/dist/slack/monitor/channel-config.d.ts +40 -0
- package/dist/slack/monitor/channel-config.js +8 -4
- package/dist/slack/monitor/commands.d.ts +4 -0
- package/dist/slack/monitor/commands.js +4 -3
- package/dist/slack/monitor/context.d.ts +109 -0
- package/dist/slack/monitor/context.js +27 -14
- package/dist/slack/monitor/events/channels.d.ts +4 -0
- package/dist/slack/monitor/events/channels.js +10 -6
- package/dist/slack/monitor/events/members.d.ts +4 -0
- package/dist/slack/monitor/events/members.js +4 -2
- package/dist/slack/monitor/events/messages.d.ts +6 -0
- package/dist/slack/monitor/events/messages.js +4 -2
- package/dist/slack/monitor/events/pins.d.ts +4 -0
- package/dist/slack/monitor/events/pins.js +4 -2
- package/dist/slack/monitor/events/reactions.d.ts +4 -0
- package/dist/slack/monitor/events/reactions.js +6 -3
- package/dist/slack/monitor/events.d.ts +8 -0
- package/dist/slack/monitor/media.d.ts +29 -0
- package/dist/slack/monitor/media.js +8 -4
- package/dist/slack/monitor/message-handler/dispatch.d.ts +2 -0
- package/dist/slack/monitor/message-handler/dispatch.js +3 -2
- package/dist/slack/monitor/message-handler/prepare.d.ts +13 -0
- package/dist/slack/monitor/message-handler/prepare.js +14 -11
- package/dist/slack/monitor/message-handler/types.d.ts +22 -0
- package/dist/slack/monitor/message-handler.d.ts +11 -0
- package/dist/slack/monitor/message-handler.js +14 -7
- package/dist/slack/monitor/policy.d.ts +5 -0
- package/dist/slack/monitor/policy.js +6 -3
- package/dist/slack/monitor/provider.d.ts +2 -0
- package/dist/slack/monitor/provider.js +27 -16
- package/dist/slack/monitor/replies.d.ts +50 -0
- package/dist/slack/monitor/replies.js +11 -6
- package/dist/slack/monitor/slash.d.ts +6 -0
- package/dist/slack/monitor/slash.js +83 -72
- package/dist/slack/monitor/thread-resolution.d.ts +12 -0
- package/dist/slack/monitor/thread-resolution.js +4 -2
- package/dist/slack/monitor/types.d.ts +97 -0
- package/dist/slack/monitor.d.ts +5 -0
- package/dist/slack/monitor.test-helpers.d.ts +25 -0
- package/dist/slack/monitor.test-helpers.js +3 -2
- package/dist/slack/probe.d.ts +15 -0
- package/dist/slack/probe.js +4 -2
- package/dist/slack/resolve-channels.d.ts +19 -0
- package/dist/slack/resolve-channels.js +10 -5
- package/dist/slack/resolve-users.d.ts +26 -0
- package/dist/slack/resolve-users.js +20 -11
- package/dist/slack/scopes.d.ts +7 -0
- package/dist/slack/scopes.js +17 -9
- package/dist/slack/send.d.ts +14 -0
- package/dist/slack/send.js +5 -3
- package/dist/slack/targets.d.ts +7 -0
- package/dist/slack/targets.js +2 -1
- package/dist/slack/threading-tool-context.d.ts +10 -0
- package/dist/slack/threading.d.ts +20 -0
- package/dist/slack/token.d.ts +3 -0
- package/dist/slack/types.d.ts +36 -0
- package/dist/telegram/accounts.d.ts +17 -0
- package/dist/telegram/accounts.js +24 -13
- package/dist/telegram/allowed-updates.d.ts +4 -0
- package/dist/telegram/api-logging.d.ts +11 -0
- package/dist/telegram/api-logging.js +4 -2
- package/dist/telegram/audit.d.ts +29 -0
- package/dist/telegram/audit.js +12 -7
- package/dist/telegram/bot/delivery.d.ts +33 -0
- package/dist/telegram/bot/delivery.js +43 -13
- package/dist/telegram/bot/helpers.d.ts +67 -0
- package/dist/telegram/bot/helpers.js +49 -25
- package/dist/telegram/bot/types.d.ts +79 -0
- package/dist/telegram/bot-access.d.ts +24 -0
- package/dist/telegram/bot-access.js +14 -7
- package/dist/telegram/bot-handlers.d.ts +2 -0
- package/dist/telegram/bot-handlers.js +47 -26
- package/dist/telegram/bot-message-context.d.ts +138 -0
- package/dist/telegram/bot-message-context.js +32 -18
- package/dist/telegram/bot-message-dispatch.d.ts +1 -0
- package/dist/telegram/bot-message-dispatch.js +61 -26
- package/dist/telegram/bot-message.d.ts +1 -0
- package/dist/telegram/bot-message.js +2 -1
- package/dist/telegram/bot-native-commands.d.ts +58 -0
- package/dist/telegram/bot-native-commands.js +67 -20
- package/dist/telegram/bot-updates.d.ts +26 -0
- package/dist/telegram/bot-updates.js +4 -2
- package/dist/telegram/bot.d.ts +53 -0
- package/dist/telegram/bot.js +39 -20
- package/dist/telegram/caption.d.ts +5 -0
- package/dist/telegram/download.d.ts +9 -0
- package/dist/telegram/download.js +5 -3
- package/dist/telegram/draft-chunking.d.ts +6 -0
- package/dist/telegram/draft-stream.d.ts +16 -0
- package/dist/telegram/draft-stream.js +22 -12
- package/dist/telegram/fetch.d.ts +4 -0
- package/dist/telegram/fetch.js +4 -2
- package/dist/telegram/format.d.ts +16 -0
- package/dist/telegram/format.js +6 -3
- package/dist/telegram/group-migration.d.ts +20 -0
- package/dist/telegram/group-migration.js +18 -9
- package/dist/telegram/index.d.ts +4 -0
- package/dist/telegram/inline-buttons.d.ts +11 -0
- package/dist/telegram/inline-buttons.js +8 -4
- package/dist/telegram/monitor.d.ts +18 -0
- package/dist/telegram/monitor.js +14 -9
- package/dist/telegram/network-config.d.ts +12 -0
- package/dist/telegram/network-config.js +2 -2
- package/dist/telegram/network-errors.d.ts +5 -0
- package/dist/telegram/network-errors.js +24 -12
- package/dist/telegram/pairing-store.d.ts +43 -0
- package/dist/telegram/pairing-store.js +2 -1
- package/dist/telegram/probe.d.ts +18 -0
- package/dist/telegram/proxy.d.ts +1 -0
- package/dist/telegram/proxy.js +2 -2
- package/dist/telegram/reaction-level.d.ts +18 -0
- package/dist/telegram/send.d.ts +96 -0
- package/dist/telegram/send.js +32 -19
- package/dist/telegram/sent-message-cache.d.ts +16 -0
- package/dist/telegram/sent-message-cache.js +2 -1
- package/dist/telegram/sticker-cache.d.ts +46 -0
- package/dist/telegram/sticker-cache.js +10 -8
- package/dist/telegram/targets.d.ts +14 -0
- package/dist/telegram/targets.js +2 -1
- package/dist/telegram/token.d.ts +13 -0
- package/dist/telegram/token.js +17 -3
- package/dist/telegram/update-offset-store.d.ts +9 -0
- package/dist/telegram/update-offset-store.js +6 -3
- package/dist/telegram/voice.d.ts +20 -0
- package/dist/telegram/voice.js +4 -2
- package/dist/telegram/webhook-set.d.ts +12 -0
- package/dist/telegram/webhook-set.js +1 -1
- package/dist/telegram/webhook.d.ts +20 -0
- package/dist/telegram/webhook.js +5 -4
- package/dist/terminal/ansi.d.ts +2 -0
- package/dist/terminal/links.d.ts +6 -0
- package/dist/terminal/links.js +1 -1
- package/dist/terminal/note.d.ts +5 -0
- package/dist/terminal/note.js +8 -4
- package/dist/terminal/palette.d.ts +10 -0
- package/dist/terminal/progress-line.d.ts +3 -0
- package/dist/terminal/progress-line.js +8 -4
- package/dist/terminal/prompt-style.d.ts +3 -0
- package/dist/terminal/stream-writer.d.ts +11 -0
- package/dist/terminal/stream-writer.js +4 -2
- package/dist/terminal/table.d.ts +18 -0
- package/dist/terminal/table.js +49 -26
- package/dist/terminal/theme.d.ts +15 -0
- package/dist/tts/tts.d.ts +198 -0
- package/dist/tts/tts.js +116 -60
- package/dist/tui/commands.d.ts +14 -0
- package/dist/tui/commands.js +4 -2
- package/dist/tui/components/assistant-message.d.ts +6 -0
- package/dist/tui/components/chat-log.d.ts +22 -0
- package/dist/tui/components/chat-log.js +4 -2
- package/dist/tui/components/custom-editor.d.ts +14 -0
- package/dist/tui/components/custom-editor.js +1 -4
- package/dist/tui/components/filterable-select-list.d.ts +32 -0
- package/dist/tui/components/fuzzy-filter.d.ts +34 -0
- package/dist/tui/components/fuzzy-filter.js +26 -14
- package/dist/tui/components/searchable-select-list.d.ts +43 -0
- package/dist/tui/components/searchable-select-list.js +11 -6
- package/dist/tui/components/selectors.d.ts +7 -0
- package/dist/tui/components/tool-execution.d.ts +33 -0
- package/dist/tui/components/tool-execution.js +6 -3
- package/dist/tui/components/user-message.d.ts +6 -0
- package/dist/tui/gateway-chat.d.ts +119 -0
- package/dist/tui/gateway-chat.js +3 -3
- package/dist/tui/theme/syntax-theme.d.ts +7 -0
- package/dist/tui/theme/theme.d.ts +35 -0
- package/dist/tui/tui-command-handlers.d.ts +31 -0
- package/dist/tui/tui-command-handlers.js +4 -2
- package/dist/tui/tui-event-handlers.d.ts +15 -0
- package/dist/tui/tui-event-handlers.js +36 -18
- package/dist/tui/tui-formatters.d.ts +31 -0
- package/dist/tui/tui-formatters.js +39 -20
- package/dist/tui/tui-local-shell.d.ts +24 -0
- package/dist/tui/tui-local-shell.js +8 -4
- package/dist/tui/tui-overlays.d.ts +7 -0
- package/dist/tui/tui-session-actions.d.ts +28 -0
- package/dist/tui/tui-session-actions.js +16 -8
- package/dist/tui/tui-status-summary.d.ts +2 -0
- package/dist/tui/tui-status-summary.js +2 -1
- package/dist/tui/tui-stream-assembler.d.ts +8 -0
- package/dist/tui/tui-stream-assembler.js +2 -1
- package/dist/tui/tui-types.d.ts +103 -0
- package/dist/tui/tui-waiting.d.ts +16 -0
- package/dist/tui/tui.d.ts +13 -0
- package/dist/tui/tui.js +40 -21
- package/dist/utils/account-id.d.ts +1 -0
- package/dist/utils/account-id.js +2 -1
- package/dist/utils/boolean.d.ts +5 -0
- package/dist/utils/boolean.js +10 -5
- package/dist/utils/delivery-context.d.ts +29 -0
- package/dist/utils/delivery-context.js +21 -7
- package/dist/utils/directive-tags.d.ts +16 -0
- package/dist/utils/directive-tags.js +2 -1
- package/dist/utils/message-channel.d.ts +27 -0
- package/dist/utils/message-channel.js +18 -9
- package/dist/utils/provider-utils.d.ts +9 -0
- package/dist/utils/provider-utils.js +2 -1
- package/dist/utils/queue-helpers.d.ts +41 -0
- package/dist/utils/queue-helpers.js +20 -10
- package/dist/utils/time-format.d.ts +1 -0
- package/dist/utils/time-format.js +10 -5
- package/dist/utils/usage-format.d.ts +26 -0
- package/dist/utils/usage-format.js +18 -9
- package/dist/utils.js +58 -33
- package/dist/version.js +3 -3
- package/dist/web/accounts.d.ts +39 -0
- package/dist/web/accounts.js +11 -6
- package/dist/web/active-listener.d.ts +24 -0
- package/dist/web/active-listener.js +1 -1
- package/dist/web/auth-store.d.ts +25 -0
- package/dist/web/auth-store.js +20 -11
- package/dist/web/auto-reply/constants.d.ts +1 -0
- package/dist/web/auto-reply/deliver-reply.d.ts +18 -0
- package/dist/web/auto-reply/deliver-reply.js +1 -1
- package/dist/web/auto-reply/heartbeat-runner.d.ts +20 -0
- package/dist/web/auto-reply/heartbeat-runner.js +9 -5
- package/dist/web/auto-reply/loggers.d.ts +4 -0
- package/dist/web/auto-reply/mentions.d.ts +19 -0
- package/dist/web/auto-reply/mentions.js +10 -5
- package/dist/web/auto-reply/monitor/ack-reaction.d.ts +13 -0
- package/dist/web/auto-reply/monitor/ack-reaction.js +5 -3
- package/dist/web/auto-reply/monitor/broadcast.d.ts +16 -0
- package/dist/web/auto-reply/monitor/broadcast.js +4 -2
- package/dist/web/auto-reply/monitor/commands.d.ts +2 -0
- package/dist/web/auto-reply/monitor/commands.js +2 -1
- package/dist/web/auto-reply/monitor/echo.d.ts +17 -0
- package/dist/web/auto-reply/monitor/echo.js +4 -2
- package/dist/web/auto-reply/monitor/group-activation.d.ts +9 -0
- package/dist/web/auto-reply/monitor/group-activation.js +1 -1
- package/dist/web/auto-reply/monitor/group-gating.d.ts +29 -0
- package/dist/web/auto-reply/monitor/group-gating.js +4 -3
- package/dist/web/auto-reply/monitor/group-members.d.ts +6 -0
- package/dist/web/auto-reply/monitor/group-members.js +14 -7
- package/dist/web/auto-reply/monitor/last-route.d.ts +15 -0
- package/dist/web/auto-reply/monitor/last-route.js +2 -1
- package/dist/web/auto-reply/monitor/message-line.d.ts +11 -0
- package/dist/web/auto-reply/monitor/message-line.js +2 -1
- package/dist/web/auto-reply/monitor/on-message.d.ts +24 -0
- package/dist/web/auto-reply/monitor/on-message.js +2 -1
- package/dist/web/auto-reply/monitor/peer.d.ts +2 -0
- package/dist/web/auto-reply/monitor/peer.js +6 -3
- package/dist/web/auto-reply/monitor/process-message.d.ts +40 -0
- package/dist/web/auto-reply/monitor/process-message.js +18 -11
- package/dist/web/auto-reply/monitor.d.ts +5 -0
- package/dist/web/auto-reply/monitor.js +22 -13
- package/dist/web/auto-reply/session-snapshot.d.ts +17 -0
- package/dist/web/auto-reply/types.d.ts +28 -0
- package/dist/web/auto-reply/util.d.ts +2 -0
- package/dist/web/auto-reply/util.js +20 -10
- package/dist/web/auto-reply.d.ts +1 -0
- package/dist/web/auto-reply.impl.d.ts +6 -0
- package/dist/web/inbound/access-control.d.ts +24 -0
- package/dist/web/inbound/dedupe.d.ts +2 -0
- package/dist/web/inbound/extract.d.ts +13 -0
- package/dist/web/inbound/extract.js +60 -30
- package/dist/web/inbound/media.d.ts +6 -0
- package/dist/web/inbound/media.js +4 -3
- package/dist/web/inbound/monitor.d.ts +30 -0
- package/dist/web/inbound/monitor.js +29 -15
- package/dist/web/inbound/send-api.d.ts +22 -0
- package/dist/web/inbound/types.d.ts +40 -0
- package/dist/web/inbound.d.ts +4 -0
- package/dist/web/login-qr.d.ts +19 -0
- package/dist/web/login-qr.js +13 -7
- package/dist/web/login.d.ts +3 -0
- package/dist/web/login.js +4 -4
- package/dist/web/media.d.ts +20 -0
- package/dist/web/media.js +16 -9
- package/dist/web/outbound.d.ts +23 -0
- package/dist/web/outbound.js +3 -3
- package/dist/web/qr-image.d.ts +4 -0
- package/dist/web/qr-image.js +2 -1
- package/dist/web/reconnect.d.ts +12 -0
- package/dist/web/reconnect.js +2 -1
- package/dist/web/session.d.ts +14 -0
- package/dist/web/session.js +36 -20
- package/dist/web/vcard.d.ts +6 -0
- package/dist/web/vcard.js +18 -9
- package/dist/whatsapp/normalize.d.ts +6 -0
- package/dist/whatsapp/normalize.js +16 -8
- package/dist/wizard/clack-prompter.d.ts +2 -0
- package/dist/wizard/clack-prompter.js +9 -6
- package/dist/wizard/onboarding.d.ts +4 -0
- package/dist/wizard/onboarding.finalize.d.ts +17 -0
- package/dist/wizard/onboarding.finalize.js +34 -31
- package/dist/wizard/onboarding.gateway-config.d.ts +19 -0
- package/dist/wizard/onboarding.gateway-config.js +20 -17
- package/dist/wizard/onboarding.js +43 -24
- package/dist/wizard/onboarding.types.d.ts +22 -0
- package/dist/wizard/prompts.d.ts +42 -0
- package/dist/wizard/session.d.ts +42 -0
- package/dist/wizard/session.js +4 -2
- package/docs/CNAME +1 -1
- package/docs/_config.yml +3 -3
- package/docs/_layouts/default.html +9 -9
- package/docs/assets/openclaw-logo-text-dark.png +0 -0
- package/docs/assets/openclaw-logo-text.png +0 -0
- package/docs/assets/theme.js +1 -1
- package/docs/automation/auth-monitoring.md +10 -7
- package/docs/automation/cron-jobs.md +184 -26
- package/docs/automation/cron-vs-heartbeat.md +43 -36
- package/docs/automation/gmail-pubsub.md +44 -40
- package/docs/automation/poll.md +14 -8
- package/docs/automation/webhook.md +16 -8
- package/docs/bedrock.md +27 -23
- package/docs/brave-search.md +9 -8
- package/docs/broadcast-groups.md +50 -15
- package/docs/channels/bluebubbles.md +70 -39
- package/docs/channels/discord.md +129 -68
- package/docs/channels/googlechat.md +67 -37
- package/docs/channels/grammy.md +5 -1
- package/docs/channels/imessage.md +81 -47
- package/docs/channels/index.md +6 -4
- package/docs/channels/line.md +31 -28
- package/docs/channels/location.md +9 -1
- package/docs/channels/matrix.md +44 -41
- package/docs/channels/mattermost.md +36 -21
- package/docs/channels/msteams.md +154 -95
- package/docs/channels/nextcloud-talk.md +40 -25
- package/docs/channels/nostr.md +34 -36
- package/docs/channels/signal.md +49 -26
- package/docs/channels/slack.md +120 -81
- package/docs/channels/telegram.md +203 -128
- package/docs/channels/tlon.md +31 -32
- package/docs/channels/troubleshooting.md +6 -2
- package/docs/channels/twitch.md +81 -70
- package/docs/channels/whatsapp.md +84 -42
- package/docs/channels/zalo.md +55 -33
- package/docs/channels/zalouser.md +45 -28
- package/docs/cli/acp.md +31 -27
- package/docs/cli/agent.md +8 -6
- package/docs/cli/agents.md +20 -16
- package/docs/cli/approvals.md +16 -14
- package/docs/cli/browser.md +27 -24
- package/docs/cli/channels.md +25 -21
- package/docs/cli/config.md +16 -15
- package/docs/cli/configure.md +9 -6
- package/docs/cli/cron.md +7 -5
- package/docs/cli/dashboard.md +5 -5
- package/docs/cli/devices.md +14 -13
- package/docs/cli/directory.md +15 -12
- package/docs/cli/dns.md +7 -6
- package/docs/cli/docs.md +6 -6
- package/docs/cli/doctor.md +14 -11
- package/docs/cli/gateway.md +38 -26
- package/docs/cli/health.md +7 -5
- package/docs/cli/hooks.md +49 -35
- package/docs/cli/index.md +154 -43
- package/docs/cli/logs.md +8 -7
- package/docs/cli/memory.md +16 -12
- package/docs/cli/message.md +22 -11
- package/docs/cli/models.md +26 -15
- package/docs/cli/node.md +21 -17
- package/docs/cli/nodes.md +19 -14
- package/docs/cli/onboard.md +10 -7
- package/docs/cli/pairing.md +6 -5
- package/docs/cli/plugins.md +18 -16
- package/docs/cli/reset.md +6 -6
- package/docs/cli/sandbox.md +39 -37
- package/docs/cli/security.md +7 -5
- package/docs/cli/sessions.md +6 -6
- package/docs/cli/setup.md +8 -7
- package/docs/cli/skills.md +9 -8
- package/docs/cli/status.md +9 -7
- package/docs/cli/system.md +11 -6
- package/docs/cli/tui.md +7 -6
- package/docs/cli/uninstall.md +6 -6
- package/docs/cli/update.md +22 -20
- package/docs/cli/voicecall.md +11 -10
- package/docs/cli/webhooks.md +7 -5
- package/docs/concepts/agent-loop.md +29 -9
- package/docs/concepts/agent-workspace.md +30 -28
- package/docs/concepts/agent.md +23 -17
- package/docs/concepts/architecture.md +9 -2
- package/docs/concepts/channel-routing.md +12 -12
- package/docs/concepts/compaction.md +17 -5
- package/docs/concepts/context.md +21 -11
- package/docs/concepts/group-messages.md +26 -20
- package/docs/concepts/groups.md +103 -74
- package/docs/concepts/markdown-formatting.md +6 -8
- package/docs/concepts/memory.md +71 -28
- package/docs/concepts/messages.md +20 -9
- package/docs/concepts/model-failover.md +29 -19
- package/docs/concepts/model-providers.md +59 -65
- package/docs/concepts/models.md +43 -37
- package/docs/concepts/multi-agent.md +79 -57
- package/docs/concepts/oauth.md +40 -30
- package/docs/concepts/presence.md +6 -2
- package/docs/concepts/queue.md +15 -3
- package/docs/concepts/retry.md +16 -7
- package/docs/concepts/session-pruning.md +33 -15
- package/docs/concepts/session-tool.md +30 -8
- package/docs/concepts/session.md +50 -34
- package/docs/concepts/sessions.md +2 -0
- package/docs/concepts/streaming.md +15 -3
- package/docs/concepts/system-prompt.md +20 -15
- package/docs/concepts/timezone.md +8 -6
- package/docs/concepts/typebox.md +46 -38
- package/docs/concepts/typing-indicators.md +15 -6
- package/docs/concepts/usage-tracking.md +8 -3
- package/docs/date-time.md +9 -8
- package/docs/debug/node-issue.md +18 -7
- package/docs/debugging.md +21 -20
- package/docs/diagnostics/flags.md +9 -7
- package/docs/docs.json +38 -24
- package/docs/environment.md +22 -19
- package/docs/experiments/onboarding-config-protocol.md +6 -0
- package/docs/experiments/plans/cron-add-hardening.md +7 -1
- package/docs/experiments/plans/group-policy-hardening.md +3 -1
- package/docs/experiments/plans/openresponses-gateway.md +3 -2
- package/docs/experiments/proposals/model-config.md +4 -0
- package/docs/experiments/research/memory.md +32 -14
- package/docs/gateway/authentication.md +26 -24
- package/docs/gateway/background-process.md +18 -7
- package/docs/gateway/bonjour.md +31 -26
- package/docs/gateway/bridge-protocol.md +10 -6
- package/docs/gateway/cli-backends.md +37 -35
- package/docs/gateway/configuration-examples.md +143 -135
- package/docs/gateway/configuration.md +795 -660
- package/docs/gateway/discovery.md +22 -16
- package/docs/gateway/doctor.md +57 -27
- package/docs/gateway/gateway-lock.md +7 -1
- package/docs/gateway/health.md +17 -11
- package/docs/gateway/heartbeat.md +36 -31
- package/docs/gateway/index.md +99 -63
- package/docs/gateway/local-models.md +31 -27
- package/docs/gateway/logging.md +9 -8
- package/docs/gateway/multiple-gateways.md +32 -27
- package/docs/gateway/openai-http-api.md +26 -20
- package/docs/gateway/openresponses-http-api.md +48 -29
- package/docs/gateway/pairing.md +16 -9
- package/docs/gateway/protocol.md +12 -6
- package/docs/gateway/remote-gateway-readme.md +18 -16
- package/docs/gateway/remote.md +12 -7
- package/docs/gateway/sandbox-vs-tool-policy-vs-elevated.md +22 -14
- package/docs/gateway/sandboxing.md +43 -26
- package/docs/gateway/security/formal-verification.md +12 -8
- package/docs/gateway/security/index.md +152 -97
- package/docs/gateway/tailscale.md +19 -16
- package/docs/gateway/tools-invoke-http-api.md +11 -5
- package/docs/gateway/troubleshooting.md +189 -136
- package/docs/help/faq.md +548 -451
- package/docs/help/index.md +1 -0
- package/docs/help/troubleshooting.md +17 -16
- package/docs/hooks/soul-evil.md +3 -2
- package/docs/hooks.md +95 -78
- package/docs/index.md +61 -44
- package/docs/install/ansible.md +38 -35
- package/docs/install/bun.md +2 -1
- package/docs/install/development-channels.md +11 -10
- package/docs/install/docker.md +102 -67
- package/docs/install/index.md +34 -33
- package/docs/install/installer.md +29 -28
- package/docs/install/migrating.md +38 -36
- package/docs/install/nix.md +19 -18
- package/docs/install/node.md +6 -6
- package/docs/install/uninstall.md +41 -38
- package/docs/install/updating.md +63 -54
- package/docs/logging.md +69 -62
- package/docs/multi-agent-sandbox-tools.md +39 -18
- package/docs/network.md +4 -1
- package/docs/nodes/audio.md +34 -29
- package/docs/nodes/camera.md +23 -19
- package/docs/nodes/images.md +15 -4
- package/docs/nodes/index.md +71 -57
- package/docs/nodes/location-command.md +23 -5
- package/docs/nodes/media-understanding.md +129 -63
- package/docs/nodes/talk.md +24 -13
- package/docs/nodes/voicewake.md +7 -3
- package/docs/northflank.mdx +24 -24
- package/docs/perplexity.md +13 -12
- package/docs/pi-dev.md +70 -0
- package/docs/pi.md +600 -0
- package/docs/platforms/android.md +22 -15
- package/docs/platforms/digitalocean.md +58 -39
- package/docs/platforms/exe-dev.md +23 -23
- package/docs/platforms/fly.md +62 -44
- package/docs/platforms/gcp.md +79 -74
- package/docs/platforms/hetzner.md +73 -68
- package/docs/platforms/index.md +11 -8
- package/docs/platforms/ios.md +20 -17
- package/docs/platforms/linux.md +19 -14
- package/docs/platforms/mac/bundled-gateway.md +20 -14
- package/docs/platforms/mac/canvas.md +18 -14
- package/docs/platforms/mac/child-process.md +7 -5
- package/docs/platforms/mac/dev-setup.md +22 -11
- package/docs/platforms/mac/health.md +8 -2
- package/docs/platforms/mac/icon.md +6 -1
- package/docs/platforms/mac/logging.md +10 -4
- package/docs/platforms/mac/menu-bar.md +12 -1
- package/docs/platforms/mac/peekaboo.md +12 -9
- package/docs/platforms/mac/permissions.md +5 -1
- package/docs/platforms/mac/release.md +24 -16
- package/docs/platforms/mac/remote.md +29 -17
- package/docs/platforms/mac/signing.md +11 -7
- package/docs/platforms/mac/skills.md +10 -4
- package/docs/platforms/mac/voice-overlay.md +9 -1
- package/docs/platforms/mac/voicewake.md +12 -1
- package/docs/platforms/mac/webchat.md +3 -1
- package/docs/platforms/mac/xpc.md +14 -4
- package/docs/platforms/macos-vm.md +37 -31
- package/docs/platforms/macos.md +31 -23
- package/docs/platforms/oracle.md +62 -50
- package/docs/platforms/raspberry-pi.md +49 -45
- package/docs/platforms/windows.md +16 -11
- package/docs/plugin.md +119 -93
- package/docs/plugins/agent-tools.md +12 -9
- package/docs/plugins/manifest.md +9 -5
- package/docs/plugins/voice-call.md +50 -43
- package/docs/plugins/zalouser.md +18 -12
- package/docs/prose.md +15 -12
- package/docs/providers/anthropic.md +29 -23
- package/docs/providers/claude-max-api-proxy.md +19 -16
- package/docs/providers/deepgram.md +24 -20
- package/docs/providers/github-copilot.md +15 -13
- package/docs/providers/glm.md +7 -5
- package/docs/providers/index.md +12 -9
- package/docs/providers/minimax.md +57 -32
- package/docs/providers/models.md +11 -9
- package/docs/providers/moonshot.md +31 -52
- package/docs/providers/ollama.md +29 -25
- package/docs/providers/openai.md +10 -8
- package/docs/providers/opencode.md +6 -4
- package/docs/providers/openrouter.md +8 -6
- package/docs/providers/qwen.md +8 -6
- package/docs/providers/synthetic.md +37 -35
- package/docs/providers/venice.md +86 -83
- package/docs/providers/vercel-ai-gateway.md +11 -11
- package/docs/providers/xiaomi.md +64 -0
- package/docs/providers/zai.md +8 -6
- package/docs/railway.mdx +30 -27
- package/docs/refactor/clawnet.md +72 -15
- package/docs/refactor/exec-host.md +66 -15
- package/docs/refactor/outbound-session-mirroring.md +11 -1
- package/docs/refactor/plugin-sdk.md +41 -14
- package/docs/refactor/strict-config.md +25 -13
- package/docs/reference/AGENTS.default.md +32 -21
- package/docs/reference/RELEASING.md +50 -38
- package/docs/reference/api-usage-costs.md +27 -6
- package/docs/reference/device-models.md +8 -7
- package/docs/reference/rpc.md +9 -3
- package/docs/reference/session-management-compaction.md +45 -33
- package/docs/reference/templates/AGENTS.dev.md +17 -12
- package/docs/reference/templates/AGENTS.md +23 -1
- package/docs/reference/templates/BOOT.md +2 -1
- package/docs/reference/templates/BOOTSTRAP.md +8 -2
- package/docs/reference/templates/HEARTBEAT.md +2 -0
- package/docs/reference/templates/IDENTITY.dev.md +7 -0
- package/docs/reference/templates/IDENTITY.md +1 -1
- package/docs/reference/templates/SOUL.dev.md +3 -1
- package/docs/reference/templates/SOUL.md +5 -4
- package/docs/reference/templates/TOOLS.dev.md +5 -2
- package/docs/reference/templates/TOOLS.md +7 -2
- package/docs/reference/templates/USER.dev.md +4 -3
- package/docs/reference/test.md +6 -2
- package/docs/reference/transcript-hygiene.md +13 -1
- package/docs/render.mdx +34 -27
- package/docs/scripts.md +3 -1
- package/docs/security/formal-verification.md +12 -8
- package/docs/start/getting-started.md +33 -29
- package/docs/start/hubs.md +5 -3
- package/docs/start/lore.md +80 -30
- package/docs/start/onboarding.md +18 -15
- package/docs/start/{clawd.md → openclaw.md} +58 -52
- package/docs/start/pairing.md +16 -14
- package/docs/start/setup.md +34 -29
- package/docs/start/showcase.md +60 -60
- package/docs/start/wizard.md +65 -53
- package/docs/testing.md +77 -58
- package/docs/token-use.md +9 -7
- package/docs/tools/agent-send.md +12 -10
- package/docs/tools/apply-patch.md +1 -0
- package/docs/tools/browser-linux-troubleshooting.md +33 -23
- package/docs/tools/browser-login.md +14 -13
- package/docs/tools/browser.md +163 -137
- package/docs/tools/chrome-extension.md +35 -26
- package/docs/tools/{clawdhub.md → clawhub.md} +46 -45
- package/docs/tools/creating-skills.md +21 -8
- package/docs/tools/elevated.md +8 -0
- package/docs/tools/exec-approvals.md +27 -9
- package/docs/tools/exec.md +23 -13
- package/docs/tools/firecrawl.md +15 -12
- package/docs/tools/index.md +107 -49
- package/docs/tools/llm-task.md +5 -4
- package/docs/tools/lobster.md +18 -14
- package/docs/tools/reactions.md +2 -0
- package/docs/tools/skills-config.md +14 -13
- package/docs/tools/skills.md +86 -53
- package/docs/tools/slash-commands.md +18 -10
- package/docs/tools/subagents.md +19 -6
- package/docs/tools/thinking.md +11 -0
- package/docs/tools/web.md +49 -47
- package/docs/tts.md +52 -45
- package/docs/tui.md +35 -10
- package/docs/vps.md +3 -1
- package/docs/web/control-ui.md +22 -14
- package/docs/web/dashboard.md +10 -6
- package/docs/web/index.md +15 -11
- package/docs/web/webchat.md +12 -4
- package/extensions/bluebubbles/index.ts +3 -4
- package/extensions/bluebubbles/node_modules/.bin/openclaw +17 -0
- package/extensions/bluebubbles/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/bluebubbles/package.json +8 -5
- package/extensions/bluebubbles/src/accounts.ts +22 -14
- package/extensions/bluebubbles/src/actions.test.ts +22 -23
- package/extensions/bluebubbles/src/actions.ts +71 -36
- package/extensions/bluebubbles/src/attachments.test.ts +1 -2
- package/extensions/bluebubbles/src/attachments.ts +39 -21
- package/extensions/bluebubbles/src/channel.ts +54 -39
- package/extensions/bluebubbles/src/chat.test.ts +0 -1
- package/extensions/bluebubbles/src/chat.ts +49 -25
- package/extensions/bluebubbles/src/config-schema.ts +1 -1
- package/extensions/bluebubbles/src/media-send.ts +14 -8
- package/extensions/bluebubbles/src/monitor.test.ts +297 -103
- package/extensions/bluebubbles/src/monitor.ts +341 -148
- package/extensions/bluebubbles/src/onboarding.ts +28 -16
- package/extensions/bluebubbles/src/probe.ts +19 -11
- package/extensions/bluebubbles/src/reactions.test.ts +0 -1
- package/extensions/bluebubbles/src/reactions.ts +21 -16
- package/extensions/bluebubbles/src/runtime.ts +1 -1
- package/extensions/bluebubbles/src/send.test.ts +1 -2
- package/extensions/bluebubbles/src/send.ts +76 -27
- package/extensions/bluebubbles/src/targets.test.ts +0 -1
- package/extensions/bluebubbles/src/targets.ts +151 -52
- package/extensions/copilot-proxy/README.md +3 -3
- package/extensions/copilot-proxy/index.ts +10 -4
- package/extensions/copilot-proxy/node_modules/.bin/openclaw +17 -0
- package/extensions/copilot-proxy/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/copilot-proxy/package.json +7 -4
- package/extensions/diagnostics-otel/index.ts +3 -4
- package/extensions/diagnostics-otel/node_modules/.bin/openclaw +17 -0
- package/extensions/diagnostics-otel/package.json +11 -8
- package/extensions/diagnostics-otel/src/service.test.ts +22 -16
- package/extensions/diagnostics-otel/src/service.ts +185 -116
- package/extensions/discord/index.ts +3 -4
- package/extensions/discord/node_modules/.bin/openclaw +17 -0
- package/extensions/discord/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/discord/package.json +7 -4
- package/extensions/discord/src/channel.ts +10 -10
- package/extensions/discord/src/runtime.ts +1 -1
- package/extensions/google-antigravity-auth/README.md +3 -3
- package/extensions/google-antigravity-auth/index.ts +42 -18
- package/extensions/google-antigravity-auth/node_modules/.bin/openclaw +17 -0
- package/extensions/google-antigravity-auth/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/google-antigravity-auth/package.json +7 -4
- package/extensions/google-gemini-cli-auth/README.md +5 -5
- package/extensions/google-gemini-cli-auth/index.ts +4 -7
- package/extensions/google-gemini-cli-auth/node_modules/.bin/openclaw +17 -0
- package/extensions/google-gemini-cli-auth/oauth.test.ts +19 -7
- package/extensions/google-gemini-cli-auth/oauth.ts +122 -40
- package/extensions/google-gemini-cli-auth/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/google-gemini-cli-auth/package.json +7 -4
- package/extensions/googlechat/index.ts +4 -5
- package/extensions/googlechat/node_modules/.bin/openclaw +17 -0
- package/extensions/googlechat/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/googlechat/package.json +14 -14
- package/extensions/googlechat/src/accounts.ts +40 -26
- package/extensions/googlechat/src/actions.ts +37 -18
- package/extensions/googlechat/src/api.test.ts +0 -1
- package/extensions/googlechat/src/api.ts +37 -14
- package/extensions/googlechat/src/auth.ts +17 -7
- package/extensions/googlechat/src/channel.ts +48 -45
- package/extensions/googlechat/src/monitor.test.ts +2 -7
- package/extensions/googlechat/src/monitor.ts +115 -66
- package/extensions/googlechat/src/onboarding.ts +29 -38
- package/extensions/googlechat/src/runtime.ts +1 -1
- package/extensions/googlechat/src/targets.test.ts +1 -4
- package/extensions/googlechat/src/targets.ts +15 -5
- package/extensions/googlechat/src/types.config.ts +1 -1
- package/extensions/imessage/index.ts +3 -4
- package/extensions/imessage/node_modules/.bin/openclaw +17 -0
- package/extensions/imessage/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/imessage/package.json +7 -4
- package/extensions/imessage/src/channel.ts +8 -8
- package/extensions/imessage/src/runtime.ts +1 -1
- package/extensions/line/index.ts +4 -5
- package/extensions/line/node_modules/.bin/openclaw +17 -0
- package/extensions/line/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/line/package.json +8 -8
- package/extensions/line/src/card-command.ts +17 -11
- package/extensions/line/src/channel.logout.test.ts +22 -21
- package/extensions/line/src/channel.sendPayload.test.ts +23 -25
- package/extensions/line/src/channel.ts +62 -54
- package/extensions/line/src/runtime.ts +1 -1
- package/extensions/llm-task/README.md +6 -6
- package/extensions/llm-task/index.ts +2 -3
- package/extensions/llm-task/node_modules/.bin/openclaw +17 -0
- package/extensions/llm-task/package.json +7 -4
- package/extensions/llm-task/src/llm-task-tool.test.ts +20 -13
- package/extensions/llm-task/src/llm-task-tool.ts +48 -29
- package/extensions/lobster/README.md +14 -19
- package/extensions/lobster/SKILL.md +14 -7
- package/extensions/lobster/index.ts +5 -4
- package/extensions/lobster/node_modules/.bin/openclaw +17 -0
- package/extensions/lobster/package.json +7 -4
- package/extensions/lobster/src/lobster-tool.test.ts +141 -38
- package/extensions/lobster/src/lobster-tool.ts +107 -19
- package/extensions/matrix/CHANGELOG.md +27 -11
- package/extensions/matrix/index.ts +3 -4
- package/extensions/matrix/node_modules/.bin/openclaw +17 -0
- package/extensions/matrix/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/matrix/package.json +15 -15
- package/extensions/matrix/src/actions.ts +17 -7
- package/extensions/matrix/src/channel.directory.test.ts +13 -5
- package/extensions/matrix/src/channel.ts +64 -38
- package/extensions/matrix/src/config-schema.ts +1 -1
- package/extensions/matrix/src/directory-live.ts +22 -9
- package/extensions/matrix/src/group-mentions.ts +11 -6
- package/extensions/matrix/src/matrix/accounts.test.ts +0 -1
- package/extensions/matrix/src/matrix/accounts.ts +5 -3
- package/extensions/matrix/src/matrix/actions/client.ts +9 -5
- package/extensions/matrix/src/matrix/actions/messages.ts +17 -9
- package/extensions/matrix/src/matrix/actions/pins.ts +12 -6
- package/extensions/matrix/src/matrix/actions/reactions.ts +24 -12
- package/extensions/matrix/src/matrix/actions/room.ts +10 -13
- package/extensions/matrix/src/matrix/actions/summary.ts +4 -6
- package/extensions/matrix/src/matrix/client/config.ts +5 -10
- package/extensions/matrix/src/matrix/client/create-client.ts +12 -16
- package/extensions/matrix/src/matrix/client/logging.ts +17 -16
- package/extensions/matrix/src/matrix/client/shared.ts +6 -5
- package/extensions/matrix/src/matrix/client/storage.ts +12 -12
- package/extensions/matrix/src/matrix/client.test.ts +0 -1
- package/extensions/matrix/src/matrix/client.ts +1 -5
- package/extensions/matrix/src/matrix/credentials.ts +7 -5
- package/extensions/matrix/src/matrix/deps.ts +8 -5
- package/extensions/matrix/src/matrix/format.test.ts +0 -1
- package/extensions/matrix/src/matrix/monitor/allowlist.ts +7 -3
- package/extensions/matrix/src/matrix/monitor/auto-join.ts +7 -4
- package/extensions/matrix/src/matrix/monitor/direct.ts +11 -12
- package/extensions/matrix/src/matrix/monitor/events.ts +2 -4
- package/extensions/matrix/src/matrix/monitor/handler.ts +67 -42
- package/extensions/matrix/src/matrix/monitor/index.ts +27 -15
- package/extensions/matrix/src/matrix/monitor/location.ts +28 -11
- package/extensions/matrix/src/matrix/monitor/media.test.ts +1 -2
- package/extensions/matrix/src/matrix/monitor/media.ts +8 -8
- package/extensions/matrix/src/matrix/monitor/replies.ts +5 -4
- package/extensions/matrix/src/matrix/monitor/room-info.ts +5 -8
- package/extensions/matrix/src/matrix/monitor/rooms.ts +7 -2
- package/extensions/matrix/src/matrix/monitor/threads.ts +6 -2
- package/extensions/matrix/src/matrix/poll-types.test.ts +0 -1
- package/extensions/matrix/src/matrix/poll-types.ts +17 -8
- package/extensions/matrix/src/matrix/send/client.ts +8 -5
- package/extensions/matrix/src/matrix/send/formatting.ts +14 -17
- package/extensions/matrix/src/matrix/send/media.ts +17 -8
- package/extensions/matrix/src/matrix/send/targets.test.ts +7 -11
- package/extensions/matrix/src/matrix/send/targets.ts +19 -27
- package/extensions/matrix/src/matrix/send.test.ts +1 -2
- package/extensions/matrix/src/matrix/send.ts +10 -5
- package/extensions/matrix/src/onboarding.ts +26 -16
- package/extensions/matrix/src/outbound.ts +2 -3
- package/extensions/matrix/src/resolve-targets.ts +8 -8
- package/extensions/matrix/src/runtime.ts +1 -1
- package/extensions/matrix/src/tool-actions.ts +15 -11
- package/extensions/mattermost/index.ts +3 -4
- package/extensions/mattermost/node_modules/.bin/openclaw +17 -0
- package/extensions/mattermost/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/mattermost/package.json +8 -5
- package/extensions/mattermost/src/channel.test.ts +9 -4
- package/extensions/mattermost/src/channel.ts +10 -12
- package/extensions/mattermost/src/config-schema.ts +2 -3
- package/extensions/mattermost/src/group-mentions.ts +4 -3
- package/extensions/mattermost/src/mattermost/accounts.ts +31 -18
- package/extensions/mattermost/src/mattermost/client.ts +18 -6
- package/extensions/mattermost/src/mattermost/monitor-helpers.ts +33 -17
- package/extensions/mattermost/src/mattermost/monitor.ts +137 -71
- package/extensions/mattermost/src/mattermost/probe.ts +6 -2
- package/extensions/mattermost/src/mattermost/send.ts +21 -7
- package/extensions/mattermost/src/normalize.ts +12 -4
- package/extensions/mattermost/src/onboarding-helpers.ts +9 -7
- package/extensions/mattermost/src/onboarding.ts +4 -5
- package/extensions/mattermost/src/runtime.ts +1 -1
- package/extensions/mattermost/src/types.ts +1 -1
- package/extensions/memory-core/index.ts +6 -4
- package/extensions/memory-core/node_modules/.bin/openclaw +17 -0
- package/extensions/memory-core/package.json +10 -10
- package/extensions/memory-lancedb/config.ts +34 -9
- package/extensions/memory-lancedb/index.test.ts +10 -8
- package/extensions/memory-lancedb/index.ts +76 -58
- package/extensions/memory-lancedb/node_modules/.bin/openclaw +17 -0
- package/extensions/memory-lancedb/{clawdbot.plugin.json → openclaw.plugin.json} +4 -11
- package/extensions/memory-lancedb/package.json +9 -6
- package/extensions/minimax-portal-auth/README.md +33 -0
- package/extensions/minimax-portal-auth/index.ts +155 -0
- package/extensions/minimax-portal-auth/node_modules/.bin/openclaw +17 -0
- package/extensions/minimax-portal-auth/oauth.ts +247 -0
- package/extensions/minimax-portal-auth/openclaw.plugin.json +9 -0
- package/extensions/minimax-portal-auth/package.json +14 -0
- package/extensions/msteams/CHANGELOG.md +24 -9
- package/extensions/msteams/index.ts +3 -4
- package/extensions/msteams/node_modules/.bin/openclaw +17 -0
- package/extensions/msteams/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/msteams/package.json +16 -13
- package/extensions/msteams/src/attachments/download.ts +53 -21
- package/extensions/msteams/src/attachments/graph.ts +48 -16
- package/extensions/msteams/src/attachments/html.ts +23 -9
- package/extensions/msteams/src/attachments/shared.ts +54 -18
- package/extensions/msteams/src/attachments.test.ts +1 -2
- package/extensions/msteams/src/channel.directory.test.ts +8 -6
- package/extensions/msteams/src/channel.ts +49 -26
- package/extensions/msteams/src/conversation-store-fs.test.ts +10 -10
- package/extensions/msteams/src/conversation-store-fs.ts +15 -5
- package/extensions/msteams/src/conversation-store-memory.ts +3 -1
- package/extensions/msteams/src/directory-live.ts +42 -16
- package/extensions/msteams/src/errors.test.ts +0 -1
- package/extensions/msteams/src/errors.ts +48 -16
- package/extensions/msteams/src/file-consent-helpers.test.ts +12 -3
- package/extensions/msteams/src/file-consent.ts +6 -2
- package/extensions/msteams/src/graph-chat.ts +5 -4
- package/extensions/msteams/src/graph-upload.ts +27 -19
- package/extensions/msteams/src/inbound.test.ts +0 -1
- package/extensions/msteams/src/inbound.ts +15 -5
- package/extensions/msteams/src/media-helpers.test.ts +9 -6
- package/extensions/msteams/src/media-helpers.ts +16 -7
- package/extensions/msteams/src/messenger.test.ts +7 -4
- package/extensions/msteams/src/messenger.ts +56 -21
- package/extensions/msteams/src/monitor-handler/inbound-media.ts +4 -2
- package/extensions/msteams/src/monitor-handler/message-handler.ts +66 -56
- package/extensions/msteams/src/monitor-handler.ts +5 -9
- package/extensions/msteams/src/monitor.ts +22 -17
- package/extensions/msteams/src/onboarding.ts +21 -22
- package/extensions/msteams/src/outbound.ts +1 -2
- package/extensions/msteams/src/pending-uploads.ts +7 -5
- package/extensions/msteams/src/policy.test.ts +1 -2
- package/extensions/msteams/src/policy.ts +41 -15
- package/extensions/msteams/src/polls-store-memory.ts +3 -1
- package/extensions/msteams/src/polls-store.test.ts +2 -4
- package/extensions/msteams/src/polls.test.ts +8 -8
- package/extensions/msteams/src/polls.ts +33 -17
- package/extensions/msteams/src/probe.test.ts +4 -3
- package/extensions/msteams/src/probe.ts +19 -11
- package/extensions/msteams/src/reply-dispatcher.ts +8 -6
- package/extensions/msteams/src/resolve-allowlist.ts +39 -19
- package/extensions/msteams/src/runtime.ts +1 -1
- package/extensions/msteams/src/send-context.ts +13 -5
- package/extensions/msteams/src/send.ts +53 -23
- package/extensions/msteams/src/sent-message-cache.test.ts +0 -1
- package/extensions/msteams/src/sent-message-cache.ts +9 -3
- package/extensions/msteams/src/storage.ts +6 -3
- package/extensions/msteams/src/store-fs.ts +6 -3
- package/extensions/msteams/src/token.ts +1 -1
- package/extensions/nextcloud-talk/index.ts +3 -4
- package/extensions/nextcloud-talk/node_modules/.bin/openclaw +17 -0
- package/extensions/nextcloud-talk/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/nextcloud-talk/package.json +8 -5
- package/extensions/nextcloud-talk/src/accounts.ts +40 -20
- package/extensions/nextcloud-talk/src/channel.ts +25 -20
- package/extensions/nextcloud-talk/src/config-schema.ts +1 -1
- package/extensions/nextcloud-talk/src/format.ts +13 -13
- package/extensions/nextcloud-talk/src/inbound.ts +23 -39
- package/extensions/nextcloud-talk/src/monitor.ts +8 -8
- package/extensions/nextcloud-talk/src/normalize.ts +12 -4
- package/extensions/nextcloud-talk/src/onboarding.ts +8 -6
- package/extensions/nextcloud-talk/src/policy.ts +20 -7
- package/extensions/nextcloud-talk/src/room-info.ts +29 -15
- package/extensions/nextcloud-talk/src/runtime.ts +1 -1
- package/extensions/nextcloud-talk/src/send.ts +7 -3
- package/extensions/nextcloud-talk/src/signature.ts +9 -4
- package/extensions/nextcloud-talk/src/types.ts +1 -1
- package/extensions/nostr/CHANGELOG.md +17 -6
- package/extensions/nostr/README.md +21 -21
- package/extensions/nostr/index.ts +8 -9
- package/extensions/nostr/node_modules/.bin/openclaw +17 -0
- package/extensions/nostr/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/nostr/package.json +13 -10
- package/extensions/nostr/src/channel.test.ts +15 -5
- package/extensions/nostr/src/channel.ts +30 -19
- package/extensions/nostr/src/config-schema.ts +2 -2
- package/extensions/nostr/src/metrics.ts +33 -19
- package/extensions/nostr/src/nostr-bus.fuzz.test.ts +11 -22
- package/extensions/nostr/src/nostr-bus.integration.test.ts +2 -6
- package/extensions/nostr/src/nostr-bus.test.ts +3 -3
- package/extensions/nostr/src/nostr-bus.ts +56 -82
- package/extensions/nostr/src/nostr-profile-http.test.ts +10 -10
- package/extensions/nostr/src/nostr-profile-http.ts +37 -18
- package/extensions/nostr/src/nostr-profile-import.test.ts +2 -3
- package/extensions/nostr/src/nostr-profile-import.ts +10 -7
- package/extensions/nostr/src/nostr-profile.fuzz.test.ts +7 -9
- package/extensions/nostr/src/nostr-profile.test.ts +7 -7
- package/extensions/nostr/src/nostr-profile.ts +56 -21
- package/extensions/nostr/src/nostr-state-store.test.ts +14 -11
- package/extensions/nostr/src/nostr-state-store.ts +29 -29
- package/extensions/nostr/src/runtime.ts +1 -1
- package/extensions/nostr/src/seen-tracker.ts +48 -16
- package/extensions/nostr/src/types.test.ts +1 -5
- package/extensions/nostr/src/types.ts +8 -6
- package/extensions/open-prose/index.ts +2 -2
- package/extensions/open-prose/node_modules/.bin/openclaw +17 -0
- package/extensions/open-prose/package.json +7 -4
- package/extensions/open-prose/skills/prose/SKILL.md +69 -64
- package/extensions/open-prose/skills/prose/alts/arabian-nights.md +62 -62
- package/extensions/open-prose/skills/prose/alts/borges.md +65 -65
- package/extensions/open-prose/skills/prose/alts/folk.md +61 -61
- package/extensions/open-prose/skills/prose/alts/homer.md +59 -59
- package/extensions/open-prose/skills/prose/alts/kafka.md +67 -67
- package/extensions/open-prose/skills/prose/compiler.md +135 -131
- package/extensions/open-prose/skills/prose/examples/README.md +6 -6
- package/extensions/open-prose/skills/prose/examples/roadmap/README.md +8 -8
- package/extensions/open-prose/skills/prose/guidance/patterns.md +16 -16
- package/extensions/open-prose/skills/prose/help.md +22 -21
- package/extensions/open-prose/skills/prose/lib/README.md +14 -11
- package/extensions/open-prose/skills/prose/primitives/session.md +17 -11
- package/extensions/open-prose/skills/prose/prose.md +25 -23
- package/extensions/open-prose/skills/prose/state/filesystem.md +61 -41
- package/extensions/open-prose/skills/prose/state/in-context.md +46 -42
- package/extensions/open-prose/skills/prose/state/postgres.md +70 -65
- package/extensions/open-prose/skills/prose/state/sqlite.md +45 -43
- package/extensions/qq/src/onebot/api.test.ts +51 -0
- package/extensions/qq/src/onebot/api.ts +39 -0
- package/extensions/qq/src/send.test.ts +48 -5
- package/extensions/qq/src/send.ts +65 -0
- package/extensions/qwen-portal-auth/README.md +3 -3
- package/extensions/qwen-portal-auth/index.ts +6 -3
- package/extensions/qwen-portal-auth/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/signal/index.ts +3 -4
- package/extensions/signal/node_modules/.bin/openclaw +17 -0
- package/extensions/signal/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/signal/package.json +7 -4
- package/extensions/signal/src/channel.ts +7 -4
- package/extensions/signal/src/runtime.ts +1 -1
- package/extensions/slack/index.ts +3 -4
- package/extensions/slack/node_modules/.bin/openclaw +17 -0
- package/extensions/slack/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/slack/package.json +7 -4
- package/extensions/slack/src/channel.ts +43 -16
- package/extensions/slack/src/runtime.ts +1 -1
- package/extensions/telegram/index.ts +3 -4
- package/extensions/telegram/node_modules/.bin/openclaw +17 -0
- package/extensions/telegram/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/telegram/package.json +7 -4
- package/extensions/telegram/src/channel.ts +30 -17
- package/extensions/telegram/src/runtime.ts +1 -1
- package/extensions/tlon/README.md +3 -3
- package/extensions/tlon/index.ts +3 -4
- package/extensions/tlon/node_modules/.bin/openclaw +17 -0
- package/extensions/tlon/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/tlon/package.json +12 -9
- package/extensions/tlon/src/channel.ts +45 -32
- package/extensions/tlon/src/config-schema.test.ts +0 -1
- package/extensions/tlon/src/config-schema.ts +1 -1
- package/extensions/tlon/src/monitor/discovery.ts +8 -5
- package/extensions/tlon/src/monitor/history.ts +8 -7
- package/extensions/tlon/src/monitor/index.ts +98 -48
- package/extensions/tlon/src/monitor/processed-messages.test.ts +0 -1
- package/extensions/tlon/src/monitor/processed-messages.ts +12 -4
- package/extensions/tlon/src/monitor/utils.ts +28 -12
- package/extensions/tlon/src/onboarding.ts +8 -7
- package/extensions/tlon/src/runtime.ts +1 -1
- package/extensions/tlon/src/targets.ts +15 -5
- package/extensions/tlon/src/types.ts +16 -9
- package/extensions/tlon/src/urbit/http-api.ts +3 -1
- package/extensions/tlon/src/urbit/send.ts +7 -3
- package/extensions/tlon/src/urbit/sse-client.test.ts +0 -1
- package/extensions/tlon/src/urbit/sse-client.ts +18 -6
- package/extensions/twitch/CHANGELOG.md +10 -3
- package/extensions/twitch/README.md +8 -8
- package/extensions/twitch/index.ts +3 -4
- package/extensions/twitch/node_modules/.bin/openclaw +17 -0
- package/extensions/twitch/package.json +6 -6
- package/extensions/twitch/src/access-control.test.ts +1 -1
- package/extensions/twitch/src/access-control.ts +12 -4
- package/extensions/twitch/src/actions.ts +2 -2
- package/extensions/twitch/src/client-manager-registry.ts +1 -1
- package/extensions/twitch/src/config-schema.ts +1 -1
- package/extensions/twitch/src/config.test.ts +0 -1
- package/extensions/twitch/src/config.ts +3 -3
- package/extensions/twitch/src/monitor.ts +11 -7
- package/extensions/twitch/src/onboarding.test.ts +1 -1
- package/extensions/twitch/src/onboarding.ts +23 -17
- package/extensions/twitch/src/outbound.test.ts +2 -2
- package/extensions/twitch/src/outbound.ts +6 -6
- package/extensions/twitch/src/plugin.test.ts +2 -2
- package/extensions/twitch/src/plugin.ts +22 -22
- package/extensions/twitch/src/probe.test.ts +2 -5
- package/extensions/twitch/src/probe.ts +3 -1
- package/extensions/twitch/src/runtime.ts +1 -1
- package/extensions/twitch/src/send.test.ts +2 -2
- package/extensions/twitch/src/send.ts +6 -6
- package/extensions/twitch/src/status.test.ts +1 -1
- package/extensions/twitch/src/status.ts +4 -2
- package/extensions/twitch/src/token.test.ts +12 -12
- package/extensions/twitch/src/token.ts +14 -10
- package/extensions/twitch/src/twitch-client.test.ts +10 -4
- package/extensions/twitch/src/twitch-client.ts +4 -4
- package/extensions/twitch/src/types.ts +12 -12
- package/extensions/twitch/src/utils/markdown.ts +10 -4
- package/extensions/voice-call/CHANGELOG.md +32 -13
- package/extensions/voice-call/README.md +29 -25
- package/extensions/voice-call/index.ts +45 -49
- package/extensions/voice-call/node_modules/.bin/openclaw +17 -0
- package/extensions/voice-call/{clawdbot.plugin.json → openclaw.plugin.json} +11 -53
- package/extensions/voice-call/package.json +8 -5
- package/extensions/voice-call/src/cli.ts +92 -113
- package/extensions/voice-call/src/config.test.ts +1 -4
- package/extensions/voice-call/src/config.ts +88 -110
- package/extensions/voice-call/src/core-bridge.ts +18 -16
- package/extensions/voice-call/src/manager/context.ts +1 -1
- package/extensions/voice-call/src/manager/events.ts +18 -9
- package/extensions/voice-call/src/manager/lookup.ts +3 -1
- package/extensions/voice-call/src/manager/outbound.ts +46 -19
- package/extensions/voice-call/src/manager/state.ts +4 -6
- package/extensions/voice-call/src/manager/store.ts +6 -3
- package/extensions/voice-call/src/manager/timers.ts +11 -8
- package/extensions/voice-call/src/manager.test.ts +9 -12
- package/extensions/voice-call/src/manager.ts +69 -79
- package/extensions/voice-call/src/media-stream.test.ts +0 -1
- package/extensions/voice-call/src/media-stream.ts +12 -26
- package/extensions/voice-call/src/providers/mock.ts +13 -16
- package/extensions/voice-call/src/providers/plivo.test.ts +0 -1
- package/extensions/voice-call/src/providers/plivo.ts +27 -29
- package/extensions/voice-call/src/providers/stt-openai-realtime.ts +8 -8
- package/extensions/voice-call/src/providers/telnyx.ts +5 -11
- package/extensions/voice-call/src/providers/tts-openai.ts +9 -14
- package/extensions/voice-call/src/providers/twilio/api.ts +9 -12
- package/extensions/voice-call/src/providers/twilio/webhook.ts +2 -4
- package/extensions/voice-call/src/providers/twilio.test.ts +1 -5
- package/extensions/voice-call/src/providers/twilio.ts +34 -46
- package/extensions/voice-call/src/response-generator.ts +8 -21
- package/extensions/voice-call/src/runtime.ts +12 -25
- package/extensions/voice-call/src/telephony-audio.ts +14 -12
- package/extensions/voice-call/src/telephony-tts.ts +21 -12
- package/extensions/voice-call/src/tunnel.ts +7 -24
- package/extensions/voice-call/src/types.ts +0 -1
- package/extensions/voice-call/src/utils.ts +3 -1
- package/extensions/voice-call/src/voice-mapping.ts +3 -1
- package/extensions/voice-call/src/webhook-security.test.ts +12 -21
- package/extensions/voice-call/src/webhook-security.ts +25 -29
- package/extensions/voice-call/src/webhook.ts +22 -57
- package/extensions/whatsapp/index.ts +3 -4
- package/extensions/whatsapp/node_modules/.bin/openclaw +17 -0
- package/extensions/whatsapp/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/whatsapp/package.json +7 -4
- package/extensions/whatsapp/src/channel.ts +26 -18
- package/extensions/whatsapp/src/runtime.ts +1 -1
- package/extensions/zalo/CHANGELOG.md +28 -11
- package/extensions/zalo/README.md +10 -10
- package/extensions/zalo/index.ts +3 -4
- package/extensions/zalo/node_modules/.bin/openclaw +17 -0
- package/extensions/zalo/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/zalo/package.json +12 -9
- package/extensions/zalo/src/accounts.ts +25 -16
- package/extensions/zalo/src/actions.ts +15 -10
- package/extensions/zalo/src/api.ts +3 -1
- package/extensions/zalo/src/channel.directory.test.ts +16 -8
- package/extensions/zalo/src/channel.ts +58 -38
- package/extensions/zalo/src/config-schema.ts +1 -1
- package/extensions/zalo/src/monitor.ts +40 -47
- package/extensions/zalo/src/monitor.webhook.test.ts +25 -22
- package/extensions/zalo/src/onboarding.ts +58 -62
- package/extensions/zalo/src/proxy.ts +8 -5
- package/extensions/zalo/src/runtime.ts +1 -1
- package/extensions/zalo/src/send.ts +20 -13
- package/extensions/zalo/src/status-issues.ts +12 -9
- package/extensions/zalo/src/token.ts +16 -8
- package/extensions/zalouser/CHANGELOG.md +17 -6
- package/extensions/zalouser/README.md +24 -20
- package/extensions/zalouser/index.ts +4 -5
- package/extensions/zalouser/node_modules/.bin/openclaw +17 -0
- package/extensions/zalouser/{clawdbot.plugin.json → openclaw.plugin.json} +1 -3
- package/extensions/zalouser/package.json +10 -7
- package/extensions/zalouser/src/accounts.ts +47 -29
- package/extensions/zalouser/src/channel.test.ts +3 -2
- package/extensions/zalouser/src/channel.ts +113 -68
- package/extensions/zalouser/src/config-schema.ts +1 -1
- package/extensions/zalouser/src/monitor.ts +54 -38
- package/extensions/zalouser/src/onboarding.ts +86 -70
- package/extensions/zalouser/src/probe.ts +1 -1
- package/extensions/zalouser/src/runtime.ts +1 -1
- package/extensions/zalouser/src/send.ts +15 -5
- package/extensions/zalouser/src/status-issues.test.ts +0 -1
- package/extensions/zalouser/src/status-issues.ts +14 -6
- package/extensions/zalouser/src/tool.ts +29 -21
- package/extensions/zalouser/src/types.ts +8 -2
- package/extensions/zalouser/src/zca.ts +3 -9
- package/package.json +135 -146
- package/scripts/format-staged.js +28 -27
- package/scripts/postinstall.js +85 -24
- package/scripts/setup-git-hooks.js +13 -5
- package/skills/1password/SKILL.md +20 -3
- package/skills/apple-notes/SKILL.md +29 -2
- package/skills/apple-reminders/SKILL.md +30 -1
- package/skills/bear-notes/SKILL.md +29 -1
- package/skills/bird/SKILL.md +29 -2
- package/skills/blogwatcher/SKILL.md +24 -1
- package/skills/blucli/SKILL.md +21 -1
- package/skills/bluebubbles/SKILL.md +7 -2
- package/skills/camsnap/SKILL.md +21 -1
- package/skills/canvas/SKILL.md +28 -19
- package/skills/clawhub/SKILL.md +77 -0
- package/skills/coding-agent/SKILL.md +36 -30
- package/skills/discord/SKILL.md +13 -6
- package/skills/eightctl/SKILL.md +22 -1
- package/skills/food-order/SKILL.md +8 -1
- package/skills/gemini/SKILL.md +21 -1
- package/skills/gifgrep/SKILL.md +33 -1
- package/skills/github/SKILL.md +31 -2
- package/skills/gog/SKILL.md +25 -1
- package/skills/goplaces/SKILL.md +23 -1
- package/skills/himalaya/SKILL.md +41 -1
- package/skills/himalaya/references/configuration.md +10 -0
- package/skills/himalaya/references/message-composition.md +17 -0
- package/skills/imsg/SKILL.md +22 -1
- package/skills/local-places/SKILL.md +14 -3
- package/skills/local-places/pyproject.toml +2 -8
- package/skills/mcporter/SKILL.md +24 -1
- package/skills/model-usage/SKILL.md +27 -3
- package/skills/model-usage/references/codexbar-cli.md +7 -2
- package/skills/nano-banana-pro/SKILL.md +26 -3
- package/skills/nano-banana-pro/scripts/generate_image.py +1 -1
- package/skills/nano-pdf/SKILL.md +19 -1
- package/skills/notion/SKILL.md +17 -1
- package/skills/obsidian/SKILL.md +27 -1
- package/skills/openai-image-gen/SKILL.md +19 -1
- package/skills/openai-whisper/SKILL.md +20 -1
- package/skills/openai-whisper-api/SKILL.md +14 -5
- package/skills/openhue/SKILL.md +22 -1
- package/skills/oracle/SKILL.md +21 -1
- package/skills/ordercli/SKILL.md +32 -1
- package/skills/peekaboo/SKILL.md +38 -1
- package/skills/sag/SKILL.md +26 -1
- package/skills/session-logs/SKILL.md +17 -7
- package/skills/sherpa-onnx-tts/SKILL.md +64 -10
- package/skills/skill-creator/SKILL.md +0 -1
- package/skills/slack/SKILL.md +11 -11
- package/skills/songsee/SKILL.md +21 -1
- package/skills/sonoscli/SKILL.md +21 -1
- package/skills/spotify-player/SKILL.md +31 -1
- package/skills/summarize/SKILL.md +21 -1
- package/skills/things-mac/SKILL.md +28 -3
- package/skills/tmux/SKILL.md +10 -8
- package/skills/tmux/scripts/find-sessions.sh +2 -2
- package/skills/trello/SKILL.md +13 -2
- package/skills/video-frames/SKILL.md +18 -1
- package/skills/voice-call/SKILL.md +14 -4
- package/skills/wacli/SKILL.md +32 -2
- package/skills/weather/SKILL.md +6 -1
- package/dist/control-ui/assets/index-BAFzd9IE.css +0 -1
- package/dist/control-ui/assets/index-CxUFDXFX.js +0 -3162
- package/dist/control-ui/assets/index-CxUFDXFX.js.map +0 -1
- package/skills/clawdhub/SKILL.md +0 -53
- /package/docs/{whatsapp-clawd.jpg → whatsapp-openclaw.jpg} +0 -0
- /package/extensions/diagnostics-otel/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/llm-task/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/lobster/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/memory-core/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/open-prose/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/twitch/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/{moltbot.mjs → openclaw.mjs} +0 -0
package/docs/help/faq.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
---
|
|
2
|
-
summary: "Frequently asked questions about
|
|
2
|
+
summary: "Frequently asked questions about OpenClaw setup, configuration, and usage"
|
|
3
|
+
title: "FAQ"
|
|
3
4
|
---
|
|
5
|
+
|
|
4
6
|
# FAQ
|
|
5
7
|
|
|
6
8
|
Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS, multi-agent, OAuth/API keys, model failover). For runtime diagnostics, see [Troubleshooting](/gateway/troubleshooting). For the full config reference, see [Configuration](/gateway/configuration).
|
|
@@ -9,7 +11,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
9
11
|
|
|
10
12
|
- [Quick start and first-run setup](#quick-start-and-firstrun-setup)
|
|
11
13
|
- [Im stuck whats the fastest way to get unstuck?](#im-stuck-whats-the-fastest-way-to-get-unstuck)
|
|
12
|
-
- [What’s the recommended way to install and set up
|
|
14
|
+
- [What’s the recommended way to install and set up OpenClaw?](#whats-the-recommended-way-to-install-and-set-up-openclaw)
|
|
13
15
|
- [How do I open the dashboard after onboarding?](#how-do-i-open-the-dashboard-after-onboarding)
|
|
14
16
|
- [How do I authenticate the dashboard (token) on localhost vs remote?](#how-do-i-authenticate-the-dashboard-token-on-localhost-vs-remote)
|
|
15
17
|
- [What runtime do I need?](#what-runtime-do-i-need)
|
|
@@ -18,18 +20,18 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
18
20
|
- [It is stuck on "wake up my friend" / onboarding will not hatch. What now?](#it-is-stuck-on-wake-up-my-friend-onboarding-will-not-hatch-what-now)
|
|
19
21
|
- [Can I migrate my setup to a new machine (Mac mini) without redoing onboarding?](#can-i-migrate-my-setup-to-a-new-machine-mac-mini-without-redoing-onboarding)
|
|
20
22
|
- [Where do I see what’s new in the latest version?](#where-do-i-see-whats-new-in-the-latest-version)
|
|
21
|
-
- [I can't access docs.
|
|
23
|
+
- [I can't access docs.openclaw.ai (SSL error). What now?](#i-cant-access-docsopenclawai-ssl-error-what-now)
|
|
22
24
|
- [What’s the difference between stable and beta?](#whats-the-difference-between-stable-and-beta)
|
|
23
25
|
- [How do I install the beta version, and what’s the difference between beta and dev?](#how-do-i-install-the-beta-version-and-whats-the-difference-between-beta-and-dev)
|
|
24
26
|
- [How do I try the latest bits?](#how-do-i-try-the-latest-bits)
|
|
25
27
|
- [How long does install and onboarding usually take?](#how-long-does-install-and-onboarding-usually-take)
|
|
26
28
|
- [Installer stuck? How do I get more feedback?](#installer-stuck-how-do-i-get-more-feedback)
|
|
27
|
-
- [Windows install says git not found or
|
|
29
|
+
- [Windows install says git not found or openclaw not recognized](#windows-install-says-git-not-found-or-openclaw-not-recognized)
|
|
28
30
|
- [The docs didn’t answer my question - how do I get a better answer?](#the-docs-didnt-answer-my-question-how-do-i-get-a-better-answer)
|
|
29
|
-
- [How do I install
|
|
30
|
-
- [How do I install
|
|
31
|
+
- [How do I install OpenClaw on Linux?](#how-do-i-install-openclaw-on-linux)
|
|
32
|
+
- [How do I install OpenClaw on a VPS?](#how-do-i-install-openclaw-on-a-vps)
|
|
31
33
|
- [Where are the cloud/VPS install guides?](#where-are-the-cloudvps-install-guides)
|
|
32
|
-
- [Can I ask
|
|
34
|
+
- [Can I ask OpenClaw to update itself?](#can-i-ask-openclaw-to-update-itself)
|
|
33
35
|
- [What does the onboarding wizard actually do?](#what-does-the-onboarding-wizard-actually-do)
|
|
34
36
|
- [Do I need a Claude or OpenAI subscription to run this?](#do-i-need-a-claude-or-openai-subscription-to-run-this)
|
|
35
37
|
- [Can I use Claude Max subscription without an API key](#can-i-use-claude-max-subscription-without-an-api-key)
|
|
@@ -45,24 +47,24 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
45
47
|
- [How do I keep hosted model traffic in a specific region?](#how-do-i-keep-hosted-model-traffic-in-a-specific-region)
|
|
46
48
|
- [Do I have to buy a Mac Mini to install this?](#do-i-have-to-buy-a-mac-mini-to-install-this)
|
|
47
49
|
- [Do I need a Mac mini for iMessage support?](#do-i-need-a-mac-mini-for-imessage-support)
|
|
48
|
-
- [If I buy a Mac mini to run
|
|
50
|
+
- [If I buy a Mac mini to run OpenClaw, can I connect it to my MacBook Pro?](#if-i-buy-a-mac-mini-to-run-openclaw-can-i-connect-it-to-my-macbook-pro)
|
|
49
51
|
- [Can I use Bun?](#can-i-use-bun)
|
|
50
52
|
- [Telegram: what goes in `allowFrom`?](#telegram-what-goes-in-allowfrom)
|
|
51
|
-
- [Can multiple people use one WhatsApp number with different
|
|
53
|
+
- [Can multiple people use one WhatsApp number with different OpenClaw instances?](#can-multiple-people-use-one-whatsapp-number-with-different-openclaw-instances)
|
|
52
54
|
- [Can I run a "fast chat" agent and an "Opus for coding" agent?](#can-i-run-a-fast-chat-agent-and-an-opus-for-coding-agent)
|
|
53
55
|
- [Does Homebrew work on Linux?](#does-homebrew-work-on-linux)
|
|
54
56
|
- [What’s the difference between the hackable (git) install and npm install?](#whats-the-difference-between-the-hackable-git-install-and-npm-install)
|
|
55
57
|
- [Can I switch between npm and git installs later?](#can-i-switch-between-npm-and-git-installs-later)
|
|
56
58
|
- [Should I run the Gateway on my laptop or a VPS?](#should-i-run-the-gateway-on-my-laptop-or-a-vps)
|
|
57
|
-
- [How important is it to run
|
|
59
|
+
- [How important is it to run OpenClaw on a dedicated machine?](#how-important-is-it-to-run-openclaw-on-a-dedicated-machine)
|
|
58
60
|
- [What are the minimum VPS requirements and recommended OS?](#what-are-the-minimum-vps-requirements-and-recommended-os)
|
|
59
|
-
- [Can I run
|
|
60
|
-
- [What is
|
|
61
|
-
- [What is
|
|
61
|
+
- [Can I run OpenClaw in a VM and what are the requirements](#can-i-run-openclaw-in-a-vm-and-what-are-the-requirements)
|
|
62
|
+
- [What is OpenClaw?](#what-is-openclaw)
|
|
63
|
+
- [What is OpenClaw, in one paragraph?](#what-is-openclaw-in-one-paragraph)
|
|
62
64
|
- [What’s the value proposition?](#whats-the-value-proposition)
|
|
63
65
|
- [I just set it up what should I do first](#i-just-set-it-up-what-should-i-do-first)
|
|
64
|
-
- [What are the top five everyday use cases for
|
|
65
|
-
- [Can
|
|
66
|
+
- [What are the top five everyday use cases for OpenClaw](#what-are-the-top-five-everyday-use-cases-for-openclaw)
|
|
67
|
+
- [Can OpenClaw help with lead gen outreach ads and blogs for a SaaS](#can-openclaw-help-with-lead-gen-outreach-ads-and-blogs-for-a-saas)
|
|
66
68
|
- [What are the advantages vs Claude Code for web development?](#what-are-the-advantages-vs-claude-code-for-web-development)
|
|
67
69
|
- [Skills and automation](#skills-and-automation)
|
|
68
70
|
- [How do I customize skills without keeping the repo dirty?](#how-do-i-customize-skills-without-keeping-the-repo-dirty)
|
|
@@ -71,7 +73,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
71
73
|
- [The bot freezes while doing heavy work. How do I offload that?](#the-bot-freezes-while-doing-heavy-work-how-do-i-offload-that)
|
|
72
74
|
- [Cron or reminders do not fire. What should I check?](#cron-or-reminders-do-not-fire-what-should-i-check)
|
|
73
75
|
- [How do I install skills on Linux?](#how-do-i-install-skills-on-linux)
|
|
74
|
-
- [Can
|
|
76
|
+
- [Can OpenClaw run tasks on a schedule or continuously in the background?](#can-openclaw-run-tasks-on-a-schedule-or-continuously-in-the-background)
|
|
75
77
|
- [Can I run Apple/macOS-only skills from Linux?](#can-i-run-applemacosonly-skills-from-linux)
|
|
76
78
|
- [Do you have a Notion or HeyGen integration?](#do-you-have-a-notion-or-heygen-integration)
|
|
77
79
|
- [How do I install the Chrome extension for browser takeover?](#how-do-i-install-the-chrome-extension-for-browser-takeover)
|
|
@@ -83,11 +85,11 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
83
85
|
- [Does memory persist forever? What are the limits?](#does-memory-persist-forever-what-are-the-limits)
|
|
84
86
|
- [Does semantic memory search require an OpenAI API key?](#does-semantic-memory-search-require-an-openai-api-key)
|
|
85
87
|
- [Where things live on disk](#where-things-live-on-disk)
|
|
86
|
-
- [Is all data used with
|
|
87
|
-
- [Where does
|
|
88
|
+
- [Is all data used with OpenClaw saved locally?](#is-all-data-used-with-openclaw-saved-locally)
|
|
89
|
+
- [Where does OpenClaw store its data?](#where-does-openclaw-store-its-data)
|
|
88
90
|
- [Where should AGENTS.md / SOUL.md / USER.md / MEMORY.md live?](#where-should-agentsmd-soulmd-usermd-memorymd-live)
|
|
89
91
|
- [What’s the recommended backup strategy?](#whats-the-recommended-backup-strategy)
|
|
90
|
-
- [How do I completely uninstall
|
|
92
|
+
- [How do I completely uninstall OpenClaw?](#how-do-i-completely-uninstall-openclaw)
|
|
91
93
|
- [Can agents work outside the workspace?](#can-agents-work-outside-the-workspace)
|
|
92
94
|
- [I’m in remote mode - where is the session store?](#im-in-remote-mode-where-is-the-session-store)
|
|
93
95
|
- [Config basics](#config-basics)
|
|
@@ -98,13 +100,13 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
98
100
|
- [How do I enable web search (and web fetch)?](#how-do-i-enable-web-search-and-web-fetch)
|
|
99
101
|
- [config.apply wiped my config. How do I recover and avoid this?](#configapply-wiped-my-config-how-do-i-recover-and-avoid-this)
|
|
100
102
|
- [How do I run a central Gateway with specialized workers across devices?](#how-do-i-run-a-central-gateway-with-specialized-workers-across-devices)
|
|
101
|
-
- [Can the
|
|
103
|
+
- [Can the OpenClaw browser run headless?](#can-the-openclaw-browser-run-headless)
|
|
102
104
|
- [How do I use Brave for browser control?](#how-do-i-use-brave-for-browser-control)
|
|
103
105
|
- [Remote gateways + nodes](#remote-gateways-nodes)
|
|
104
106
|
- [How do commands propagate between Telegram, the gateway, and nodes?](#how-do-commands-propagate-between-telegram-the-gateway-and-nodes)
|
|
105
107
|
- [How can my agent access my computer if the Gateway is hosted remotely?](#how-can-my-agent-access-my-computer-if-the-gateway-is-hosted-remotely)
|
|
106
108
|
- [Tailscale is connected but I get no replies. What now?](#tailscale-is-connected-but-i-get-no-replies-what-now)
|
|
107
|
-
- [Can two
|
|
109
|
+
- [Can two OpenClaw instances talk to each other (local + VPS)?](#can-two-openclaw-instances-talk-to-each-other-local-vps)
|
|
108
110
|
- [Do I need separate VPSes for multiple agents](#do-i-need-separate-vpses-for-multiple-agents)
|
|
109
111
|
- [Is there a benefit to using a node on my personal laptop instead of SSH from a VPS?](#is-there-a-benefit-to-using-a-node-on-my-personal-laptop-instead-of-ssh-from-a-vps)
|
|
110
112
|
- [Do nodes run a gateway service?](#do-nodes-run-a-gateway-service)
|
|
@@ -114,21 +116,21 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
114
116
|
- [How do I connect a Mac node to a remote Gateway (Tailscale Serve)?](#how-do-i-connect-a-mac-node-to-a-remote-gateway-tailscale-serve)
|
|
115
117
|
- [Should I install on a second laptop or just add a node?](#should-i-install-on-a-second-laptop-or-just-add-a-node)
|
|
116
118
|
- [Env vars and .env loading](#env-vars-and-env-loading)
|
|
117
|
-
- [How does
|
|
119
|
+
- [How does OpenClaw load environment variables?](#how-does-openclaw-load-environment-variables)
|
|
118
120
|
- [“I started the Gateway via the service and my env vars disappeared.” What now?](#i-started-the-gateway-via-the-service-and-my-env-vars-disappeared-what-now)
|
|
119
121
|
- [I set `COPILOT_GITHUB_TOKEN`, but models status shows “Shell env: off.” Why?](#i-set-copilotgithubtoken-but-models-status-shows-shell-env-off-why)
|
|
120
122
|
- [Sessions & multiple chats](#sessions-multiple-chats)
|
|
121
123
|
- [How do I start a fresh conversation?](#how-do-i-start-a-fresh-conversation)
|
|
122
124
|
- [Do sessions reset automatically if I never send `/new`?](#do-sessions-reset-automatically-if-i-never-send-new)
|
|
123
|
-
- [Is there a way to make a team of
|
|
125
|
+
- [Is there a way to make a team of OpenClaw instances one CEO and many agents](#is-there-a-way-to-make-a-team-of-openclaw-instances-one-ceo-and-many-agents)
|
|
124
126
|
- [Why did context get truncated mid-task? How do I prevent it?](#why-did-context-get-truncated-midtask-how-do-i-prevent-it)
|
|
125
|
-
- [How do I completely reset
|
|
127
|
+
- [How do I completely reset OpenClaw but keep it installed?](#how-do-i-completely-reset-openclaw-but-keep-it-installed)
|
|
126
128
|
- [I’m getting “context too large” errors - how do I reset or compact?](#im-getting-context-too-large-errors-how-do-i-reset-or-compact)
|
|
127
129
|
- [Why am I seeing “LLM request rejected: messages.N.content.X.tool_use.input: Field required”?](#why-am-i-seeing-llm-request-rejected-messagesncontentxtooluseinput-field-required)
|
|
128
130
|
- [Why am I getting heartbeat messages every 30 minutes?](#why-am-i-getting-heartbeat-messages-every-30-minutes)
|
|
129
131
|
- [Do I need to add a “bot account” to a WhatsApp group?](#do-i-need-to-add-a-bot-account-to-a-whatsapp-group)
|
|
130
132
|
- [How do I get the JID of a WhatsApp group?](#how-do-i-get-the-jid-of-a-whatsapp-group)
|
|
131
|
-
- [Why doesn’t
|
|
133
|
+
- [Why doesn’t OpenClaw reply in a group?](#why-doesnt-openclaw-reply-in-a-group)
|
|
132
134
|
- [Do groups/threads share context with DMs?](#do-groupsthreads-share-context-with-dms)
|
|
133
135
|
- [How many workspaces and agents can I create?](#how-many-workspaces-and-agents-can-i-create)
|
|
134
136
|
- [Can I run multiple bots or chats at the same time (Slack), and how should I set that up?](#can-i-run-multiple-bots-or-chats-at-the-same-time-slack-and-how-should-i-set-that-up)
|
|
@@ -137,7 +139,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
137
139
|
- [What model do you recommend?](#what-model-do-you-recommend)
|
|
138
140
|
- [How do I switch models without wiping my config?](#how-do-i-switch-models-without-wiping-my-config)
|
|
139
141
|
- [Can I use self-hosted models (llama.cpp, vLLM, Ollama)?](#can-i-use-selfhosted-models-llamacpp-vllm-ollama)
|
|
140
|
-
- [What do
|
|
142
|
+
- [What do OpenClaw, Flawd, and Krill use for models?](#what-do-openclaw-flawd-and-krill-use-for-models)
|
|
141
143
|
- [How do I switch models on the fly (without restarting)?](#how-do-i-switch-models-on-the-fly-without-restarting)
|
|
142
144
|
- [Can I use GPT 5.2 for daily tasks and Codex 5.2 for coding](#can-i-use-gpt-52-for-daily-tasks-and-codex-52-for-coding)
|
|
143
145
|
- [Why do I see “Model … is not allowed” and then no reply?](#why-do-i-see-model-is-not-allowed-and-then-no-reply)
|
|
@@ -158,10 +160,10 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
158
160
|
- [OAuth vs API key: what’s the difference?](#oauth-vs-api-key-whats-the-difference)
|
|
159
161
|
- [Gateway: ports, “already running”, and remote mode](#gateway-ports-already-running-and-remote-mode)
|
|
160
162
|
- [What port does the Gateway use?](#what-port-does-the-gateway-use)
|
|
161
|
-
- [Why does `
|
|
162
|
-
- [Why does `
|
|
163
|
+
- [Why does `openclaw gateway status` say `Runtime: running` but `RPC probe: failed`?](#why-does-openclaw-gateway-status-say-runtime-running-but-rpc-probe-failed)
|
|
164
|
+
- [Why does `openclaw gateway status` show `Config (cli)` and `Config (service)` different?](#why-does-openclaw-gateway-status-show-config-cli-and-config-service-different)
|
|
163
165
|
- [What does “another gateway instance is already listening” mean?](#what-does-another-gateway-instance-is-already-listening-mean)
|
|
164
|
-
- [How do I run
|
|
166
|
+
- [How do I run OpenClaw in remote mode (client connects to a Gateway elsewhere)?](#how-do-i-run-openclaw-in-remote-mode-client-connects-to-a-gateway-elsewhere)
|
|
165
167
|
- [The Control UI says “unauthorized” (or keeps reconnecting). What now?](#the-control-ui-says-unauthorized-or-keeps-reconnecting-what-now)
|
|
166
168
|
- [I set `gateway.bind: "tailnet"` but it can’t bind / nothing listens](#i-set-gatewaybind-tailnet-but-it-cant-bind-nothing-listens)
|
|
167
169
|
- [Can I run multiple Gateways on the same host?](#can-i-run-multiple-gateways-on-the-same-host)
|
|
@@ -169,18 +171,18 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
169
171
|
- [Logging and debugging](#logging-and-debugging)
|
|
170
172
|
- [Where are logs?](#where-are-logs)
|
|
171
173
|
- [How do I start/stop/restart the Gateway service?](#how-do-i-startstoprestart-the-gateway-service)
|
|
172
|
-
- [I closed my terminal on Windows - how do I restart
|
|
174
|
+
- [I closed my terminal on Windows - how do I restart OpenClaw?](#i-closed-my-terminal-on-windows-how-do-i-restart-openclaw)
|
|
173
175
|
- [The Gateway is up but replies never arrive. What should I check?](#the-gateway-is-up-but-replies-never-arrive-what-should-i-check)
|
|
174
176
|
- ["Disconnected from gateway: no reason" - what now?](#disconnected-from-gateway-no-reason-what-now)
|
|
175
177
|
- [Telegram setMyCommands fails with network errors. What should I check?](#telegram-setmycommands-fails-with-network-errors-what-should-i-check)
|
|
176
178
|
- [TUI shows no output. What should I check?](#tui-shows-no-output-what-should-i-check)
|
|
177
179
|
- [How do I completely stop then start the Gateway?](#how-do-i-completely-stop-then-start-the-gateway)
|
|
178
|
-
- [ELI5: `
|
|
180
|
+
- [ELI5: `openclaw gateway restart` vs `openclaw gateway`](#eli5-openclaw-gateway-restart-vs-openclaw-gateway)
|
|
179
181
|
- [What’s the fastest way to get more details when something fails?](#whats-the-fastest-way-to-get-more-details-when-something-fails)
|
|
180
182
|
- [Media & attachments](#media-attachments)
|
|
181
183
|
- [My skill generated an image/PDF, but nothing was sent](#my-skill-generated-an-imagepdf-but-nothing-was-sent)
|
|
182
184
|
- [Security and access control](#security-and-access-control)
|
|
183
|
-
- [Is it safe to expose
|
|
185
|
+
- [Is it safe to expose OpenClaw to inbound DMs?](#is-it-safe-to-expose-openclaw-to-inbound-dms)
|
|
184
186
|
- [Is prompt injection only a concern for public bots?](#is-prompt-injection-only-a-concern-for-public-bots)
|
|
185
187
|
- [Should my bot have its own email GitHub account or phone number](#should-my-bot-have-its-own-email-github-account-or-phone-number)
|
|
186
188
|
- [Can I give it autonomy over my text messages and is that safe](#can-i-give-it-autonomy-over-my-text-messages-and-is-that-safe)
|
|
@@ -195,50 +197,64 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
|
|
|
195
197
|
|
|
196
198
|
## First 60 seconds if something's broken
|
|
197
199
|
|
|
198
|
-
1
|
|
200
|
+
1. **Quick status (first check)**
|
|
201
|
+
|
|
199
202
|
```bash
|
|
200
|
-
|
|
203
|
+
openclaw status
|
|
201
204
|
```
|
|
205
|
+
|
|
202
206
|
Fast local summary: OS + update, gateway/service reachability, agents/sessions, provider config + runtime issues (when gateway is reachable).
|
|
203
207
|
|
|
204
|
-
2
|
|
208
|
+
2. **Pasteable report (safe to share)**
|
|
209
|
+
|
|
205
210
|
```bash
|
|
206
|
-
|
|
211
|
+
openclaw status --all
|
|
207
212
|
```
|
|
213
|
+
|
|
208
214
|
Read-only diagnosis with log tail (tokens redacted).
|
|
209
215
|
|
|
210
|
-
3
|
|
216
|
+
3. **Daemon + port state**
|
|
217
|
+
|
|
211
218
|
```bash
|
|
212
|
-
|
|
219
|
+
openclaw gateway status
|
|
213
220
|
```
|
|
221
|
+
|
|
214
222
|
Shows supervisor runtime vs RPC reachability, the probe target URL, and which config the service likely used.
|
|
215
223
|
|
|
216
|
-
4
|
|
224
|
+
4. **Deep probes**
|
|
225
|
+
|
|
217
226
|
```bash
|
|
218
|
-
|
|
227
|
+
openclaw status --deep
|
|
219
228
|
```
|
|
229
|
+
|
|
220
230
|
Runs gateway health checks + provider probes (requires a reachable gateway). See [Health](/gateway/health).
|
|
221
231
|
|
|
222
|
-
5
|
|
232
|
+
5. **Tail the latest log**
|
|
233
|
+
|
|
223
234
|
```bash
|
|
224
|
-
|
|
235
|
+
openclaw logs --follow
|
|
225
236
|
```
|
|
237
|
+
|
|
226
238
|
If RPC is down, fall back to:
|
|
239
|
+
|
|
227
240
|
```bash
|
|
228
|
-
tail -f "$(ls -t /tmp/
|
|
241
|
+
tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
|
|
229
242
|
```
|
|
243
|
+
|
|
230
244
|
File logs are separate from service logs; see [Logging](/logging) and [Troubleshooting](/gateway/troubleshooting).
|
|
231
245
|
|
|
232
|
-
6
|
|
246
|
+
6. **Run the doctor (repairs)**
|
|
247
|
+
|
|
233
248
|
```bash
|
|
234
|
-
|
|
249
|
+
openclaw doctor
|
|
235
250
|
```
|
|
251
|
+
|
|
236
252
|
Repairs/migrates config/state + runs health checks. See [Doctor](/gateway/doctor).
|
|
237
253
|
|
|
238
|
-
7
|
|
254
|
+
7. **Gateway snapshot**
|
|
239
255
|
```bash
|
|
240
|
-
|
|
241
|
-
|
|
256
|
+
openclaw health --json
|
|
257
|
+
openclaw health --verbose # shows the target URL + config path on errors
|
|
242
258
|
```
|
|
243
259
|
Asks the running gateway for a full snapshot (WS-only). See [Health](/gateway/health).
|
|
244
260
|
|
|
@@ -258,10 +274,10 @@ setup (PATH, services, permissions, auth files). Give them the **full source che
|
|
|
258
274
|
the hackable (git) install:
|
|
259
275
|
|
|
260
276
|
```bash
|
|
261
|
-
curl -fsSL https://
|
|
277
|
+
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
|
|
262
278
|
```
|
|
263
279
|
|
|
264
|
-
This installs
|
|
280
|
+
This installs OpenClaw **from a git checkout**, so the agent can read the code + docs and
|
|
265
281
|
reason about the exact version you are running. You can always switch back to stable later
|
|
266
282
|
by re-running the installer without `--install-method git`.
|
|
267
283
|
|
|
@@ -269,35 +285,36 @@ Tip: ask the agent to **plan and supervise** the fix (step-by-step), then execut
|
|
|
269
285
|
necessary commands. That keeps changes small and easier to audit.
|
|
270
286
|
|
|
271
287
|
If you discover a real bug or fix, please file a GitHub issue or send a PR:
|
|
272
|
-
https://github.com/
|
|
273
|
-
https://github.com/
|
|
288
|
+
https://github.com/openclaw/openclaw/issues
|
|
289
|
+
https://github.com/openclaw/openclaw/pulls
|
|
274
290
|
|
|
275
291
|
Start with these commands (share outputs when asking for help):
|
|
276
292
|
|
|
277
293
|
```bash
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
294
|
+
openclaw status
|
|
295
|
+
openclaw models status
|
|
296
|
+
openclaw doctor
|
|
281
297
|
```
|
|
282
298
|
|
|
283
299
|
What they do:
|
|
284
|
-
- `moltbot status`: quick snapshot of gateway/agent health + basic config.
|
|
285
|
-
- `moltbot models status`: checks provider auth + model availability.
|
|
286
|
-
- `moltbot doctor`: validates and repairs common config/state issues.
|
|
287
300
|
|
|
288
|
-
|
|
289
|
-
`
|
|
301
|
+
- `openclaw status`: quick snapshot of gateway/agent health + basic config.
|
|
302
|
+
- `openclaw models status`: checks provider auth + model availability.
|
|
303
|
+
- `openclaw doctor`: validates and repairs common config/state issues.
|
|
304
|
+
|
|
305
|
+
Other useful CLI checks: `openclaw status --all`, `openclaw logs --follow`,
|
|
306
|
+
`openclaw gateway status`, `openclaw health --verbose`.
|
|
290
307
|
|
|
291
308
|
Quick debug loop: [First 60 seconds if something's broken](#first-60-seconds-if-somethings-broken).
|
|
292
309
|
Install docs: [Install](/install), [Installer flags](/install/installer), [Updating](/install/updating).
|
|
293
310
|
|
|
294
|
-
###
|
|
311
|
+
### What's the recommended way to install and set up OpenClaw
|
|
295
312
|
|
|
296
313
|
The repo recommends running from source and using the onboarding wizard:
|
|
297
314
|
|
|
298
315
|
```bash
|
|
299
|
-
curl -fsSL https://
|
|
300
|
-
|
|
316
|
+
curl -fsSL https://openclaw.ai/install.sh | bash
|
|
317
|
+
openclaw onboard --install-daemon
|
|
301
318
|
```
|
|
302
319
|
|
|
303
320
|
The wizard can also build UI assets automatically. After onboarding, you typically run the Gateway on port **18789**.
|
|
@@ -305,15 +322,15 @@ The wizard can also build UI assets automatically. After onboarding, you typical
|
|
|
305
322
|
From source (contributors/dev):
|
|
306
323
|
|
|
307
324
|
```bash
|
|
308
|
-
git clone https://github.com/
|
|
309
|
-
cd
|
|
325
|
+
git clone https://github.com/openclaw/openclaw.git
|
|
326
|
+
cd openclaw
|
|
310
327
|
pnpm install
|
|
311
328
|
pnpm build
|
|
312
329
|
pnpm ui:build # auto-installs UI deps on first run
|
|
313
|
-
|
|
330
|
+
openclaw onboard
|
|
314
331
|
```
|
|
315
332
|
|
|
316
|
-
If you don’t have a global install yet, run it via `pnpm
|
|
333
|
+
If you don’t have a global install yet, run it via `pnpm openclaw onboard`.
|
|
317
334
|
|
|
318
335
|
### How do I open the dashboard after onboarding
|
|
319
336
|
|
|
@@ -322,14 +339,16 @@ The wizard now opens your browser with a tokenized dashboard URL right after onb
|
|
|
322
339
|
### How do I authenticate the dashboard token on localhost vs remote
|
|
323
340
|
|
|
324
341
|
**Localhost (same machine):**
|
|
342
|
+
|
|
325
343
|
- Open `http://127.0.0.1:18789/`.
|
|
326
|
-
- If it asks for auth, run `
|
|
327
|
-
- The token is the same value as `gateway.auth.token` (or `
|
|
344
|
+
- If it asks for auth, run `openclaw dashboard` and use the tokenized link (`?token=...`).
|
|
345
|
+
- The token is the same value as `gateway.auth.token` (or `OPENCLAW_GATEWAY_TOKEN`) and is stored by the UI after first load.
|
|
328
346
|
|
|
329
347
|
**Not on localhost:**
|
|
330
|
-
|
|
331
|
-
- **
|
|
332
|
-
- **
|
|
348
|
+
|
|
349
|
+
- **Tailscale Serve** (recommended): keep bind loopback, run `openclaw gateway --tailscale serve`, open `https://<magicdns>/`. If `gateway.auth.allowTailscale` is `true`, identity headers satisfy auth (no token).
|
|
350
|
+
- **Tailnet bind**: run `openclaw gateway --bind tailnet --token "<token>"`, open `http://<tailscale-ip>:18789/`, paste token in dashboard settings.
|
|
351
|
+
- **SSH tunnel**: `ssh -N -L 18789:127.0.0.1:18789 user@host` then open `http://127.0.0.1:18789/?token=...` from `openclaw dashboard`.
|
|
333
352
|
|
|
334
353
|
See [Dashboard](/web/dashboard) and [Web surfaces](/web) for bind modes and auth details.
|
|
335
354
|
|
|
@@ -365,19 +384,24 @@ That screen depends on the Gateway being reachable and authenticated. The TUI al
|
|
|
365
384
|
"Wake up, my friend!" automatically on first hatch. If you see that line with **no reply**
|
|
366
385
|
and tokens stay at 0, the agent never ran.
|
|
367
386
|
|
|
368
|
-
1
|
|
387
|
+
1. Restart the Gateway:
|
|
388
|
+
|
|
369
389
|
```bash
|
|
370
|
-
|
|
390
|
+
openclaw gateway restart
|
|
371
391
|
```
|
|
372
|
-
|
|
392
|
+
|
|
393
|
+
2. Check status + auth:
|
|
394
|
+
|
|
373
395
|
```bash
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
396
|
+
openclaw status
|
|
397
|
+
openclaw models status
|
|
398
|
+
openclaw logs --follow
|
|
377
399
|
```
|
|
378
|
-
|
|
400
|
+
|
|
401
|
+
3. If it still hangs, run:
|
|
402
|
+
|
|
379
403
|
```bash
|
|
380
|
-
|
|
404
|
+
openclaw doctor
|
|
381
405
|
```
|
|
382
406
|
|
|
383
407
|
If the Gateway is remote, ensure the tunnel/Tailscale connection is up and that the UI
|
|
@@ -389,44 +413,45 @@ Yes. Copy the **state directory** and **workspace**, then run Doctor once. This
|
|
|
389
413
|
keeps your bot “exactly the same” (memory, session history, auth, and channel
|
|
390
414
|
state) as long as you copy **both** locations:
|
|
391
415
|
|
|
392
|
-
1
|
|
393
|
-
2
|
|
394
|
-
3
|
|
395
|
-
4
|
|
416
|
+
1. Install OpenClaw on the new machine.
|
|
417
|
+
2. Copy `$OPENCLAW_STATE_DIR` (default: `~/.openclaw`) from the old machine.
|
|
418
|
+
3. Copy your workspace (default: `~/.openclaw/workspace`).
|
|
419
|
+
4. Run `openclaw doctor` and restart the Gateway service.
|
|
396
420
|
|
|
397
421
|
That preserves config, auth profiles, WhatsApp creds, sessions, and memory. If you’re in
|
|
398
422
|
remote mode, remember the gateway host owns the session store and workspace.
|
|
399
423
|
|
|
400
424
|
**Important:** if you only commit/push your workspace to GitHub, you’re backing
|
|
401
425
|
up **memory + bootstrap files**, but **not** session history or auth. Those live
|
|
402
|
-
under `~/.
|
|
426
|
+
under `~/.openclaw/` (for example `~/.openclaw/agents/<agentId>/sessions/`).
|
|
403
427
|
|
|
404
|
-
Related: [Migrating](/install/migrating), [Where things live on disk](/help/faq#where-does-
|
|
428
|
+
Related: [Migrating](/install/migrating), [Where things live on disk](/help/faq#where-does-openclaw-store-its-data),
|
|
405
429
|
[Agent workspace](/concepts/agent-workspace), [Doctor](/gateway/doctor),
|
|
406
430
|
[Remote mode](/gateway/remote).
|
|
407
431
|
|
|
408
432
|
### Where do I see whats new in the latest version
|
|
409
433
|
|
|
410
434
|
Check the GitHub changelog:
|
|
411
|
-
https://github.com/
|
|
435
|
+
https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md
|
|
412
436
|
|
|
413
437
|
Newest entries are at the top. If the top section is marked **Unreleased**, the next dated
|
|
414
438
|
section is the latest shipped version. Entries are grouped by **Highlights**, **Changes**, and
|
|
415
439
|
**Fixes** (plus docs/other sections when needed).
|
|
416
440
|
|
|
417
|
-
### I cant access
|
|
441
|
+
### I cant access docs.openclaw.ai SSL error What now
|
|
418
442
|
|
|
419
|
-
Some Comcast/Xfinity connections incorrectly block `docs.
|
|
420
|
-
Advanced Security. Disable it or allowlist `docs.
|
|
421
|
-
detail: [Troubleshooting](/help/troubleshooting#
|
|
443
|
+
Some Comcast/Xfinity connections incorrectly block `docs.openclaw.ai` via Xfinity
|
|
444
|
+
Advanced Security. Disable it or allowlist `docs.openclaw.ai`, then retry. More
|
|
445
|
+
detail: [Troubleshooting](/help/troubleshooting#docsopenclawai-shows-an-ssl-error-comcastxfinity).
|
|
422
446
|
Please help us unblock it by reporting here: https://spa.xfinity.com/check_url_status.
|
|
423
447
|
|
|
424
448
|
If you still can't reach the site, the docs are mirrored on GitHub:
|
|
425
|
-
https://github.com/
|
|
449
|
+
https://github.com/openclaw/openclaw/tree/main/docs
|
|
426
450
|
|
|
427
|
-
###
|
|
451
|
+
### What's the difference between stable and beta
|
|
428
452
|
|
|
429
453
|
**Stable** and **beta** are **npm dist‑tags**, not separate code lines:
|
|
454
|
+
|
|
430
455
|
- `latest` = stable
|
|
431
456
|
- `beta` = early build for testing
|
|
432
457
|
|
|
@@ -435,7 +460,7 @@ that same version to `latest`**. That’s why beta and stable can point at the
|
|
|
435
460
|
**same version**.
|
|
436
461
|
|
|
437
462
|
See what changed:
|
|
438
|
-
https://github.com/
|
|
463
|
+
https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md
|
|
439
464
|
|
|
440
465
|
### How do I install the beta version and whats the difference between beta and dev
|
|
441
466
|
|
|
@@ -445,21 +470,22 @@ https://github.com/moltbot/moltbot/blob/main/CHANGELOG.md
|
|
|
445
470
|
One‑liners (macOS/Linux):
|
|
446
471
|
|
|
447
472
|
```bash
|
|
448
|
-
curl -fsSL --proto '=https' --tlsv1.2 https://
|
|
473
|
+
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta
|
|
449
474
|
```
|
|
450
475
|
|
|
451
476
|
```bash
|
|
452
|
-
curl -fsSL --proto '=https' --tlsv1.2 https://
|
|
477
|
+
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
|
|
453
478
|
```
|
|
454
479
|
|
|
455
480
|
Windows installer (PowerShell):
|
|
456
|
-
https://
|
|
481
|
+
https://openclaw.ai/install.ps1
|
|
457
482
|
|
|
458
483
|
More detail: [Development channels](/install/development-channels) and [Installer flags](/install/installer).
|
|
459
484
|
|
|
460
485
|
### How long does install and onboarding usually take
|
|
461
486
|
|
|
462
487
|
Rough guide:
|
|
488
|
+
|
|
463
489
|
- **Install:** 2-5 minutes
|
|
464
490
|
- **Onboarding:** 5-15 minutes depending on how many channels/models you configure
|
|
465
491
|
|
|
@@ -470,22 +496,27 @@ and the fast debug loop in [Im stuck](/help/faq#im-stuck--whats-the-fastest-way-
|
|
|
470
496
|
|
|
471
497
|
Two options:
|
|
472
498
|
|
|
473
|
-
1
|
|
499
|
+
1. **Dev channel (git checkout):**
|
|
500
|
+
|
|
474
501
|
```bash
|
|
475
|
-
|
|
502
|
+
openclaw update --channel dev
|
|
476
503
|
```
|
|
504
|
+
|
|
477
505
|
This switches to the `main` branch and updates from source.
|
|
478
506
|
|
|
479
|
-
2
|
|
507
|
+
2. **Hackable install (from the installer site):**
|
|
508
|
+
|
|
480
509
|
```bash
|
|
481
|
-
curl -fsSL https://
|
|
510
|
+
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
|
|
482
511
|
```
|
|
512
|
+
|
|
483
513
|
That gives you a local repo you can edit, then update via git.
|
|
484
514
|
|
|
485
515
|
If you prefer a clean clone manually, use:
|
|
516
|
+
|
|
486
517
|
```bash
|
|
487
|
-
git clone https://github.com/
|
|
488
|
-
cd
|
|
518
|
+
git clone https://github.com/openclaw/openclaw.git
|
|
519
|
+
cd openclaw
|
|
489
520
|
pnpm install
|
|
490
521
|
pnpm build
|
|
491
522
|
```
|
|
@@ -498,32 +529,34 @@ Docs: [Update](/cli/update), [Development channels](/install/development-channel
|
|
|
498
529
|
Re-run the installer with **verbose output**:
|
|
499
530
|
|
|
500
531
|
```bash
|
|
501
|
-
curl -fsSL https://
|
|
532
|
+
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose
|
|
502
533
|
```
|
|
503
534
|
|
|
504
535
|
Beta install with verbose:
|
|
505
536
|
|
|
506
537
|
```bash
|
|
507
|
-
curl -fsSL https://
|
|
538
|
+
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose
|
|
508
539
|
```
|
|
509
540
|
|
|
510
541
|
For a hackable (git) install:
|
|
511
542
|
|
|
512
543
|
```bash
|
|
513
|
-
curl -fsSL https://
|
|
544
|
+
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
|
|
514
545
|
```
|
|
515
546
|
|
|
516
547
|
More options: [Installer flags](/install/installer).
|
|
517
548
|
|
|
518
|
-
### Windows install says git not found or
|
|
549
|
+
### Windows install says git not found or openclaw not recognized
|
|
519
550
|
|
|
520
551
|
Two common Windows issues:
|
|
521
552
|
|
|
522
553
|
**1) npm error spawn git / git not found**
|
|
554
|
+
|
|
523
555
|
- Install **Git for Windows** and make sure `git` is on your PATH.
|
|
524
556
|
- Close and reopen PowerShell, then re-run the installer.
|
|
525
557
|
|
|
526
|
-
**2)
|
|
558
|
+
**2) openclaw is not recognized after install**
|
|
559
|
+
|
|
527
560
|
- Your npm global bin folder is not on PATH.
|
|
528
561
|
- Check the path:
|
|
529
562
|
```powershell
|
|
@@ -538,15 +571,15 @@ Docs: [Windows](/platforms/windows).
|
|
|
538
571
|
### The docs didnt answer my question how do I get a better answer
|
|
539
572
|
|
|
540
573
|
Use the **hackable (git) install** so you have the full source and docs locally, then ask
|
|
541
|
-
your bot (or Claude/Codex)
|
|
574
|
+
your bot (or Claude/Codex) _from that folder_ so it can read the repo and answer precisely.
|
|
542
575
|
|
|
543
576
|
```bash
|
|
544
|
-
curl -fsSL https://
|
|
577
|
+
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
|
|
545
578
|
```
|
|
546
579
|
|
|
547
580
|
More detail: [Install](/install) and [Installer flags](/install/installer).
|
|
548
581
|
|
|
549
|
-
### How do I install
|
|
582
|
+
### How do I install OpenClaw on Linux
|
|
550
583
|
|
|
551
584
|
Short answer: follow the Linux guide, then run the onboarding wizard.
|
|
552
585
|
|
|
@@ -554,7 +587,7 @@ Short answer: follow the Linux guide, then run the onboarding wizard.
|
|
|
554
587
|
- Full walkthrough: [Getting Started](/start/getting-started).
|
|
555
588
|
- Installer + updates: [Install & updates](/install/updating).
|
|
556
589
|
|
|
557
|
-
### How do I install
|
|
590
|
+
### How do I install OpenClaw on a VPS
|
|
558
591
|
|
|
559
592
|
Any Linux VPS works. Install on the server, then use SSH/Tailscale to reach the Gateway.
|
|
560
593
|
|
|
@@ -581,7 +614,7 @@ Gateway in the cloud.
|
|
|
581
614
|
Hub: [Platforms](/platforms). Remote access: [Gateway remote](/gateway/remote).
|
|
582
615
|
Nodes: [Nodes](/nodes), [Nodes CLI](/cli/nodes).
|
|
583
616
|
|
|
584
|
-
### Can I ask
|
|
617
|
+
### Can I ask OpenClaw to update itself
|
|
585
618
|
|
|
586
619
|
Short answer: **possible, not recommended**. The update flow can restart the
|
|
587
620
|
Gateway (which drops the active session), may need a clean git checkout, and
|
|
@@ -590,25 +623,25 @@ can prompt for confirmation. Safer: run updates from a shell as the operator.
|
|
|
590
623
|
Use the CLI:
|
|
591
624
|
|
|
592
625
|
```bash
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
626
|
+
openclaw update
|
|
627
|
+
openclaw update status
|
|
628
|
+
openclaw update --channel stable|beta|dev
|
|
629
|
+
openclaw update --tag <dist-tag|version>
|
|
630
|
+
openclaw update --no-restart
|
|
598
631
|
```
|
|
599
632
|
|
|
600
633
|
If you must automate from an agent:
|
|
601
634
|
|
|
602
635
|
```bash
|
|
603
|
-
|
|
604
|
-
|
|
636
|
+
openclaw update --yes --no-restart
|
|
637
|
+
openclaw gateway restart
|
|
605
638
|
```
|
|
606
639
|
|
|
607
640
|
Docs: [Update](/cli/update), [Updating](/install/updating).
|
|
608
641
|
|
|
609
642
|
### What does the onboarding wizard actually do
|
|
610
643
|
|
|
611
|
-
`
|
|
644
|
+
`openclaw onboard` is the recommended setup path. In **local mode** it walks you through:
|
|
612
645
|
|
|
613
646
|
- **Model/auth setup** (Anthropic **setup-token** recommended for Claude subscriptions, OpenAI Codex OAuth supported, API keys optional, LM Studio local models supported)
|
|
614
647
|
- **Workspace** location + bootstrap files
|
|
@@ -621,7 +654,7 @@ It also warns if your configured model is unknown or missing auth.
|
|
|
621
654
|
|
|
622
655
|
### Do I need a Claude or OpenAI subscription to run this
|
|
623
656
|
|
|
624
|
-
No. You can run
|
|
657
|
+
No. You can run OpenClaw with **API keys** (Anthropic/OpenAI/others) or with
|
|
625
658
|
**local‑only models** so your data stays on your device. Subscriptions (Claude
|
|
626
659
|
Pro/Max or OpenAI Codex) are optional ways to authenticate those providers.
|
|
627
660
|
|
|
@@ -640,7 +673,7 @@ If you want the most explicit, supported path, use an Anthropic API key.
|
|
|
640
673
|
|
|
641
674
|
### How does Anthropic setuptoken auth work
|
|
642
675
|
|
|
643
|
-
`claude setup-token` generates a **token string** via the Claude Code CLI (it is not available in the web console). You can run it on **any machine**. Choose **Anthropic token (paste setup-token)** in the wizard or paste it with `
|
|
676
|
+
`claude setup-token` generates a **token string** via the Claude Code CLI (it is not available in the web console). You can run it on **any machine**. Choose **Anthropic token (paste setup-token)** in the wizard or paste it with `openclaw models auth paste-token --provider anthropic`. The token is stored as an auth profile for the **anthropic** provider and used like an API key (no auto-refresh). More detail: [OAuth](/concepts/oauth).
|
|
644
677
|
|
|
645
678
|
### Where do I find an Anthropic setuptoken
|
|
646
679
|
|
|
@@ -650,11 +683,11 @@ It is **not** in the Anthropic Console. The setup-token is generated by the **Cl
|
|
|
650
683
|
claude setup-token
|
|
651
684
|
```
|
|
652
685
|
|
|
653
|
-
Copy the token it prints, then choose **Anthropic token (paste setup-token)** in the wizard. If you want to run it on the gateway host, use `
|
|
686
|
+
Copy the token it prints, then choose **Anthropic token (paste setup-token)** in the wizard. If you want to run it on the gateway host, use `openclaw models auth setup-token --provider anthropic`. If you ran `claude setup-token` elsewhere, paste it on the gateway host with `openclaw models auth paste-token --provider anthropic`. See [Anthropic](/providers/anthropic).
|
|
654
687
|
|
|
655
688
|
### Do you support Claude subscription auth (Claude Pro/Max)
|
|
656
689
|
|
|
657
|
-
Yes — via **setup-token**.
|
|
690
|
+
Yes — via **setup-token**. OpenClaw no longer reuses Claude Code CLI OAuth tokens; use a setup-token or an Anthropic API key. Generate the token anywhere and paste it on the gateway host. See [Anthropic](/providers/anthropic) and [OAuth](/concepts/oauth).
|
|
658
691
|
|
|
659
692
|
Note: Claude subscription access is governed by Anthropic’s terms. For production or multi‑user workloads, API keys are usually the safer choice.
|
|
660
693
|
|
|
@@ -665,7 +698,7 @@ use a **Claude subscription** (setup‑token or Claude Code OAuth), wait for the
|
|
|
665
698
|
reset or upgrade your plan. If you use an **Anthropic API key**, check the Anthropic Console
|
|
666
699
|
for usage/billing and raise limits as needed.
|
|
667
700
|
|
|
668
|
-
Tip: set a **fallback model** so
|
|
701
|
+
Tip: set a **fallback model** so OpenClaw can keep replying while a provider is rate‑limited.
|
|
669
702
|
See [Models](/cli/models) and [OAuth](/concepts/oauth).
|
|
670
703
|
|
|
671
704
|
### Is AWS Bedrock supported
|
|
@@ -674,28 +707,29 @@ Yes - via pi‑ai’s **Amazon Bedrock (Converse)** provider with **manual confi
|
|
|
674
707
|
|
|
675
708
|
### How does Codex auth work
|
|
676
709
|
|
|
677
|
-
|
|
710
|
+
OpenClaw supports **OpenAI Code (Codex)** via OAuth (ChatGPT sign-in). The wizard can run the OAuth flow and will set the default model to `openai-codex/gpt-5.2` when appropriate. See [Model providers](/concepts/model-providers) and [Wizard](/start/wizard).
|
|
678
711
|
|
|
679
712
|
### Do you support OpenAI subscription auth Codex OAuth
|
|
680
713
|
|
|
681
|
-
Yes.
|
|
714
|
+
Yes. OpenClaw fully supports **OpenAI Code (Codex) subscription OAuth**. The onboarding wizard
|
|
682
715
|
can run the OAuth flow for you.
|
|
683
716
|
|
|
684
717
|
See [OAuth](/concepts/oauth), [Model providers](/concepts/model-providers), and [Wizard](/start/wizard).
|
|
685
718
|
|
|
686
719
|
### How do I set up Gemini CLI OAuth
|
|
687
720
|
|
|
688
|
-
Gemini CLI uses a **plugin auth flow**, not a client id or secret in `
|
|
721
|
+
Gemini CLI uses a **plugin auth flow**, not a client id or secret in `openclaw.json`.
|
|
689
722
|
|
|
690
723
|
Steps:
|
|
691
|
-
|
|
692
|
-
|
|
724
|
+
|
|
725
|
+
1. Enable the plugin: `openclaw plugins enable google-gemini-cli-auth`
|
|
726
|
+
2. Login: `openclaw models auth login --provider google-gemini-cli --set-default`
|
|
693
727
|
|
|
694
728
|
This stores OAuth tokens in auth profiles on the gateway host. Details: [Model providers](/concepts/model-providers).
|
|
695
729
|
|
|
696
730
|
### Is a local model OK for casual chats
|
|
697
731
|
|
|
698
|
-
Usually no.
|
|
732
|
+
Usually no. OpenClaw needs large context + strong safety; small cards truncate and leak. If you must, run the **largest** MiniMax M2.1 build you can locally (LM Studio) and see [/gateway/local-models](/gateway/local-models). Smaller/quantized models increase prompt-injection risk - see [Security](/gateway/security).
|
|
699
733
|
|
|
700
734
|
### How do I keep hosted model traffic in a specific region
|
|
701
735
|
|
|
@@ -703,7 +737,7 @@ Pick region-pinned endpoints. OpenRouter exposes US-hosted options for MiniMax,
|
|
|
703
737
|
|
|
704
738
|
### Do I have to buy a Mac Mini to install this
|
|
705
739
|
|
|
706
|
-
No.
|
|
740
|
+
No. OpenClaw runs on macOS or Linux (Windows via WSL2). A Mac mini is optional - some people
|
|
707
741
|
buy one as an always‑on host, but a small VPS, home server, or Raspberry Pi‑class box works too.
|
|
708
742
|
|
|
709
743
|
You only need a Mac **for macOS‑only tools**. For iMessage, you can keep the Gateway on Linux
|
|
@@ -715,10 +749,11 @@ Docs: [iMessage](/channels/imessage), [Nodes](/nodes), [Mac remote mode](/platfo
|
|
|
715
749
|
### Do I need a Mac mini for iMessage support
|
|
716
750
|
|
|
717
751
|
You need **some macOS device** signed into Messages. It does **not** have to be a Mac mini -
|
|
718
|
-
any Mac works.
|
|
752
|
+
any Mac works. OpenClaw’s iMessage integrations run on macOS (BlueBubbles or `imsg`), while
|
|
719
753
|
the Gateway can run elsewhere.
|
|
720
754
|
|
|
721
755
|
Common setups:
|
|
756
|
+
|
|
722
757
|
- Run the Gateway on Linux/VPS, and point `channels.imessage.cliPath` at an SSH wrapper that
|
|
723
758
|
runs `imsg` on the Mac.
|
|
724
759
|
- Run everything on the Mac if you want the simplest single‑machine setup.
|
|
@@ -726,16 +761,17 @@ Common setups:
|
|
|
726
761
|
Docs: [iMessage](/channels/imessage), [BlueBubbles](/channels/bluebubbles),
|
|
727
762
|
[Mac remote mode](/platforms/mac/remote).
|
|
728
763
|
|
|
729
|
-
### If I buy a Mac mini to run
|
|
764
|
+
### If I buy a Mac mini to run OpenClaw can I connect it to my MacBook Pro
|
|
730
765
|
|
|
731
766
|
Yes. The **Mac mini can run the Gateway**, and your MacBook Pro can connect as a
|
|
732
767
|
**node** (companion device). Nodes don’t run the Gateway - they provide extra
|
|
733
768
|
capabilities like screen/camera/canvas and `system.run` on that device.
|
|
734
769
|
|
|
735
770
|
Common pattern:
|
|
771
|
+
|
|
736
772
|
- Gateway on the Mac mini (always‑on).
|
|
737
773
|
- MacBook Pro runs the macOS app or a node host and pairs to the Gateway.
|
|
738
|
-
- Use `
|
|
774
|
+
- Use `openclaw nodes status` / `openclaw nodes list` to see it.
|
|
739
775
|
|
|
740
776
|
Docs: [Nodes](/nodes), [Nodes CLI](/cli/nodes).
|
|
741
777
|
|
|
@@ -752,17 +788,20 @@ without WhatsApp/Telegram.
|
|
|
752
788
|
`channels.telegram.allowFrom` is **the human sender’s Telegram user ID** (numeric, recommended) or `@username`. It is not the bot username.
|
|
753
789
|
|
|
754
790
|
Safer (no third-party bot):
|
|
755
|
-
|
|
791
|
+
|
|
792
|
+
- DM your bot, then run `openclaw logs --follow` and read `from.id`.
|
|
756
793
|
|
|
757
794
|
Official Bot API:
|
|
795
|
+
|
|
758
796
|
- DM your bot, then call `https://api.telegram.org/bot<bot_token>/getUpdates` and read `message.from.id`.
|
|
759
797
|
|
|
760
798
|
Third-party (less private):
|
|
799
|
+
|
|
761
800
|
- DM `@userinfobot` or `@getidsbot`.
|
|
762
801
|
|
|
763
802
|
See [/channels/telegram](/channels/telegram#access-control-dms--groups).
|
|
764
803
|
|
|
765
|
-
### Can multiple people use one WhatsApp number with different
|
|
804
|
+
### Can multiple people use one WhatsApp number with different OpenClaw instances
|
|
766
805
|
|
|
767
806
|
Yes, via **multi‑agent routing**. Bind each sender’s WhatsApp **DM** (peer `kind: "dm"`, sender E.164 like `+15551234567`) to a different `agentId`, so each person gets their own workspace and session store. Replies still come from the **same WhatsApp account**, and DM access control (`channels.whatsapp.dmPolicy` / `channels.whatsapp.allowFrom`) is global per WhatsApp account. See [Multi-Agent Routing](/concepts/multi-agent) and [WhatsApp](/channels/whatsapp).
|
|
768
807
|
|
|
@@ -781,10 +820,10 @@ eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
|
|
|
781
820
|
brew install <formula>
|
|
782
821
|
```
|
|
783
822
|
|
|
784
|
-
If you run
|
|
823
|
+
If you run OpenClaw via systemd, ensure the service PATH includes `/home/linuxbrew/.linuxbrew/bin` (or your brew prefix) so `brew`-installed tools resolve in non‑login shells.
|
|
785
824
|
Recent builds also prepend common user bin dirs on Linux systemd services (for example `~/.local/bin`, `~/.npm-global/bin`, `~/.local/share/pnpm`, `~/.bun/bin`) and honor `PNPM_HOME`, `NPM_CONFIG_PREFIX`, `BUN_INSTALL`, `VOLTA_HOME`, `ASDF_DATA_DIR`, `NVM_DIR`, and `FNM_DIR` when set.
|
|
786
825
|
|
|
787
|
-
###
|
|
826
|
+
### What's the difference between the hackable git install and npm install
|
|
788
827
|
|
|
789
828
|
- **Hackable (git) install:** full source checkout, editable, best for contributors.
|
|
790
829
|
You run builds locally and can patch code/docs.
|
|
@@ -796,26 +835,26 @@ Docs: [Getting started](/start/getting-started), [Updating](/install/updating).
|
|
|
796
835
|
### Can I switch between npm and git installs later
|
|
797
836
|
|
|
798
837
|
Yes. Install the other flavor, then run Doctor so the gateway service points at the new entrypoint.
|
|
799
|
-
This **does not delete your data** - it only changes the
|
|
800
|
-
(`~/.
|
|
838
|
+
This **does not delete your data** - it only changes the OpenClaw code install. Your state
|
|
839
|
+
(`~/.openclaw`) and workspace (`~/.openclaw/workspace`) stay untouched.
|
|
801
840
|
|
|
802
841
|
From npm → git:
|
|
803
842
|
|
|
804
843
|
```bash
|
|
805
|
-
git clone https://github.com/
|
|
806
|
-
cd
|
|
844
|
+
git clone https://github.com/openclaw/openclaw.git
|
|
845
|
+
cd openclaw
|
|
807
846
|
pnpm install
|
|
808
847
|
pnpm build
|
|
809
|
-
|
|
810
|
-
|
|
848
|
+
openclaw doctor
|
|
849
|
+
openclaw gateway restart
|
|
811
850
|
```
|
|
812
851
|
|
|
813
852
|
From git → npm:
|
|
814
853
|
|
|
815
854
|
```bash
|
|
816
|
-
npm install -g
|
|
817
|
-
|
|
818
|
-
|
|
855
|
+
npm install -g openclaw@latest
|
|
856
|
+
openclaw doctor
|
|
857
|
+
openclaw gateway restart
|
|
819
858
|
```
|
|
820
859
|
|
|
821
860
|
Doctor detects a gateway service entrypoint mismatch and offers to rewrite the service config to match the current install (use `--repair` in automation).
|
|
@@ -828,18 +867,20 @@ Short answer: **if you want 24/7 reliability, use a VPS**. If you want the
|
|
|
828
867
|
lowest friction and you’re okay with sleep/restarts, run it locally.
|
|
829
868
|
|
|
830
869
|
**Laptop (local Gateway)**
|
|
870
|
+
|
|
831
871
|
- **Pros:** no server cost, direct access to local files, live browser window.
|
|
832
872
|
- **Cons:** sleep/network drops = disconnects, OS updates/reboots interrupt, must stay awake.
|
|
833
873
|
|
|
834
874
|
**VPS / cloud**
|
|
875
|
+
|
|
835
876
|
- **Pros:** always‑on, stable network, no laptop sleep issues, easier to keep running.
|
|
836
877
|
- **Cons:** often run headless (use screenshots), remote file access only, you must SSH for updates.
|
|
837
878
|
|
|
838
|
-
**
|
|
879
|
+
**OpenClaw-specific note:** WhatsApp/Telegram/Slack/Mattermost (plugin)/Discord all work fine from a VPS. The only real trade-off is **headless browser** vs a visible window. See [Browser](/tools/browser).
|
|
839
880
|
|
|
840
881
|
**Recommended default:** VPS if you had gateway disconnects before. Local is great when you’re actively using the Mac and want local file access or UI automation with a visible browser.
|
|
841
882
|
|
|
842
|
-
### How important is it to run
|
|
883
|
+
### How important is it to run OpenClaw on a dedicated machine
|
|
843
884
|
|
|
844
885
|
Not required, but **recommended for reliability and isolation**.
|
|
845
886
|
|
|
@@ -851,7 +892,7 @@ For security guidance, read [Security](/gateway/security).
|
|
|
851
892
|
|
|
852
893
|
### What are the minimum VPS requirements and recommended OS
|
|
853
894
|
|
|
854
|
-
|
|
895
|
+
OpenClaw is lightweight. For a basic Gateway + one chat channel:
|
|
855
896
|
|
|
856
897
|
- **Absolute minimum:** 1 vCPU, 1GB RAM, ~500MB disk.
|
|
857
898
|
- **Recommended:** 1-2 vCPU, 2GB RAM or more for headroom (logs, media, multiple channels). Node tools and browser automation can be resource hungry.
|
|
@@ -860,12 +901,13 @@ OS: use **Ubuntu LTS** (or any modern Debian/Ubuntu). The Linux install path is
|
|
|
860
901
|
|
|
861
902
|
Docs: [Linux](/platforms/linux), [VPS hosting](/vps).
|
|
862
903
|
|
|
863
|
-
### Can I run
|
|
904
|
+
### Can I run OpenClaw in a VM and what are the requirements
|
|
864
905
|
|
|
865
906
|
Yes. Treat a VM the same as a VPS: it needs to be always on, reachable, and have enough
|
|
866
907
|
RAM for the Gateway and any channels you enable.
|
|
867
908
|
|
|
868
909
|
Baseline guidance:
|
|
910
|
+
|
|
869
911
|
- **Absolute minimum:** 1 vCPU, 1GB RAM.
|
|
870
912
|
- **Recommended:** 2GB RAM or more if you run multiple channels, browser automation, or media tools.
|
|
871
913
|
- **OS:** Ubuntu LTS or another modern Debian/Ubuntu.
|
|
@@ -874,29 +916,30 @@ If you are on Windows, **WSL2 is the easiest VM style setup** and has the best t
|
|
|
874
916
|
compatibility. See [Windows](/platforms/windows), [VPS hosting](/vps).
|
|
875
917
|
If you are running macOS in a VM, see [macOS VM](/platforms/macos-vm).
|
|
876
918
|
|
|
877
|
-
## What is
|
|
919
|
+
## What is OpenClaw?
|
|
878
920
|
|
|
879
|
-
### What is
|
|
921
|
+
### What is OpenClaw in one paragraph
|
|
880
922
|
|
|
881
|
-
|
|
923
|
+
OpenClaw is a personal AI assistant you run on your own devices. It replies on the messaging surfaces you already use (WhatsApp, Telegram, Slack, Mattermost (plugin), Discord, Google Chat, Signal, iMessage, WebChat) and can also do voice + a live Canvas on supported platforms. The **Gateway** is the always-on control plane; the assistant is the product.
|
|
882
924
|
|
|
883
|
-
###
|
|
925
|
+
### What's the value proposition
|
|
884
926
|
|
|
885
|
-
|
|
927
|
+
OpenClaw is not “just a Claude wrapper.” It’s a **local-first control plane** that lets you run a
|
|
886
928
|
capable assistant on **your own hardware**, reachable from the chat apps you already use, with
|
|
887
929
|
stateful sessions, memory, and tools - without handing control of your workflows to a hosted
|
|
888
930
|
SaaS.
|
|
889
931
|
|
|
890
932
|
Highlights:
|
|
933
|
+
|
|
891
934
|
- **Your devices, your data:** run the Gateway wherever you want (Mac, Linux, VPS) and keep the
|
|
892
|
-
workspace + session history local.
|
|
935
|
+
workspace + session history local.
|
|
893
936
|
- **Real channels, not a web sandbox:** WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc,
|
|
894
|
-
plus mobile voice and Canvas on supported platforms.
|
|
937
|
+
plus mobile voice and Canvas on supported platforms.
|
|
895
938
|
- **Model-agnostic:** use Anthropic, OpenAI, MiniMax, OpenRouter, etc., with per‑agent routing
|
|
896
|
-
and failover.
|
|
939
|
+
and failover.
|
|
897
940
|
- **Local-only option:** run local models so **all data can stay on your device** if you want.
|
|
898
941
|
- **Multi-agent routing:** separate agents per channel, account, or task, each with its own
|
|
899
|
-
workspace and defaults.
|
|
942
|
+
workspace and defaults.
|
|
900
943
|
- **Open source and hackable:** inspect, extend, and self-host without vendor lock‑in.
|
|
901
944
|
|
|
902
945
|
Docs: [Gateway](/gateway), [Channels](/channels), [Multi‑agent](/concepts/multi-agent),
|
|
@@ -905,6 +948,7 @@ Docs: [Gateway](/gateway), [Channels](/channels), [Multi‑agent](/concepts/mult
|
|
|
905
948
|
### I just set it up what should I do first
|
|
906
949
|
|
|
907
950
|
Good first projects:
|
|
951
|
+
|
|
908
952
|
- Build a website (WordPress, Shopify, or a simple static site).
|
|
909
953
|
- Prototype a mobile app (outline, screens, API plan).
|
|
910
954
|
- Organize files and folders (cleanup, naming, tagging).
|
|
@@ -913,54 +957,57 @@ Good first projects:
|
|
|
913
957
|
It can handle large tasks, but it works best when you split them into phases and
|
|
914
958
|
use sub agents for parallel work.
|
|
915
959
|
|
|
916
|
-
### What are the top five everyday use cases for
|
|
960
|
+
### What are the top five everyday use cases for OpenClaw
|
|
917
961
|
|
|
918
962
|
Everyday wins usually look like:
|
|
963
|
+
|
|
919
964
|
- **Personal briefings:** summaries of inbox, calendar, and news you care about.
|
|
920
965
|
- **Research and drafting:** quick research, summaries, and first drafts for emails or docs.
|
|
921
966
|
- **Reminders and follow ups:** cron or heartbeat driven nudges and checklists.
|
|
922
967
|
- **Browser automation:** filling forms, collecting data, and repeating web tasks.
|
|
923
968
|
- **Cross device coordination:** send a task from your phone, let the Gateway run it on a server, and get the result back in chat.
|
|
924
969
|
|
|
925
|
-
### Can
|
|
970
|
+
### Can OpenClaw help with lead gen outreach ads and blogs for a SaaS
|
|
926
971
|
|
|
927
972
|
Yes for **research, qualification, and drafting**. It can scan sites, build shortlists,
|
|
928
973
|
summarize prospects, and write outreach or ad copy drafts.
|
|
929
974
|
|
|
930
975
|
For **outreach or ad runs**, keep a human in the loop. Avoid spam, follow local laws and
|
|
931
976
|
platform policies, and review anything before it is sent. The safest pattern is to let
|
|
932
|
-
|
|
977
|
+
OpenClaw draft and you approve.
|
|
933
978
|
|
|
934
979
|
Docs: [Security](/gateway/security).
|
|
935
980
|
|
|
936
981
|
### What are the advantages vs Claude Code for web development
|
|
937
982
|
|
|
938
|
-
|
|
939
|
-
Claude Code or Codex for the fastest direct coding loop inside a repo. Use
|
|
983
|
+
OpenClaw is a **personal assistant** and coordination layer, not an IDE replacement. Use
|
|
984
|
+
Claude Code or Codex for the fastest direct coding loop inside a repo. Use OpenClaw when you
|
|
940
985
|
want durable memory, cross-device access, and tool orchestration.
|
|
941
986
|
|
|
942
987
|
Advantages:
|
|
988
|
+
|
|
943
989
|
- **Persistent memory + workspace** across sessions
|
|
944
990
|
- **Multi-platform access** (WhatsApp, Telegram, TUI, WebChat)
|
|
945
991
|
- **Tool orchestration** (browser, files, scheduling, hooks)
|
|
946
992
|
- **Always-on Gateway** (run on a VPS, interact from anywhere)
|
|
947
993
|
- **Nodes** for local browser/screen/camera/exec
|
|
948
994
|
|
|
949
|
-
Showcase: https://
|
|
995
|
+
Showcase: https://openclaw.ai/showcase
|
|
950
996
|
|
|
951
997
|
## Skills and automation
|
|
952
998
|
|
|
953
999
|
### How do I customize skills without keeping the repo dirty
|
|
954
1000
|
|
|
955
|
-
Use managed overrides instead of editing the repo copy. Put your changes in `~/.
|
|
1001
|
+
Use managed overrides instead of editing the repo copy. Put your changes in `~/.openclaw/skills/<name>/SKILL.md` (or add a folder via `skills.load.extraDirs` in `~/.openclaw/openclaw.json`). Precedence is `<workspace>/skills` > `~/.openclaw/skills` > bundled, so managed overrides win without touching git. Only upstream-worthy edits should live in the repo and go out as PRs.
|
|
956
1002
|
|
|
957
1003
|
### Can I load skills from a custom folder
|
|
958
1004
|
|
|
959
|
-
Yes. Add extra directories via `skills.load.extraDirs` in `~/.
|
|
1005
|
+
Yes. Add extra directories via `skills.load.extraDirs` in `~/.openclaw/openclaw.json` (lowest precedence). Default precedence remains: `<workspace>/skills` → `~/.openclaw/skills` → bundled → `skills.load.extraDirs`. `clawhub` installs into `./skills` by default, which OpenClaw treats as `<workspace>/skills`.
|
|
960
1006
|
|
|
961
1007
|
### How can I use different models for different tasks
|
|
962
1008
|
|
|
963
1009
|
Today the supported patterns are:
|
|
1010
|
+
|
|
964
1011
|
- **Cron jobs**: isolated jobs can set a `model` override per job.
|
|
965
1012
|
- **Sub-agents**: route tasks to separate agents with different default models.
|
|
966
1013
|
- **On-demand switch**: use `/model` to switch the current session model at any time.
|
|
@@ -986,34 +1033,36 @@ Cron runs inside the Gateway process. If the Gateway is not running continuously
|
|
|
986
1033
|
scheduled jobs will not run.
|
|
987
1034
|
|
|
988
1035
|
Checklist:
|
|
989
|
-
|
|
1036
|
+
|
|
1037
|
+
- Confirm cron is enabled (`cron.enabled`) and `OPENCLAW_SKIP_CRON` is not set.
|
|
990
1038
|
- Check the Gateway is running 24/7 (no sleep/restarts).
|
|
991
1039
|
- Verify timezone settings for the job (`--tz` vs host timezone).
|
|
992
1040
|
|
|
993
1041
|
Debug:
|
|
1042
|
+
|
|
994
1043
|
```bash
|
|
995
|
-
|
|
996
|
-
|
|
1044
|
+
openclaw cron run <jobId> --force
|
|
1045
|
+
openclaw cron runs --id <jobId> --limit 50
|
|
997
1046
|
```
|
|
998
1047
|
|
|
999
1048
|
Docs: [Cron jobs](/automation/cron-jobs), [Cron vs Heartbeat](/automation/cron-vs-heartbeat).
|
|
1000
1049
|
|
|
1001
1050
|
### How do I install skills on Linux
|
|
1002
1051
|
|
|
1003
|
-
Use **
|
|
1004
|
-
Browse skills at https://
|
|
1052
|
+
Use **ClawHub** (CLI) or drop skills into your workspace. The macOS Skills UI isn’t available on Linux.
|
|
1053
|
+
Browse skills at https://clawhub.com.
|
|
1005
1054
|
|
|
1006
|
-
Install the
|
|
1055
|
+
Install the ClawHub CLI (pick one package manager):
|
|
1007
1056
|
|
|
1008
1057
|
```bash
|
|
1009
|
-
npm i -g
|
|
1058
|
+
npm i -g clawhub
|
|
1010
1059
|
```
|
|
1011
1060
|
|
|
1012
1061
|
```bash
|
|
1013
|
-
pnpm add -g
|
|
1062
|
+
pnpm add -g clawhub
|
|
1014
1063
|
```
|
|
1015
1064
|
|
|
1016
|
-
### Can
|
|
1065
|
+
### Can OpenClaw run tasks on a schedule or continuously in the background
|
|
1017
1066
|
|
|
1018
1067
|
Yes. Use the Gateway scheduler:
|
|
1019
1068
|
|
|
@@ -1026,47 +1075,49 @@ Docs: [Cron jobs](/automation/cron-jobs), [Cron vs Heartbeat](/automation/cron-v
|
|
|
1026
1075
|
|
|
1027
1076
|
**Can I run Apple macOS only skills from Linux**
|
|
1028
1077
|
|
|
1029
|
-
Not directly. macOS skills are gated by `metadata.
|
|
1078
|
+
Not directly. macOS skills are gated by `metadata.openclaw.os` plus required binaries, and skills only appear in the system prompt when they are eligible on the **Gateway host**. On Linux, `darwin`-only skills (like `imsg`, `apple-notes`, `apple-reminders`) will not load unless you override the gating.
|
|
1030
1079
|
|
|
1031
1080
|
You have three supported patterns:
|
|
1032
1081
|
|
|
1033
1082
|
**Option A - run the Gateway on a Mac (simplest).**
|
|
1034
|
-
Run the Gateway where the macOS binaries exist, then connect from Linux in [remote mode](#how-do-i-run-
|
|
1083
|
+
Run the Gateway where the macOS binaries exist, then connect from Linux in [remote mode](#how-do-i-run-openclaw-in-remote-mode-client-connects-to-a-gateway-elsewhere) or over Tailscale. The skills load normally because the Gateway host is macOS.
|
|
1035
1084
|
|
|
1036
1085
|
**Option B - use a macOS node (no SSH).**
|
|
1037
|
-
Run the Gateway on Linux, pair a macOS node (menubar app), and set **Node Run Commands** to "Always Ask" or "Always Allow" on the Mac.
|
|
1086
|
+
Run the Gateway on Linux, pair a macOS node (menubar app), and set **Node Run Commands** to "Always Ask" or "Always Allow" on the Mac. OpenClaw can treat macOS-only skills as eligible when the required binaries exist on the node. The agent runs those skills via the `nodes` tool. If you choose "Always Ask", approving "Always Allow" in the prompt adds that command to the allowlist.
|
|
1038
1087
|
|
|
1039
1088
|
**Option C - proxy macOS binaries over SSH (advanced).**
|
|
1040
1089
|
Keep the Gateway on Linux, but make the required CLI binaries resolve to SSH wrappers that run on a Mac. Then override the skill to allow Linux so it stays eligible.
|
|
1041
1090
|
|
|
1042
|
-
1
|
|
1091
|
+
1. Create an SSH wrapper for the binary (example: `imsg`):
|
|
1043
1092
|
```bash
|
|
1044
1093
|
#!/usr/bin/env bash
|
|
1045
1094
|
set -euo pipefail
|
|
1046
1095
|
exec ssh -T user@mac-host /opt/homebrew/bin/imsg "$@"
|
|
1047
1096
|
```
|
|
1048
|
-
2
|
|
1049
|
-
3
|
|
1097
|
+
2. Put the wrapper on `PATH` on the Linux host (for example `~/bin/imsg`).
|
|
1098
|
+
3. Override the skill metadata (workspace or `~/.openclaw/skills`) to allow Linux:
|
|
1050
1099
|
```markdown
|
|
1051
1100
|
---
|
|
1052
1101
|
name: imsg
|
|
1053
1102
|
description: iMessage/SMS CLI for listing chats, history, watch, and sending.
|
|
1054
|
-
metadata: {"
|
|
1103
|
+
metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["imsg"] } } }
|
|
1055
1104
|
---
|
|
1056
1105
|
```
|
|
1057
|
-
4
|
|
1106
|
+
4. Start a new session so the skills snapshot refreshes.
|
|
1058
1107
|
|
|
1059
|
-
For iMessage specifically, you can also point `channels.imessage.cliPath` at an SSH wrapper (
|
|
1108
|
+
For iMessage specifically, you can also point `channels.imessage.cliPath` at an SSH wrapper (OpenClaw only needs stdio). See [iMessage](/channels/imessage).
|
|
1060
1109
|
|
|
1061
1110
|
### Do you have a Notion or HeyGen integration
|
|
1062
1111
|
|
|
1063
1112
|
Not built‑in today.
|
|
1064
1113
|
|
|
1065
1114
|
Options:
|
|
1115
|
+
|
|
1066
1116
|
- **Custom skill / plugin:** best for reliable API access (Notion/HeyGen both have APIs).
|
|
1067
1117
|
- **Browser automation:** works without code but is slower and more fragile.
|
|
1068
1118
|
|
|
1069
1119
|
If you want to keep context per client (agency workflows), a simple pattern is:
|
|
1120
|
+
|
|
1070
1121
|
- One Notion page per client (context + preferences + active work).
|
|
1071
1122
|
- Ask the agent to fetch that page at the start of a session.
|
|
1072
1123
|
|
|
@@ -1076,19 +1127,19 @@ targeting those APIs.
|
|
|
1076
1127
|
Install skills:
|
|
1077
1128
|
|
|
1078
1129
|
```bash
|
|
1079
|
-
|
|
1080
|
-
|
|
1130
|
+
clawhub install <skill-slug>
|
|
1131
|
+
clawhub update --all
|
|
1081
1132
|
```
|
|
1082
1133
|
|
|
1083
|
-
|
|
1134
|
+
ClawHub installs into `./skills` under your current directory (or falls back to your configured OpenClaw workspace); OpenClaw treats that as `<workspace>/skills` on the next session. For shared skills across agents, place them in `~/.openclaw/skills/<name>/SKILL.md`. Some skills expect binaries installed via Homebrew; on Linux that means Linuxbrew (see the Homebrew Linux FAQ entry above). See [Skills](/tools/skills) and [ClawHub](/tools/clawhub).
|
|
1084
1135
|
|
|
1085
1136
|
### How do I install the Chrome extension for browser takeover
|
|
1086
1137
|
|
|
1087
1138
|
Use the built-in installer, then load the unpacked extension in Chrome:
|
|
1088
1139
|
|
|
1089
1140
|
```bash
|
|
1090
|
-
|
|
1091
|
-
|
|
1141
|
+
openclaw browser extension install
|
|
1142
|
+
openclaw browser extension path
|
|
1092
1143
|
```
|
|
1093
1144
|
|
|
1094
1145
|
Then Chrome → `chrome://extensions` → enable “Developer mode” → “Load unpacked” → pick that folder.
|
|
@@ -1121,11 +1172,12 @@ Set `agents.defaults.sandbox.docker.binds` to `["host:path:mode"]` (e.g., `"/hom
|
|
|
1121
1172
|
|
|
1122
1173
|
### How does memory work
|
|
1123
1174
|
|
|
1124
|
-
|
|
1175
|
+
OpenClaw memory is just Markdown files in the agent workspace:
|
|
1176
|
+
|
|
1125
1177
|
- Daily notes in `memory/YYYY-MM-DD.md`
|
|
1126
1178
|
- Curated long-term notes in `MEMORY.md` (main/private sessions only)
|
|
1127
1179
|
|
|
1128
|
-
|
|
1180
|
+
OpenClaw also runs a **silent pre-compaction memory flush** to remind the model
|
|
1129
1181
|
to write durable notes before auto-compaction. This only runs when the workspace
|
|
1130
1182
|
is writable (read-only sandboxes skip it). See [Memory](/concepts/memory).
|
|
1131
1183
|
|
|
@@ -1147,11 +1199,11 @@ does **not** grant embeddings access, so **signing in with Codex (OAuth or the
|
|
|
1147
1199
|
Codex CLI login)** does not help for semantic memory search. OpenAI embeddings
|
|
1148
1200
|
still need a real API key (`OPENAI_API_KEY` or `models.providers.openai.apiKey`).
|
|
1149
1201
|
|
|
1150
|
-
If you don’t set a provider explicitly,
|
|
1202
|
+
If you don’t set a provider explicitly, OpenClaw auto-selects a provider when it
|
|
1151
1203
|
can resolve an API key (auth profiles, `models.providers.*.apiKey`, or env vars).
|
|
1152
1204
|
It prefers OpenAI if an OpenAI key resolves, otherwise Gemini if a Gemini key
|
|
1153
1205
|
resolves. If neither key is available, memory search stays disabled until you
|
|
1154
|
-
configure it. If you have a local model path configured and present,
|
|
1206
|
+
configure it. If you have a local model path configured and present, OpenClaw
|
|
1155
1207
|
prefers `local`.
|
|
1156
1208
|
|
|
1157
1209
|
If you’d rather stay local, set `memorySearch.provider = "local"` (and optionally
|
|
@@ -1171,12 +1223,12 @@ Docs: [Memory](/concepts/memory), [Context](/concepts/context).
|
|
|
1171
1223
|
|
|
1172
1224
|
## Where things live on disk
|
|
1173
1225
|
|
|
1174
|
-
### Is all data used with
|
|
1226
|
+
### Is all data used with OpenClaw saved locally
|
|
1175
1227
|
|
|
1176
|
-
No - **
|
|
1228
|
+
No - **OpenClaw’s state is local**, but **external services still see what you send them**.
|
|
1177
1229
|
|
|
1178
1230
|
- **Local by default:** sessions, memory files, config, and workspace live on the Gateway host
|
|
1179
|
-
(`~/.
|
|
1231
|
+
(`~/.openclaw` + your workspace directory).
|
|
1180
1232
|
- **Remote by necessity:** messages you send to model providers (Anthropic/OpenAI/etc.) go to
|
|
1181
1233
|
their APIs, and chat platforms (WhatsApp/Telegram/Slack/etc.) store message data on their
|
|
1182
1234
|
servers.
|
|
@@ -1185,39 +1237,39 @@ No - **Moltbot’s state is local**, but **external services still see what you
|
|
|
1185
1237
|
|
|
1186
1238
|
Related: [Agent workspace](/concepts/agent-workspace), [Memory](/concepts/memory).
|
|
1187
1239
|
|
|
1188
|
-
### Where does
|
|
1240
|
+
### Where does OpenClaw store its data
|
|
1189
1241
|
|
|
1190
|
-
Everything lives under `$
|
|
1242
|
+
Everything lives under `$OPENCLAW_STATE_DIR` (default: `~/.openclaw`):
|
|
1191
1243
|
|
|
1192
|
-
| Path
|
|
1193
|
-
|
|
1194
|
-
| `$
|
|
1195
|
-
| `$
|
|
1196
|
-
| `$
|
|
1197
|
-
| `$
|
|
1198
|
-
| `$
|
|
1199
|
-
| `$
|
|
1200
|
-
| `$
|
|
1201
|
-
| `$
|
|
1244
|
+
| Path | Purpose |
|
|
1245
|
+
| --------------------------------------------------------------- | ------------------------------------------------------------ |
|
|
1246
|
+
| `$OPENCLAW_STATE_DIR/openclaw.json` | Main config (JSON5) |
|
|
1247
|
+
| `$OPENCLAW_STATE_DIR/credentials/oauth.json` | Legacy OAuth import (copied into auth profiles on first use) |
|
|
1248
|
+
| `$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.json` | Auth profiles (OAuth + API keys) |
|
|
1249
|
+
| `$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.json` | Runtime auth cache (managed automatically) |
|
|
1250
|
+
| `$OPENCLAW_STATE_DIR/credentials/` | Provider state (e.g. `whatsapp/<accountId>/creds.json`) |
|
|
1251
|
+
| `$OPENCLAW_STATE_DIR/agents/` | Per‑agent state (agentDir + sessions) |
|
|
1252
|
+
| `$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/` | Conversation history & state (per agent) |
|
|
1253
|
+
| `$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/sessions.json` | Session metadata (per agent) |
|
|
1202
1254
|
|
|
1203
|
-
Legacy single‑agent path: `~/.
|
|
1255
|
+
Legacy single‑agent path: `~/.openclaw/agent/*` (migrated by `openclaw doctor`).
|
|
1204
1256
|
|
|
1205
|
-
Your **workspace** (AGENTS.md, memory files, skills, etc.) is separate and configured via `agents.defaults.workspace` (default:
|
|
1257
|
+
Your **workspace** (AGENTS.md, memory files, skills, etc.) is separate and configured via `agents.defaults.workspace` (default: `~/.openclaw/workspace`).
|
|
1206
1258
|
|
|
1207
1259
|
### Where should AGENTSmd SOULmd USERmd MEMORYmd live
|
|
1208
1260
|
|
|
1209
|
-
These files live in the **agent workspace**, not `~/.
|
|
1261
|
+
These files live in the **agent workspace**, not `~/.openclaw`.
|
|
1210
1262
|
|
|
1211
1263
|
- **Workspace (per agent)**: `AGENTS.md`, `SOUL.md`, `IDENTITY.md`, `USER.md`,
|
|
1212
1264
|
`MEMORY.md` (or `memory.md`), `memory/YYYY-MM-DD.md`, optional `HEARTBEAT.md`.
|
|
1213
|
-
- **State dir (`~/.
|
|
1214
|
-
and shared skills (`~/.
|
|
1265
|
+
- **State dir (`~/.openclaw`)**: config, credentials, auth profiles, sessions, logs,
|
|
1266
|
+
and shared skills (`~/.openclaw/skills`).
|
|
1215
1267
|
|
|
1216
|
-
Default workspace is
|
|
1268
|
+
Default workspace is `~/.openclaw/workspace`, configurable via:
|
|
1217
1269
|
|
|
1218
1270
|
```json5
|
|
1219
1271
|
{
|
|
1220
|
-
agents: { defaults: { workspace: "
|
|
1272
|
+
agents: { defaults: { workspace: "~/.openclaw/workspace" } },
|
|
1221
1273
|
}
|
|
1222
1274
|
```
|
|
1223
1275
|
|
|
@@ -1230,19 +1282,19 @@ AGENTS.md or MEMORY.md** rather than relying on chat history.
|
|
|
1230
1282
|
|
|
1231
1283
|
See [Agent workspace](/concepts/agent-workspace) and [Memory](/concepts/memory).
|
|
1232
1284
|
|
|
1233
|
-
###
|
|
1285
|
+
### What's the recommended backup strategy
|
|
1234
1286
|
|
|
1235
1287
|
Put your **agent workspace** in a **private** git repo and back it up somewhere
|
|
1236
1288
|
private (for example GitHub private). This captures memory + AGENTS/SOUL/USER
|
|
1237
1289
|
files, and lets you restore the assistant’s “mind” later.
|
|
1238
1290
|
|
|
1239
|
-
Do **not** commit anything under `~/.
|
|
1291
|
+
Do **not** commit anything under `~/.openclaw` (credentials, sessions, tokens).
|
|
1240
1292
|
If you need a full restore, back up both the workspace and the state directory
|
|
1241
1293
|
separately (see the migration question above).
|
|
1242
1294
|
|
|
1243
1295
|
Docs: [Agent workspace](/concepts/agent-workspace).
|
|
1244
1296
|
|
|
1245
|
-
### How do I completely uninstall
|
|
1297
|
+
### How do I completely uninstall OpenClaw
|
|
1246
1298
|
|
|
1247
1299
|
See the dedicated guide: [Uninstall](/install/uninstall).
|
|
1248
1300
|
|
|
@@ -1253,7 +1305,7 @@ Relative paths resolve inside the workspace, but absolute paths can access other
|
|
|
1253
1305
|
host locations unless sandboxing is enabled. If you need isolation, use
|
|
1254
1306
|
[`agents.defaults.sandbox`](/gateway/sandboxing) or per‑agent sandbox settings. If you
|
|
1255
1307
|
want a repo to be the default working directory, point that agent’s
|
|
1256
|
-
`workspace` to the repo root. The
|
|
1308
|
+
`workspace` to the repo root. The OpenClaw repo is just source code; keep the
|
|
1257
1309
|
workspace separate unless you intentionally want the agent to work inside it.
|
|
1258
1310
|
|
|
1259
1311
|
Example (repo as default cwd):
|
|
@@ -1262,9 +1314,9 @@ Example (repo as default cwd):
|
|
|
1262
1314
|
{
|
|
1263
1315
|
agents: {
|
|
1264
1316
|
defaults: {
|
|
1265
|
-
workspace: "~/Projects/my-repo"
|
|
1266
|
-
}
|
|
1267
|
-
}
|
|
1317
|
+
workspace: "~/Projects/my-repo",
|
|
1318
|
+
},
|
|
1319
|
+
},
|
|
1268
1320
|
}
|
|
1269
1321
|
```
|
|
1270
1322
|
|
|
@@ -1276,17 +1328,17 @@ Session state is owned by the **gateway host**. If you’re in remote mode, the
|
|
|
1276
1328
|
|
|
1277
1329
|
### What format is the config Where is it
|
|
1278
1330
|
|
|
1279
|
-
|
|
1331
|
+
OpenClaw reads an optional **JSON5** config from `$OPENCLAW_CONFIG_PATH` (default: `~/.openclaw/openclaw.json`):
|
|
1280
1332
|
|
|
1281
1333
|
```
|
|
1282
|
-
$
|
|
1334
|
+
$OPENCLAW_CONFIG_PATH
|
|
1283
1335
|
```
|
|
1284
1336
|
|
|
1285
|
-
If the file is missing, it uses safe‑ish defaults (including a default workspace of
|
|
1337
|
+
If the file is missing, it uses safe‑ish defaults (including a default workspace of `~/.openclaw/workspace`).
|
|
1286
1338
|
|
|
1287
1339
|
### I set gatewaybind lan or tailnet and now nothing listens the UI says unauthorized
|
|
1288
1340
|
|
|
1289
|
-
Non-loopback binds **require auth**. Configure `gateway.auth.mode` + `gateway.auth.token` (or use `
|
|
1341
|
+
Non-loopback binds **require auth**. Configure `gateway.auth.mode` + `gateway.auth.token` (or use `OPENCLAW_GATEWAY_TOKEN`).
|
|
1290
1342
|
|
|
1291
1343
|
```json5
|
|
1292
1344
|
{
|
|
@@ -1294,13 +1346,14 @@ Non-loopback binds **require auth**. Configure `gateway.auth.mode` + `gateway.au
|
|
|
1294
1346
|
bind: "lan",
|
|
1295
1347
|
auth: {
|
|
1296
1348
|
mode: "token",
|
|
1297
|
-
token: "replace-me"
|
|
1298
|
-
}
|
|
1299
|
-
}
|
|
1349
|
+
token: "replace-me",
|
|
1350
|
+
},
|
|
1351
|
+
},
|
|
1300
1352
|
}
|
|
1301
1353
|
```
|
|
1302
1354
|
|
|
1303
1355
|
Notes:
|
|
1356
|
+
|
|
1304
1357
|
- `gateway.remote.token` is for **remote CLI calls** only; it does not enable local gateway auth.
|
|
1305
1358
|
- The Control UI authenticates via `connect.params.auth.token` (stored in app/UI settings). Avoid putting tokens in URLs.
|
|
1306
1359
|
|
|
@@ -1308,7 +1361,7 @@ Notes:
|
|
|
1308
1361
|
|
|
1309
1362
|
The wizard generates a gateway token by default (even on loopback) so **local WS clients must authenticate**. This blocks other local processes from calling the Gateway. Paste the token into the Control UI settings (or your client config) to connect.
|
|
1310
1363
|
|
|
1311
|
-
If you **really** want open loopback, remove `gateway.auth` from your config. Doctor can generate a token for you any time: `
|
|
1364
|
+
If you **really** want open loopback, remove `gateway.auth` from your config. Doctor can generate a token for you any time: `openclaw doctor --generate-gateway-token`.
|
|
1312
1365
|
|
|
1313
1366
|
### Do I have to restart after changing config
|
|
1314
1367
|
|
|
@@ -1320,7 +1373,7 @@ The Gateway watches the config and supports hot‑reload:
|
|
|
1320
1373
|
### How do I enable web search and web fetch
|
|
1321
1374
|
|
|
1322
1375
|
`web_fetch` works without an API key. `web_search` requires a Brave Search API
|
|
1323
|
-
key. **Recommended:** run `
|
|
1376
|
+
key. **Recommended:** run `openclaw configure --section web` to store it in
|
|
1324
1377
|
`tools.web.search.apiKey`. Environment alternative: set `BRAVE_API_KEY` for the
|
|
1325
1378
|
Gateway process.
|
|
1326
1379
|
|
|
@@ -1331,20 +1384,21 @@ Gateway process.
|
|
|
1331
1384
|
search: {
|
|
1332
1385
|
enabled: true,
|
|
1333
1386
|
apiKey: "BRAVE_API_KEY_HERE",
|
|
1334
|
-
maxResults: 5
|
|
1387
|
+
maxResults: 5,
|
|
1335
1388
|
},
|
|
1336
1389
|
fetch: {
|
|
1337
|
-
enabled: true
|
|
1338
|
-
}
|
|
1339
|
-
}
|
|
1340
|
-
}
|
|
1390
|
+
enabled: true,
|
|
1391
|
+
},
|
|
1392
|
+
},
|
|
1393
|
+
},
|
|
1341
1394
|
}
|
|
1342
1395
|
```
|
|
1343
1396
|
|
|
1344
1397
|
Notes:
|
|
1398
|
+
|
|
1345
1399
|
- If you use allowlists, add `web_search`/`web_fetch` or `group:web`.
|
|
1346
1400
|
- `web_fetch` is enabled by default (unless explicitly disabled).
|
|
1347
|
-
- Daemons read env vars from `~/.
|
|
1401
|
+
- Daemons read env vars from `~/.openclaw/.env` (or the service environment).
|
|
1348
1402
|
|
|
1349
1403
|
Docs: [Web tools](/tools/web).
|
|
1350
1404
|
|
|
@@ -1360,7 +1414,7 @@ The common pattern is **one Gateway** (e.g. Raspberry Pi) plus **nodes** and **a
|
|
|
1360
1414
|
|
|
1361
1415
|
Docs: [Nodes](/nodes), [Remote access](/gateway/remote), [Multi-Agent Routing](/concepts/multi-agent), [Sub-agents](/tools/subagents), [TUI](/tui).
|
|
1362
1416
|
|
|
1363
|
-
### Can the
|
|
1417
|
+
### Can the OpenClaw browser run headless
|
|
1364
1418
|
|
|
1365
1419
|
Yes. It’s a config option:
|
|
1366
1420
|
|
|
@@ -1369,15 +1423,16 @@ Yes. It’s a config option:
|
|
|
1369
1423
|
browser: { headless: true },
|
|
1370
1424
|
agents: {
|
|
1371
1425
|
defaults: {
|
|
1372
|
-
sandbox: { browser: { headless: true } }
|
|
1373
|
-
}
|
|
1374
|
-
}
|
|
1426
|
+
sandbox: { browser: { headless: true } },
|
|
1427
|
+
},
|
|
1428
|
+
},
|
|
1375
1429
|
}
|
|
1376
1430
|
```
|
|
1377
1431
|
|
|
1378
1432
|
Default is `false` (headful). Headless is more likely to trigger anti‑bot checks on some sites. See [Browser](/tools/browser).
|
|
1379
1433
|
|
|
1380
1434
|
Headless uses the **same Chromium engine** and works for most automation (forms, clicks, scraping, logins). The main differences:
|
|
1435
|
+
|
|
1381
1436
|
- No visible browser window (use screenshots if you need visuals).
|
|
1382
1437
|
- Some sites are stricter about automation in headless mode (CAPTCHAs, anti‑bot).
|
|
1383
1438
|
For example, X/Twitter often blocks headless sessions.
|
|
@@ -1404,15 +1459,16 @@ Short answer: **pair your computer as a node**. The Gateway runs elsewhere, but
|
|
|
1404
1459
|
call `node.*` tools (screen, camera, system) on your local machine over the Gateway WebSocket.
|
|
1405
1460
|
|
|
1406
1461
|
Typical setup:
|
|
1407
|
-
|
|
1408
|
-
|
|
1409
|
-
|
|
1410
|
-
|
|
1462
|
+
|
|
1463
|
+
1. Run the Gateway on the always‑on host (VPS/home server).
|
|
1464
|
+
2. Put the Gateway host + your computer on the same tailnet.
|
|
1465
|
+
3. Ensure the Gateway WS is reachable (tailnet bind or SSH tunnel).
|
|
1466
|
+
4. Open the macOS app locally and connect in **Remote over SSH** mode (or direct tailnet)
|
|
1411
1467
|
so it can register as a node.
|
|
1412
|
-
5
|
|
1468
|
+
5. Approve the node on the Gateway:
|
|
1413
1469
|
```bash
|
|
1414
|
-
|
|
1415
|
-
|
|
1470
|
+
openclaw nodes pending
|
|
1471
|
+
openclaw nodes approve <requestId>
|
|
1416
1472
|
```
|
|
1417
1473
|
|
|
1418
1474
|
No separate TCP bridge is required; nodes connect over the Gateway WebSocket.
|
|
@@ -1425,18 +1481,20 @@ Docs: [Nodes](/nodes), [Gateway protocol](/gateway/protocol), [macOS remote mode
|
|
|
1425
1481
|
### Tailscale is connected but I get no replies What now
|
|
1426
1482
|
|
|
1427
1483
|
Check the basics:
|
|
1428
|
-
|
|
1429
|
-
- Gateway
|
|
1430
|
-
-
|
|
1484
|
+
|
|
1485
|
+
- Gateway is running: `openclaw gateway status`
|
|
1486
|
+
- Gateway health: `openclaw status`
|
|
1487
|
+
- Channel health: `openclaw channels status`
|
|
1431
1488
|
|
|
1432
1489
|
Then verify auth and routing:
|
|
1490
|
+
|
|
1433
1491
|
- If you use Tailscale Serve, make sure `gateway.auth.allowTailscale` is set correctly.
|
|
1434
1492
|
- If you connect via SSH tunnel, confirm the local tunnel is up and points at the right port.
|
|
1435
1493
|
- Confirm your allowlists (DM or group) include your account.
|
|
1436
1494
|
|
|
1437
1495
|
Docs: [Tailscale](/gateway/tailscale), [Remote access](/gateway/remote), [Channels](/channels).
|
|
1438
1496
|
|
|
1439
|
-
### Can two
|
|
1497
|
+
### Can two OpenClaw instances talk to each other local VPS
|
|
1440
1498
|
|
|
1441
1499
|
Yes. There is no built-in "bot-to-bot" bridge, but you can wire it up in a few
|
|
1442
1500
|
reliable ways:
|
|
@@ -1445,13 +1503,14 @@ reliable ways:
|
|
|
1445
1503
|
Have Bot A send a message to Bot B, then let Bot B reply as usual.
|
|
1446
1504
|
|
|
1447
1505
|
**CLI bridge (generic):** run a script that calls the other Gateway with
|
|
1448
|
-
`
|
|
1506
|
+
`openclaw agent --message ... --deliver`, targeting a chat where the other bot
|
|
1449
1507
|
listens. If one bot is on a remote VPS, point your CLI at that remote Gateway
|
|
1450
1508
|
via SSH/Tailscale (see [Remote access](/gateway/remote)).
|
|
1451
1509
|
|
|
1452
1510
|
Example pattern (run from a machine that can reach the target Gateway):
|
|
1511
|
+
|
|
1453
1512
|
```bash
|
|
1454
|
-
|
|
1513
|
+
openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>
|
|
1455
1514
|
```
|
|
1456
1515
|
|
|
1457
1516
|
Tip: add a guardrail so the two bots do not loop endlessly (mention-only, channel
|
|
@@ -1515,23 +1574,25 @@ Yes. `config.apply` validates + writes the full config and restarts the Gateway
|
|
|
1515
1574
|
else is removed.
|
|
1516
1575
|
|
|
1517
1576
|
Recover:
|
|
1518
|
-
|
|
1519
|
-
-
|
|
1577
|
+
|
|
1578
|
+
- Restore from backup (git or a copied `~/.openclaw/openclaw.json`).
|
|
1579
|
+
- If you have no backup, re-run `openclaw doctor` and reconfigure channels/models.
|
|
1520
1580
|
- If this was unexpected, file a bug and include your last known config or any backup.
|
|
1521
1581
|
- A local coding agent can often reconstruct a working config from logs or history.
|
|
1522
1582
|
|
|
1523
1583
|
Avoid it:
|
|
1524
|
-
|
|
1525
|
-
- Use `
|
|
1584
|
+
|
|
1585
|
+
- Use `openclaw config set` for small changes.
|
|
1586
|
+
- Use `openclaw configure` for interactive edits.
|
|
1526
1587
|
|
|
1527
1588
|
Docs: [Config](/cli/config), [Configure](/cli/configure), [Doctor](/gateway/doctor).
|
|
1528
1589
|
|
|
1529
|
-
###
|
|
1590
|
+
### What's a minimal sane config for a first install
|
|
1530
1591
|
|
|
1531
1592
|
```json5
|
|
1532
1593
|
{
|
|
1533
|
-
agents: { defaults: { workspace: "
|
|
1534
|
-
channels: { whatsapp: { allowFrom: ["+15555550123"] } }
|
|
1594
|
+
agents: { defaults: { workspace: "~/.openclaw/workspace" } },
|
|
1595
|
+
channels: { whatsapp: { allowFrom: ["+15555550123"] } },
|
|
1535
1596
|
}
|
|
1536
1597
|
```
|
|
1537
1598
|
|
|
@@ -1541,23 +1602,25 @@ This sets your workspace and restricts who can trigger the bot.
|
|
|
1541
1602
|
|
|
1542
1603
|
Minimal steps:
|
|
1543
1604
|
|
|
1544
|
-
1
|
|
1605
|
+
1. **Install + login on the VPS**
|
|
1545
1606
|
```bash
|
|
1546
1607
|
curl -fsSL https://tailscale.com/install.sh | sh
|
|
1547
1608
|
sudo tailscale up
|
|
1548
1609
|
```
|
|
1549
|
-
2
|
|
1610
|
+
2. **Install + login on your Mac**
|
|
1550
1611
|
- Use the Tailscale app and sign in to the same tailnet.
|
|
1551
|
-
3
|
|
1612
|
+
3. **Enable MagicDNS (recommended)**
|
|
1552
1613
|
- In the Tailscale admin console, enable MagicDNS so the VPS has a stable name.
|
|
1553
|
-
4
|
|
1614
|
+
4. **Use the tailnet hostname**
|
|
1554
1615
|
- SSH: `ssh user@your-vps.tailnet-xxxx.ts.net`
|
|
1555
1616
|
- Gateway WS: `ws://your-vps.tailnet-xxxx.ts.net:18789`
|
|
1556
1617
|
|
|
1557
1618
|
If you want the Control UI without SSH, use Tailscale Serve on the VPS:
|
|
1619
|
+
|
|
1558
1620
|
```bash
|
|
1559
|
-
|
|
1621
|
+
openclaw gateway --tailscale serve
|
|
1560
1622
|
```
|
|
1623
|
+
|
|
1561
1624
|
This keeps the gateway bound to loopback and exposes HTTPS via Tailscale. See [Tailscale](/gateway/tailscale).
|
|
1562
1625
|
|
|
1563
1626
|
### How do I connect a Mac node to a remote Gateway Tailscale Serve
|
|
@@ -1565,25 +1628,26 @@ This keeps the gateway bound to loopback and exposes HTTPS via Tailscale. See [T
|
|
|
1565
1628
|
Serve exposes the **Gateway Control UI + WS**. Nodes connect over the same Gateway WS endpoint.
|
|
1566
1629
|
|
|
1567
1630
|
Recommended setup:
|
|
1568
|
-
|
|
1569
|
-
|
|
1631
|
+
|
|
1632
|
+
1. **Make sure the VPS + Mac are on the same tailnet**.
|
|
1633
|
+
2. **Use the macOS app in Remote mode** (SSH target can be the tailnet hostname).
|
|
1570
1634
|
The app will tunnel the Gateway port and connect as a node.
|
|
1571
|
-
3
|
|
1635
|
+
3. **Approve the node** on the gateway:
|
|
1572
1636
|
```bash
|
|
1573
|
-
|
|
1574
|
-
|
|
1637
|
+
openclaw nodes pending
|
|
1638
|
+
openclaw nodes approve <requestId>
|
|
1575
1639
|
```
|
|
1576
1640
|
|
|
1577
1641
|
Docs: [Gateway protocol](/gateway/protocol), [Discovery](/gateway/discovery), [macOS remote mode](/platforms/mac/remote).
|
|
1578
1642
|
|
|
1579
1643
|
## Env vars and .env loading
|
|
1580
1644
|
|
|
1581
|
-
### How does
|
|
1645
|
+
### How does OpenClaw load environment variables
|
|
1582
1646
|
|
|
1583
|
-
|
|
1647
|
+
OpenClaw reads env vars from the parent process (shell, launchd/systemd, CI, etc.) and additionally loads:
|
|
1584
1648
|
|
|
1585
1649
|
- `.env` from the current working directory
|
|
1586
|
-
- a global fallback `.env` from `~/.
|
|
1650
|
+
- a global fallback `.env` from `~/.openclaw/.env` (aka `$OPENCLAW_STATE_DIR/.env`)
|
|
1587
1651
|
|
|
1588
1652
|
Neither `.env` file overrides existing env vars.
|
|
1589
1653
|
|
|
@@ -1593,8 +1657,8 @@ You can also define inline env vars in config (applied only if missing from the
|
|
|
1593
1657
|
{
|
|
1594
1658
|
env: {
|
|
1595
1659
|
OPENROUTER_API_KEY: "sk-or-...",
|
|
1596
|
-
vars: { GROQ_API_KEY: "gsk-..." }
|
|
1597
|
-
}
|
|
1660
|
+
vars: { GROQ_API_KEY: "gsk-..." },
|
|
1661
|
+
},
|
|
1598
1662
|
}
|
|
1599
1663
|
```
|
|
1600
1664
|
|
|
@@ -1604,42 +1668,43 @@ See [/environment](/environment) for full precedence and sources.
|
|
|
1604
1668
|
|
|
1605
1669
|
Two common fixes:
|
|
1606
1670
|
|
|
1607
|
-
1
|
|
1608
|
-
2
|
|
1671
|
+
1. Put the missing keys in `~/.openclaw/.env` so they’re picked up even when the service doesn’t inherit your shell env.
|
|
1672
|
+
2. Enable shell import (opt‑in convenience):
|
|
1609
1673
|
|
|
1610
1674
|
```json5
|
|
1611
1675
|
{
|
|
1612
1676
|
env: {
|
|
1613
1677
|
shellEnv: {
|
|
1614
1678
|
enabled: true,
|
|
1615
|
-
timeoutMs: 15000
|
|
1616
|
-
}
|
|
1617
|
-
}
|
|
1679
|
+
timeoutMs: 15000,
|
|
1680
|
+
},
|
|
1681
|
+
},
|
|
1618
1682
|
}
|
|
1619
1683
|
```
|
|
1620
1684
|
|
|
1621
1685
|
This runs your login shell and imports only missing expected keys (never overrides). Env var equivalents:
|
|
1622
|
-
`
|
|
1686
|
+
`OPENCLAW_LOAD_SHELL_ENV=1`, `OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000`.
|
|
1623
1687
|
|
|
1624
1688
|
### I set COPILOTGITHUBTOKEN but models status shows Shell env off Why
|
|
1625
1689
|
|
|
1626
|
-
`
|
|
1627
|
-
does **not** mean your env vars are missing - it just means
|
|
1690
|
+
`openclaw models status` reports whether **shell env import** is enabled. “Shell env: off”
|
|
1691
|
+
does **not** mean your env vars are missing - it just means OpenClaw won’t load
|
|
1628
1692
|
your login shell automatically.
|
|
1629
1693
|
|
|
1630
1694
|
If the Gateway runs as a service (launchd/systemd), it won’t inherit your shell
|
|
1631
1695
|
environment. Fix by doing one of these:
|
|
1632
1696
|
|
|
1633
|
-
1
|
|
1697
|
+
1. Put the token in `~/.openclaw/.env`:
|
|
1634
1698
|
```
|
|
1635
1699
|
COPILOT_GITHUB_TOKEN=...
|
|
1636
1700
|
```
|
|
1637
|
-
2
|
|
1638
|
-
3
|
|
1701
|
+
2. Or enable shell import (`env.shellEnv.enabled: true`).
|
|
1702
|
+
3. Or add it to your config `env` block (applies only if missing).
|
|
1639
1703
|
|
|
1640
1704
|
Then restart the gateway and recheck:
|
|
1705
|
+
|
|
1641
1706
|
```bash
|
|
1642
|
-
|
|
1707
|
+
openclaw models status
|
|
1643
1708
|
```
|
|
1644
1709
|
|
|
1645
1710
|
Copilot tokens are read from `COPILOT_GITHUB_TOKEN` (also `GH_TOKEN` / `GITHUB_TOKEN`).
|
|
@@ -1660,12 +1725,12 @@ transcripts - it just starts a new session.
|
|
|
1660
1725
|
```json5
|
|
1661
1726
|
{
|
|
1662
1727
|
session: {
|
|
1663
|
-
idleMinutes: 240
|
|
1664
|
-
}
|
|
1728
|
+
idleMinutes: 240,
|
|
1729
|
+
},
|
|
1665
1730
|
}
|
|
1666
1731
|
```
|
|
1667
1732
|
|
|
1668
|
-
### Is there a way to make a team of
|
|
1733
|
+
### Is there a way to make a team of OpenClaw instances one CEO and many agents
|
|
1669
1734
|
|
|
1670
1735
|
Yes, via **multi-agent routing** and **sub-agents**. You can create one coordinator
|
|
1671
1736
|
agent and several worker agents with their own workspaces and models.
|
|
@@ -1683,45 +1748,49 @@ Session context is limited by the model window. Long chats, large tool outputs,
|
|
|
1683
1748
|
files can trigger compaction or truncation.
|
|
1684
1749
|
|
|
1685
1750
|
What helps:
|
|
1751
|
+
|
|
1686
1752
|
- Ask the bot to summarize the current state and write it to a file.
|
|
1687
1753
|
- Use `/compact` before long tasks, and `/new` when switching topics.
|
|
1688
1754
|
- Keep important context in the workspace and ask the bot to read it back.
|
|
1689
1755
|
- Use sub-agents for long or parallel work so the main chat stays smaller.
|
|
1690
1756
|
- Pick a model with a larger context window if this happens often.
|
|
1691
1757
|
|
|
1692
|
-
### How do I completely reset
|
|
1758
|
+
### How do I completely reset OpenClaw but keep it installed
|
|
1693
1759
|
|
|
1694
1760
|
Use the reset command:
|
|
1695
1761
|
|
|
1696
1762
|
```bash
|
|
1697
|
-
|
|
1763
|
+
openclaw reset
|
|
1698
1764
|
```
|
|
1699
1765
|
|
|
1700
1766
|
Non-interactive full reset:
|
|
1701
1767
|
|
|
1702
1768
|
```bash
|
|
1703
|
-
|
|
1769
|
+
openclaw reset --scope full --yes --non-interactive
|
|
1704
1770
|
```
|
|
1705
1771
|
|
|
1706
1772
|
Then re-run onboarding:
|
|
1707
1773
|
|
|
1708
1774
|
```bash
|
|
1709
|
-
|
|
1775
|
+
openclaw onboard --install-daemon
|
|
1710
1776
|
```
|
|
1711
1777
|
|
|
1712
1778
|
Notes:
|
|
1779
|
+
|
|
1713
1780
|
- The onboarding wizard also offers **Reset** if it sees an existing config. See [Wizard](/start/wizard).
|
|
1714
|
-
- If you used profiles (`--profile` / `
|
|
1715
|
-
- Dev reset: `
|
|
1781
|
+
- If you used profiles (`--profile` / `OPENCLAW_PROFILE`), reset each state dir (defaults are `~/.openclaw-<profile>`).
|
|
1782
|
+
- Dev reset: `openclaw gateway --dev --reset` (dev-only; wipes dev config + credentials + sessions + workspace).
|
|
1716
1783
|
|
|
1717
1784
|
### Im getting context too large errors how do I reset or compact
|
|
1718
1785
|
|
|
1719
1786
|
Use one of these:
|
|
1720
1787
|
|
|
1721
1788
|
- **Compact** (keeps the conversation but summarizes older turns):
|
|
1789
|
+
|
|
1722
1790
|
```
|
|
1723
1791
|
/compact
|
|
1724
1792
|
```
|
|
1793
|
+
|
|
1725
1794
|
or `/compact <instructions>` to guide the summary.
|
|
1726
1795
|
|
|
1727
1796
|
- **Reset** (fresh session ID for the same chat key):
|
|
@@ -1731,6 +1800,7 @@ Use one of these:
|
|
|
1731
1800
|
```
|
|
1732
1801
|
|
|
1733
1802
|
If it keeps happening:
|
|
1803
|
+
|
|
1734
1804
|
- Enable or tune **session pruning** (`agents.defaults.contextPruning`) to trim old tool output.
|
|
1735
1805
|
- Use a model with a larger context window.
|
|
1736
1806
|
|
|
@@ -1753,22 +1823,22 @@ Heartbeats run every **30m** by default. Tune or disable them:
|
|
|
1753
1823
|
agents: {
|
|
1754
1824
|
defaults: {
|
|
1755
1825
|
heartbeat: {
|
|
1756
|
-
every: "2h"
|
|
1757
|
-
}
|
|
1758
|
-
}
|
|
1759
|
-
}
|
|
1826
|
+
every: "2h", // or "0m" to disable
|
|
1827
|
+
},
|
|
1828
|
+
},
|
|
1829
|
+
},
|
|
1760
1830
|
}
|
|
1761
1831
|
```
|
|
1762
1832
|
|
|
1763
1833
|
If `HEARTBEAT.md` exists but is effectively empty (only blank lines and markdown
|
|
1764
|
-
headers like `# Heading`),
|
|
1834
|
+
headers like `# Heading`), OpenClaw skips the heartbeat run to save API calls.
|
|
1765
1835
|
If the file is missing, the heartbeat still runs and the model decides what to do.
|
|
1766
1836
|
|
|
1767
1837
|
Per-agent overrides use `agents.list[].heartbeat`. Docs: [Heartbeat](/gateway/heartbeat).
|
|
1768
1838
|
|
|
1769
1839
|
### Do I need to add a bot account to a WhatsApp group
|
|
1770
1840
|
|
|
1771
|
-
No.
|
|
1841
|
+
No. OpenClaw runs on **your own account**, so if you’re in the group, OpenClaw can see it.
|
|
1772
1842
|
By default, group replies are blocked until you allow senders (`groupPolicy: "allowlist"`).
|
|
1773
1843
|
|
|
1774
1844
|
If you want only **you** to be able to trigger group replies:
|
|
@@ -1778,9 +1848,9 @@ If you want only **you** to be able to trigger group replies:
|
|
|
1778
1848
|
channels: {
|
|
1779
1849
|
whatsapp: {
|
|
1780
1850
|
groupPolicy: "allowlist",
|
|
1781
|
-
groupAllowFrom: ["+15551234567"]
|
|
1782
|
-
}
|
|
1783
|
-
}
|
|
1851
|
+
groupAllowFrom: ["+15551234567"],
|
|
1852
|
+
},
|
|
1853
|
+
},
|
|
1784
1854
|
}
|
|
1785
1855
|
```
|
|
1786
1856
|
|
|
@@ -1789,7 +1859,7 @@ If you want only **you** to be able to trigger group replies:
|
|
|
1789
1859
|
Option 1 (fastest): tail logs and send a test message in the group:
|
|
1790
1860
|
|
|
1791
1861
|
```bash
|
|
1792
|
-
|
|
1862
|
+
openclaw logs --follow --json
|
|
1793
1863
|
```
|
|
1794
1864
|
|
|
1795
1865
|
Look for `chatId` (or `from`) ending in `@g.us`, like:
|
|
@@ -1798,14 +1868,15 @@ Look for `chatId` (or `from`) ending in `@g.us`, like:
|
|
|
1798
1868
|
Option 2 (if already configured/allowlisted): list groups from config:
|
|
1799
1869
|
|
|
1800
1870
|
```bash
|
|
1801
|
-
|
|
1871
|
+
openclaw directory groups list --channel whatsapp
|
|
1802
1872
|
```
|
|
1803
1873
|
|
|
1804
1874
|
Docs: [WhatsApp](/channels/whatsapp), [Directory](/cli/directory), [Logs](/cli/logs).
|
|
1805
1875
|
|
|
1806
|
-
### Why doesnt
|
|
1876
|
+
### Why doesnt OpenClaw reply in a group
|
|
1807
1877
|
|
|
1808
1878
|
Two common causes:
|
|
1879
|
+
|
|
1809
1880
|
- Mention gating is on (default). You must @mention the bot (or match `mentionPatterns`).
|
|
1810
1881
|
- You configured `channels.whatsapp.groups` without `"*"` and the group isn’t allowlisted.
|
|
1811
1882
|
|
|
@@ -1819,14 +1890,15 @@ Direct chats collapse to the main session by default. Groups/channels have their
|
|
|
1819
1890
|
|
|
1820
1891
|
No hard limits. Dozens (even hundreds) are fine, but watch for:
|
|
1821
1892
|
|
|
1822
|
-
- **Disk growth:** sessions + transcripts live under `~/.
|
|
1893
|
+
- **Disk growth:** sessions + transcripts live under `~/.openclaw/agents/<agentId>/sessions/`.
|
|
1823
1894
|
- **Token cost:** more agents means more concurrent model usage.
|
|
1824
1895
|
- **Ops overhead:** per-agent auth profiles, workspaces, and channel routing.
|
|
1825
1896
|
|
|
1826
1897
|
Tips:
|
|
1898
|
+
|
|
1827
1899
|
- Keep one **active** workspace per agent (`agents.defaults.workspace`).
|
|
1828
1900
|
- Prune old sessions (delete JSONL or store entries) if disk grows.
|
|
1829
|
-
- Use `
|
|
1901
|
+
- Use `openclaw doctor` to spot stray workspaces and profile mismatches.
|
|
1830
1902
|
|
|
1831
1903
|
### Can I run multiple bots or chats at the same time Slack and how should I set that up
|
|
1832
1904
|
|
|
@@ -1838,6 +1910,7 @@ still block automation. For the most reliable browser control, use the Chrome ex
|
|
|
1838
1910
|
on the machine that runs the browser (and keep the Gateway anywhere).
|
|
1839
1911
|
|
|
1840
1912
|
Best‑practice setup:
|
|
1913
|
+
|
|
1841
1914
|
- Always‑on Gateway host (VPS/Mac mini).
|
|
1842
1915
|
- One agent per role (bindings).
|
|
1843
1916
|
- Slack channel(s) bound to those agents.
|
|
@@ -1850,13 +1923,13 @@ Docs: [Multi‑Agent Routing](/concepts/multi-agent), [Slack](/channels/slack),
|
|
|
1850
1923
|
|
|
1851
1924
|
### What is the default model
|
|
1852
1925
|
|
|
1853
|
-
|
|
1926
|
+
OpenClaw’s default model is whatever you set as:
|
|
1854
1927
|
|
|
1855
1928
|
```
|
|
1856
1929
|
agents.defaults.model.primary
|
|
1857
1930
|
```
|
|
1858
1931
|
|
|
1859
|
-
Models are referenced as `provider/model` (example: `anthropic/claude-opus-4-5`). If you omit the provider,
|
|
1932
|
+
Models are referenced as `provider/model` (example: `anthropic/claude-opus-4-5`). If you omit the provider, OpenClaw currently assumes `anthropic` as a temporary deprecation fallback - but you should still **explicitly** set `provider/model`.
|
|
1860
1933
|
|
|
1861
1934
|
### What model do you recommend
|
|
1862
1935
|
|
|
@@ -1896,19 +1969,20 @@ Docs: [Ollama](/providers/ollama), [Local models](/gateway/local-models),
|
|
|
1896
1969
|
Use **model commands** or edit only the **model** fields. Avoid full config replaces.
|
|
1897
1970
|
|
|
1898
1971
|
Safe options:
|
|
1972
|
+
|
|
1899
1973
|
- `/model` in chat (quick, per-session)
|
|
1900
|
-
- `
|
|
1901
|
-
- `
|
|
1902
|
-
- edit `agents.defaults.model` in `~/.
|
|
1974
|
+
- `openclaw models set ...` (updates just model config)
|
|
1975
|
+
- `openclaw configure --section models` (interactive)
|
|
1976
|
+
- edit `agents.defaults.model` in `~/.openclaw/openclaw.json`
|
|
1903
1977
|
|
|
1904
1978
|
Avoid `config.apply` with a partial object unless you intend to replace the whole config.
|
|
1905
|
-
If you did overwrite config, restore from backup or re-run `
|
|
1979
|
+
If you did overwrite config, restore from backup or re-run `openclaw doctor` to repair.
|
|
1906
1980
|
|
|
1907
1981
|
Docs: [Models](/concepts/models), [Configure](/cli/configure), [Config](/cli/config), [Doctor](/gateway/doctor).
|
|
1908
1982
|
|
|
1909
|
-
### What do
|
|
1983
|
+
### What do OpenClaw, Flawd, and Krill use for models
|
|
1910
1984
|
|
|
1911
|
-
- **
|
|
1985
|
+
- **OpenClaw + Flawd:** Anthropic Opus (`anthropic/claude-opus-4-5`) - see [Anthropic](/providers/anthropic).
|
|
1912
1986
|
- **Krill:** MiniMax M2.1 (`minimax/MiniMax-M2.1`) - see [MiniMax](/providers/minimax).
|
|
1913
1987
|
|
|
1914
1988
|
### How do I switch models on the fly without restarting
|
|
@@ -1983,14 +2057,15 @@ profile was found), so the model can’t be resolved. A fix for this detection i
|
|
|
1983
2057
|
in **2026.1.12** (unreleased at the time of writing).
|
|
1984
2058
|
|
|
1985
2059
|
Fix checklist:
|
|
1986
|
-
|
|
1987
|
-
|
|
2060
|
+
|
|
2061
|
+
1. Upgrade to **2026.1.12** (or run from source `main`), then restart the gateway.
|
|
2062
|
+
2. Make sure MiniMax is configured (wizard or JSON), or that a MiniMax API key
|
|
1988
2063
|
exists in env/auth profiles so the provider can be injected.
|
|
1989
|
-
3
|
|
2064
|
+
3. Use the exact model id (case‑sensitive): `minimax/MiniMax-M2.1` or
|
|
1990
2065
|
`minimax/MiniMax-M2.1-lightning`.
|
|
1991
|
-
4
|
|
2066
|
+
4. Run:
|
|
1992
2067
|
```bash
|
|
1993
|
-
|
|
2068
|
+
openclaw models list
|
|
1994
2069
|
```
|
|
1995
2070
|
and pick from the list (or `/model list` in chat).
|
|
1996
2071
|
|
|
@@ -2002,6 +2077,7 @@ Yes. Use **MiniMax as the default** and switch models **per session** when neede
|
|
|
2002
2077
|
Fallbacks are for **errors**, not “hard tasks,” so use `/model` or a separate agent.
|
|
2003
2078
|
|
|
2004
2079
|
**Option A: switch per session**
|
|
2080
|
+
|
|
2005
2081
|
```json5
|
|
2006
2082
|
{
|
|
2007
2083
|
env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },
|
|
@@ -2010,19 +2086,21 @@ Fallbacks are for **errors**, not “hard tasks,” so use `/model` or a separat
|
|
|
2010
2086
|
model: { primary: "minimax/MiniMax-M2.1" },
|
|
2011
2087
|
models: {
|
|
2012
2088
|
"minimax/MiniMax-M2.1": { alias: "minimax" },
|
|
2013
|
-
"openai/gpt-5.2": { alias: "gpt" }
|
|
2014
|
-
}
|
|
2015
|
-
}
|
|
2016
|
-
}
|
|
2089
|
+
"openai/gpt-5.2": { alias: "gpt" },
|
|
2090
|
+
},
|
|
2091
|
+
},
|
|
2092
|
+
},
|
|
2017
2093
|
}
|
|
2018
2094
|
```
|
|
2019
2095
|
|
|
2020
2096
|
Then:
|
|
2097
|
+
|
|
2021
2098
|
```
|
|
2022
2099
|
/model gpt
|
|
2023
2100
|
```
|
|
2024
2101
|
|
|
2025
2102
|
**Option B: separate agents**
|
|
2103
|
+
|
|
2026
2104
|
- Agent A default: MiniMax
|
|
2027
2105
|
- Agent B default: OpenAI
|
|
2028
2106
|
- Route by agent or use `/agent` to switch
|
|
@@ -2031,7 +2109,7 @@ Docs: [Models](/concepts/models), [Multi-Agent Routing](/concepts/multi-agent),
|
|
|
2031
2109
|
|
|
2032
2110
|
### Are opus sonnet gpt builtin shortcuts
|
|
2033
2111
|
|
|
2034
|
-
Yes.
|
|
2112
|
+
Yes. OpenClaw ships a few default shorthands (only applied when the model exists in `agents.defaults.models`):
|
|
2035
2113
|
|
|
2036
2114
|
- `opus` → `anthropic/claude-opus-4-5`
|
|
2037
2115
|
- `sonnet` → `anthropic/claude-sonnet-4-5`
|
|
@@ -2054,10 +2132,10 @@ Aliases come from `agents.defaults.models.<modelId>.alias`. Example:
|
|
|
2054
2132
|
models: {
|
|
2055
2133
|
"anthropic/claude-opus-4-5": { alias: "opus" },
|
|
2056
2134
|
"anthropic/claude-sonnet-4-5": { alias: "sonnet" },
|
|
2057
|
-
"anthropic/claude-haiku-4-5": { alias: "haiku" }
|
|
2058
|
-
}
|
|
2059
|
-
}
|
|
2060
|
-
}
|
|
2135
|
+
"anthropic/claude-haiku-4-5": { alias: "haiku" },
|
|
2136
|
+
},
|
|
2137
|
+
},
|
|
2138
|
+
},
|
|
2061
2139
|
}
|
|
2062
2140
|
```
|
|
2063
2141
|
|
|
@@ -2072,10 +2150,10 @@ OpenRouter (pay‑per‑token; many models):
|
|
|
2072
2150
|
agents: {
|
|
2073
2151
|
defaults: {
|
|
2074
2152
|
model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
|
|
2075
|
-
models: { "openrouter/anthropic/claude-sonnet-4-5": {} }
|
|
2076
|
-
}
|
|
2153
|
+
models: { "openrouter/anthropic/claude-sonnet-4-5": {} },
|
|
2154
|
+
},
|
|
2077
2155
|
},
|
|
2078
|
-
env: { OPENROUTER_API_KEY: "sk-or-..." }
|
|
2156
|
+
env: { OPENROUTER_API_KEY: "sk-or-..." },
|
|
2079
2157
|
}
|
|
2080
2158
|
```
|
|
2081
2159
|
|
|
@@ -2086,10 +2164,10 @@ Z.AI (GLM models):
|
|
|
2086
2164
|
agents: {
|
|
2087
2165
|
defaults: {
|
|
2088
2166
|
model: { primary: "zai/glm-4.7" },
|
|
2089
|
-
models: { "zai/glm-4.7": {} }
|
|
2090
|
-
}
|
|
2167
|
+
models: { "zai/glm-4.7": {} },
|
|
2168
|
+
},
|
|
2091
2169
|
},
|
|
2092
|
-
env: { ZAI_API_KEY: "..." }
|
|
2170
|
+
env: { ZAI_API_KEY: "..." },
|
|
2093
2171
|
}
|
|
2094
2172
|
```
|
|
2095
2173
|
|
|
@@ -2101,11 +2179,12 @@ This usually means the **new agent** has an empty auth store. Auth is per-agent
|
|
|
2101
2179
|
stored in:
|
|
2102
2180
|
|
|
2103
2181
|
```
|
|
2104
|
-
~/.
|
|
2182
|
+
~/.openclaw/agents/<agentId>/agent/auth-profiles.json
|
|
2105
2183
|
```
|
|
2106
2184
|
|
|
2107
2185
|
Fix options:
|
|
2108
|
-
|
|
2186
|
+
|
|
2187
|
+
- Run `openclaw agents add <id>` and configure auth during the wizard.
|
|
2109
2188
|
- Or copy `auth-profiles.json` from the main agent’s `agentDir` into the new agent’s `agentDir`.
|
|
2110
2189
|
|
|
2111
2190
|
Do **not** reuse `agentDir` across agents; it causes auth/session collisions.
|
|
@@ -2116,10 +2195,10 @@ Do **not** reuse `agentDir` across agents; it causes auth/session collisions.
|
|
|
2116
2195
|
|
|
2117
2196
|
Failover happens in two stages:
|
|
2118
2197
|
|
|
2119
|
-
1
|
|
2120
|
-
2
|
|
2198
|
+
1. **Auth profile rotation** within the same provider.
|
|
2199
|
+
2. **Model fallback** to the next model in `agents.defaults.model.fallbacks`.
|
|
2121
2200
|
|
|
2122
|
-
Cooldowns apply to failing profiles (exponential backoff), so
|
|
2201
|
+
Cooldowns apply to failing profiles (exponential backoff), so OpenClaw can keep responding even when a provider is rate‑limited or temporarily failing.
|
|
2123
2202
|
|
|
2124
2203
|
### What does this error mean
|
|
2125
2204
|
|
|
@@ -2132,14 +2211,14 @@ It means the system attempted to use the auth profile ID `anthropic:default`, bu
|
|
|
2132
2211
|
### Fix checklist for No credentials found for profile anthropicdefault
|
|
2133
2212
|
|
|
2134
2213
|
- **Confirm where auth profiles live** (new vs legacy paths)
|
|
2135
|
-
- Current: `~/.
|
|
2136
|
-
- Legacy: `~/.
|
|
2214
|
+
- Current: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
|
2215
|
+
- Legacy: `~/.openclaw/agent/*` (migrated by `openclaw doctor`)
|
|
2137
2216
|
- **Confirm your env var is loaded by the Gateway**
|
|
2138
|
-
- If you set `ANTHROPIC_API_KEY` in your shell but run the Gateway via systemd/launchd, it may not inherit it. Put it in `~/.
|
|
2217
|
+
- If you set `ANTHROPIC_API_KEY` in your shell but run the Gateway via systemd/launchd, it may not inherit it. Put it in `~/.openclaw/.env` or enable `env.shellEnv`.
|
|
2139
2218
|
- **Make sure you’re editing the correct agent**
|
|
2140
2219
|
- Multi‑agent setups mean there can be multiple `auth-profiles.json` files.
|
|
2141
2220
|
- **Sanity‑check model/auth status**
|
|
2142
|
-
- Use `
|
|
2221
|
+
- Use `openclaw models status` to see configured models and whether providers are authenticated.
|
|
2143
2222
|
|
|
2144
2223
|
**Fix checklist for No credentials found for profile anthropic**
|
|
2145
2224
|
|
|
@@ -2147,20 +2226,20 @@ This means the run is pinned to an Anthropic auth profile, but the Gateway
|
|
|
2147
2226
|
can’t find it in its auth store.
|
|
2148
2227
|
|
|
2149
2228
|
- **Use a setup-token**
|
|
2150
|
-
- Run `claude setup-token`, then paste it with `
|
|
2151
|
-
- If the token was created on another machine, use `
|
|
2229
|
+
- Run `claude setup-token`, then paste it with `openclaw models auth setup-token --provider anthropic`.
|
|
2230
|
+
- If the token was created on another machine, use `openclaw models auth paste-token --provider anthropic`.
|
|
2152
2231
|
- **If you want to use an API key instead**
|
|
2153
|
-
- Put `ANTHROPIC_API_KEY` in `~/.
|
|
2232
|
+
- Put `ANTHROPIC_API_KEY` in `~/.openclaw/.env` on the **gateway host**.
|
|
2154
2233
|
- Clear any pinned order that forces a missing profile:
|
|
2155
2234
|
```bash
|
|
2156
|
-
|
|
2235
|
+
openclaw models auth order clear --provider anthropic
|
|
2157
2236
|
```
|
|
2158
2237
|
- **Confirm you’re running commands on the gateway host**
|
|
2159
2238
|
- In remote mode, auth profiles live on the gateway machine, not your laptop.
|
|
2160
2239
|
|
|
2161
2240
|
### Why did it also try Google Gemini and fail
|
|
2162
2241
|
|
|
2163
|
-
If your model config includes Google Gemini as a fallback (or you switched to a Gemini shorthand),
|
|
2242
|
+
If your model config includes Google Gemini as a fallback (or you switched to a Gemini shorthand), OpenClaw will try it during model fallback. If you haven’t configured Google credentials, you’ll see `No API key found for provider "google"`.
|
|
2164
2243
|
|
|
2165
2244
|
Fix: either provide Google auth, or remove/avoid Google models in `agents.defaults.model.fallbacks` / aliases so fallback doesn’t route there.
|
|
2166
2245
|
|
|
@@ -2169,7 +2248,7 @@ Fix: either provide Google auth, or remove/avoid Google models in `agents.defaul
|
|
|
2169
2248
|
Cause: the session history contains **thinking blocks without signatures** (often from
|
|
2170
2249
|
an aborted/partial stream). Google Antigravity requires signatures for thinking blocks.
|
|
2171
2250
|
|
|
2172
|
-
Fix:
|
|
2251
|
+
Fix: OpenClaw now strips unsigned thinking blocks for Google Antigravity Claude. If it still appears, start a **new session** or set `/thinking off` for that agent.
|
|
2173
2252
|
|
|
2174
2253
|
## Auth profiles: what they are and how to manage them
|
|
2175
2254
|
|
|
@@ -2180,12 +2259,12 @@ Related: [/concepts/oauth](/concepts/oauth) (OAuth flows, token storage, multi-a
|
|
|
2180
2259
|
An auth profile is a named credential record (OAuth or API key) tied to a provider. Profiles live in:
|
|
2181
2260
|
|
|
2182
2261
|
```
|
|
2183
|
-
~/.
|
|
2262
|
+
~/.openclaw/agents/<agentId>/agent/auth-profiles.json
|
|
2184
2263
|
```
|
|
2185
2264
|
|
|
2186
2265
|
### What are typical profile IDs
|
|
2187
2266
|
|
|
2188
|
-
|
|
2267
|
+
OpenClaw uses provider‑prefixed IDs like:
|
|
2189
2268
|
|
|
2190
2269
|
- `anthropic:default` (common when no email identity exists)
|
|
2191
2270
|
- `anthropic:<email>` for OAuth identities
|
|
@@ -2195,33 +2274,33 @@ Moltbot uses provider‑prefixed IDs like:
|
|
|
2195
2274
|
|
|
2196
2275
|
Yes. Config supports optional metadata for profiles and an ordering per provider (`auth.order.<provider>`). This does **not** store secrets; it maps IDs to provider/mode and sets rotation order.
|
|
2197
2276
|
|
|
2198
|
-
|
|
2277
|
+
OpenClaw may temporarily skip a profile if it’s in a short **cooldown** (rate limits/timeouts/auth failures) or a longer **disabled** state (billing/insufficient credits). To inspect this, run `openclaw models status --json` and check `auth.unusableProfiles`. Tuning: `auth.cooldowns.billingBackoffHours*`.
|
|
2199
2278
|
|
|
2200
2279
|
You can also set a **per-agent** order override (stored in that agent’s `auth-profiles.json`) via the CLI:
|
|
2201
2280
|
|
|
2202
2281
|
```bash
|
|
2203
2282
|
# Defaults to the configured default agent (omit --agent)
|
|
2204
|
-
|
|
2283
|
+
openclaw models auth order get --provider anthropic
|
|
2205
2284
|
|
|
2206
2285
|
# Lock rotation to a single profile (only try this one)
|
|
2207
|
-
|
|
2286
|
+
openclaw models auth order set --provider anthropic anthropic:default
|
|
2208
2287
|
|
|
2209
2288
|
# Or set an explicit order (fallback within provider)
|
|
2210
|
-
|
|
2289
|
+
openclaw models auth order set --provider anthropic anthropic:work anthropic:default
|
|
2211
2290
|
|
|
2212
2291
|
# Clear override (fall back to config auth.order / round-robin)
|
|
2213
|
-
|
|
2292
|
+
openclaw models auth order clear --provider anthropic
|
|
2214
2293
|
```
|
|
2215
2294
|
|
|
2216
2295
|
To target a specific agent:
|
|
2217
2296
|
|
|
2218
2297
|
```bash
|
|
2219
|
-
|
|
2298
|
+
openclaw models auth order set --provider anthropic --agent main anthropic:default
|
|
2220
2299
|
```
|
|
2221
2300
|
|
|
2222
2301
|
### OAuth vs API key whats the difference
|
|
2223
2302
|
|
|
2224
|
-
|
|
2303
|
+
OpenClaw supports both:
|
|
2225
2304
|
|
|
2226
2305
|
- **OAuth** often leverages subscription access (where applicable).
|
|
2227
2306
|
- **API keys** use pay‑per‑token billing.
|
|
@@ -2237,35 +2316,38 @@ The wizard explicitly supports Anthropic setup-token and OpenAI Codex OAuth and
|
|
|
2237
2316
|
Precedence:
|
|
2238
2317
|
|
|
2239
2318
|
```
|
|
2240
|
-
--port >
|
|
2319
|
+
--port > OPENCLAW_GATEWAY_PORT > gateway.port > default 18789
|
|
2241
2320
|
```
|
|
2242
2321
|
|
|
2243
|
-
### Why does
|
|
2322
|
+
### Why does openclaw gateway status say Runtime running but RPC probe failed
|
|
2244
2323
|
|
|
2245
2324
|
Because “running” is the **supervisor’s** view (launchd/systemd/schtasks). The RPC probe is the CLI actually connecting to the gateway WebSocket and calling `status`.
|
|
2246
2325
|
|
|
2247
|
-
Use `
|
|
2326
|
+
Use `openclaw gateway status` and trust these lines:
|
|
2327
|
+
|
|
2248
2328
|
- `Probe target:` (the URL the probe actually used)
|
|
2249
2329
|
- `Listening:` (what’s actually bound on the port)
|
|
2250
2330
|
- `Last gateway error:` (common root cause when the process is alive but the port isn’t listening)
|
|
2251
2331
|
|
|
2252
|
-
### Why does
|
|
2332
|
+
### Why does openclaw gateway status show Config cli and Config service different
|
|
2253
2333
|
|
|
2254
|
-
You’re editing one config file while the service is running another (often a `--profile` / `
|
|
2334
|
+
You’re editing one config file while the service is running another (often a `--profile` / `OPENCLAW_STATE_DIR` mismatch).
|
|
2255
2335
|
|
|
2256
2336
|
Fix:
|
|
2337
|
+
|
|
2257
2338
|
```bash
|
|
2258
|
-
|
|
2339
|
+
openclaw gateway install --force
|
|
2259
2340
|
```
|
|
2341
|
+
|
|
2260
2342
|
Run that from the same `--profile` / environment you want the service to use.
|
|
2261
2343
|
|
|
2262
2344
|
### What does another gateway instance is already listening mean
|
|
2263
2345
|
|
|
2264
|
-
|
|
2346
|
+
OpenClaw enforces a runtime lock by binding the WebSocket listener immediately on startup (default `ws://127.0.0.1:18789`). If the bind fails with `EADDRINUSE`, it throws `GatewayLockError` indicating another instance is already listening.
|
|
2265
2347
|
|
|
2266
|
-
Fix: stop the other instance, free the port, or run with `
|
|
2348
|
+
Fix: stop the other instance, free the port, or run with `openclaw gateway --port <port>`.
|
|
2267
2349
|
|
|
2268
|
-
### How do I run
|
|
2350
|
+
### How do I run OpenClaw in remote mode client connects to a Gateway elsewhere
|
|
2269
2351
|
|
|
2270
2352
|
Set `gateway.mode: "remote"` and point to a remote WebSocket URL, optionally with a token/password:
|
|
2271
2353
|
|
|
@@ -2276,14 +2358,15 @@ Set `gateway.mode: "remote"` and point to a remote WebSocket URL, optionally wit
|
|
|
2276
2358
|
remote: {
|
|
2277
2359
|
url: "ws://gateway.tailnet:18789",
|
|
2278
2360
|
token: "your-token",
|
|
2279
|
-
password: "your-password"
|
|
2280
|
-
}
|
|
2281
|
-
}
|
|
2361
|
+
password: "your-password",
|
|
2362
|
+
},
|
|
2363
|
+
},
|
|
2282
2364
|
}
|
|
2283
2365
|
```
|
|
2284
2366
|
|
|
2285
2367
|
Notes:
|
|
2286
|
-
|
|
2368
|
+
|
|
2369
|
+
- `openclaw gateway` only starts when `gateway.mode` is `local` (or you pass the override flag).
|
|
2287
2370
|
- The macOS app watches the config file and switches modes live when these values change.
|
|
2288
2371
|
|
|
2289
2372
|
### The Control UI says unauthorized or keeps reconnecting What now
|
|
@@ -2291,25 +2374,28 @@ Notes:
|
|
|
2291
2374
|
Your gateway is running with auth enabled (`gateway.auth.*`), but the UI is not sending the matching token/password.
|
|
2292
2375
|
|
|
2293
2376
|
Facts (from code):
|
|
2294
|
-
|
|
2377
|
+
|
|
2378
|
+
- The Control UI stores the token in browser localStorage key `openclaw.control.settings.v1`.
|
|
2295
2379
|
- The UI can import `?token=...` (and/or `?password=...`) once, then strips it from the URL.
|
|
2296
2380
|
|
|
2297
2381
|
Fix:
|
|
2298
|
-
|
|
2299
|
-
-
|
|
2382
|
+
|
|
2383
|
+
- Fastest: `openclaw dashboard` (prints + copies tokenized link, tries to open; shows SSH hint if headless).
|
|
2384
|
+
- If you don’t have a token yet: `openclaw doctor --generate-gateway-token`.
|
|
2300
2385
|
- If remote, tunnel first: `ssh -N -L 18789:127.0.0.1:18789 user@host` then open `http://127.0.0.1:18789/?token=...`.
|
|
2301
|
-
- Set `gateway.auth.token` (or `
|
|
2386
|
+
- Set `gateway.auth.token` (or `OPENCLAW_GATEWAY_TOKEN`) on the gateway host.
|
|
2302
2387
|
- In the Control UI settings, paste the same token (or refresh with a one-time `?token=...` link).
|
|
2303
|
-
- Still stuck? Run `
|
|
2388
|
+
- Still stuck? Run `openclaw status --all` and follow [Troubleshooting](/gateway/troubleshooting). See [Dashboard](/web/dashboard) for auth details.
|
|
2304
2389
|
|
|
2305
2390
|
### I set gatewaybind tailnet but it cant bind nothing listens
|
|
2306
2391
|
|
|
2307
2392
|
`tailnet` bind picks a Tailscale IP from your network interfaces (100.64.0.0/10). If the machine isn’t on Tailscale (or the interface is down), there’s nothing to bind to.
|
|
2308
2393
|
|
|
2309
2394
|
Fix:
|
|
2395
|
+
|
|
2310
2396
|
- Start Tailscale on that host (so it has a 100.x address), or
|
|
2311
2397
|
- Switch to `gateway.bind: "loopback"` / `"lan"`.
|
|
2312
|
-
|
|
2398
|
+
|
|
2313
2399
|
Note: `tailnet` is explicit. `auto` prefers loopback; use `gateway.bind: "tailnet"` when you want a tailnet-only bind.
|
|
2314
2400
|
|
|
2315
2401
|
### Can I run multiple Gateways on the same host
|
|
@@ -2318,17 +2404,18 @@ Usually no - one Gateway can run multiple messaging channels and agents. Use mul
|
|
|
2318
2404
|
|
|
2319
2405
|
Yes, but you must isolate:
|
|
2320
2406
|
|
|
2321
|
-
- `
|
|
2322
|
-
- `
|
|
2407
|
+
- `OPENCLAW_CONFIG_PATH` (per‑instance config)
|
|
2408
|
+
- `OPENCLAW_STATE_DIR` (per‑instance state)
|
|
2323
2409
|
- `agents.defaults.workspace` (workspace isolation)
|
|
2324
2410
|
- `gateway.port` (unique ports)
|
|
2325
2411
|
|
|
2326
2412
|
Quick setup (recommended):
|
|
2327
|
-
|
|
2413
|
+
|
|
2414
|
+
- Use `openclaw --profile <name> …` per instance (auto-creates `~/.openclaw-<name>`).
|
|
2328
2415
|
- Set a unique `gateway.port` in each profile config (or pass `--port` for manual runs).
|
|
2329
|
-
- Install a per-profile service: `
|
|
2416
|
+
- Install a per-profile service: `openclaw --profile <name> gateway install`.
|
|
2330
2417
|
|
|
2331
|
-
Profiles also suffix service names (`bot.molt.<profile>`; legacy `com.
|
|
2418
|
+
Profiles also suffix service names (`bot.molt.<profile>`; legacy `com.openclaw.*`, `openclaw-gateway-<profile>.service`, `OpenClaw Gateway (<profile>)`).
|
|
2332
2419
|
Full guide: [Multiple gateways](/gateway/multiple-gateways).
|
|
2333
2420
|
|
|
2334
2421
|
### What does invalid handshake code 1008 mean
|
|
@@ -2338,18 +2425,21 @@ be a `connect` frame. If it receives anything else, it closes the connection
|
|
|
2338
2425
|
with **code 1008** (policy violation).
|
|
2339
2426
|
|
|
2340
2427
|
Common causes:
|
|
2428
|
+
|
|
2341
2429
|
- You opened the **HTTP** URL in a browser (`http://...`) instead of a WS client.
|
|
2342
2430
|
- You used the wrong port or path.
|
|
2343
2431
|
- A proxy or tunnel stripped auth headers or sent a non‑Gateway request.
|
|
2344
2432
|
|
|
2345
2433
|
Quick fixes:
|
|
2346
|
-
|
|
2347
|
-
|
|
2348
|
-
|
|
2434
|
+
|
|
2435
|
+
1. Use the WS URL: `ws://<host>:18789` (or `wss://...` if HTTPS).
|
|
2436
|
+
2. Don’t open the WS port in a normal browser tab.
|
|
2437
|
+
3. If auth is on, include the token/password in the `connect` frame.
|
|
2349
2438
|
|
|
2350
2439
|
If you’re using the CLI or TUI, the URL should look like:
|
|
2440
|
+
|
|
2351
2441
|
```
|
|
2352
|
-
|
|
2442
|
+
openclaw tui --url ws://<host>:18789 --token <token>
|
|
2353
2443
|
```
|
|
2354
2444
|
|
|
2355
2445
|
Protocol details: [Gateway protocol](/gateway/protocol).
|
|
@@ -2361,7 +2451,7 @@ Protocol details: [Gateway protocol](/gateway/protocol).
|
|
|
2361
2451
|
File logs (structured):
|
|
2362
2452
|
|
|
2363
2453
|
```
|
|
2364
|
-
/tmp/
|
|
2454
|
+
/tmp/openclaw/openclaw-YYYY-MM-DD.log
|
|
2365
2455
|
```
|
|
2366
2456
|
|
|
2367
2457
|
You can set a stable path via `logging.file`. File log level is controlled by `logging.level`. Console verbosity is controlled by `--verbose` and `logging.consoleLevel`.
|
|
@@ -2369,13 +2459,14 @@ You can set a stable path via `logging.file`. File log level is controlled by `l
|
|
|
2369
2459
|
Fastest log tail:
|
|
2370
2460
|
|
|
2371
2461
|
```bash
|
|
2372
|
-
|
|
2462
|
+
openclaw logs --follow
|
|
2373
2463
|
```
|
|
2374
2464
|
|
|
2375
2465
|
Service/supervisor logs (when the gateway runs via launchd/systemd):
|
|
2376
|
-
|
|
2377
|
-
-
|
|
2378
|
-
-
|
|
2466
|
+
|
|
2467
|
+
- macOS: `$OPENCLAW_STATE_DIR/logs/gateway.log` and `gateway.err.log` (default: `~/.openclaw/logs/...`; profiles use `~/.openclaw-<profile>/logs/...`)
|
|
2468
|
+
- Linux: `journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager`
|
|
2469
|
+
- Windows: `schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST`
|
|
2379
2470
|
|
|
2380
2471
|
See [Troubleshooting](/gateway/troubleshooting#log-locations) for more.
|
|
2381
2472
|
|
|
@@ -2384,13 +2475,13 @@ See [Troubleshooting](/gateway/troubleshooting#log-locations) for more.
|
|
|
2384
2475
|
Use the gateway helpers:
|
|
2385
2476
|
|
|
2386
2477
|
```bash
|
|
2387
|
-
|
|
2388
|
-
|
|
2478
|
+
openclaw gateway status
|
|
2479
|
+
openclaw gateway restart
|
|
2389
2480
|
```
|
|
2390
2481
|
|
|
2391
|
-
If you run the gateway manually, `
|
|
2482
|
+
If you run the gateway manually, `openclaw gateway --force` can reclaim the port. See [Gateway](/gateway).
|
|
2392
2483
|
|
|
2393
|
-
### I closed my terminal on Windows how do I restart
|
|
2484
|
+
### I closed my terminal on Windows how do I restart OpenClaw
|
|
2394
2485
|
|
|
2395
2486
|
There are **two Windows install modes**:
|
|
2396
2487
|
|
|
@@ -2400,14 +2491,14 @@ Open PowerShell, enter WSL, then restart:
|
|
|
2400
2491
|
|
|
2401
2492
|
```powershell
|
|
2402
2493
|
wsl
|
|
2403
|
-
|
|
2404
|
-
|
|
2494
|
+
openclaw gateway status
|
|
2495
|
+
openclaw gateway restart
|
|
2405
2496
|
```
|
|
2406
2497
|
|
|
2407
2498
|
If you never installed the service, start it in the foreground:
|
|
2408
2499
|
|
|
2409
2500
|
```bash
|
|
2410
|
-
|
|
2501
|
+
openclaw gateway run
|
|
2411
2502
|
```
|
|
2412
2503
|
|
|
2413
2504
|
**2) Native Windows (not recommended):** the Gateway runs directly in Windows.
|
|
@@ -2415,14 +2506,14 @@ moltbot gateway run
|
|
|
2415
2506
|
Open PowerShell and run:
|
|
2416
2507
|
|
|
2417
2508
|
```powershell
|
|
2418
|
-
|
|
2419
|
-
|
|
2509
|
+
openclaw gateway status
|
|
2510
|
+
openclaw gateway restart
|
|
2420
2511
|
```
|
|
2421
2512
|
|
|
2422
2513
|
If you run it manually (no service), use:
|
|
2423
2514
|
|
|
2424
2515
|
```powershell
|
|
2425
|
-
|
|
2516
|
+
openclaw gateway run
|
|
2426
2517
|
```
|
|
2427
2518
|
|
|
2428
2519
|
Docs: [Windows (WSL2)](/platforms/windows), [Gateway service runbook](/gateway).
|
|
@@ -2432,13 +2523,14 @@ Docs: [Windows (WSL2)](/platforms/windows), [Gateway service runbook](/gateway).
|
|
|
2432
2523
|
Start with a quick health sweep:
|
|
2433
2524
|
|
|
2434
2525
|
```bash
|
|
2435
|
-
|
|
2436
|
-
|
|
2437
|
-
|
|
2438
|
-
|
|
2526
|
+
openclaw status
|
|
2527
|
+
openclaw models status
|
|
2528
|
+
openclaw channels status
|
|
2529
|
+
openclaw logs --follow
|
|
2439
2530
|
```
|
|
2440
2531
|
|
|
2441
2532
|
Common causes:
|
|
2533
|
+
|
|
2442
2534
|
- Model auth not loaded on the **gateway host** (check `models status`).
|
|
2443
2535
|
- Channel pairing/allowlist blocking replies (check channel config + logs).
|
|
2444
2536
|
- WebChat/Dashboard is open without the right token.
|
|
@@ -2452,15 +2544,15 @@ Docs: [Channels](/channels), [Troubleshooting](/gateway/troubleshooting), [Remot
|
|
|
2452
2544
|
|
|
2453
2545
|
This usually means the UI lost the WebSocket connection. Check:
|
|
2454
2546
|
|
|
2455
|
-
1
|
|
2456
|
-
2
|
|
2457
|
-
3
|
|
2458
|
-
4
|
|
2547
|
+
1. Is the Gateway running? `openclaw gateway status`
|
|
2548
|
+
2. Is the Gateway healthy? `openclaw status`
|
|
2549
|
+
3. Does the UI have the right token? `openclaw dashboard`
|
|
2550
|
+
4. If remote, is the tunnel/Tailscale link up?
|
|
2459
2551
|
|
|
2460
2552
|
Then tail logs:
|
|
2461
2553
|
|
|
2462
2554
|
```bash
|
|
2463
|
-
|
|
2555
|
+
openclaw logs --follow
|
|
2464
2556
|
```
|
|
2465
2557
|
|
|
2466
2558
|
Docs: [Dashboard](/web/dashboard), [Remote access](/gateway/remote), [Troubleshooting](/gateway/troubleshooting).
|
|
@@ -2470,8 +2562,8 @@ Docs: [Dashboard](/web/dashboard), [Remote access](/gateway/remote), [Troublesho
|
|
|
2470
2562
|
Start with logs and channel status:
|
|
2471
2563
|
|
|
2472
2564
|
```bash
|
|
2473
|
-
|
|
2474
|
-
|
|
2565
|
+
openclaw channels status
|
|
2566
|
+
openclaw channels logs --channel telegram
|
|
2475
2567
|
```
|
|
2476
2568
|
|
|
2477
2569
|
If you are on a VPS or behind a proxy, confirm outbound HTTPS is allowed and DNS works.
|
|
@@ -2484,9 +2576,9 @@ Docs: [Telegram](/channels/telegram), [Channel troubleshooting](/channels/troubl
|
|
|
2484
2576
|
First confirm the Gateway is reachable and the agent can run:
|
|
2485
2577
|
|
|
2486
2578
|
```bash
|
|
2487
|
-
|
|
2488
|
-
|
|
2489
|
-
|
|
2579
|
+
openclaw status
|
|
2580
|
+
openclaw models status
|
|
2581
|
+
openclaw logs --follow
|
|
2490
2582
|
```
|
|
2491
2583
|
|
|
2492
2584
|
In the TUI, use `/status` to see the current state. If you expect replies in a chat
|
|
@@ -2499,8 +2591,8 @@ Docs: [TUI](/tui), [Slash commands](/tools/slash-commands).
|
|
|
2499
2591
|
If you installed the service:
|
|
2500
2592
|
|
|
2501
2593
|
```bash
|
|
2502
|
-
|
|
2503
|
-
|
|
2594
|
+
openclaw gateway stop
|
|
2595
|
+
openclaw gateway start
|
|
2504
2596
|
```
|
|
2505
2597
|
|
|
2506
2598
|
This stops/starts the **supervised service** (launchd on macOS, systemd on Linux).
|
|
@@ -2509,20 +2601,20 @@ Use this when the Gateway runs in the background as a daemon.
|
|
|
2509
2601
|
If you’re running in the foreground, stop with Ctrl‑C, then:
|
|
2510
2602
|
|
|
2511
2603
|
```bash
|
|
2512
|
-
|
|
2604
|
+
openclaw gateway run
|
|
2513
2605
|
```
|
|
2514
2606
|
|
|
2515
2607
|
Docs: [Gateway service runbook](/gateway).
|
|
2516
2608
|
|
|
2517
|
-
### ELI5
|
|
2609
|
+
### ELI5 openclaw gateway restart vs openclaw gateway
|
|
2518
2610
|
|
|
2519
|
-
- `
|
|
2520
|
-
- `
|
|
2611
|
+
- `openclaw gateway restart`: restarts the **background service** (launchd/systemd).
|
|
2612
|
+
- `openclaw gateway`: runs the gateway **in the foreground** for this terminal session.
|
|
2521
2613
|
|
|
2522
|
-
If you installed the service, use the gateway commands. Use `
|
|
2614
|
+
If you installed the service, use the gateway commands. Use `openclaw gateway` when
|
|
2523
2615
|
you want a one-off, foreground run.
|
|
2524
2616
|
|
|
2525
|
-
###
|
|
2617
|
+
### What's the fastest way to get more details when something fails
|
|
2526
2618
|
|
|
2527
2619
|
Start the Gateway with `--verbose` to get more console detail. Then inspect the log file for channel auth, model routing, and RPC errors.
|
|
2528
2620
|
|
|
@@ -2530,15 +2622,16 @@ Start the Gateway with `--verbose` to get more console detail. Then inspect the
|
|
|
2530
2622
|
|
|
2531
2623
|
### My skill generated an imagePDF but nothing was sent
|
|
2532
2624
|
|
|
2533
|
-
Outbound attachments from the agent must include a `MEDIA:<path-or-url>` line (on its own line). See [
|
|
2625
|
+
Outbound attachments from the agent must include a `MEDIA:<path-or-url>` line (on its own line). See [OpenClaw assistant setup](/start/openclaw) and [Agent send](/tools/agent-send).
|
|
2534
2626
|
|
|
2535
2627
|
CLI sending:
|
|
2536
2628
|
|
|
2537
2629
|
```bash
|
|
2538
|
-
|
|
2630
|
+
openclaw message send --target +15555550123 --message "Here you go" --media /path/to/file.png
|
|
2539
2631
|
```
|
|
2540
2632
|
|
|
2541
2633
|
Also check:
|
|
2634
|
+
|
|
2542
2635
|
- The target channel supports outbound media and isn’t blocked by allowlists.
|
|
2543
2636
|
- The file is within the provider’s size limits (images are resized to max 2048px).
|
|
2544
2637
|
|
|
@@ -2546,17 +2639,17 @@ See [Images](/nodes/images).
|
|
|
2546
2639
|
|
|
2547
2640
|
## Security and access control
|
|
2548
2641
|
|
|
2549
|
-
### Is it safe to expose
|
|
2642
|
+
### Is it safe to expose OpenClaw to inbound DMs
|
|
2550
2643
|
|
|
2551
2644
|
Treat inbound DMs as untrusted input. Defaults are designed to reduce risk:
|
|
2552
2645
|
|
|
2553
2646
|
- Default behavior on DM‑capable channels is **pairing**:
|
|
2554
2647
|
- Unknown senders receive a pairing code; the bot does not process their message.
|
|
2555
|
-
- Approve with: `
|
|
2556
|
-
- Pending requests are capped at **3 per channel**; check `
|
|
2648
|
+
- Approve with: `openclaw pairing approve <channel> <code>`
|
|
2649
|
+
- Pending requests are capped at **3 per channel**; check `openclaw pairing list <channel>` if a code didn’t arrive.
|
|
2557
2650
|
- Opening DMs publicly requires explicit opt‑in (`dmPolicy: "open"` and allowlist `"*"`).
|
|
2558
2651
|
|
|
2559
|
-
Run `
|
|
2652
|
+
Run `openclaw doctor` to surface risky DM policies.
|
|
2560
2653
|
|
|
2561
2654
|
### Is prompt injection only a concern for public bots
|
|
2562
2655
|
|
|
@@ -2567,6 +2660,7 @@ to hijack the model. This can happen even if **you are the only sender**.
|
|
|
2567
2660
|
|
|
2568
2661
|
The biggest risk is when tools are enabled: the model can be tricked into
|
|
2569
2662
|
exfiltrating context or calling tools on your behalf. Reduce the blast radius by:
|
|
2663
|
+
|
|
2570
2664
|
- using a read-only or tool-disabled "reader" agent to summarize untrusted content
|
|
2571
2665
|
- keeping `web_search` / `web_fetch` / `browser` off for tool-enabled agents
|
|
2572
2666
|
- sandboxing and strict tool allowlists
|
|
@@ -2587,6 +2681,7 @@ Docs: [Security](/gateway/security), [Pairing](/start/pairing).
|
|
|
2587
2681
|
### Can I give it autonomy over my text messages and is that safe
|
|
2588
2682
|
|
|
2589
2683
|
We do **not** recommend full autonomy over your personal messages. The safest pattern is:
|
|
2684
|
+
|
|
2590
2685
|
- Keep DMs in **pairing mode** or a tight allowlist.
|
|
2591
2686
|
- Use a **separate number or account** if you want it to message on your behalf.
|
|
2592
2687
|
- Let it draft, then **approve before sending**.
|
|
@@ -2607,8 +2702,9 @@ Pairing codes are sent **only** when an unknown sender messages the bot and
|
|
|
2607
2702
|
`dmPolicy: "pairing"` is enabled. `/start` by itself doesn’t generate a code.
|
|
2608
2703
|
|
|
2609
2704
|
Check pending requests:
|
|
2705
|
+
|
|
2610
2706
|
```bash
|
|
2611
|
-
|
|
2707
|
+
openclaw pairing list telegram
|
|
2612
2708
|
```
|
|
2613
2709
|
|
|
2614
2710
|
If you want immediate access, allowlist your sender id or set `dmPolicy: "open"`
|
|
@@ -2616,18 +2712,18 @@ for that account.
|
|
|
2616
2712
|
|
|
2617
2713
|
### WhatsApp will it message my contacts How does pairing work
|
|
2618
2714
|
|
|
2619
|
-
No. Default WhatsApp DM policy is **pairing**. Unknown senders only get a pairing code and their message is **not processed**.
|
|
2715
|
+
No. Default WhatsApp DM policy is **pairing**. Unknown senders only get a pairing code and their message is **not processed**. OpenClaw only replies to chats it receives or to explicit sends you trigger.
|
|
2620
2716
|
|
|
2621
2717
|
Approve pairing with:
|
|
2622
2718
|
|
|
2623
2719
|
```bash
|
|
2624
|
-
|
|
2720
|
+
openclaw pairing approve whatsapp <code>
|
|
2625
2721
|
```
|
|
2626
2722
|
|
|
2627
2723
|
List pending requests:
|
|
2628
2724
|
|
|
2629
2725
|
```bash
|
|
2630
|
-
|
|
2726
|
+
openclaw pairing list whatsapp
|
|
2631
2727
|
```
|
|
2632
2728
|
|
|
2633
2729
|
Wizard phone number prompt: it’s used to set your **allowlist/owner** so your own DMs are permitted. It’s not used for auto-sending. If you run on your personal WhatsApp number, use that number and enable `channels.whatsapp.selfChatMode`.
|
|
@@ -2640,6 +2736,7 @@ Most internal or tool messages only appear when **verbose** or **reasoning** is
|
|
|
2640
2736
|
for that session.
|
|
2641
2737
|
|
|
2642
2738
|
Fix in the chat where you see it:
|
|
2739
|
+
|
|
2643
2740
|
```
|
|
2644
2741
|
/verbose off
|
|
2645
2742
|
/reasoning off
|
|
@@ -2678,7 +2775,7 @@ Most commands must be sent as a **standalone** message that starts with `/`, but
|
|
|
2678
2775
|
|
|
2679
2776
|
### How do I send a Discord message from Telegram Crosscontext messaging denied
|
|
2680
2777
|
|
|
2681
|
-
|
|
2778
|
+
OpenClaw blocks **cross‑provider** messaging by default. If a tool call is bound
|
|
2682
2779
|
to Telegram, it won’t send to Discord unless you explicitly allow it.
|
|
2683
2780
|
|
|
2684
2781
|
Enable cross‑provider messaging for the agent:
|
|
@@ -2691,12 +2788,12 @@ Enable cross‑provider messaging for the agent:
|
|
|
2691
2788
|
message: {
|
|
2692
2789
|
crossContext: {
|
|
2693
2790
|
allowAcrossProviders: true,
|
|
2694
|
-
marker: { enabled: true, prefix: "[from {channel}] " }
|
|
2695
|
-
}
|
|
2696
|
-
}
|
|
2697
|
-
}
|
|
2698
|
-
}
|
|
2699
|
-
}
|
|
2791
|
+
marker: { enabled: true, prefix: "[from {channel}] " },
|
|
2792
|
+
},
|
|
2793
|
+
},
|
|
2794
|
+
},
|
|
2795
|
+
},
|
|
2796
|
+
},
|
|
2700
2797
|
}
|
|
2701
2798
|
```
|
|
2702
2799
|
|
|
@@ -2719,8 +2816,8 @@ You can add options like `debounce:2s cap:25 drop:summarize` for followup modes.
|
|
|
2719
2816
|
|
|
2720
2817
|
**Q: “What’s the default model for Anthropic with an API key?”**
|
|
2721
2818
|
|
|
2722
|
-
**A:** In
|
|
2819
|
+
**A:** In OpenClaw, credentials and model selection are separate. Setting `ANTHROPIC_API_KEY` (or storing an Anthropic API key in auth profiles) enables authentication, but the actual default model is whatever you configure in `agents.defaults.model.primary` (for example, `anthropic/claude-sonnet-4-5` or `anthropic/claude-opus-4-5`). If you see `No credentials found for profile "anthropic:default"`, it means the Gateway couldn’t find Anthropic credentials in the expected `auth-profiles.json` for the agent that’s running.
|
|
2723
2820
|
|
|
2724
2821
|
---
|
|
2725
2822
|
|
|
2726
|
-
Still stuck? Ask in [Discord](https://discord.com/invite/clawd) or open a [GitHub discussion](https://github.com/
|
|
2823
|
+
Still stuck? Ask in [Discord](https://discord.com/invite/clawd) or open a [GitHub discussion](https://github.com/openclaw/openclaw/discussions).
|