@gguf/pigbot 0.0.6 → 0.0.7
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 +1206 -12
- package/LICENSE +2 -2
- package/README.md +347 -37
- 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.js +5 -5
- package/dist/acp/server.js +3 -3
- package/dist/acp/types.js +2 -2
- package/dist/agents/agent-paths.js +6 -6
- package/dist/agents/agent-scope.js +1 -1
- package/dist/agents/anthropic-payload-log.js +2 -2
- package/dist/agents/auth-profiles/doctor.js +1 -1
- package/dist/agents/auth-profiles/paths.js +3 -3
- package/dist/agents/bash-tools.exec.js +1 -1
- package/dist/agents/bash-tools.shared.js +2 -2
- package/dist/agents/cache-trace.js +5 -5
- package/dist/agents/channel-tools.js +31 -2
- package/dist/agents/cli-runner/helpers.js +3 -3
- package/dist/agents/cli-runner.js +3 -3
- package/dist/agents/context.js +4 -4
- package/dist/agents/docs-path.js +3 -3
- package/dist/agents/identity.js +1 -1
- package/dist/agents/live-auth-keys.js +2 -2
- package/dist/agents/memory-search.js +5 -0
- package/dist/agents/minimax-vlm.js +1 -1
- package/dist/agents/model-auth.js +2 -1
- package/dist/agents/model-catalog.js +4 -4
- package/dist/agents/model-selection.js +1 -1
- package/dist/agents/models-config.js +3 -3
- package/dist/agents/models-config.providers.js +40 -8
- package/dist/agents/{moltbot-tools.js → openclaw-tools.js} +1 -1
- package/dist/agents/pi-embedded-helpers/errors.js +20 -0
- package/dist/agents/pi-embedded-helpers/openai.js +1 -1
- package/dist/agents/pi-embedded-helpers.js +1 -1
- package/dist/agents/pi-embedded-runner/cache-ttl.js +1 -1
- package/dist/agents/pi-embedded-runner/compact.js +8 -8
- package/dist/agents/pi-embedded-runner/model.js +2 -2
- package/dist/agents/pi-embedded-runner/run/attempt.js +6 -6
- package/dist/agents/pi-embedded-runner/run.js +31 -5
- package/dist/agents/pi-embedded-runner/session-manager-cache.js +1 -1
- package/dist/agents/pi-embedded-runner/utils.js +1 -1
- package/dist/agents/pi-embedded-subscribe.raw-stream.js +2 -2
- package/dist/agents/pi-tools.js +5 -5
- package/dist/agents/pi-tools.read.js +2 -2
- package/dist/agents/sandbox/browser.js +16 -11
- package/dist/agents/sandbox/constants.js +7 -7
- package/dist/agents/sandbox/docker.js +17 -14
- package/dist/agents/sandbox/runtime-status.js +1 -1
- package/dist/agents/session-transcript-repair.js +1 -1
- package/dist/agents/session-write-lock.js +2 -2
- package/dist/agents/skills/bundled-dir.js +1 -1
- package/dist/agents/skills/config.js +2 -1
- package/dist/agents/skills/frontmatter.js +11 -3
- package/dist/agents/skills/workspace.js +6 -6
- package/dist/agents/synthetic-models.js +8 -0
- package/dist/agents/system-prompt.js +21 -21
- package/dist/agents/tool-images.js +1 -1
- package/dist/agents/tool-policy.js +2 -2
- package/dist/agents/tools/browser-tool.js +5 -5
- package/dist/agents/tools/image-tool.js +2 -2
- package/dist/agents/tools/memory-tool.js +1 -1
- package/dist/agents/tools/sessions-send-tool.js +2 -2
- package/dist/agents/tools/web-search.js +7 -7
- package/dist/agents/transcript-policy.js +2 -1
- package/dist/agents/workspace.js +3 -3
- package/dist/auto-reply/commands-registry.data.js +1 -1
- package/dist/auto-reply/reply/agent-runner-execution.js +1 -1
- package/dist/auto-reply/reply/bash-command.js +2 -2
- package/dist/auto-reply/reply/commands-context-report.js +2 -2
- package/dist/auto-reply/reply/commands-session.js +4 -4
- package/dist/auto-reply/reply/directive-handling.shared.js +1 -1
- package/dist/auto-reply/reply/dispatch-from-config.js +21 -0
- package/dist/auto-reply/reply/get-reply-inline-actions.js +2 -2
- package/dist/auto-reply/reply/get-reply.js +1 -1
- package/dist/auto-reply/reply/groups.js +1 -1
- package/dist/auto-reply/reply/mentions.js +3 -2
- package/dist/auto-reply/reply/normalize-reply.js +12 -4
- package/dist/auto-reply/reply/reply-dispatcher.js +8 -1
- package/dist/auto-reply/reply/reply-elevated.js +1 -1
- package/dist/auto-reply/reply/stage-sandbox-media.js +1 -1
- package/dist/auto-reply/status.js +2 -2
- package/dist/browser/chrome.js +13 -13
- package/dist/browser/chrome.profile-decoration.js +5 -5
- package/dist/browser/client-fetch.js +3 -3
- package/dist/browser/config.js +11 -11
- package/dist/browser/constants.js +3 -3
- package/dist/browser/control-service.js +1 -1
- package/dist/browser/extension-relay.js +3 -3
- package/dist/browser/profiles-service.js +2 -2
- package/dist/browser/profiles.js +1 -1
- package/dist/browser/pw-tools-core.downloads.js +1 -1
- package/dist/browser/pw-tools-core.interactions.js +5 -5
- package/dist/browser/pw-tools-core.responses.js +1 -1
- package/dist/browser/routes/agent.act.js +2 -2
- package/dist/browser/routes/agent.debug.js +1 -1
- package/dist/browser/server-context.js +9 -9
- package/dist/browser/server.js +2 -2
- package/dist/build-info.json +2 -2
- package/dist/canvas-host/a2ui/.bundle.hash +1 -1
- package/dist/canvas-host/a2ui/a2ui.bundle.js +24 -19
- package/dist/canvas-host/a2ui/index.html +28 -28
- package/dist/canvas-host/a2ui.js +14 -18
- package/dist/canvas-host/server.js +33 -35
- package/dist/channels/plugins/catalog.js +7 -7
- package/dist/channels/plugins/helpers.js +2 -2
- package/dist/channels/plugins/onboarding/imessage.js +1 -1
- package/dist/channels/plugins/onboarding/signal.js +2 -2
- package/dist/channels/plugins/onboarding/slack.js +5 -5
- package/dist/channels/plugins/onboarding/telegram.js +3 -3
- package/dist/channels/plugins/onboarding/whatsapp.js +4 -4
- package/dist/channels/plugins/pairing-message.js +1 -1
- package/dist/channels/plugins/status-issues/bluebubbles.js +1 -1
- package/dist/channels/plugins/status-issues/whatsapp.js +2 -2
- package/dist/channels/registry.js +1 -1
- package/dist/cli/acp-cli.js +2 -2
- package/dist/cli/argv.js +2 -2
- package/dist/cli/banner.js +10 -11
- package/dist/cli/browser-cli-actions-input/register.files-downloads.js +1 -1
- package/dist/cli/browser-cli-examples.js +29 -29
- package/dist/cli/browser-cli-extension.js +5 -5
- package/dist/cli/browser-cli-manage.js +4 -4
- package/dist/cli/browser-cli.js +3 -3
- package/dist/cli/channel-options.js +1 -1
- package/dist/cli/channels-cli.js +1 -1
- package/dist/cli/cli-name.js +4 -8
- package/dist/cli/command-format.js +3 -3
- package/dist/cli/config-cli.js +2 -2
- package/dist/cli/cron-cli/register.js +1 -1
- package/dist/cli/daemon-cli/install.js +2 -2
- package/dist/cli/daemon-cli/register.js +1 -1
- package/dist/cli/daemon-cli/shared.js +11 -13
- package/dist/cli/daemon-cli/status.gather.js +2 -5
- package/dist/cli/daemon-cli/status.print.js +9 -17
- package/dist/cli/directory-cli.js +1 -1
- package/dist/cli/dns-cli.js +20 -13
- package/dist/cli/docs-cli.js +2 -2
- package/dist/cli/exec-approvals-cli.js +2 -2
- package/dist/cli/gateway-cli/dev.js +7 -5
- package/dist/cli/gateway-cli/register.js +12 -6
- package/dist/cli/gateway-cli/run.js +15 -14
- package/dist/cli/gateway-cli/shared.js +5 -5
- package/dist/cli/hooks-cli.js +3 -3
- package/dist/cli/logs-cli.js +3 -3
- package/dist/cli/memory-cli.js +36 -5
- package/dist/cli/models-cli.js +1 -1
- package/dist/cli/node-cli/daemon.js +3 -3
- package/dist/cli/node-cli/register.js +1 -1
- package/dist/cli/nodes-cli/register.canvas.js +1 -1
- package/dist/cli/nodes-cli/register.js +1 -1
- package/dist/cli/nodes-screen.js +1 -1
- package/dist/cli/pairing-cli.js +3 -3
- package/dist/cli/plugin-registry.js +2 -2
- package/dist/cli/plugins-cli.js +3 -3
- package/dist/cli/profile.js +9 -9
- package/dist/cli/program/config-guard.js +1 -1
- package/dist/cli/program/help.js +14 -11
- package/dist/cli/program/preaction.js +1 -1
- package/dist/cli/program/register.agent.js +15 -12
- package/dist/cli/program/register.configure.js +1 -1
- package/dist/cli/program/register.maintenance.js +4 -4
- package/dist/cli/program/register.message.js +5 -5
- package/dist/cli/program/register.onboard.js +5 -3
- package/dist/cli/program/register.setup.js +3 -3
- package/dist/cli/program/register.status-health-sessions.js +13 -13
- package/dist/cli/program/register.subclis.js +7 -2
- package/dist/cli/route.js +1 -1
- package/dist/cli/run-main.js +3 -3
- package/dist/cli/sandbox-cli.js +19 -19
- package/dist/cli/security-cli.js +4 -4
- package/dist/cli/skills-cli.js +3 -3
- package/dist/cli/system-cli.js +1 -1
- package/dist/cli/tagline.js +11 -9
- package/dist/cli/tui-cli.js +1 -1
- package/dist/cli/update-cli.js +48 -45
- package/dist/cli/webhooks-cli.js +6 -6
- package/dist/commands/agent-via-gateway.js +1 -1
- package/dist/commands/agent.js +1 -1
- package/dist/commands/agents.command-shared.js +1 -1
- package/dist/commands/agents.commands.add.js +2 -2
- package/dist/commands/agents.commands.list.js +1 -1
- package/dist/commands/auth-choice-options.js +10 -0
- package/dist/commands/auth-choice.apply.api-providers.js +49 -1
- package/dist/commands/auth-choice.apply.openai.js +1 -1
- package/dist/commands/auth-choice.apply.plugin-provider.js +2 -2
- package/dist/commands/auth-choice.preferred-provider.js +1 -0
- package/dist/commands/channels/shared.js +1 -1
- package/dist/commands/channels/status.js +1 -1
- package/dist/commands/chutes-oauth.js +1 -1
- package/dist/commands/configure.channels.js +2 -2
- package/dist/commands/configure.gateway.js +1 -1
- package/dist/commands/configure.wizard.js +21 -21
- package/dist/commands/daemon-install-helpers.js +2 -2
- package/dist/commands/dashboard.js +2 -2
- package/dist/commands/docs.js +5 -5
- package/dist/commands/doctor-auth.js +5 -5
- package/dist/commands/doctor-config-flow.js +64 -7
- package/dist/commands/doctor-format.js +5 -5
- package/dist/commands/doctor-gateway-daemon-flow.js +7 -4
- package/dist/commands/doctor-gateway-services.js +72 -65
- package/dist/commands/doctor-platform-notes.js +51 -9
- package/dist/commands/doctor-sandbox.js +4 -4
- package/dist/commands/doctor-security.js +7 -7
- package/dist/commands/doctor-state-integrity.js +9 -7
- package/dist/commands/doctor-state-migrations.js +1 -1
- package/dist/commands/doctor-ui.js +2 -2
- package/dist/commands/doctor-update.js +5 -5
- package/dist/commands/doctor-workspace-status.js +2 -2
- package/dist/commands/doctor-workspace.js +5 -27
- package/dist/commands/doctor.js +11 -11
- package/dist/commands/gateway-status/helpers.js +2 -2
- package/dist/commands/gateway-status.js +9 -3
- package/dist/commands/health.js +2 -2
- package/dist/commands/models/auth.js +1 -1
- package/dist/commands/models/list.probe.js +2 -2
- package/dist/commands/models/list.registry.js +4 -4
- package/dist/commands/models/list.status-command.js +4 -4
- package/dist/commands/node-daemon-install-helpers.js +1 -1
- package/dist/commands/onboard-auth.config-core.js +65 -1
- package/dist/commands/onboard-auth.credentials.js +14 -2
- package/dist/commands/onboard-auth.js +2 -2
- package/dist/commands/onboard-channels.js +5 -5
- package/dist/commands/onboard-helpers.js +9 -8
- package/dist/commands/onboard-hooks.js +4 -4
- package/dist/commands/onboard-non-interactive/local/auth-choice.js +21 -1
- package/dist/commands/onboard-non-interactive/local.js +1 -1
- package/dist/commands/onboard-non-interactive/remote.js +1 -1
- package/dist/commands/onboard-non-interactive.js +1 -1
- package/dist/commands/onboard-remote.js +7 -3
- package/dist/commands/onboard-skills.js +2 -2
- package/dist/commands/onboard.js +3 -3
- package/dist/commands/onboarding/plugin-install.js +2 -2
- package/dist/commands/reset.js +3 -3
- package/dist/commands/sandbox-display.js +1 -1
- package/dist/commands/sandbox-explain.js +2 -2
- package/dist/commands/setup.js +9 -7
- package/dist/commands/signal-install.js +2 -2
- package/dist/commands/status-all/diagnosis.js +1 -1
- package/dist/commands/status-all/report-lines.js +1 -1
- package/dist/commands/status-all.js +5 -5
- package/dist/commands/status.command.js +9 -9
- package/dist/commands/status.gateway-probe.js +2 -2
- package/dist/commands/status.scan.js +2 -2
- package/dist/commands/status.update.js +3 -3
- package/dist/commands/uninstall.js +4 -4
- package/dist/compat/legacy-names.js +8 -6
- package/dist/config/config.js +1 -1
- package/dist/config/io.js +13 -14
- package/dist/config/paths.js +107 -33
- package/dist/config/schema.js +14 -12
- package/dist/config/sessions/store.js +1 -1
- package/dist/config/sessions/transcript.js +1 -1
- package/dist/config/types.js +1 -1
- package/dist/config/validation.js +2 -2
- package/dist/config/version.js +4 -4
- package/dist/config/zod-schema.agent-runtime.js +1 -0
- package/dist/config/zod-schema.js +3 -2
- package/dist/config/zod-schema.session.js +6 -1
- 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-CxLFx0Ae.js → index-DFDgq9AK.js} +397 -366
- package/dist/control-ui/assets/index-DFDgq9AK.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/daemon/constants.js +19 -25
- package/dist/daemon/inspect.js +64 -28
- package/dist/daemon/launchd.js +7 -7
- package/dist/daemon/node-service.js +14 -14
- package/dist/daemon/paths.js +3 -3
- package/dist/daemon/program-args.js +1 -1
- package/dist/daemon/schtasks.js +6 -6
- package/dist/daemon/service-env.js +25 -21
- package/dist/daemon/systemd-hints.js +1 -1
- package/dist/daemon/systemd-unit.js +1 -1
- package/dist/daemon/systemd.js +6 -6
- package/dist/discord/send.outbound.js +4 -4
- package/dist/discord/send.shared.js +32 -1
- package/dist/discord/targets.js +79 -0
- package/dist/entry.js +9 -8
- package/dist/gateway/auth.js +6 -3
- package/dist/gateway/call.js +3 -1
- package/dist/gateway/control-ui.js +4 -4
- package/dist/gateway/hooks.js +3 -1
- package/dist/gateway/http-utils.js +5 -3
- package/dist/gateway/openai-http.js +3 -3
- package/dist/gateway/openresponses-http.js +4 -4
- package/dist/gateway/protocol/client-info.js +5 -5
- package/dist/gateway/server/ws-connection/message-handler.js +1 -1
- package/dist/gateway/server-browser.js +2 -2
- package/dist/gateway/server-constants.js +2 -2
- package/dist/gateway/server-cron.js +1 -1
- package/dist/gateway/server-discovery-runtime.js +12 -4
- package/dist/gateway/server-discovery.js +7 -7
- package/dist/gateway/server-http.js +1 -1
- package/dist/gateway/server-methods/config.js +2 -2
- package/dist/gateway/server-methods/logs.js +1 -1
- package/dist/gateway/server-methods/update.js +2 -2
- package/dist/gateway/server-plugins.js +2 -2
- package/dist/gateway/server-reload-handlers.js +5 -5
- package/dist/gateway/server-runtime-config.js +3 -3
- package/dist/gateway/server-startup.js +6 -6
- package/dist/gateway/server.impl.js +8 -7
- package/dist/gateway/session-utils.fs.js +2 -1
- package/dist/gateway/test-helpers.mocks.js +8 -6
- package/dist/gateway/test-helpers.server.js +28 -28
- package/dist/gateway/tools-invoke-http.js +40 -4
- package/dist/hooks/bundled/boot-md/HOOK.md +3 -3
- package/dist/hooks/bundled/command-logger/HOOK.md +12 -12
- package/dist/hooks/bundled/command-logger/handler.js +2 -1
- package/dist/hooks/bundled/session-memory/HOOK.md +30 -7
- package/dist/hooks/bundled/session-memory/handler.js +19 -12
- package/dist/hooks/bundled/soul-evil/HOOK.md +5 -5
- package/dist/hooks/bundled-dir.js +2 -2
- package/dist/hooks/config.js +1 -1
- package/dist/hooks/frontmatter.js +11 -3
- package/dist/hooks/gmail-ops.js +1 -1
- package/dist/hooks/gmail-watcher.js +1 -1
- package/dist/hooks/hooks-status.js +2 -2
- package/dist/hooks/install.js +8 -8
- package/dist/hooks/internal-hooks.js +1 -1
- package/dist/hooks/llm-slug-generator.js +1 -1
- package/dist/hooks/loader.js +1 -1
- package/dist/hooks/plugin-hooks.js +2 -2
- package/dist/hooks/workspace.js +9 -9
- package/dist/imessage/monitor/monitor-provider.js +2 -2
- package/dist/index.js +4 -4
- package/dist/infra/bonjour-discovery.js +21 -17
- package/dist/infra/bonjour.js +10 -9
- package/dist/infra/device-identity.js +1 -1
- package/dist/infra/diagnostic-flags.js +1 -1
- package/dist/infra/dotenv.js +1 -1
- package/dist/infra/exec-approvals.js +2 -2
- package/dist/infra/gateway-lock.js +3 -2
- package/dist/infra/machine-name.js +1 -1
- package/dist/infra/{moltbot-root.js → openclaw-root.js} +2 -2
- package/dist/infra/outbound/outbound-session.js +18 -0
- package/dist/infra/outbound/targets.js +1 -1
- package/dist/infra/path-env.js +10 -9
- package/dist/infra/ports-format.js +3 -2
- package/dist/infra/ports.js +2 -2
- package/dist/infra/provider-usage.auth.js +33 -0
- package/dist/infra/provider-usage.fetch.claude.js +1 -1
- package/dist/infra/provider-usage.fetch.minimax.js +1 -1
- package/dist/infra/provider-usage.load.js +6 -0
- package/dist/infra/provider-usage.shared.js +2 -0
- package/dist/infra/restart-sentinel.js +1 -1
- package/dist/infra/restart.js +4 -4
- package/dist/infra/runtime-guard.js +2 -2
- package/dist/infra/shell-env.js +4 -4
- package/dist/infra/ssh-config.js +2 -1
- package/dist/infra/ssh-tunnel.js +8 -1
- package/dist/infra/state-migrations.js +165 -6
- package/dist/infra/system-presence.js +1 -1
- package/dist/infra/tailscale.js +1 -1
- package/dist/infra/tls/gateway.js +1 -1
- package/dist/infra/unhandled-rejections.js +56 -33
- package/dist/infra/update-check.js +1 -1
- package/dist/infra/update-global.js +21 -11
- package/dist/infra/update-runner.js +7 -7
- package/dist/infra/update-startup.js +3 -3
- package/dist/infra/voicewake.js +1 -1
- package/dist/infra/warnings.js +1 -1
- package/dist/infra/widearea-dns.js +31 -14
- package/dist/logging/logger.js +4 -4
- package/dist/macos/gateway-daemon.js +9 -6
- package/dist/macos/relay-smoke.js +1 -1
- package/dist/macos/relay.js +6 -6
- package/dist/media/host.js +1 -1
- package/dist/media/image-ops.js +3 -3
- package/dist/media/input-files.js +1 -1
- package/dist/media/mime.js +3 -0
- package/dist/media-understanding/apply.js +278 -1
- package/dist/media-understanding/attachments.js +1 -1
- package/dist/media-understanding/providers/image.js +2 -2
- package/dist/media-understanding/runner.js +1 -1
- package/dist/memory/batch-gemini.js +2 -2
- package/dist/memory/batch-openai.js +1 -1
- package/dist/memory/embeddings-gemini.js +1 -1
- package/dist/memory/embeddings.js +1 -1
- package/dist/memory/internal.js +49 -16
- package/dist/memory/manager-cache-key.js +1 -0
- package/dist/memory/manager.js +62 -10
- package/dist/memory/sync-memory-files.js +1 -1
- package/dist/node-host/runner.js +6 -6
- package/dist/pairing/pairing-messages.js +2 -2
- package/dist/plugins/bundled-dir.js +1 -1
- package/dist/plugins/cli.js +2 -2
- package/dist/plugins/config-state.js +60 -0
- package/dist/plugins/discovery.js +14 -12
- package/dist/plugins/install.js +8 -8
- package/dist/plugins/loader.js +4 -7
- package/dist/plugins/manifest-registry.js +4 -4
- package/dist/plugins/manifest.js +4 -7
- package/dist/plugins/providers.js +2 -2
- package/dist/plugins/registry.js +2 -2
- package/dist/plugins/runtime.js +1 -1
- package/dist/plugins/status.js +2 -2
- package/dist/plugins/tools.js +2 -2
- package/dist/plugins/update.js +3 -3
- package/dist/providers/qwen-portal-oauth.js +1 -1
- package/dist/routing/resolve-route.js +2 -0
- package/dist/routing/session-key.js +5 -0
- package/dist/security/audit-extra.js +2 -2
- package/dist/security/audit.js +7 -7
- package/dist/shared/text/reasoning-tags.js +44 -3
- package/dist/slack/monitor/commands.js +4 -3
- package/dist/slack/monitor/slash.js +62 -59
- package/dist/slack/monitor.test-helpers.js +1 -1
- package/dist/telegram/accounts.js +1 -1
- package/dist/telegram/bot/delivery.js +26 -3
- package/dist/telegram/bot/helpers.js +13 -2
- package/dist/telegram/bot-message-context.js +8 -4
- package/dist/telegram/bot-message-dispatch.js +36 -5
- package/dist/telegram/bot-native-commands.js +50 -11
- package/dist/telegram/bot.js +7 -5
- package/dist/telegram/download.js +1 -1
- package/dist/telegram/monitor.js +19 -1
- package/dist/telegram/network-config.js +2 -2
- package/dist/telegram/network-errors.js +4 -0
- package/dist/terminal/links.js +1 -1
- package/dist/tts/tts.js +12 -6
- package/dist/tui/gateway-chat.js +3 -3
- package/dist/tui/tui.js +1 -1
- package/dist/utils.js +12 -3
- package/dist/version.js +3 -3
- package/dist/web/active-listener.js +1 -1
- package/dist/web/auth-store.js +1 -1
- package/dist/web/auto-reply/monitor/broadcast.js +2 -0
- package/dist/web/auto-reply/monitor/process-message.js +1 -1
- package/dist/web/auto-reply/monitor.js +1 -1
- package/dist/web/login.js +1 -1
- package/dist/web/session.js +2 -2
- package/dist/wizard/onboarding.finalize.js +24 -21
- package/dist/wizard/onboarding.gateway-config.js +1 -1
- package/dist/wizard/onboarding.js +11 -11
- 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 +7 -7
- package/docs/automation/cron-jobs.md +19 -19
- package/docs/automation/cron-vs-heartbeat.md +7 -7
- package/docs/automation/gmail-pubsub.md +25 -25
- package/docs/automation/poll.md +7 -7
- package/docs/automation/webhook.md +5 -5
- package/docs/bedrock.md +10 -10
- package/docs/brave-search.md +1 -1
- package/docs/broadcast-groups.md +6 -6
- package/docs/channels/bluebubbles.md +12 -12
- package/docs/channels/discord.md +15 -15
- package/docs/channels/googlechat.md +16 -16
- package/docs/channels/imessage.md +13 -13
- package/docs/channels/index.md +4 -4
- package/docs/channels/line.md +6 -6
- package/docs/channels/location.md +1 -1
- package/docs/channels/matrix.md +14 -14
- package/docs/channels/mattermost.md +8 -8
- package/docs/channels/msteams.md +26 -26
- package/docs/channels/nextcloud-talk.md +7 -7
- package/docs/channels/nostr.md +9 -9
- package/docs/channels/signal.md +9 -9
- package/docs/channels/slack.md +16 -16
- package/docs/channels/telegram.md +23 -23
- package/docs/channels/tlon.md +5 -5
- package/docs/channels/troubleshooting.md +2 -2
- package/docs/channels/twitch.md +14 -14
- package/docs/channels/whatsapp.md +26 -26
- package/docs/channels/zalo.md +8 -8
- package/docs/channels/zalouser.md +12 -12
- package/docs/cli/acp.md +24 -24
- package/docs/cli/agent.md +6 -6
- package/docs/cli/agents.md +12 -12
- package/docs/cli/approvals.md +14 -14
- package/docs/cli/browser.md +24 -24
- package/docs/cli/channels.md +21 -21
- package/docs/cli/config.md +15 -15
- package/docs/cli/configure.md +6 -6
- package/docs/cli/cron.md +5 -5
- package/docs/cli/dashboard.md +4 -4
- package/docs/cli/devices.md +13 -13
- package/docs/cli/directory.md +12 -12
- package/docs/cli/dns.md +5 -6
- package/docs/cli/docs.md +5 -5
- package/docs/cli/doctor.md +11 -11
- package/docs/cli/gateway.md +26 -26
- package/docs/cli/health.md +5 -5
- package/docs/cli/hooks.md +35 -35
- package/docs/cli/index.md +42 -42
- package/docs/cli/logs.md +6 -6
- package/docs/cli/memory.md +12 -11
- package/docs/cli/message.md +11 -11
- package/docs/cli/models.md +15 -15
- package/docs/cli/node.md +14 -14
- package/docs/cli/nodes.md +14 -14
- package/docs/cli/onboard.md +7 -7
- package/docs/cli/pairing.md +4 -4
- package/docs/cli/plugins.md +16 -16
- package/docs/cli/reset.md +5 -5
- package/docs/cli/sandbox.md +28 -28
- package/docs/cli/security.md +6 -6
- package/docs/cli/sessions.md +5 -5
- package/docs/cli/setup.md +6 -6
- package/docs/cli/skills.md +6 -6
- package/docs/cli/status.md +7 -7
- package/docs/cli/system.md +6 -6
- package/docs/cli/tui.md +5 -5
- package/docs/cli/uninstall.md +5 -5
- package/docs/cli/update.md +20 -20
- package/docs/cli/voicecall.md +9 -9
- package/docs/cli/webhooks.md +5 -5
- package/docs/concepts/agent-loop.md +5 -5
- package/docs/concepts/agent-workspace.md +27 -27
- package/docs/concepts/agent.md +12 -12
- package/docs/concepts/architecture.md +2 -2
- package/docs/concepts/channel-routing.md +5 -5
- package/docs/concepts/compaction.md +5 -5
- package/docs/concepts/context.md +6 -6
- package/docs/concepts/group-messages.md +7 -7
- package/docs/concepts/groups.md +5 -5
- package/docs/concepts/markdown-formatting.md +3 -3
- package/docs/concepts/memory.md +41 -19
- package/docs/concepts/messages.md +4 -4
- package/docs/concepts/model-failover.md +14 -14
- package/docs/concepts/model-providers.md +25 -24
- package/docs/concepts/models.md +27 -27
- package/docs/concepts/multi-agent.md +31 -31
- package/docs/concepts/oauth.md +22 -22
- package/docs/concepts/presence.md +2 -2
- package/docs/concepts/retry.md +1 -1
- package/docs/concepts/session-pruning.md +1 -1
- package/docs/concepts/session-tool.md +4 -4
- package/docs/concepts/session.md +18 -16
- package/docs/concepts/streaming.md +3 -3
- package/docs/concepts/system-prompt.md +11 -11
- package/docs/concepts/timezone.md +2 -2
- package/docs/concepts/typebox.md +3 -3
- package/docs/concepts/typing-indicators.md +2 -2
- package/docs/concepts/usage-tracking.md +3 -3
- package/docs/date-time.md +2 -2
- package/docs/debug/node-issue.md +6 -6
- package/docs/debugging.md +18 -18
- package/docs/diagnostics/flags.md +7 -7
- package/docs/docs.json +21 -5
- package/docs/environment.md +7 -7
- package/docs/experiments/plans/cron-add-hardening.md +1 -1
- package/docs/experiments/plans/openresponses-gateway.md +2 -2
- package/docs/experiments/research/memory.md +12 -12
- package/docs/gateway/authentication.md +22 -22
- package/docs/gateway/background-process.md +2 -2
- package/docs/gateway/bonjour.md +25 -25
- package/docs/gateway/bridge-protocol.md +2 -2
- package/docs/gateway/cli-backends.md +12 -12
- package/docs/gateway/configuration-examples.md +26 -25
- package/docs/gateway/configuration.md +155 -153
- package/docs/gateway/discovery.md +10 -10
- package/docs/gateway/doctor.md +27 -27
- package/docs/gateway/gateway-lock.md +1 -1
- package/docs/gateway/health.md +11 -11
- package/docs/gateway/heartbeat.md +5 -5
- package/docs/gateway/index.md +63 -63
- package/docs/gateway/local-models.md +2 -2
- package/docs/gateway/logging.md +8 -8
- package/docs/gateway/multiple-gateways.md +24 -24
- package/docs/gateway/openai-http-api.md +12 -12
- package/docs/gateway/openresponses-http-api.md +12 -12
- package/docs/gateway/pairing.md +9 -9
- package/docs/gateway/protocol.md +4 -4
- package/docs/gateway/remote-gateway-readme.md +10 -10
- package/docs/gateway/remote.md +4 -4
- package/docs/gateway/sandbox-vs-tool-policy-vs-elevated.md +7 -7
- package/docs/gateway/sandboxing.md +6 -6
- package/docs/gateway/security/formal-verification.md +67 -14
- package/docs/gateway/security/index.md +56 -59
- package/docs/gateway/tailscale.md +10 -10
- package/docs/gateway/tools-invoke-http-api.md +5 -5
- package/docs/gateway/troubleshooting.md +112 -112
- package/docs/help/faq.md +338 -338
- package/docs/help/troubleshooting.md +16 -16
- package/docs/hooks/soul-evil.md +2 -2
- package/docs/hooks.md +62 -62
- package/docs/index.md +45 -36
- package/docs/install/ansible.md +35 -35
- package/docs/install/development-channels.md +10 -10
- package/docs/install/docker.md +45 -45
- package/docs/install/index.md +33 -33
- package/docs/install/installer.md +24 -24
- package/docs/install/migrating.md +36 -36
- package/docs/install/nix.md +18 -18
- package/docs/install/node.md +4 -4
- package/docs/install/uninstall.md +29 -29
- package/docs/install/updating.md +51 -51
- package/docs/logging.md +59 -59
- package/docs/multi-agent-sandbox-tools.md +15 -15
- package/docs/network.md +1 -1
- package/docs/nodes/audio.md +2 -2
- package/docs/nodes/camera.md +18 -18
- package/docs/nodes/images.md +4 -4
- package/docs/nodes/index.md +57 -57
- package/docs/nodes/location-command.md +2 -2
- package/docs/nodes/media-understanding.md +5 -5
- package/docs/nodes/talk.md +1 -1
- package/docs/nodes/voicewake.md +3 -3
- package/docs/northflank.mdx +9 -9
- package/docs/perplexity.md +2 -2
- package/docs/platforms/android.md +14 -14
- package/docs/platforms/digitalocean.md +26 -26
- package/docs/platforms/exe-dev.md +68 -130
- package/docs/platforms/fly.md +33 -33
- package/docs/platforms/gcp.md +58 -58
- package/docs/platforms/hetzner.md +45 -45
- package/docs/platforms/index.md +8 -8
- package/docs/platforms/ios.md +13 -13
- package/docs/platforms/linux.md +11 -11
- package/docs/platforms/mac/bundled-gateway.md +14 -14
- package/docs/platforms/mac/canvas.md +14 -14
- package/docs/platforms/mac/child-process.md +5 -5
- package/docs/platforms/mac/dev-setup.md +10 -10
- package/docs/platforms/mac/health.md +2 -2
- package/docs/platforms/mac/icon.md +1 -1
- package/docs/platforms/mac/logging.md +4 -4
- package/docs/platforms/mac/menu-bar.md +1 -1
- package/docs/platforms/mac/peekaboo.md +9 -9
- package/docs/platforms/mac/permissions.md +1 -1
- package/docs/platforms/mac/release.md +18 -18
- package/docs/platforms/mac/remote.md +14 -14
- package/docs/platforms/mac/signing.md +7 -7
- package/docs/platforms/mac/skills.md +4 -4
- package/docs/platforms/mac/webchat.md +1 -1
- package/docs/platforms/mac/xpc.md +4 -4
- package/docs/platforms/macos-vm.md +27 -27
- package/docs/platforms/macos.md +16 -16
- package/docs/platforms/oracle.md +35 -35
- package/docs/platforms/raspberry-pi.md +22 -22
- package/docs/platforms/windows.md +11 -11
- package/docs/plugin.md +65 -65
- package/docs/plugins/agent-tools.md +1 -1
- package/docs/plugins/manifest.md +4 -4
- package/docs/plugins/voice-call.md +12 -12
- package/docs/plugins/zalouser.md +9 -9
- package/docs/prose.md +9 -9
- package/docs/providers/anthropic.md +16 -16
- package/docs/providers/claude-max-api-proxy.md +4 -4
- package/docs/providers/deepgram.md +2 -2
- package/docs/providers/github-copilot.md +11 -11
- package/docs/providers/glm.md +4 -4
- package/docs/providers/index.md +4 -3
- package/docs/providers/minimax.md +9 -9
- package/docs/providers/models.md +3 -3
- package/docs/providers/moonshot.md +15 -4
- package/docs/providers/ollama.md +11 -11
- package/docs/providers/openai.md +6 -6
- package/docs/providers/opencode.md +3 -3
- package/docs/providers/openrouter.md +3 -3
- package/docs/providers/qwen.md +6 -6
- package/docs/providers/synthetic.md +4 -4
- package/docs/providers/venice.md +23 -23
- package/docs/providers/vercel-ai-gateway.md +4 -4
- package/docs/providers/xiaomi.md +62 -0
- package/docs/providers/zai.md +5 -5
- package/docs/railway.mdx +8 -8
- package/docs/refactor/exec-host.md +5 -5
- package/docs/refactor/plugin-sdk.md +12 -12
- package/docs/refactor/strict-config.md +11 -11
- package/docs/reference/AGENTS.default.md +17 -17
- package/docs/reference/RELEASING.md +29 -29
- package/docs/reference/api-usage-costs.md +6 -6
- package/docs/reference/device-models.md +7 -7
- package/docs/reference/rpc.md +3 -3
- package/docs/reference/session-management-compaction.md +19 -19
- package/docs/reference/templates/AGENTS.dev.md +1 -1
- package/docs/reference/templates/BOOT.md +1 -1
- package/docs/reference/templates/IDENTITY.md +1 -1
- package/docs/reference/templates/TOOLS.dev.md +1 -1
- package/docs/reference/templates/USER.dev.md +2 -2
- package/docs/reference/test.md +2 -2
- package/docs/reference/transcript-hygiene.md +1 -1
- package/docs/render.mdx +13 -13
- package/docs/scripts.md +1 -1
- package/docs/security/formal-verification.md +66 -13
- package/docs/start/getting-started.md +29 -29
- package/docs/start/hubs.md +2 -2
- package/docs/start/lore.md +14 -14
- package/docs/start/onboarding.md +7 -7
- package/docs/start/{clawd.md → openclaw.md} +35 -35
- package/docs/start/pairing.md +10 -10
- package/docs/start/setup.md +22 -22
- package/docs/start/showcase.md +32 -32
- package/docs/start/wizard.md +30 -30
- package/docs/testing.md +56 -56
- package/docs/token-use.md +7 -7
- package/docs/tools/agent-send.md +10 -10
- package/docs/tools/browser-linux-troubleshooting.md +16 -16
- package/docs/tools/browser-login.md +6 -6
- package/docs/tools/browser.md +126 -126
- package/docs/tools/chrome-extension.md +17 -17
- package/docs/tools/clawdhub.md +7 -7
- package/docs/tools/creating-skills.md +6 -6
- package/docs/tools/exec-approvals.md +5 -5
- package/docs/tools/exec.md +4 -4
- package/docs/tools/firecrawl.md +2 -2
- package/docs/tools/index.md +13 -13
- package/docs/tools/llm-task.md +2 -2
- package/docs/tools/lobster.md +13 -13
- package/docs/tools/skills-config.md +2 -2
- package/docs/tools/skills.md +31 -31
- package/docs/tools/slash-commands.md +8 -8
- package/docs/tools/web.md +8 -8
- package/docs/tts.md +11 -11
- package/docs/tui.md +7 -7
- package/docs/vps.md +1 -1
- package/docs/web/control-ui.md +8 -8
- package/docs/web/dashboard.md +6 -6
- package/docs/web/index.md +5 -5
- package/extensions/bluebubbles/index.ts +3 -3
- package/extensions/bluebubbles/package.json +5 -5
- package/extensions/bluebubbles/src/accounts.ts +9 -9
- package/extensions/bluebubbles/src/actions.test.ts +22 -22
- package/extensions/bluebubbles/src/actions.ts +6 -6
- package/extensions/bluebubbles/src/attachments.ts +2 -2
- package/extensions/bluebubbles/src/channel.ts +17 -17
- package/extensions/bluebubbles/src/chat.ts +2 -2
- package/extensions/bluebubbles/src/config-schema.ts +1 -1
- package/extensions/bluebubbles/src/media-send.ts +2 -2
- package/extensions/bluebubbles/src/monitor.test.ts +48 -48
- package/extensions/bluebubbles/src/monitor.ts +6 -6
- package/extensions/bluebubbles/src/onboarding.ts +9 -9
- package/extensions/bluebubbles/src/reactions.ts +2 -2
- package/extensions/bluebubbles/src/runtime.ts +1 -1
- package/extensions/bluebubbles/src/send.ts +2 -2
- package/extensions/copilot-proxy/README.md +3 -3
- package/extensions/copilot-proxy/index.ts +1 -1
- package/extensions/copilot-proxy/package.json +4 -4
- package/extensions/diagnostics-otel/index.ts +3 -3
- package/extensions/diagnostics-otel/package.json +4 -4
- package/extensions/diagnostics-otel/src/service.test.ts +15 -15
- package/extensions/diagnostics-otel/src/service.ts +85 -85
- package/extensions/discord/index.ts +3 -3
- package/extensions/discord/package.json +4 -4
- package/extensions/discord/src/channel.ts +1 -1
- package/extensions/discord/src/runtime.ts +1 -1
- package/extensions/google-antigravity-auth/README.md +3 -3
- package/extensions/google-antigravity-auth/index.ts +2 -2
- package/extensions/google-antigravity-auth/package.json +4 -4
- package/extensions/google-gemini-cli-auth/README.md +5 -5
- package/extensions/google-gemini-cli-auth/index.ts +3 -3
- package/extensions/google-gemini-cli-auth/oauth.ts +4 -4
- package/extensions/google-gemini-cli-auth/package.json +4 -4
- package/extensions/googlechat/index.ts +4 -4
- package/extensions/googlechat/node_modules/.bin/openclaw +16 -0
- package/extensions/googlechat/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/googlechat/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/googlechat/package.json +7 -7
- package/extensions/googlechat/src/accounts.ts +9 -9
- package/extensions/googlechat/src/actions.ts +8 -8
- package/extensions/googlechat/src/api.ts +1 -1
- package/extensions/googlechat/src/channel.ts +23 -23
- package/extensions/googlechat/src/monitor.ts +9 -9
- package/extensions/googlechat/src/onboarding.ts +11 -11
- package/extensions/googlechat/src/runtime.ts +1 -1
- package/extensions/googlechat/src/types.config.ts +1 -1
- package/extensions/imessage/index.ts +3 -3
- package/extensions/imessage/package.json +4 -4
- package/extensions/imessage/src/channel.ts +1 -1
- package/extensions/imessage/src/runtime.ts +1 -1
- package/extensions/line/index.ts +3 -3
- package/extensions/line/node_modules/.bin/openclaw +16 -0
- package/extensions/line/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/line/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/line/package.json +6 -6
- package/extensions/line/src/card-command.ts +3 -3
- package/extensions/line/src/channel.logout.test.ts +4 -4
- package/extensions/line/src/channel.sendPayload.test.ts +8 -8
- package/extensions/line/src/channel.ts +5 -5
- package/extensions/line/src/runtime.ts +1 -1
- package/extensions/llm-task/README.md +4 -4
- package/extensions/llm-task/index.ts +2 -2
- package/extensions/llm-task/package.json +4 -4
- package/extensions/llm-task/src/llm-task-tool.ts +6 -6
- package/extensions/lobster/README.md +7 -7
- package/extensions/lobster/index.ts +2 -2
- package/extensions/lobster/package.json +3 -3
- package/extensions/lobster/src/lobster-tool.test.ts +7 -7
- package/extensions/lobster/src/lobster-tool.ts +2 -2
- package/extensions/matrix/CHANGELOG.md +14 -9
- package/extensions/matrix/index.ts +3 -3
- package/extensions/matrix/node_modules/.bin/markdown-it +0 -5
- package/extensions/matrix/node_modules/.bin/markdown-it.CMD +0 -5
- package/extensions/matrix/node_modules/.bin/markdown-it.ps1 +0 -13
- package/extensions/matrix/node_modules/.bin/openclaw +16 -0
- package/extensions/matrix/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/matrix/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/matrix/package.json +6 -6
- package/extensions/matrix/src/actions.ts +1 -1
- package/extensions/matrix/src/channel.directory.test.ts +1 -1
- package/extensions/matrix/src/channel.ts +1 -1
- package/extensions/matrix/src/config-schema.ts +1 -1
- package/extensions/matrix/src/directory-live.ts +1 -1
- package/extensions/matrix/src/group-mentions.ts +1 -1
- package/extensions/matrix/src/matrix/accounts.ts +1 -1
- package/extensions/matrix/src/matrix/actions/client.ts +1 -1
- package/extensions/matrix/src/matrix/client/config.ts +1 -1
- package/extensions/matrix/src/matrix/deps.ts +1 -1
- package/extensions/matrix/src/matrix/monitor/allowlist.ts +1 -1
- package/extensions/matrix/src/matrix/monitor/auto-join.ts +1 -1
- package/extensions/matrix/src/matrix/monitor/events.ts +1 -1
- package/extensions/matrix/src/matrix/monitor/handler.ts +5 -5
- package/extensions/matrix/src/matrix/monitor/index.ts +1 -1
- package/extensions/matrix/src/matrix/monitor/location.ts +1 -1
- package/extensions/matrix/src/matrix/monitor/media.test.ts +1 -1
- package/extensions/matrix/src/matrix/monitor/replies.ts +1 -1
- package/extensions/matrix/src/matrix/monitor/rooms.ts +1 -1
- package/extensions/matrix/src/matrix/poll-types.ts +1 -1
- package/extensions/matrix/src/matrix/send/client.ts +1 -1
- package/extensions/matrix/src/matrix/send.test.ts +1 -1
- package/extensions/matrix/src/matrix/send.ts +1 -1
- package/extensions/matrix/src/onboarding.ts +2 -2
- package/extensions/matrix/src/outbound.ts +1 -1
- package/extensions/matrix/src/resolve-targets.ts +1 -1
- package/extensions/matrix/src/runtime.ts +1 -1
- package/extensions/matrix/src/tool-actions.ts +1 -1
- package/extensions/mattermost/index.ts +3 -3
- package/extensions/mattermost/package.json +5 -5
- package/extensions/mattermost/src/channel.ts +1 -1
- package/extensions/mattermost/src/config-schema.ts +1 -1
- package/extensions/mattermost/src/group-mentions.ts +1 -1
- package/extensions/mattermost/src/mattermost/accounts.ts +9 -9
- package/extensions/mattermost/src/mattermost/monitor-helpers.ts +5 -5
- package/extensions/mattermost/src/mattermost/monitor.ts +4 -4
- package/extensions/mattermost/src/onboarding-helpers.ts +4 -4
- package/extensions/mattermost/src/onboarding.ts +4 -4
- package/extensions/mattermost/src/runtime.ts +1 -1
- package/extensions/mattermost/src/types.ts +1 -1
- package/extensions/memory-core/index.ts +3 -3
- package/extensions/memory-core/node_modules/.bin/openclaw +16 -0
- package/extensions/memory-core/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/memory-core/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/memory-core/package.json +6 -6
- package/extensions/memory-lancedb/config.ts +26 -2
- package/extensions/memory-lancedb/index.test.ts +3 -3
- package/extensions/memory-lancedb/index.ts +4 -4
- package/extensions/memory-lancedb/node_modules/.bin/openai +0 -5
- package/extensions/memory-lancedb/node_modules/.bin/openai.CMD +0 -5
- package/extensions/memory-lancedb/node_modules/.bin/openai.ps1 +0 -13
- package/extensions/memory-lancedb/{clawdbot.plugin.json → openclaw.plugin.json} +1 -1
- package/extensions/memory-lancedb/package.json +4 -4
- package/extensions/msteams/CHANGELOG.md +12 -7
- package/extensions/msteams/index.ts +3 -3
- package/extensions/msteams/node_modules/.bin/openclaw +16 -0
- package/extensions/msteams/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/msteams/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/msteams/package.json +6 -6
- package/extensions/msteams/src/attachments.test.ts +1 -1
- package/extensions/msteams/src/channel.directory.test.ts +2 -2
- package/extensions/msteams/src/channel.ts +3 -3
- package/extensions/msteams/src/conversation-store-fs.test.ts +6 -5
- package/extensions/msteams/src/directory-live.ts +1 -1
- package/extensions/msteams/src/graph-upload.ts +4 -4
- package/extensions/msteams/src/media-helpers.ts +1 -1
- package/extensions/msteams/src/messenger.test.ts +1 -1
- package/extensions/msteams/src/messenger.ts +1 -1
- package/extensions/msteams/src/monitor-handler/message-handler.ts +1 -1
- package/extensions/msteams/src/monitor-handler.ts +2 -2
- package/extensions/msteams/src/monitor.ts +3 -3
- package/extensions/msteams/src/onboarding.ts +11 -11
- package/extensions/msteams/src/outbound.ts +1 -1
- package/extensions/msteams/src/policy.test.ts +1 -1
- package/extensions/msteams/src/policy.ts +2 -2
- package/extensions/msteams/src/polls-store.test.ts +1 -1
- package/extensions/msteams/src/polls.test.ts +6 -5
- package/extensions/msteams/src/polls.ts +9 -8
- package/extensions/msteams/src/probe.test.ts +1 -1
- package/extensions/msteams/src/probe.ts +1 -1
- package/extensions/msteams/src/reply-dispatcher.ts +3 -3
- package/extensions/msteams/src/runtime.ts +1 -1
- package/extensions/msteams/src/send-context.ts +2 -2
- package/extensions/msteams/src/send.ts +5 -5
- package/extensions/msteams/src/token.ts +1 -1
- package/extensions/nextcloud-talk/index.ts +3 -3
- package/extensions/nextcloud-talk/package.json +5 -5
- package/extensions/nextcloud-talk/src/accounts.ts +2 -2
- package/extensions/nextcloud-talk/src/channel.ts +8 -8
- package/extensions/nextcloud-talk/src/config-schema.ts +1 -1
- package/extensions/nextcloud-talk/src/inbound.ts +8 -8
- package/extensions/nextcloud-talk/src/monitor.ts +1 -1
- package/extensions/nextcloud-talk/src/onboarding.ts +2 -2
- package/extensions/nextcloud-talk/src/policy.ts +2 -2
- package/extensions/nextcloud-talk/src/room-info.ts +1 -1
- package/extensions/nextcloud-talk/src/runtime.ts +1 -1
- package/extensions/nextcloud-talk/src/types.ts +1 -1
- package/extensions/nostr/CHANGELOG.md +9 -4
- package/extensions/nostr/README.md +5 -5
- package/extensions/nostr/index.ts +6 -6
- package/extensions/nostr/node_modules/.bin/openclaw +16 -0
- package/extensions/nostr/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/nostr/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/nostr/package.json +6 -6
- package/extensions/nostr/src/channel.ts +2 -2
- package/extensions/nostr/src/config-schema.ts +1 -1
- package/extensions/nostr/src/nostr-state-store.test.ts +9 -8
- package/extensions/nostr/src/runtime.ts +1 -1
- package/extensions/nostr/src/types.ts +4 -4
- package/extensions/open-prose/index.ts +2 -2
- package/extensions/open-prose/package.json +3 -3
- package/extensions/open-prose/skills/prose/SKILL.md +5 -5
- package/extensions/open-prose/skills/prose/prose.md +4 -4
- package/extensions/qwen-portal-auth/README.md +3 -3
- package/extensions/qwen-portal-auth/index.ts +1 -1
- package/extensions/signal/index.ts +3 -3
- package/extensions/signal/package.json +4 -4
- package/extensions/signal/src/channel.ts +1 -1
- package/extensions/signal/src/runtime.ts +1 -1
- package/extensions/slack/index.ts +3 -3
- package/extensions/slack/package.json +4 -4
- package/extensions/slack/src/channel.ts +1 -1
- package/extensions/slack/src/runtime.ts +1 -1
- package/extensions/telegram/index.ts +3 -3
- package/extensions/telegram/package.json +4 -4
- package/extensions/telegram/src/channel.ts +3 -3
- package/extensions/telegram/src/runtime.ts +1 -1
- package/extensions/tlon/README.md +3 -3
- package/extensions/tlon/index.ts +3 -3
- package/extensions/tlon/package.json +5 -5
- package/extensions/tlon/src/channel.ts +15 -15
- package/extensions/tlon/src/config-schema.ts +1 -1
- package/extensions/tlon/src/monitor/discovery.ts +1 -1
- package/extensions/tlon/src/monitor/history.ts +1 -1
- package/extensions/tlon/src/monitor/index.ts +3 -3
- package/extensions/tlon/src/onboarding.ts +4 -4
- package/extensions/tlon/src/runtime.ts +1 -1
- package/extensions/tlon/src/types.ts +3 -3
- package/extensions/twitch/CHANGELOG.md +6 -1
- package/extensions/twitch/README.md +8 -8
- package/extensions/twitch/index.ts +3 -3
- package/extensions/twitch/node_modules/.bin/openclaw +16 -0
- package/extensions/twitch/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/twitch/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/twitch/package.json +5 -5
- package/extensions/twitch/src/actions.ts +1 -1
- package/extensions/twitch/src/config-schema.ts +1 -1
- package/extensions/twitch/src/config.ts +3 -3
- package/extensions/twitch/src/monitor.ts +3 -3
- package/extensions/twitch/src/onboarding.test.ts +1 -1
- package/extensions/twitch/src/onboarding.ts +13 -13
- package/extensions/twitch/src/outbound.test.ts +2 -2
- package/extensions/twitch/src/outbound.ts +2 -2
- package/extensions/twitch/src/plugin.test.ts +2 -2
- package/extensions/twitch/src/plugin.ts +9 -9
- package/extensions/twitch/src/runtime.ts +1 -1
- package/extensions/twitch/src/send.test.ts +2 -2
- package/extensions/twitch/src/send.ts +5 -5
- package/extensions/twitch/src/token.test.ts +12 -12
- package/extensions/twitch/src/token.ts +7 -7
- package/extensions/twitch/src/twitch-client.ts +4 -4
- package/extensions/twitch/src/types.ts +3 -3
- package/extensions/twitch/src/utils/markdown.ts +1 -1
- package/extensions/voice-call/CHANGELOG.md +16 -11
- package/extensions/voice-call/README.md +16 -16
- package/extensions/voice-call/package.json +4 -4
- package/extensions/voice-call/src/cli.ts +16 -4
- package/extensions/voice-call/src/core-bridge.ts +5 -5
- package/extensions/voice-call/src/manager.test.ts +2 -2
- package/extensions/voice-call/src/manager.ts +17 -5
- package/extensions/voice-call/src/response-generator.ts +1 -1
- package/extensions/whatsapp/index.ts +3 -3
- package/extensions/whatsapp/package.json +4 -4
- package/extensions/whatsapp/src/channel.ts +1 -1
- package/extensions/whatsapp/src/runtime.ts +1 -1
- package/extensions/zalo/CHANGELOG.md +14 -9
- package/extensions/zalo/README.md +4 -4
- package/extensions/zalo/index.ts +3 -3
- package/extensions/zalo/node_modules/.bin/openclaw +16 -0
- package/extensions/zalo/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/zalo/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/zalo/package.json +6 -6
- package/extensions/zalo/src/accounts.ts +9 -9
- package/extensions/zalo/src/actions.ts +6 -6
- package/extensions/zalo/src/channel.directory.test.ts +2 -2
- package/extensions/zalo/src/channel.ts +20 -20
- package/extensions/zalo/src/config-schema.ts +1 -1
- package/extensions/zalo/src/monitor.ts +9 -9
- package/extensions/zalo/src/monitor.webhook.test.ts +2 -2
- package/extensions/zalo/src/onboarding.ts +27 -27
- package/extensions/zalo/src/runtime.ts +1 -1
- package/extensions/zalo/src/send.ts +2 -2
- package/extensions/zalo/src/status-issues.ts +1 -1
- package/extensions/zalo/src/token.ts +1 -1
- package/extensions/zalouser/CHANGELOG.md +9 -4
- package/extensions/zalouser/README.md +18 -18
- package/extensions/zalouser/index.ts +3 -3
- package/extensions/zalouser/node_modules/.bin/openclaw +16 -0
- package/extensions/zalouser/node_modules/.bin/openclaw.CMD +7 -0
- package/extensions/zalouser/node_modules/.bin/openclaw.ps1 +28 -0
- package/extensions/zalouser/package.json +6 -6
- package/extensions/zalouser/src/accounts.ts +10 -10
- package/extensions/zalouser/src/channel.ts +27 -27
- package/extensions/zalouser/src/config-schema.ts +1 -1
- package/extensions/zalouser/src/monitor.ts +5 -5
- package/extensions/zalouser/src/onboarding.ts +32 -32
- package/extensions/zalouser/src/runtime.ts +1 -1
- package/extensions/zalouser/src/status-issues.ts +2 -2
- package/openclaw.mjs +14 -0
- package/package.json +35 -25
- package/scripts/postinstall.js +1 -0
- package/skills/1password/SKILL.md +3 -3
- package/skills/apple-notes/SKILL.md +2 -2
- package/skills/apple-reminders/SKILL.md +1 -1
- package/skills/bear-notes/SKILL.md +1 -1
- package/skills/bird/SKILL.md +1 -1
- package/skills/blogwatcher/SKILL.md +1 -1
- package/skills/blucli/SKILL.md +1 -1
- package/skills/bluebubbles/SKILL.md +1 -1
- package/skills/camsnap/SKILL.md +1 -1
- package/skills/canvas/SKILL.md +6 -6
- package/skills/clawdhub/SKILL.md +2 -2
- package/skills/coding-agent/SKILL.md +6 -6
- package/skills/discord/SKILL.md +5 -5
- package/skills/eightctl/SKILL.md +1 -1
- package/skills/food-order/SKILL.md +1 -1
- package/skills/gemini/SKILL.md +1 -1
- package/skills/gifgrep/SKILL.md +1 -1
- package/skills/github/SKILL.md +1 -1
- package/skills/gog/SKILL.md +1 -1
- package/skills/goplaces/SKILL.md +1 -1
- package/skills/himalaya/SKILL.md +1 -1
- package/skills/imsg/SKILL.md +1 -1
- package/skills/local-places/SKILL.md +1 -1
- package/skills/mcporter/SKILL.md +1 -1
- package/skills/model-usage/SKILL.md +1 -1
- package/skills/nano-banana-pro/SKILL.md +3 -3
- package/skills/nano-banana-pro/scripts/generate_image.py +1 -1
- package/skills/nano-pdf/SKILL.md +1 -1
- package/skills/notion/SKILL.md +1 -1
- package/skills/obsidian/SKILL.md +1 -1
- package/skills/openai-image-gen/SKILL.md +1 -1
- package/skills/openai-whisper/SKILL.md +1 -1
- package/skills/openai-whisper-api/SKILL.md +2 -2
- package/skills/openhue/SKILL.md +1 -1
- package/skills/oracle/SKILL.md +1 -1
- package/skills/ordercli/SKILL.md +1 -1
- package/skills/peekaboo/SKILL.md +1 -1
- package/skills/sag/SKILL.md +1 -1
- package/skills/session-logs/SKILL.md +1 -1
- package/skills/sherpa-onnx-tts/SKILL.md +2 -2
- package/skills/slack/SKILL.md +4 -4
- package/skills/songsee/SKILL.md +1 -1
- package/skills/sonoscli/SKILL.md +1 -1
- package/skills/spotify-player/SKILL.md +1 -1
- package/skills/summarize/SKILL.md +1 -1
- package/skills/things-mac/SKILL.md +3 -3
- package/skills/tmux/SKILL.md +7 -7
- package/skills/trello/SKILL.md +2 -2
- package/skills/video-frames/SKILL.md +1 -1
- package/skills/voice-call/SKILL.md +4 -4
- package/skills/wacli/SKILL.md +2 -2
- package/skills/weather/SKILL.md +1 -1
- package/assets/images/icon.png +0 -0
- package/dist/control-ui/assets/index-BAFzd9IE.css +0 -1
- package/dist/control-ui/assets/index-CxLFx0Ae.js.map +0 -1
- package/dist/control-ui/pixel_pig_icon.png +0 -0
- package/dist/daemon/legacy.js +0 -44
- package/dist/extension.js +0 -70
- /package/dist/config/{types.clawdbot.js → types.openclaw.js} +0 -0
- /package/docs/{whatsapp-clawd.jpg → whatsapp-openclaw.jpg} +0 -0
- /package/extensions/bluebubbles/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/copilot-proxy/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/diagnostics-otel/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/discord/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/google-antigravity-auth/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/google-gemini-cli-auth/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/googlechat/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/imessage/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/line/{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/matrix/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/mattermost/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/memory-core/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/msteams/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/nextcloud-talk/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/nostr/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/open-prose/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/qwen-portal-auth/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/signal/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/slack/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/telegram/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/tlon/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/twitch/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/voice-call/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/whatsapp/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/zalo/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
- /package/extensions/zalouser/{clawdbot.plugin.json → openclaw.plugin.json} +0 -0
package/docs/tools/browser.md
CHANGED
|
@@ -2,29 +2,29 @@
|
|
|
2
2
|
summary: "Integrated browser control service + action commands"
|
|
3
3
|
read_when:
|
|
4
4
|
- Adding agent-controlled browser automation
|
|
5
|
-
- Debugging why
|
|
5
|
+
- Debugging why openclaw is interfering with your own Chrome
|
|
6
6
|
- Implementing browser settings + lifecycle in the macOS app
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
# Browser (
|
|
9
|
+
# Browser (openclaw-managed)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
OpenClaw can run a **dedicated Chrome/Brave/Edge/Chromium profile** that the agent controls.
|
|
12
12
|
It is isolated from your personal browser and is managed through a small local
|
|
13
13
|
control service inside the Gateway (loopback only).
|
|
14
14
|
|
|
15
15
|
Beginner view:
|
|
16
16
|
- Think of it as a **separate, agent-only browser**.
|
|
17
|
-
- The `
|
|
17
|
+
- The `openclaw` profile does **not** touch your personal browser profile.
|
|
18
18
|
- The agent can **open tabs, read pages, click, and type** in a safe lane.
|
|
19
19
|
- The default `chrome` profile uses the **system default Chromium browser** via the
|
|
20
|
-
extension relay; switch to `
|
|
20
|
+
extension relay; switch to `openclaw` for the isolated managed browser.
|
|
21
21
|
|
|
22
22
|
## What you get
|
|
23
23
|
|
|
24
|
-
- A separate browser profile named **
|
|
24
|
+
- A separate browser profile named **openclaw** (orange accent by default).
|
|
25
25
|
- Deterministic tab control (list/open/focus/close).
|
|
26
26
|
- Agent actions (click/type/drag/select), snapshots, screenshots, PDFs.
|
|
27
|
-
- Optional multi-profile support (`
|
|
27
|
+
- Optional multi-profile support (`openclaw`, `work`, `remote`, ...).
|
|
28
28
|
|
|
29
29
|
This browser is **not** your daily driver. It is a safe, isolated surface for
|
|
30
30
|
agent automation and verification.
|
|
@@ -32,26 +32,26 @@ agent automation and verification.
|
|
|
32
32
|
## Quick start
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
35
|
+
openclaw browser --browser-profile openclaw status
|
|
36
|
+
openclaw browser --browser-profile openclaw start
|
|
37
|
+
openclaw browser --browser-profile openclaw open https://example.com
|
|
38
|
+
openclaw browser --browser-profile openclaw snapshot
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
If you get “Browser disabled”, enable it in config (see below) and restart the
|
|
42
42
|
Gateway.
|
|
43
43
|
|
|
44
|
-
## Profiles: `
|
|
44
|
+
## Profiles: `openclaw` vs `chrome`
|
|
45
45
|
|
|
46
|
-
- `
|
|
47
|
-
- `chrome`: extension relay to your **system browser** (requires the
|
|
46
|
+
- `openclaw`: managed, isolated browser (no extension required).
|
|
47
|
+
- `chrome`: extension relay to your **system browser** (requires the OpenClaw
|
|
48
48
|
extension to be attached to a tab).
|
|
49
49
|
|
|
50
|
-
Set `browser.defaultProfile: "
|
|
50
|
+
Set `browser.defaultProfile: "openclaw"` if you want managed mode by default.
|
|
51
51
|
|
|
52
52
|
## Configuration
|
|
53
53
|
|
|
54
|
-
Browser settings live in `~/.
|
|
54
|
+
Browser settings live in `~/.openclaw/openclaw.json`.
|
|
55
55
|
|
|
56
56
|
```json5
|
|
57
57
|
{
|
|
@@ -67,7 +67,7 @@ Browser settings live in `~/.clawdbot/moltbot.json`.
|
|
|
67
67
|
attachOnly: false,
|
|
68
68
|
executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
|
|
69
69
|
profiles: {
|
|
70
|
-
|
|
70
|
+
openclaw: { cdpPort: 18800, color: "#FF4500" },
|
|
71
71
|
work: { cdpPort: 18801, color: "#0066CC" },
|
|
72
72
|
remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" }
|
|
73
73
|
}
|
|
@@ -78,27 +78,27 @@ Browser settings live in `~/.clawdbot/moltbot.json`.
|
|
|
78
78
|
Notes:
|
|
79
79
|
- The browser control service binds to loopback on a port derived from `gateway.port`
|
|
80
80
|
(default: `18791`, which is gateway + 2). The relay uses the next port (`18792`).
|
|
81
|
-
- If you override the Gateway port (`gateway.port` or `
|
|
81
|
+
- If you override the Gateway port (`gateway.port` or `OPENCLAW_GATEWAY_PORT`),
|
|
82
82
|
the derived browser ports shift to stay in the same “family”.
|
|
83
83
|
- `cdpUrl` defaults to the relay port when unset.
|
|
84
84
|
- `remoteCdpTimeoutMs` applies to remote (non-loopback) CDP reachability checks.
|
|
85
85
|
- `remoteCdpHandshakeTimeoutMs` applies to remote CDP WebSocket reachability checks.
|
|
86
86
|
- `attachOnly: true` means “never launch a local browser; only attach if it is already running.”
|
|
87
87
|
- `color` + per-profile `color` tint the browser UI so you can see which profile is active.
|
|
88
|
-
- Default profile is `chrome` (extension relay). Use `defaultProfile: "
|
|
88
|
+
- Default profile is `chrome` (extension relay). Use `defaultProfile: "openclaw"` for the managed browser.
|
|
89
89
|
- Auto-detect order: system default browser if Chromium-based; otherwise Chrome → Brave → Edge → Chromium → Chrome Canary.
|
|
90
|
-
- Local `
|
|
90
|
+
- Local `openclaw` profiles auto-assign `cdpPort`/`cdpUrl` — set those only for remote CDP.
|
|
91
91
|
|
|
92
92
|
## Use Brave (or another Chromium-based browser)
|
|
93
93
|
|
|
94
94
|
If your **system default** browser is Chromium-based (Chrome/Brave/Edge/etc),
|
|
95
|
-
|
|
95
|
+
OpenClaw uses it automatically. Set `browser.executablePath` to override
|
|
96
96
|
auto-detection:
|
|
97
97
|
|
|
98
98
|
CLI example:
|
|
99
99
|
|
|
100
100
|
```bash
|
|
101
|
-
|
|
101
|
+
openclaw config set browser.executablePath "/usr/bin/google-chrome"
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
```json5
|
|
@@ -129,19 +129,19 @@ moltbot config set browser.executablePath "/usr/bin/google-chrome"
|
|
|
129
129
|
- **Local control (default):** the Gateway starts the loopback control service and can launch a local browser.
|
|
130
130
|
- **Remote control (node host):** run a node host on the machine that has the browser; the Gateway proxies browser actions to it.
|
|
131
131
|
- **Remote CDP:** set `browser.profiles.<name>.cdpUrl` (or `browser.cdpUrl`) to
|
|
132
|
-
attach to a remote Chromium-based browser. In this case,
|
|
132
|
+
attach to a remote Chromium-based browser. In this case, OpenClaw will not launch a local browser.
|
|
133
133
|
|
|
134
134
|
Remote CDP URLs can include auth:
|
|
135
135
|
- Query tokens (e.g., `https://provider.example?token=<token>`)
|
|
136
136
|
- HTTP Basic auth (e.g., `https://user:pass@provider.example`)
|
|
137
137
|
|
|
138
|
-
|
|
138
|
+
OpenClaw preserves the auth when calling `/json/*` endpoints and when connecting
|
|
139
139
|
to the CDP WebSocket. Prefer environment variables or secrets managers for
|
|
140
140
|
tokens instead of committing them to config files.
|
|
141
141
|
|
|
142
142
|
## Node browser proxy (zero-config default)
|
|
143
143
|
|
|
144
|
-
If you run a **node host** on the machine that has your browser,
|
|
144
|
+
If you run a **node host** on the machine that has your browser, OpenClaw can
|
|
145
145
|
auto-route browser tool calls to that node without any extra browser config.
|
|
146
146
|
This is the default path for remote gateways.
|
|
147
147
|
|
|
@@ -155,7 +155,7 @@ Notes:
|
|
|
155
155
|
## Browserless (hosted remote CDP)
|
|
156
156
|
|
|
157
157
|
[Browserless](https://browserless.io) is a hosted Chromium service that exposes
|
|
158
|
-
CDP endpoints over HTTPS. You can point a
|
|
158
|
+
CDP endpoints over HTTPS. You can point a OpenClaw browser profile at a
|
|
159
159
|
Browserless region endpoint and authenticate with your API key.
|
|
160
160
|
|
|
161
161
|
Example:
|
|
@@ -193,13 +193,13 @@ Remote CDP tips:
|
|
|
193
193
|
|
|
194
194
|
## Profiles (multi-browser)
|
|
195
195
|
|
|
196
|
-
|
|
197
|
-
- **
|
|
196
|
+
OpenClaw supports multiple named profiles (routing configs). Profiles can be:
|
|
197
|
+
- **openclaw-managed**: a dedicated Chromium-based browser instance with its own user data directory + CDP port
|
|
198
198
|
- **remote**: an explicit CDP URL (Chromium-based browser running elsewhere)
|
|
199
199
|
- **extension relay**: your existing Chrome tab(s) via the local relay + Chrome extension
|
|
200
200
|
|
|
201
201
|
Defaults:
|
|
202
|
-
- The `
|
|
202
|
+
- The `openclaw` profile is auto-created if missing.
|
|
203
203
|
- The `chrome` profile is built-in for the Chrome extension relay (points at `http://127.0.0.1:18792` by default).
|
|
204
204
|
- Local CDP ports allocate from **18800–18899** by default.
|
|
205
205
|
- Deleting a profile moves its local data directory to Trash.
|
|
@@ -208,14 +208,14 @@ All control endpoints accept `?profile=<name>`; the CLI uses `--browser-profile`
|
|
|
208
208
|
|
|
209
209
|
## Chrome extension relay (use your existing Chrome)
|
|
210
210
|
|
|
211
|
-
|
|
211
|
+
OpenClaw can also drive **your existing Chrome tabs** (no separate “openclaw” Chrome instance) via a local CDP relay + a Chrome extension.
|
|
212
212
|
|
|
213
213
|
Full guide: [Chrome extension](/tools/chrome-extension)
|
|
214
214
|
|
|
215
215
|
Flow:
|
|
216
216
|
- The Gateway runs locally (same machine) or a node host runs on the browser machine.
|
|
217
217
|
- A local **relay server** listens at a loopback `cdpUrl` (default: `http://127.0.0.1:18792`).
|
|
218
|
-
- You click the **
|
|
218
|
+
- You click the **OpenClaw Browser Relay** extension icon on a tab to attach (it does not auto-attach).
|
|
219
219
|
- The agent controls that tab via the normal `browser` tool, by selecting the right profile.
|
|
220
220
|
|
|
221
221
|
If the Gateway runs elsewhere, run a node host on the browser machine so the Gateway can proxy browser actions.
|
|
@@ -232,21 +232,21 @@ Chrome extension relay takeover requires host browser control, so either:
|
|
|
232
232
|
1) Load the extension (dev/unpacked):
|
|
233
233
|
|
|
234
234
|
```bash
|
|
235
|
-
|
|
235
|
+
openclaw browser extension install
|
|
236
236
|
```
|
|
237
237
|
|
|
238
238
|
- Chrome → `chrome://extensions` → enable “Developer mode”
|
|
239
|
-
- “Load unpacked” → select the directory printed by `
|
|
239
|
+
- “Load unpacked” → select the directory printed by `openclaw browser extension path`
|
|
240
240
|
- Pin the extension, then click it on the tab you want to control (badge shows `ON`).
|
|
241
241
|
|
|
242
242
|
2) Use it:
|
|
243
|
-
- CLI: `
|
|
243
|
+
- CLI: `openclaw browser --browser-profile chrome tabs`
|
|
244
244
|
- Agent tool: `browser` with `profile="chrome"`
|
|
245
245
|
|
|
246
246
|
Optional: if you want a different name or relay port, create your own profile:
|
|
247
247
|
|
|
248
248
|
```bash
|
|
249
|
-
|
|
249
|
+
openclaw browser create-profile \
|
|
250
250
|
--name my-chrome \
|
|
251
251
|
--driver extension \
|
|
252
252
|
--cdp-url http://127.0.0.1:18792 \
|
|
@@ -265,7 +265,7 @@ Notes:
|
|
|
265
265
|
|
|
266
266
|
## Browser selection
|
|
267
267
|
|
|
268
|
-
When launching locally,
|
|
268
|
+
When launching locally, OpenClaw picks the first available:
|
|
269
269
|
1. Chrome
|
|
270
270
|
2. Brave
|
|
271
271
|
3. Edge
|
|
@@ -302,12 +302,12 @@ All endpoints accept `?profile=<name>`.
|
|
|
302
302
|
|
|
303
303
|
Some features (navigate/act/AI snapshot/role snapshot, element screenshots, PDF) require
|
|
304
304
|
Playwright. If Playwright isn’t installed, those endpoints return a clear 501
|
|
305
|
-
error. ARIA snapshots and basic screenshots still work for
|
|
305
|
+
error. ARIA snapshots and basic screenshots still work for openclaw-managed Chrome.
|
|
306
306
|
For the Chrome extension relay driver, ARIA snapshots and screenshots require Playwright.
|
|
307
307
|
|
|
308
308
|
If you see `Playwright is not available in this gateway build`, install the full
|
|
309
309
|
Playwright package (not `playwright-core`) and restart the gateway, or reinstall
|
|
310
|
-
|
|
310
|
+
OpenClaw with browser support.
|
|
311
311
|
|
|
312
312
|
## How it works (internal)
|
|
313
313
|
|
|
@@ -327,76 +327,76 @@ All commands accept `--browser-profile <name>` to target a specific profile.
|
|
|
327
327
|
All commands also accept `--json` for machine-readable output (stable payloads).
|
|
328
328
|
|
|
329
329
|
Basics:
|
|
330
|
-
- `
|
|
331
|
-
- `
|
|
332
|
-
- `
|
|
333
|
-
- `
|
|
334
|
-
- `
|
|
335
|
-
- `
|
|
336
|
-
- `
|
|
337
|
-
- `
|
|
338
|
-
- `
|
|
339
|
-
- `
|
|
340
|
-
- `
|
|
330
|
+
- `openclaw browser status`
|
|
331
|
+
- `openclaw browser start`
|
|
332
|
+
- `openclaw browser stop`
|
|
333
|
+
- `openclaw browser tabs`
|
|
334
|
+
- `openclaw browser tab`
|
|
335
|
+
- `openclaw browser tab new`
|
|
336
|
+
- `openclaw browser tab select 2`
|
|
337
|
+
- `openclaw browser tab close 2`
|
|
338
|
+
- `openclaw browser open https://example.com`
|
|
339
|
+
- `openclaw browser focus abcd1234`
|
|
340
|
+
- `openclaw browser close abcd1234`
|
|
341
341
|
|
|
342
342
|
Inspection:
|
|
343
|
-
- `
|
|
344
|
-
- `
|
|
345
|
-
- `
|
|
346
|
-
- `
|
|
347
|
-
- `
|
|
348
|
-
- `
|
|
349
|
-
- `
|
|
350
|
-
- `
|
|
351
|
-
- `
|
|
352
|
-
- `
|
|
353
|
-
- `
|
|
354
|
-
- `
|
|
355
|
-
- `
|
|
356
|
-
- `
|
|
357
|
-
- `
|
|
358
|
-
- `
|
|
343
|
+
- `openclaw browser screenshot`
|
|
344
|
+
- `openclaw browser screenshot --full-page`
|
|
345
|
+
- `openclaw browser screenshot --ref 12`
|
|
346
|
+
- `openclaw browser screenshot --ref e12`
|
|
347
|
+
- `openclaw browser snapshot`
|
|
348
|
+
- `openclaw browser snapshot --format aria --limit 200`
|
|
349
|
+
- `openclaw browser snapshot --interactive --compact --depth 6`
|
|
350
|
+
- `openclaw browser snapshot --efficient`
|
|
351
|
+
- `openclaw browser snapshot --labels`
|
|
352
|
+
- `openclaw browser snapshot --selector "#main" --interactive`
|
|
353
|
+
- `openclaw browser snapshot --frame "iframe#main" --interactive`
|
|
354
|
+
- `openclaw browser console --level error`
|
|
355
|
+
- `openclaw browser errors --clear`
|
|
356
|
+
- `openclaw browser requests --filter api --clear`
|
|
357
|
+
- `openclaw browser pdf`
|
|
358
|
+
- `openclaw browser responsebody "**/api" --max-chars 5000`
|
|
359
359
|
|
|
360
360
|
Actions:
|
|
361
|
-
- `
|
|
362
|
-
- `
|
|
363
|
-
- `
|
|
364
|
-
- `
|
|
365
|
-
- `
|
|
366
|
-
- `
|
|
367
|
-
- `
|
|
368
|
-
- `
|
|
369
|
-
- `
|
|
370
|
-
- `
|
|
371
|
-
- `
|
|
372
|
-
- `
|
|
373
|
-
- `
|
|
374
|
-
- `
|
|
375
|
-
- `
|
|
376
|
-
- `
|
|
377
|
-
- `
|
|
378
|
-
- `
|
|
379
|
-
- `
|
|
380
|
-
- `
|
|
381
|
-
- `
|
|
361
|
+
- `openclaw browser navigate https://example.com`
|
|
362
|
+
- `openclaw browser resize 1280 720`
|
|
363
|
+
- `openclaw browser click 12 --double`
|
|
364
|
+
- `openclaw browser click e12 --double`
|
|
365
|
+
- `openclaw browser type 23 "hello" --submit`
|
|
366
|
+
- `openclaw browser press Enter`
|
|
367
|
+
- `openclaw browser hover 44`
|
|
368
|
+
- `openclaw browser scrollintoview e12`
|
|
369
|
+
- `openclaw browser drag 10 11`
|
|
370
|
+
- `openclaw browser select 9 OptionA OptionB`
|
|
371
|
+
- `openclaw browser download e12 /tmp/report.pdf`
|
|
372
|
+
- `openclaw browser waitfordownload /tmp/report.pdf`
|
|
373
|
+
- `openclaw browser upload /tmp/file.pdf`
|
|
374
|
+
- `openclaw browser fill --fields '[{"ref":"1","type":"text","value":"Ada"}]'`
|
|
375
|
+
- `openclaw browser dialog --accept`
|
|
376
|
+
- `openclaw browser wait --text "Done"`
|
|
377
|
+
- `openclaw browser wait "#main" --url "**/dash" --load networkidle --fn "window.ready===true"`
|
|
378
|
+
- `openclaw browser evaluate --fn '(el) => el.textContent' --ref 7`
|
|
379
|
+
- `openclaw browser highlight e12`
|
|
380
|
+
- `openclaw browser trace start`
|
|
381
|
+
- `openclaw browser trace stop`
|
|
382
382
|
|
|
383
383
|
State:
|
|
384
|
-
- `
|
|
385
|
-
- `
|
|
386
|
-
- `
|
|
387
|
-
- `
|
|
388
|
-
- `
|
|
389
|
-
- `
|
|
390
|
-
- `
|
|
391
|
-
- `
|
|
392
|
-
- `
|
|
393
|
-
- `
|
|
394
|
-
- `
|
|
395
|
-
- `
|
|
396
|
-
- `
|
|
397
|
-
- `
|
|
398
|
-
- `
|
|
399
|
-
- `
|
|
384
|
+
- `openclaw browser cookies`
|
|
385
|
+
- `openclaw browser cookies set session abc123 --url "https://example.com"`
|
|
386
|
+
- `openclaw browser cookies clear`
|
|
387
|
+
- `openclaw browser storage local get`
|
|
388
|
+
- `openclaw browser storage local set theme dark`
|
|
389
|
+
- `openclaw browser storage session clear`
|
|
390
|
+
- `openclaw browser set offline on`
|
|
391
|
+
- `openclaw browser set headers --json '{"X-Debug":"1"}'`
|
|
392
|
+
- `openclaw browser set credentials user pass`
|
|
393
|
+
- `openclaw browser set credentials --clear`
|
|
394
|
+
- `openclaw browser set geo 37.7749 -122.4194 --origin "https://example.com"`
|
|
395
|
+
- `openclaw browser set geo --clear`
|
|
396
|
+
- `openclaw browser set media dark`
|
|
397
|
+
- `openclaw browser set timezone America/New_York`
|
|
398
|
+
- `openclaw browser set locale en-US`
|
|
399
|
+
- `openclaw browser set device "iPhone 14"`
|
|
400
400
|
|
|
401
401
|
Notes:
|
|
402
402
|
- `upload` and `dialog` are **arming** calls; run them before the click/press
|
|
@@ -406,7 +406,7 @@ Notes:
|
|
|
406
406
|
- `--format ai` (default when Playwright is installed): returns an AI snapshot with numeric refs (`aria-ref="<n>"`).
|
|
407
407
|
- `--format aria`: returns the accessibility tree (no refs; inspection only).
|
|
408
408
|
- `--efficient` (or `--mode efficient`): compact role snapshot preset (interactive + compact + depth + lower maxChars).
|
|
409
|
-
- Config default (tool/CLI only): set `browser.snapshotDefaults.mode: "efficient"` to use efficient snapshots when the caller does not pass a mode (see [Gateway configuration](/gateway/configuration#browser-
|
|
409
|
+
- Config default (tool/CLI only): set `browser.snapshotDefaults.mode: "efficient"` to use efficient snapshots when the caller does not pass a mode (see [Gateway configuration](/gateway/configuration#browser-openclaw-managed-browser)).
|
|
410
410
|
- Role snapshot options (`--interactive`, `--compact`, `--depth`, `--selector`) force a role-based snapshot with refs like `ref=e12`.
|
|
411
411
|
- `--frame "<iframe selector>"` scopes role snapshots to an iframe (pairs with role refs like `e12`).
|
|
412
412
|
- `--interactive` outputs a flat, easy-to-pick list of interactive elements (best for driving actions).
|
|
@@ -416,16 +416,16 @@ Notes:
|
|
|
416
416
|
|
|
417
417
|
## Snapshots and refs
|
|
418
418
|
|
|
419
|
-
|
|
419
|
+
OpenClaw supports two “snapshot” styles:
|
|
420
420
|
|
|
421
|
-
- **AI snapshot (numeric refs)**: `
|
|
421
|
+
- **AI snapshot (numeric refs)**: `openclaw browser snapshot` (default; `--format ai`)
|
|
422
422
|
- Output: a text snapshot that includes numeric refs.
|
|
423
|
-
- Actions: `
|
|
423
|
+
- Actions: `openclaw browser click 12`, `openclaw browser type 23 "hello"`.
|
|
424
424
|
- Internally, the ref is resolved via Playwright’s `aria-ref`.
|
|
425
425
|
|
|
426
|
-
- **Role snapshot (role refs like `e12`)**: `
|
|
426
|
+
- **Role snapshot (role refs like `e12`)**: `openclaw browser snapshot --interactive` (or `--compact`, `--depth`, `--selector`, `--frame`)
|
|
427
427
|
- Output: a role-based list/tree with `[ref=e12]` (and optional `[nth=1]`).
|
|
428
|
-
- Actions: `
|
|
428
|
+
- Actions: `openclaw browser click e12`, `openclaw browser highlight e12`.
|
|
429
429
|
- Internally, the ref is resolved via `getByRole(...)` (plus `nth()` for duplicates).
|
|
430
430
|
- Add `--labels` to include a viewport screenshot with overlayed `e12` labels.
|
|
431
431
|
|
|
@@ -438,18 +438,18 @@ Ref behavior:
|
|
|
438
438
|
You can wait on more than just time/text:
|
|
439
439
|
|
|
440
440
|
- Wait for URL (globs supported by Playwright):
|
|
441
|
-
- `
|
|
441
|
+
- `openclaw browser wait --url "**/dash"`
|
|
442
442
|
- Wait for load state:
|
|
443
|
-
- `
|
|
443
|
+
- `openclaw browser wait --load networkidle`
|
|
444
444
|
- Wait for a JS predicate:
|
|
445
|
-
- `
|
|
445
|
+
- `openclaw browser wait --fn "window.ready===true"`
|
|
446
446
|
- Wait for a selector to become visible:
|
|
447
|
-
- `
|
|
447
|
+
- `openclaw browser wait "#main"`
|
|
448
448
|
|
|
449
449
|
These can be combined:
|
|
450
450
|
|
|
451
451
|
```bash
|
|
452
|
-
|
|
452
|
+
openclaw browser wait "#main" \
|
|
453
453
|
--url "**/dash" \
|
|
454
454
|
--load networkidle \
|
|
455
455
|
--fn "window.ready===true" \
|
|
@@ -460,16 +460,16 @@ moltbot browser wait "#main" \
|
|
|
460
460
|
|
|
461
461
|
When an action fails (e.g. “not visible”, “strict mode violation”, “covered”):
|
|
462
462
|
|
|
463
|
-
1. `
|
|
463
|
+
1. `openclaw browser snapshot --interactive`
|
|
464
464
|
2. Use `click <ref>` / `type <ref>` (prefer role refs in interactive mode)
|
|
465
|
-
3. If it still fails: `
|
|
465
|
+
3. If it still fails: `openclaw browser highlight <ref>` to see what Playwright is targeting
|
|
466
466
|
4. If the page behaves oddly:
|
|
467
|
-
- `
|
|
468
|
-
- `
|
|
467
|
+
- `openclaw browser errors --clear`
|
|
468
|
+
- `openclaw browser requests --filter api --clear`
|
|
469
469
|
5. For deep debugging: record a trace:
|
|
470
|
-
- `
|
|
470
|
+
- `openclaw browser trace start`
|
|
471
471
|
- reproduce the issue
|
|
472
|
-
- `
|
|
472
|
+
- `openclaw browser trace stop` (prints `TRACE:<path>`)
|
|
473
473
|
|
|
474
474
|
## JSON output
|
|
475
475
|
|
|
@@ -478,10 +478,10 @@ When an action fails (e.g. “not visible”, “strict mode violation”, “co
|
|
|
478
478
|
Examples:
|
|
479
479
|
|
|
480
480
|
```bash
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
481
|
+
openclaw browser status --json
|
|
482
|
+
openclaw browser snapshot --interactive --json
|
|
483
|
+
openclaw browser requests --filter api --json
|
|
484
|
+
openclaw browser cookies --json
|
|
485
485
|
```
|
|
486
486
|
|
|
487
487
|
Role snapshots in JSON include `refs` plus a small `stats` block (lines/chars/refs/interactive) so tools can reason about payload size and density.
|
|
@@ -504,8 +504,8 @@ These are useful for “make the site behave like X” workflows:
|
|
|
504
504
|
|
|
505
505
|
## Security & privacy
|
|
506
506
|
|
|
507
|
-
- The
|
|
508
|
-
- `browser act kind=evaluate` / `
|
|
507
|
+
- The openclaw browser profile may contain logged-in sessions; treat it as sensitive.
|
|
508
|
+
- `browser act kind=evaluate` / `openclaw browser evaluate` and `wait --fn`
|
|
509
509
|
execute arbitrary JavaScript in the page context. Prompt injection can steer
|
|
510
510
|
this. Disable it with `browser.evaluateEnabled=false` if you do not need it.
|
|
511
511
|
- For logins and anti-bot notes (X/Twitter, etc.), see [Browser login + X/Twitter posting](/tools/browser-login).
|
|
@@ -527,7 +527,7 @@ How it maps:
|
|
|
527
527
|
- `browser act` uses the snapshot `ref` IDs to click/type/drag/select.
|
|
528
528
|
- `browser screenshot` captures pixels (full page or element).
|
|
529
529
|
- `browser` accepts:
|
|
530
|
-
- `profile` to choose a named browser profile (
|
|
530
|
+
- `profile` to choose a named browser profile (openclaw, chrome, or remote CDP).
|
|
531
531
|
- `target` (`sandbox` | `host` | `node`) to select where the browser lives.
|
|
532
532
|
- In sandboxed sessions, `target: "host"` requires `agents.defaults.sandbox.browser.allowHostControl=true`.
|
|
533
533
|
- If `target` is omitted: sandboxed sessions default to `sandbox`, non-sandbox sessions default to `host`.
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
summary: "Chrome extension: let
|
|
2
|
+
summary: "Chrome extension: let OpenClaw drive your existing Chrome tab"
|
|
3
3
|
read_when:
|
|
4
4
|
- You want the agent to drive an existing Chrome tab (toolbar button)
|
|
5
5
|
- You need remote Gateway + local browser automation via Tailscale
|
|
@@ -8,7 +8,7 @@ read_when:
|
|
|
8
8
|
|
|
9
9
|
# Chrome extension (browser relay)
|
|
10
10
|
|
|
11
|
-
The
|
|
11
|
+
The OpenClaw Chrome extension lets the agent control your **existing Chrome tabs** (your normal Chrome window) instead of launching a separate openclaw-managed Chrome profile.
|
|
12
12
|
|
|
13
13
|
Attach/detach happens via a **single Chrome toolbar button**.
|
|
14
14
|
|
|
@@ -19,20 +19,20 @@ There are three parts:
|
|
|
19
19
|
- **Local relay server** (loopback CDP): bridges between the control server and the extension (`http://127.0.0.1:18792` by default)
|
|
20
20
|
- **Chrome MV3 extension**: attaches to the active tab using `chrome.debugger` and pipes CDP messages to the relay
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
OpenClaw then controls the attached tab through the normal `browser` tool surface (selecting the right profile).
|
|
23
23
|
|
|
24
24
|
## Install / load (unpacked)
|
|
25
25
|
|
|
26
26
|
1) Install the extension to a stable local path:
|
|
27
27
|
|
|
28
28
|
```bash
|
|
29
|
-
|
|
29
|
+
openclaw browser extension install
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
2) Print the installed extension directory path:
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
|
|
35
|
+
openclaw browser extension path
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
3) Chrome → `chrome://extensions`
|
|
@@ -43,24 +43,24 @@ moltbot browser extension path
|
|
|
43
43
|
|
|
44
44
|
## Updates (no build step)
|
|
45
45
|
|
|
46
|
-
The extension ships inside the
|
|
46
|
+
The extension ships inside the OpenClaw release (npm package) as static files. There is no separate “build” step.
|
|
47
47
|
|
|
48
|
-
After upgrading
|
|
49
|
-
- Re-run `
|
|
48
|
+
After upgrading OpenClaw:
|
|
49
|
+
- Re-run `openclaw browser extension install` to refresh the installed files under your OpenClaw state directory.
|
|
50
50
|
- Chrome → `chrome://extensions` → click “Reload” on the extension.
|
|
51
51
|
|
|
52
52
|
## Use it (no extra config)
|
|
53
53
|
|
|
54
|
-
|
|
54
|
+
OpenClaw ships with a built-in browser profile named `chrome` that targets the extension relay on the default port.
|
|
55
55
|
|
|
56
56
|
Use it:
|
|
57
|
-
- CLI: `
|
|
57
|
+
- CLI: `openclaw browser --browser-profile chrome tabs`
|
|
58
58
|
- Agent tool: `browser` with `profile="chrome"`
|
|
59
59
|
|
|
60
60
|
If you want a different name or a different relay port, create your own profile:
|
|
61
61
|
|
|
62
62
|
```bash
|
|
63
|
-
|
|
63
|
+
openclaw browser create-profile \
|
|
64
64
|
--name my-chrome \
|
|
65
65
|
--driver extension \
|
|
66
66
|
--cdp-url http://127.0.0.1:18792 \
|
|
@@ -69,7 +69,7 @@ moltbot browser create-profile \
|
|
|
69
69
|
|
|
70
70
|
## Attach / detach (toolbar button)
|
|
71
71
|
|
|
72
|
-
- Open the tab you want
|
|
72
|
+
- Open the tab you want OpenClaw to control.
|
|
73
73
|
- Click the extension icon.
|
|
74
74
|
- Badge shows `ON` when attached.
|
|
75
75
|
- Click again to detach.
|
|
@@ -82,7 +82,7 @@ moltbot browser create-profile \
|
|
|
82
82
|
|
|
83
83
|
## Badge + common errors
|
|
84
84
|
|
|
85
|
-
- `ON`: attached;
|
|
85
|
+
- `ON`: attached; OpenClaw can drive that tab.
|
|
86
86
|
- `…`: connecting to the local relay.
|
|
87
87
|
- `!`: relay not reachable (most common: browser relay server isn’t running on this machine).
|
|
88
88
|
|
|
@@ -131,7 +131,7 @@ Options:
|
|
|
131
131
|
|
|
132
132
|
Then ensure the tool isn’t denied by tool policy, and (if needed) call `browser` with `target="host"`.
|
|
133
133
|
|
|
134
|
-
Debugging: `
|
|
134
|
+
Debugging: `openclaw sandbox explain`
|
|
135
135
|
|
|
136
136
|
## Remote access tips
|
|
137
137
|
|
|
@@ -140,9 +140,9 @@ Debugging: `moltbot sandbox explain`
|
|
|
140
140
|
|
|
141
141
|
## How “extension path” works
|
|
142
142
|
|
|
143
|
-
`
|
|
143
|
+
`openclaw browser extension path` prints the **installed** on-disk directory containing the extension files.
|
|
144
144
|
|
|
145
|
-
The CLI intentionally does **not** print a `node_modules` path. Always run `
|
|
145
|
+
The CLI intentionally does **not** print a `node_modules` path. Always run `openclaw browser extension install` first to copy the extension to a stable location under your OpenClaw state directory.
|
|
146
146
|
|
|
147
147
|
If you move or delete that install directory, Chrome will mark the extension as broken until you reload it from a valid path.
|
|
148
148
|
|
|
@@ -154,7 +154,7 @@ This is powerful and risky. Treat it like giving the model “hands on your brow
|
|
|
154
154
|
- click/type/navigate in that tab
|
|
155
155
|
- read page content
|
|
156
156
|
- access whatever the tab’s logged-in session can access
|
|
157
|
-
- **This is not isolated** like the dedicated
|
|
157
|
+
- **This is not isolated** like the dedicated openclaw-managed profile.
|
|
158
158
|
- If you attach to your daily-driver profile/tab, you’re granting access to that account state.
|
|
159
159
|
|
|
160
160
|
Recommendations:
|
package/docs/tools/clawdhub.md
CHANGED
|
@@ -8,13 +8,13 @@ read_when:
|
|
|
8
8
|
|
|
9
9
|
# ClawdHub
|
|
10
10
|
|
|
11
|
-
ClawdHub is the **public skill registry for
|
|
11
|
+
ClawdHub is the **public skill registry for OpenClaw**. It is a free service: all skills are public, open, and visible to everyone for sharing and reuse. A skill is just a folder with a `SKILL.md` file (plus supporting text files). You can browse skills in the web app or use the CLI to search, install, update, and publish skills.
|
|
12
12
|
|
|
13
13
|
Site: [clawdhub.com](https://clawdhub.com)
|
|
14
14
|
|
|
15
15
|
## Who this is for (beginner-friendly)
|
|
16
16
|
|
|
17
|
-
If you want to add new capabilities to your
|
|
17
|
+
If you want to add new capabilities to your OpenClaw agent, ClawdHub is the easiest way to find and install skills. You do not need to know how the backend works. You can:
|
|
18
18
|
|
|
19
19
|
- Search for skills by plain language.
|
|
20
20
|
- Install a skill into your workspace.
|
|
@@ -28,7 +28,7 @@ If you want to add new capabilities to your Moltbot agent, ClawdHub is the easie
|
|
|
28
28
|
- `clawdhub search "calendar"`
|
|
29
29
|
3) Install a skill:
|
|
30
30
|
- `clawdhub install <skill-slug>`
|
|
31
|
-
4) Start a new
|
|
31
|
+
4) Start a new OpenClaw session so it picks up the new skill.
|
|
32
32
|
|
|
33
33
|
## Install the CLI
|
|
34
34
|
|
|
@@ -42,9 +42,9 @@ npm i -g clawdhub
|
|
|
42
42
|
pnpm add -g clawdhub
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
-
## How it fits into
|
|
45
|
+
## How it fits into OpenClaw
|
|
46
46
|
|
|
47
|
-
By default, the CLI installs skills into `./skills` under your current working directory. If a
|
|
47
|
+
By default, the CLI installs skills into `./skills` under your current working directory. If a OpenClaw workspace is configured, `clawdhub` falls back to that workspace unless you override `--workdir` (or `CLAWDHUB_WORKDIR`). OpenClaw loads workspace skills from `<workspace>/skills` and will pick them up in the **next** session. If you already use `~/.openclaw/skills` or bundled skills, workspace skills take precedence.
|
|
48
48
|
|
|
49
49
|
For more detail on how skills are loaded, shared, and gated, see
|
|
50
50
|
[Skills](/tools/skills).
|
|
@@ -63,7 +63,7 @@ For more detail on how skills are loaded, shared, and gated, see
|
|
|
63
63
|
|
|
64
64
|
Global options (apply to all commands):
|
|
65
65
|
|
|
66
|
-
- `--workdir <dir>`: Working directory (default: current dir; falls back to
|
|
66
|
+
- `--workdir <dir>`: Working directory (default: current dir; falls back to OpenClaw workspace).
|
|
67
67
|
- `--dir <dir>`: Skills directory, relative to workdir (default: `skills`).
|
|
68
68
|
- `--site <url>`: Site base URL (browser login).
|
|
69
69
|
- `--registry <url>`: Registry API base URL.
|
|
@@ -177,7 +177,7 @@ Updates compare the local skill contents to registry versions using a content ha
|
|
|
177
177
|
|
|
178
178
|
### Sync scanning and fallback roots
|
|
179
179
|
|
|
180
|
-
`clawdhub sync` scans your current workdir first. If no skills are found, it falls back to known legacy locations (for example `~/
|
|
180
|
+
`clawdhub sync` scans your current workdir first. If no skills are found, it falls back to known legacy locations (for example `~/openclaw/skills` and `~/.openclaw/skills`). This is designed to find older skill installs without extra flags.
|
|
181
181
|
|
|
182
182
|
### Storage and lockfile
|
|
183
183
|
|