---
title: "OpenClaw Integration"
type: source
tags: [OpenClaw, The-Agency, Integration]
date: 2026-05-03
---

## Source File
- [[Agent/agency-agents/integrations/openclaw/README.md]]

## Summary（用中文描述）
- 核心主题：The Agency Agent 资产与 OpenClaw 多智能体框架的集成方案
- 问题域：如何将 The Agency 的 .md 格式 Agent 角色转换为 OpenClaw workspace 并安装激活
- 方法/机制：① `convert.sh --tool openclaw` 将 Agent 转换为 OpenClaw workspace；② `install.sh --tool openclaw` 将 workspace 复制到 `~/.openclaw/agency-agents/`；③ `openclaw gateway restart` 重启网关使 Agent 可用
- 结论/价值：The Agency 的 Agent 资产通过 OpenClaw 的 workspace 机制获得持久记忆、n8n 工作流编排和多渠道接入能力

## Key Claims（用中文描述）
- OpenClaw agents 以 workspace 形式安装，包含 `SOUL.md`、`AGENTS.md` 和 `IDENTITY.md` 文件
- `convert.sh --tool openclaw` 脚本将 The Agency 的 Agent 配置转换为 OpenClaw workspace 格式
- `install.sh --tool openclaw` 将 workspace 复制到 `~/.openclaw/agency-agents/` 并自动注册
- 安装后 agents 通过 OpenClaw gateway 的 `agentId` 对外暴露
- Gateway 运行状态下安装后需执行 `openclaw gateway restart` 使新 Agent 生效

## Key Quotes
> "OpenClaw agents are installed as workspaces containing `SOUL.md`, `AGENTS.md`, and `IDENTITY.md` files" — OpenClaw workspace 核心组件定义
> "The installer copies each workspace into `~/.openclaw/agency-agents/` and registers it when the `openclaw` CLI is available" — 安装路径与注册机制
> "If the OpenClaw gateway is already running, restart it after installation" — Gateway 热加载要求

## Key Concepts
- [[OpenClaw-Workspace]]：OpenClaw agent 的工作空间目录，包含 SOUL.md（性格）、AGENTS.md（职责）、IDENTITY.md（身份元数据）等配置文件
- [[Workspace-Based-Agent]]：基于 workspace 目录架构的 Agent 部署模式，与 [[The-Agency]] 原生的 `.md + YAML frontmatter` 格式不同
- [[Agent-Conversion]]：通过 `convert.sh` 脚本将 The Agency Agent 转换为目标工具可识别格式的过程

## Key Entities
- [[The-Agency]]：The Agency 多智能体编码框架，提供 147+ Agent 角色
- [[OpenClaw]]：开源自主 Agent 框架，专注持久记忆与工作流编排
- [[OpenClaw-Gateway]]：OpenClaw 的网关服务，通过 `agentId` 暴露 Agent 能力

## Connections
- [[The-Agency]] ← converts_agents_to ← [[OpenClaw-Workspace]]（通过 `convert.sh`）
- [[OpenClaw-Workspace]] ← installs_to ← `~/.openclaw/agency-agents/`（通过 `install.sh`）
- [[OpenClaw]] ← serves ← [[OpenClaw-Gateway]]
- [[openclaw-integration]] ← part_of ← [[integrations-readme]]（The Agency 11 种集成之一）
- [[openclaw-integration]] ← related_to ← [[claude-code-integration]]（同为 The Agency 集成方案）

## Contradictions
- 无已知内容冲突