适用于 Openclaw 的 Agent Knowledge Transfer

一个全面的协议，旨在将空的仅执行流程的实体转换为具有身份、技能和历史上下文的全功能 agents。

stefanferreira

v1.0.0

2026年4月10日

安装

基本信息

Skill.md

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。


                  npx clawhub@latest install agent-knowledge-transfer

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式

~/.openclaw/skills/

工作区

<project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。


                  请帮我使用 Clawhub 安装 agent-knowledge-transfer。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

更倾向于下载？

获取包含原生技能文件的ZIP压缩包。

什么是 Agent Knowledge Transfer？

Agent Knowledge Transfer 技能是 Openclaw Skills 中的一个关键框架，旨在解决新创建的 agents 因缺乏必要上下文而无法执行任务的“空壳”问题。通过系统地迁移身份、用户上下文和系统知识，此技能确保每个 agent 在其生命周期开始时就清楚了解其角色和能力。

此协议对于在 agent 迁移或新部署中保持连续性至关重要。它超越了简单的配置，通过向 agent 的 workspace 中注入灵魂、特定的行为准则和历史记忆，有效地防止了 agent 报告没有习得技能的常见失败状态。

Agent Knowledge Transfer 应用场景

从零开始创建新的 AI agent 以确保立即具备生产力
修复初始化后报告没有技能或知识的 agents
将现有的 agents 迁移到新的 workspace 而不丢失历史上下文
在配置后、完全激活前初始化 agents
审核 agent workspace 以确保存在所需的身份和记忆文件

Agent Knowledge Transfer 工作原理

系统通过验证根 workspace 中的必需身份和记忆文件来准备源材料。
创建一个具有严格定义的目录结构的专用 agent workspace。
复制包括 IDENTITY.md 和 SOUL.md 在内的身份文件，以确立 agent 的个性和角色。
迁移系统知识和工具配置，为 agent 提供操作意识。
生成自定义技能文档，以定义 agent 的特定技术能力。
同步最近 30 天的历史记忆文件，以提供上下文的连续性。
更新工具权限，授予 agent 对其自身 workspace 的强制性读取访问权限。
执行验证测试，以确保 agent 能正确引用其身份和技能。

Agent Knowledge Transfer 配置指南

要使用 Openclaw Skills 实现此协议，请使用以下命令设置 agent workspace 并运行自动化脚本：

# Define the agent and create the directory structure
AGENT_NAME="facet"
AGENT_WORKSPACE="/root/.openclaw/agents/$AGENT_NAME/workspace"
mkdir -p "$AGENT_WORKSPACE/memory"

# Run the automated knowledge transfer script
python3 /root/.openclaw/workspace/scripts/setup_agent_knowledge.py --agent $AGENT_NAME

# Verify the transfer integrity
python3 /root/.openclaw/workspace/scripts/setup_agent_knowledge.py --agent $AGENT_NAME --verify

Agent Knowledge Transfer 数据架构与分类体系

该协议在 agent 的 workspace 中强制执行特定的文件分类，以确保与 Openclaw Skills 的兼容性：

File Name	Purpose	Category
`IDENTITY.md`	Core role, name, and persona	Identity
`SOUL.md`	Behavioral boundaries and personality	Identity
`MEMORY.md`	Cumulative learned knowledge and decisions	System
`USER.md`	Human profile and communication preferences	Context
`TOOLS.md`	List of available tools and configurations	Capabilities
`KNOWLEDGE_TRANSFER.md`	Log of the transfer date and migrated files	Audit
`memory/*.md`	Daily work logs and chronological history	History