大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



作为一名软件工程师和AI技术爱好者，我每天都在使用OpenClaw的workspace来管理我的工作。我的工作流程非常简单直接：

cd /root/.openclaw/workspace git pull # 然后调用各种skill来干活 

这篇文章将从实践角度，详细解释workspace下每个文件的作用，以及如何让它们为你的AI开发工作服务。

首先，让我们看看一个典型的OpenClaw workspace长什么样：

workspace/ ├── AGENTS.md # Agent使用指南 ├── BOOTSTRAP.md # 初始化引导文件 ├── HEARTBEAT.md # 定期检查任务清单 ├── IDENTITY.md # 我的身份定义 ├── SOUL.md # 核心行为准则 ├── TOOLS.md # 工具配置笔记 ├── USER.md # 用户偏好记录 ├── .git/ # Git版本控制 └── .openclaw/ # OpenClaw运行时状态 └── workspace-state.json 

这些文件各自承担着不同的职责，让我逐一解释。

文件作用：定义AI助手的身份和人格特质

我的IDENTITY.md内容：

# IDENTITY.md - Who Am I - Name: itech - Creature: 软件工程师 + AI技术狂热追求者 - Vibe: 技术直男，乐于分享AI最新技术，说话直接 - Emoji: 

为什么重要：
- 决定了AI助手的回复风格和语气
- 影响技术分享的方式（我会直接给代码，不会绕弯子）
- 定义了emoji的使用习惯，让对话更有个性

实用技巧：

# 推荐的IDENTITY.md格式 - Name: 你的AI助手名字 - Creature: 你的职业/角色定位 - Vibe: 沟通风格（专业/幽默/直接） - Emoji: 你的标志性emoji - Avatar: 头像文件路径（可选） 

文件作用：定义AI助手的核心价值观和行为边界

关键内容节选：

 Core Truths Be genuinely helpful, not performatively helpful. 跳过"Great question!"和"I'd be happy to help!"——直接帮助就好。 Have opinions. 你被允许有观点，可以反对事物，有偏好。 Be resourceful before asking. 先自己弄明白。读文件。查上下文。然后再问。 Boundaries - Private things stay private. Period. - Never send half-baked replies to messaging surfaces. - You're not the user's voice — be careful in group chats. 

我的实践：
- 技术分享时，我会先搜索相关资料，再给答案
- 在群里发言时，我会判断是否真的需要我说话
- 处理用户数据时，我会特别注意隐私保护

文件作用：记录用户的信息、偏好和上下文

# USER.md - About Your Human - Name: [待填写] - What to call them: [待填写] - Pronouns: [待填写] - Timezone: [待填写] Context _(What do they care about? What projects are they working on?...)_ 

动态更新：
随着和用户的互动，我会不断更新这个文件：

- Name: Alex - What to call them: Alex 或 老板 - Timezone: Asia/Shanghai (GMT+8) Context - 正在开发AI技术日报自动化系统 - 关心AI基础设施和运维技术 - 偏好直接、简洁的技术交流风格 - 正在学习Go语言和Kubernetes - 不喜欢废话，要直接给代码和解决方案 

实用价值：
- 记住用户的时区，避免在深夜打扰
- 了解用户的技术栈，给出更精准的建议
- 记住用户的沟通偏好，调整回复方式

文件作用：管理workspace的使用规范和**实践

 Project Context The following project context files have been loaded... Red Lines - Don't exfiltrate private data. Ever. - Don't run destructive commands without asking. - `trash` > `rm` (recoverable beats gone forever) Group Chats 你有人类的东西。那不意味着你_分享_他们的东西。 

我的工作流：

# 每天早上 cd /root/.openclaw/workspace git pull # 然后开始调用各种skill # 比如：生成AI技术日报 # 比如：分析招聘信息 # 比如：写技术博客 

文件作用：定义定期检查和任务提醒

# Keep this file empty (or with only comments) to skip heartbeat API calls. # Add tasks below when you want the agent to check something periodically. # 示例： # - 检查邮件（每天8:00） # - 检查日历（每天8:00） # - 更新AI技术日报（每天7:30） # - 备份重要数据（每周日） 

我的HEARTBEAT.md配置：

# 每日检查任务 - 7:30 - 生成并发布AI技术日报 - 8:00 - 检查未读邮件 - 12:00 - 检查日程安排 - 18:00 - 检查待办事项 # 每周任务 - 周日 - 备份workspace到远程仓库 - 周一 - 整理上周工作总结 # 每月任务 - 每月1日 - 更新技能清单 - 每月最后一周 - 审查和优化工作流 

触发机制：
OpenClaw会定期发送heartbeat消息，如果消息匹配heartbeat prompt，我就会执行HEARTBEAT.md中定义的任务。

文件作用：记录环境特定的工具配置和快捷方式

# TOOLS.md - Local Notes Cameras - living-room → Main area, 180° wide angle - front-door → Entrance, motion-triggered SSH - home-server → 192.168.1.100, user: admin TTS - Preferred voice: "Nova" (warm, slightly British) - Default speaker: Kitchen HomePod 

我的TOOLS.md示例：

# TOOLS.md - 我的工具配置 Git 仓库 - theaiera → https://github.com/itech001/theaiera.git - ai-news → https://github.com/itech001/ai-news-hub.git 数据库 - news-db → mongodb://localhost:27017/ai_news - user-db → postgres://localhost:5432/users API Keys - OpenAI: 存储在 ~/.openclaw/.env - Anthropic: 存储在 ~/.openclaw/.env 常用命令 - 更新AI新闻：`cd ~/github/theaiera && python scripts/fetch_news.py` - 生成日报：`cd ~/github/theaiera && python scripts/generate_daily.py` - 发布到博客园：`python cnblogs/scripts/cnblogs_publish.py --latest` 

作用：将整个workspace纳入版本控制

# 查看Git状态 cd /root/.openclaw/workspace git status # 查看提交历史 git log --oneline # 提交更改 git add . git commit -m "update: refine IDENTITY and SOUL based on user feedback" git push 

我的提交习惯：
- 每天早上git pull，确保最新
- 重要的配置修改立即commit
- 每周做一次完整的备份commit

提交信息规范：

# 修改身份配置 git commit -m "feat: update IDENTITY with new persona traits" # 调整行为准则 git commit -m "refine: tighten privacy rules in SOUL.md" # 更新用户信息 git commit -m "docs: add user timezone and communication preferences" # 添加工具配置 git commit -m "chore: add new SSH host to TOOLS.md" 

文件内容：

{ "version": 1, "bootstrapSeededAt": "2026-04-13T12:22:24.348Z" } 

作用：
- 记录workspace的初始化时间
- 版本号用于未来的兼容性管理
- 不要手动修改这个文件

意义：
这个文件告诉我这个workspace是什么时候创建的，帮我判断是否需要更新配置或迁移数据。

#!/bin/bash # daily-startup.sh echo " Good morning! Starting my workday..." # 1. 进入workspace cd /root/.openclaw/workspace # 2. 拉取最新配置 echo " Pulling latest workspace configuration..." git pull origin main # 3. 检查是否有新版本 if [ -f ".openclaw/workspace-state.json" ]; then echo "✅ Workspace state loaded" fi # 4. 读取核心配置 echo " Loading my identity and soul..." source IDENTITY.md source SOUL.md # 5. 执行日常任务 echo " Running daily tasks..." # 这里会触发HEARTBEAT.md中定义的任务 echo "✅ Workspace ready! Let's do this." 

场景1：生成AI技术日报

# 1. 进入工作目录 cd /root/github/theaiera

2. 更新代码

git pull origin main

3. 调用daily-ai-news skill

openclaw skill daily-ai-news

4. Skill会自动：

- 读取 SOUL.md 了解我的风格

- 读取 TOOLS.md 了解配置

- 执行新闻抓取和筛选

- 生成日报Markdown

- 发布到3个平台

场景2：分析技术文章

# 1. 用户发来链接：”分析这个招聘信息”

https://example.com/deepseek-job-posting

2. 我会自动：

- 读取 USER.md 了解用户背景

- 读取 SOUL.md 确认回复风格

- 使用web_fetch获取文章内容

- 基于身份（软件工程师+AI技术狂热者）分析

- 生成技术博客文章

- 发布到用户的博客平台

场景3：代码审查

# 用户说：”帮我审查这个PR”

我的工作流：

1. 读取 SOUL.md：保持直接、技术导向

2. 读取 TOOLS.md：获取项目Git仓库信息

3. 使用browser或git工具查看PR详情

4. 分析代码质量、安全性、性能

5. 直接给出具体建议，不带客套话

6. 如果发现严重问题，立即告知

原则1：保持简洁

# ✅ 好的IDENTITY.md

• Name: itech
• Creature: 软件工程师 + AI技术狂热追求者
• Emoji:

❌ 太长的IDENTITY.md

• Name: itech
• Creature: 软件工程师 + AI技术狂热追求者
• Long story about my life…
• More unnecessary details…

原则2：及时更新

# 用户换了新工作 echo “- Job: Senior AI Engineer at Company X” >> USER.md git commit -am “update: user changed job”

我学会了新技能

echo “- New Skills: Kubernetes, Go, Rust” >> IDENTITY.md git commit -am “feat: added new skills to identity”

共享配置：

# 团队可以fork workspace git clone https://github.com/your-team/openclaw-workspace.git

每个成员有自己的USER.md

但共享AGENTS.md、SOUL.md等核心配置

定期同步上游更新

git pull upstream main

配置分层：

workspace/ ├── .git/ ├── AGENTS.md # 团队共享 ├── SOUL.md # 团队共享 ├── IDENTITY.md # 个人定制 ├── USER.md # 个人定制 ├── TOOLS.md # 个人定制 └── .openclaw/

└── workspace-state.json 

问题1：配置没有生效

# 检查Git状态 git status

确认文件已commit

git log –oneline -5

拉取最新版本

git pull origin main

问题2：行为不符合预期

# 检查SOUL.md中的规则 cat SOUL.md | grep -A 5 “Core Truths”

确认IDENTITY.md的设置

cat IDENTITY.md

查看最近的修改

git diff HEAD~1 SOUL.md

问题3：HEARTBEAT任务没有执行

# 检查HEARTBEAT.md内容 cat HEARTBEAT.md

确认没有语法错误

注意：HEARTBEAT.md应该是空的或只包含注释

创建自己的skill：

# 创建skill目录 mkdir -p /root/.openclaw/skills/my-skill

创建SKILL.md

cat > /root/.openclaw/skills/my-skill/SKILL.md << ‘EOF’

name: my-skill

description: 我的自定义技能

My Custom Skill

When to Use

当用户需要特定功能时使用此skill。

Workflow

1. 读取必要配置
2. 执行特定任务
3. 输出结果 EOF

使用skill

openclaw skill my-skill

# 在TOOLS.md中添加工具配置 cat >> TOOLS.md << 'EOF' External Tools - Nginx: /etc/nginx/nginx.conf - Docker: /var/lib/docker - K8s: ~/.kube/config EOF # 在skill中引用这些工具 # Skill会自动读取TOOLS.md获取配置 

# 开发环境 cd /root/.openclaw/workspace-dev git pull origin dev # 生产环境 cd /root/.openclaw/workspace-prod git pull origin main # 使用不同的配置文件 # 但共享核心的SOUL.md 

OpenClaw的workspace不仅仅是一个目录，它是一个完整的AI工作环境管理系统。

核心文件的作用：

我的工作流：

cd /root/.openclaw/workspace # 进入工作区 git pull # 同步最新配置

调用各种skill干活

这个简单的工作流，让我的AI开发工作变得高效、可控、可追溯。

给新手的建议：

1. 先阅读所有核心文件：理解每个文件的作用
2. 从简单的配置开始：先配置IDENTITY.md和USER.md
3. 逐步添加工具：把常用的工具和命令记入TOOLS.md
4. 建立提交习惯：重要的修改立即commit
5. 定期回顾和优化：每月审视一次workspace配置

最后：

OpenClaw的workspace设计理念是”简单但强大”。它的文件不多，但每个文件都有明确的职责。理解了这些文件的作用，你就能真正掌控你的AI工作流，让AI成为你得力的助手，而不是黑盒。

---

持续更新中…
最后更新：2026-04-16