How gilbertoffice007-lab/my-openclaw works
OpenClaw is a self-hosted personal AI assistant: a user sends a request through a supported messaging channel or companion app, the Gateway coordinates assistant work, and the response is returned through an available surface. The repository also supports agent context and memory, browser automation, live Canvas, voice, and native device capabilities. The README establishes the product workflow and capabilities; source excerpts and the index show selected internal links, so unverified runtime connections are dashed or omitted.
Main entry points: embedded-agent-runner Agent runtime · gateway Gateway · context-engine-lifecycle.ts Context lifecycle · extensions Messaging channels
Components 26
User surfaces
- Messaging channels
extensions - Control UI
ui/src/ui/storage.ts - Theme preferences
ui/src/ui/storage.ts - Custom themes
ui/src/ui/custom-theme.ts
Gateway and channels
- Gateway
src/gateway - Reply pipeline
src/channels/message/reply-pipeline.ts - Device pairing
src/infra/device-pairing.ts
Agent runtime
- Agent runtime
src/agents/embedded-agent-runner - Context lifecycle
src/agents/harness/context-engine-lifecycle.ts - Context engine
src/context-engine/registry.ts - Context maintenance
src/agents/embedded-agent-runner/context-engine-maintenance.ts - Credential storage
src/agents/sessions/auth-storage.ts - Prompt helpers
src/agents/embedded-agent-runner/run/attempt.prompt-helpers.ts - Session write lock
src/agents/session-write-lock.ts
Assistant capabilities
- Memory search
extensions/memory-core/src/memory - Browser automation
extensions/browser/src/browser - Live Canvas
extensions/canvas/src/host/server.ts - Voice interaction
src/talk/talk-session-controller.ts - Browser runtime context
extensions/browser/src/browser/server-context.ts - Chrome control
extensions/browser/src/browser/chrome.ts - Chrome MCP tabs
extensions/browser/src/browser/chrome-mcp.ts
Companion apps
- Android companion
apps/android/app/src/main/java/ai/openclaw/app - iOS companion
apps/ios/Sources - macOS companion
apps/macos/Sources/OpenClaw - Watch companion
apps/ios/WatchExtension/Sources
Other components
- User
Connections 26
- User → Messaging channels: sends request
README.md - Messaging channels → Gateway: delivers message
- User → Control UI: uses
- Control UI → Gateway: controls
- Gateway → Agent runtime: dispatches work
- Agent runtime → Reply pipeline: prepares response
- Reply pipeline → Messaging channels: delivers reply
- Agent runtime → Context lifecycle: uses lifecycle
src/agents/harness/context-engine-lifecycle.ts - Context lifecycle → Context engine: assembles context
src/agents/harness/context-engine-lifecycle.ts - Context lifecycle → Context maintenance: runs maintenance
src/agents/harness/context-engine-lifecycle.ts - Context maintenance → Context engine: resolves owner
src/agents/embedded-agent-runner/context-engine-maintenance.ts - Agent runtime → Memory search: uses memory
- Agent runtime → Browser automation: uses automation
- Browser runtime context → Chrome control: checks reachability
extensions/browser/src/browser/server-context.ts - Browser runtime context → Chrome MCP tabs: lists tabs
extensions/browser/src/browser/server-context.ts - Agent runtime → Live Canvas: controls Canvas
README.md - User → Voice interaction: speaks and listens
README.md - Agent runtime → Credential storage: uses credentials
- User → Android companion: uses companion
README.md - User → iOS companion: uses companion
README.md - User → macOS companion: uses companion
README.md - iOS companion → Watch companion: pairs with
- Theme preferences → Custom themes: parses theme
ui/src/ui/storage.ts - Agent runtime → Prompt helpers: uses prompts
- Agent runtime → Session write lock: serializes writes
- Gateway → Device pairing: authorizes devices
src/gateway/server.auth.control-ui.suite.ts