Skip to content

feat(agent): add remote agent support with OpenClaw protocol#1739

Merged
IceyLiu merged 6 commits intoiOfficeAI:mainfrom
TCP404:feat/remote-agent
Mar 27, 2026
Merged

feat(agent): add remote agent support with OpenClaw protocol#1739
IceyLiu merged 6 commits intoiOfficeAI:mainfrom
TCP404:feat/remote-agent

Conversation

@TCP404
Copy link
Copy Markdown
Collaborator

@TCP404 TCP404 commented Mar 26, 2026 •
edited
Loading

Summary

  • Add remote agent support with protocol-agnostic architecture (OpenClaw as first implementation)
  • Per-agent Ed25519 device identity with encrypted credential storage, full pairing approval flow
  • Settings UI for CRUD operations, conversation lifecycle (create, send, receive, resume sessions)

Changes

Core Architecture

  • New RemoteAgentCore and RemoteAgentManager (runs in-process, no worker fork via enableFork flag)
  • OpenClawGatewayConnection supports external device identity injection (isolated from local ~/.openclaw/identity/)
  • Protocol-specific connection handling delegated from RemoteAgentCore

Database

  • Migration v17: 4 new columns on remote_agents (device_id, device_public_key, device_private_key, device_token)
  • Encrypted storage for sensitive fields using existing credentialCrypto
  • Full CRUD with camelCase ↔ snake_case mapping in IPC bridge

IPC & Bridge

  • remoteAgent IPC namespace: list, get, create, update, delete, testConnection, handshake
  • Handshake handler with pairing detection (structured error + regex fallback)
  • Session key persistence across conversation resumption

Settings UI

  • Remote agent management panel with add/edit/delete
  • OpenClaw pairing approval flow: 5s polling, 5min timeout, cancel support
  • Agent name display in conversation send box

i18n

  • All 6 locales updated (en-US, zh-CN, zh-TW, ja-JP, ko-KR, tr-TR)

Related Issue

Closes #1738

Test Plan

  • Add remote agent in Settings → verify handshake executes and DB stores encrypted device keys
  • Test pairing approval flow with unapproved device → verify polling UI and timeout
  • Test already-paired device → verify immediate connection success
  • Edit remote agent config (name, URL, avatar) → verify changes persist
  • Create conversation with remote agent → verify messages send/receive correctly
  • Resume session (close and reopen conversation) → verify session key continuity
  • Verify local OpenClaw gateway sessions unaffected (regression)
  • Verify ~/.openclaw/identity/device.json not modified by remote agent operations

feat(agent): add remote agent support with OpenClaw protocol
008dde6 
Implement full remote agent lifecycle: device identity generation,
OpenClaw Gateway handshake with pairing approval flow (5s poll, 5min
timeout), encrypted credential storage, and per-agent Ed25519 keypairs
stored in database instead of shared ~/.openclaw/identity/.
@sentry
Copy link
Copy Markdown

sentry bot commented Mar 26, 2026 •
edited
Loading

Codecov Report

❌ Patch coverage is 57.66497% with 417 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
...s/settings/AgentSettings/RemoteAgentManagement.tsx 26.45% 107 Missing and 7 partials ⚠️
...es/conversation/platforms/remote/RemoteSendBox.tsx 55.13% 66 Missing and 17 partials ⚠️
src/process/agent/remote/RemoteAgentCore.ts 79.86% 31 Missing and 27 partials ⚠️
src/process/services/database/index.ts 0.00% 53 Missing ⚠️
src/process/services/database/migrations.ts 6.66% 28 Missing ⚠️
...rocess/agent/openclaw/OpenClawGatewayConnection.ts 0.00% 18 Missing ⚠️
src/process/bridge/remoteAgentBridge.ts 86.20% 7 Missing and 5 partials ⚠️
src/process/task/RemoteAgentManager.ts 90.80% 1 Missing and 7 partials ⚠️
...pages/conversation/platforms/remote/RemoteChat.tsx 0.00% 6 Missing ⚠️
...renderer/pages/guid/hooks/useGuidAgentSelection.ts 40.00% 3 Missing and 3 partials ⚠️
... and 14 more

📢 Thoughts on this report? Let us know!

huangpeirong added 3 commits March 26, 2026 15:59
fix(agent): add missing remoteAgent mock and regenerate i18n types
17f672f
test(agent): add unit tests for remote agent core, manager, and bridge
3ba607c
test(agent): increase remote agent test coverage for PR iOfficeAI#1739
43ba2dd 
Add comprehensive tests covering:
- RemoteAgentCore: connection errors, history fallback, tool events, session resolution, message routing
- remoteAgentBridge: handshake scenarios (ok, pending, error, timeout, regex fallback)
- RemoteAgentManagement: DOM tests for settings UI (render, agent list, empty state)
- RemoteSendBox: DOM tests for chat send box (stream events, initial message, stop)
- useGuidSend: remote agent conversation creation path
- usePresetAssistantInfo: remote agent info resolution
TCP404 added a commit that referenced this pull request Mar 26, 2026
@TCP404
test(agent): increase remote agent test coverage for PR #1739
bb9a98a 
Add comprehensive tests covering:
- RemoteAgentCore: connection errors, history fallback, tool events, session resolution, message routing
- remoteAgentBridge: handshake scenarios (ok, pending, error, timeout, regex fallback)
- RemoteAgentManagement: DOM tests for settings UI (render, agent list, empty state)
- RemoteSendBox: DOM tests for chat send box (stream events, initial message, stop)
- useGuidSend: remote agent conversation creation path
- usePresetAssistantInfo: remote agent info resolution
@piorpua piorpua added the bot:reviewing Review in progress (mutex) label Mar 27, 2026
@piorpua piorpua added bot:reviewing Review in progress (mutex) and removed bot:reviewing Review in progress (mutex) labels Mar 27, 2026
@piorpua piorpua added bot:reviewing Review in progress (mutex) and removed bot:reviewing Review in progress (mutex) labels Mar 27, 2026
@IceyLiu IceyLiu merged commit 4599785 into iOfficeAI:main Mar 27, 2026
14 checks passed
@TCP404 TCP404 mentioned this pull request Mar 27, 2026
Merged
IceyLiu added a commit that referenced this pull request Mar 27, 2026
@IceyLiu
Merge pull request #1807 from iOfficeAI/fix/remote-agent-ui
0e5a8cf 
fix(agent): apply missing remote agent UI updates from #1739
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Feature]: Remote agent support (OpenClaw as first protocol)

3 participants

@TCP404 @piorpua @IceyLiu