A2A Delegation Setup
Use this skill when @aramisfa/openclaw-a2a-outbound still needs installation, enablement, configuration, verification, updating, or troubleshooting on the OpenClaw Gateway host.
Do not use this skill for routine runtime delegation after setup is complete. Once the plugin is ready, switch to the bundled remote-agent skill and the remote_agent tool.
Interaction rules
- - Ask before any install, update, restart, or config edit.
- Run commands on the Gateway host that owns the OpenClaw config and plugin installation.
- If shell access is unavailable, provide the exact commands and expected verification steps instead of claiming success.
Use when
- - Install
@aramisfa/openclaw-a2a-outbound for the first time. - Enable
openclaw-a2a-outbound in OpenClaw. - Configure targets or policy settings.
- Verify whether the plugin is actually ready for runtime delegation.
- Update or troubleshoot an existing setup.
Do not use when
- - The plugin is already installed, enabled, configured, and verified, and the task is routine runtime delegation.
Collect or confirm first
- - The target alias to configure.
- The target base URL.
- Whether this target should be the default target.
- Whether direct URL overrides should be allowed through
plugins.entries.openclaw-a2a-outbound.config.policy.allowTargetUrlOverride.
Inspect current state
Run these first:
CODEBLOCK0
The bundled runtime skill is only eligible when both plugins.entries.openclaw-a2a-outbound.enabled and plugins.entries.openclaw-a2a-outbound.config.enabled are true.
Install or update
For a first install:
CODEBLOCK1
For an update:
CODEBLOCK2
Then ensure the plugin entry itself is enabled:
CODEBLOCK3
Configure readiness
Use openclaw config set ... --strict-json whenever you write booleans or arrays into the plugin config.
Required readiness paths:
- - INLINECODE9
- INLINECODE10
- INLINECODE11
Example commands:
CODEBLOCK4
Replace the example alias, base URL, default-target choice, and URL-override policy with the values you confirmed earlier.
Activate and verify
Use a Gateway restart as the deterministic activation step:
CODEBLOCK5
After the restart, start a new session and verify with:
CODEBLOCK6
If list_targets succeeds and the two enable flags remain true, setup is complete.
Handoff
After setup is complete, stop using this setup skill for normal delegation work. Use the bundled remote-agent skill and the remote_agent tool instead.
A2A 委派设置
当 @aramisfa/openclaw-a2a-outbound 在 OpenClaw 网关主机上仍需安装、启用、配置、验证、更新或故障排除时,使用此技能。
设置完成后,请勿将此技能用于常规运行时委派。插件就绪后,请切换到捆绑的 remote-agent 技能和 remote_agent 工具。
交互规则
- - 在进行任何安装、更新、重启或配置编辑前先询问。
- 在拥有 OpenClaw 配置和插件安装的网关主机上运行命令。
- 如果无法使用 Shell 访问,请提供确切的命令和预期验证步骤,而不是声称成功。
适用场景
- - 首次安装 @aramisfa/openclaw-a2a-outbound。
- 在 OpenClaw 中启用 openclaw-a2a-outbound。
- 配置目标或策略设置。
- 验证插件是否真正准备好进行运行时委派。
- 更新或排查现有设置的问题。
不适用场景
- - 插件已安装、启用、配置和验证,且任务为常规运行时委派。
首先收集或确认
- - 要配置的目标别名。
- 目标基础 URL。
- 该目标是否应为默认目标。
- 是否应通过 plugins.entries.openclaw-a2a-outbound.config.policy.allowTargetUrlOverride 允许直接 URL 覆盖。
检查当前状态
首先运行以下命令:
bash
openclaw plugins list
openclaw plugins info openclaw-a2a-outbound
openclaw config get plugins.entries.openclaw-a2a-outbound
openclaw config validate
仅当 plugins.entries.openclaw-a2a-outbound.enabled 和 plugins.entries.openclaw-a2a-outbound.config.enabled 均为 true 时,捆绑的运行时技能才符合条件。
安装或更新
首次安装:
bash
openclaw plugins install @aramisfa/openclaw-a2a-outbound --pin
更新:
bash
openclaw plugins update openclaw-a2a-outbound
然后确保插件条目本身已启用:
bash
openclaw plugins enable openclaw-a2a-outbound
配置就绪状态
在将布尔值或数组写入插件配置时,请使用 openclaw config set ... --strict-json。
必需的配置路径:
- - plugins.entries.openclaw-a2a-outbound.config.enabled
- plugins.entries.openclaw-a2a-outbound.config.targets
- plugins.entries.openclaw-a2a-outbound.config.policy.allowTargetUrlOverride
示例命令:
bash
openclaw config set plugins.entries.openclaw-a2a-outbound.config.enabled --strict-json true
openclaw config set plugins.entries.openclaw-a2a-outbound.config.targets --strict-json [{alias:support,baseUrl:https://support.example,default:true}]
openclaw config set plugins.entries.openclaw-a2a-outbound.config.policy.allowTargetUrlOverride --strict-json false
openclaw config validate
将示例别名、基础 URL、默认目标选择和 URL 覆盖策略替换为您之前确认的值。
激活和验证
使用网关重启作为确定性激活步骤:
bash
openclaw gateway restart
重启后,启动新会话并使用以下命令验证:
text
remoteagent { action: listtargets }
如果 list_targets 成功且两个启用标志保持为 true,则设置完成。
交接
设置完成后,停止使用此设置技能进行常规委派工作。请改用捆绑的 remote-agent 技能和 remote_agent 工具。