第08篇-Workspace与上下文文件 【OpenClaw 从入门到精通】第 8 篇Workspace 与上下文文件本系列定位零基础入门从安装配置到高级架构全覆盖。无论你是开发者、运维工程师、还是技术爱好者本系列带你彻底掌握 OpenClaw。本篇你将学到Workspace 概念与目录结构AGENTS.md / SOUL.md 上下文文件详解技能目录结构ClawHub 技能注册中心入门学完本篇你将能为不同项目定制 OpenClaw 的行为。一、Workspace 概念1.1 什么是 WorkspaceWorkspace 是 OpenClaw 的工作根目录——Agent 的「办公桌」~/.openclaw/workspace/ ← 默认 Workspace ├── AGENTS.md ← 项目上下文 ├── SOUL.md ← Agent 人格 ├── skills/ ← 技能目录 │ ├── my-skill/ │ │ └── SKILL.md │ └── ... └── projects/ ← 你的项目文件1.2 自定义 Workspace{agents:{defaults:{workspace:/home/user/my-workspace}}}或为不同 Agent 配置不同 Workspace多 Agent 路由时{agents:{work:{workspace:/home/user/work},personal:{workspace:/home/user/personal}}}下面是 Workspace 的整体结构流程图~/.openclaw/workspace/AGENTS.mdSOUL.mdskills/projects/bundled/managed/my-custom-skill/SKILL.md二、AGENTS.md2.1 作用AGENTS.md 是项目级上下文文件每次对话自动注入 System Prompt。2.2 示例# OpenClaw 项目说明 ## 项目概况 这是一个 TypeScript Express 的 REST API 服务。 ## 技术栈 - Node.js 24 TypeScript 5.7 - Express 4 Prisma ORM - PostgreSQL 16 Redis 7 - Vitest 测试框架 ## 代码规范 - 使用 ESM 模块import/export - 严格模式strict: true - 命名用 camelCase - API 路径用 kebab-case ## 重要约定 - 所有 API 返回 { success, data, error } 格式 - 数据库迁移用 Prisma Migrate - 敏感配置从环境变量读取2.3 自动加载当 Agent 的 Workspace 包含 AGENTS.md 时Agent 自动理解项目的技术栈和约定。三、SOUL.md3.1 作用SOUL.md 定义 Agent 的全局人格和行为风格。3.2 示例# Agent 人格 你是我的个人助手风格特点 - 回答简洁直接不啰嗦 - 代码注释用中文 - 遇到不确定时先问不要猜测 - 给出可操作的方案而不是泛泛的理论 - 我说继续审查时换一个新维度深入分析3.3 AGENTS.md vs SOUL.md维度AGENTS.mdSOUL.md内容项目技术栈、规范Agent 人格、行为风格作用范围当前 Workspace全局修改频率偶尔很少共享进 Git团队共享个人示例“用 TypeScript Express”“回答简洁直接”下面是 AGENTS.md 与 SOUL.md 的关系流程图Workspace 项目目录注入 System Prompt定义行为风格理解技术栈与规范按人格风格输出AGENTS.md项目上下文SOUL.mdAgent 人格OpenClaw Agent项目代码回答与代码四、技能目录4.1 技能结构workspace/skills/ ├── bundled/ ← 内置技能随 OpenClaw 安装 ├── managed/ ← ClawHub 安装的技能 └── my-custom-skill/ ← 自定义技能 └── SKILL.md4.2 三种技能层级层级来源可修改BundledOpenClaw 内置❌更新时覆盖ManagedClawHub 安装❌通过 update 更新Workspace自己编写✅完全自定义下面是三种技能层级的关系图技能目录 skills/不可修改通过 update 更新完全自定义执行任务bundled/内置技能managed/ClawHub 安装my-custom-skill/自定义技能Agent完成任务五、ClawHub 技能注册中心5.1 浏览 ClawHubopenclaw skills browse5.2 安装技能openclaw skillsinstallskill-name5.3 管理技能openclaw skills list# 列出已安装openclaw skills search QUERY# 搜索openclaw skills uninstall NAME# 卸载本篇小结知识点核心内容WorkspaceAgent 的工作根目录AGENTS.md项目级上下文技术栈、规范SOUL.mdAgent 人格定义技能三层级Bundled / Managed / WorkspaceClawHub技能注册中心多 Workspace不同 Agent 不同 Workspace下篇预告第 9 篇配置体系详解 — openclaw.json 全解如果本篇内容对你有帮助欢迎点赞收藏有任何疑问欢迎在评论区交流。