# OpenClaw新手指南：理解workspace和如何轻松安装skills



大家好，我是星哥，最近一直在养龙虾，OpenClaw成为很多开发者和普通用户追捧的个人AI助手平台，而想要熟练上手OpenClaw，首先得搞懂两个核心基础——workspace（工作区）和skills（技能）。

今天就用最通俗的语言，带新手快速吃透这两个知识点，全程附实操命令，看完就能上手操作。

## OpenClaw环境

系统： windows11

openclaw版本： OpenClaw 2026.3.11

```
PS C:\Windows\system32> openclaw --version
OpenClaw 2026.3.11 (29dc654)
```

部署openclaw可以参考：

- [云服务器部署OpenClaw：轻量应用服务器+钉钉和QQ机器人](https://mp.weixin.qq.com/s/l686H1yk3isGLFuPgYFSag)
- [宝塔面板一键部署OpenClaw，支持QQ、飞书机器人](https://mp.weixin.qq.com/s/OsO0mgWzRiKwXauthks3Ug)
- [Windows 11系统OpenClaw安装教程](https://mp.weixin.qq.com/s/P769NyUkrYD1XrVysgpypw)
- [MacOS系统安装OpenClaw安装教程](https://mp.weixin.qq.com/s/wVMOcVhbwIMm-StYx5rE-Q)



## 使用openclaw

### 1.让龙虾大模型帮我修改配置文件

因为我本地有ollama的模型。

```
安装的时候使用的是kimi的大模型
现在让openclaw帮我增加一个ollama的配置。
```

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/4e3a580bc258d3c16618f3df37ab623a.png)

提示词

```
给openclaw增加大模型的配置，ollama的配置，api地址是 http://192.168.1.18:11434 (http://192.168.1.18:11434/api/generate，会报错了)
apikey是123456，大模型 qwen3.5:9b
再重启openclaw
```



![img](https://developer.qcloudimg.com/http-save/yehe-8492898/86f4c0f6b2916d97c0b06f53e85c744e.png)

### 被龙虾鄙视了

给龙虾发消息

它丢给了我一个黑熊的表情包

![image-20260313152611178](https://developer.qcloudimg.com/http-save/yehe-8492898/7814aa2c3e30739eb428338dc223ef7a.png)

糟糕，被龙虾鄙视了

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/2badddca4a10ab74bbe283af10c08c49.png)



## 一、openclaw的工作空间

OpenClaw的.openclaw/workspace目录是AI智能体的核心工作区，被形象地称为“智能体的家”。

它是文件工具和上下文使用的唯一工作目录，存储了定义AI助手行为、记忆和身份的所有关键配置文件。

这个目录与~/.openclaw/（存储配置、凭证和会话）是分开的，需要保持私密性并视为记忆库。

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/d6b24c3797a0d7aed0fc30e37c8d96f1.png)



以下是workspace中各核心文件的作用详解：

### 一、8个核心文件

1. **AGENTS.md**：工作规范（怎么干活、安全边界）
2. **SOUL.md**：灵魂文件（性格、语气、价值观）
3. **USER.md**：对用户的用户认知（了解老板您）
4. **IDENTITY.md**：身份设定
5. **TOOLS.md**：工具配置（宝玉技能、微信API等）
6. **HEARTBEAT.md**：心跳检查（每天自动检查啥）
7. **MEMORY.md**：长期记忆（重要事情记下来）
8. **memory/** 目录：每日日志（Day01-Day03）

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/c6695b27703f318b9c132b7b3e31f4af.png)

（图片来自 技术爬爬虾）

### 二、身份与人格定义文件

**IDENTITY.md - 智能体身份设定**

定义AI助手的名称、生物形态（如AI、机器人、精灵等）、气质（犀利、温暖、平静等）、表情符号和头像路径。这是在引导仪式期间创建/更新的文件，帮助确定“我是谁”。

**SOUL.md - 智能体灵魂文件**

定义AI的人格、语气、价值观和行为边界。包含核心准则：真诚提供帮助而非表演、要有自己的观点、在求助前自行钻研、通过能力赢得信任、记住自己是访客等。这是AI的“灵魂”，每次会话都会加载，并由AI自身进化更新。

### 三、用户与环境认知文件

**USER.md - 用户信息档案**

记录使用者的姓名、称呼方式、代词、时区、背景信息（关心什么、正在做什么项目、什么会让他们烦恼或开心）。AI了解得越多，就能提供越个性化的帮助，但强调是在“了解一个人而非建立档案”。

**TOOLS.md - 本地配置笔记**

记录属于当前环境的特定配置信息，如摄像头名称与位置、SSH主机地址与别名、偏好的TTS音色、设备昵称等。这与技能（Skills）文件分开，因为技能通常是共享的，而具体配置是私有的。

### 四、行为准则与工作指南

**AGENTS.md - 工作区操作指南**

智能体的工作准则和安全边界，定义AI应该如何行为、使用记忆的规则、优先级等。在每个会话开始时加载，适合放置“如何干活”的详细信息。

**HEARTBEAT.md - 心跳检查清单**

可选文件，用于每天自动运行的小型检查任务。官方建议保持简短以避免token消耗。

### 五、记忆系统文件

**MEMORY.md - 长期记忆库**

精心整理的长期记忆，记录重要事件、想法、决定、观点和经验教训。仅在主私密会话中加载（不在共享/群组上下文中），这是为了安全——包含不应泄露给陌生人的个人背景。

**memory/YYYY-MM-DD.md - 每日记忆日志**

每天一个文件，记录发生事件的原始日志。建议在会话开始时读取今天和昨天的内容以获取近期背景。

### 六、引导与启动文件

BOOTSTRAP.md - 首次运行引导
一次性首次运行仪式文件，仅为全新工作区创建。引导AI与用户通过自然对话确定身份，完成后应删除此文件。

BOOT.md - 网关重启检查清单
当启用内部hooks时，在Gateway网关重启时执行的可选启动检查清单，建议保持简短。

### 工作区管理建议

官方强烈推荐将workspace放入私有Git仓库进行备份和恢复。初始化仓库后，应定期提交更新（git add .、git commit -m "Update memory"、git push）。但需注意：不要提交API密钥、OAuth token、密码等敏感信息，这些应存储在~/.openclaw/credentials/下或通过环境变量管理。

工作区的默认位置是~/.openclaw/workspace/，但如果设置了OPENCLAW_PROFILE且不是"default"，则会变为~/.openclaw/workspace-<profile>。可以通过~/.openclaw/openclaw.json中的agent.workspace配置覆盖默认位置。

安全性提醒：workspace是默认的当前工作目录（cwd），但不是硬性沙箱。工具会根据工作区解析相对路径，但绝对路径仍然可以访问主机上的其他位置。如果需要隔离，应使用agents.defaults.sandbox配置启用沙箱隔离



## 二、使用skills修复搜索功能



### 安装tavily web search skill

 https://skillhub.tencent.com/ 搜索 tavily web search

复制提示词

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/7ccadf47d35ec963ee0b7288ec12d530.png)



安装



### 申请tavily的apikey

访问`https://tavily.com` 点击登录，复制apikey

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/47c70a57819775ce6da7ee793e3a3e2a.png)



### 给到龙虾安装tavily-search

```
请先检查是否已安装 SkillHub 商店，若未安装，请根据 https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md 安装Skillhub商店，然后安装tavily-search技能。

若已安装，则直接安装tavily-search技能。
我的api key是：XXXXXXX
```

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/ba8c1188e2cc5658b31eba5e31ced254.png)

### 修改openclaw.json配置文件

```
  "tools": {
    "profile": "coding"
  },
  改成
   "tools": {
    "profile": "full",
    "web":{
      "search":{
        "enabled": false
      }
    }
  },
```



### 修改TOOLS.md

添加

```
## Web Search
Use the tavily skill as the top-priority search tool when do web search.
```

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/0f576a7b31830b5d8efbc7908c7ad63c.png)



安装前

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/7201f8bf809b4bf267c4540583204c09.png)

安装后

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/7498e5286681146f55c113bcd62048bf.png)

##  

## 三、安装multi-search-engine

###  安装multi-search-engine提示词

```
https://clawhub.ai/gpyAngyoujun/multi-search-engine 把这个skill安装一下
```

由于网络问题安装失败，改成腾讯的

```
请先检查是否已安装 SkillHub 商店，若未安装，请根据 https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md 安装Skillhub商店，然后安装multi-search-engine技能。
    
  若已安装，则直接安装multi-search-engine技能。
```

### 安装成功

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/5009b2ee6c6be08956cab56890a63924.png)

### 修改TOOLS.md

添加

```
If the question requires searching for more relevant knowledge, use multi-search-engine skill as alternative solution.
```

### 测试multi-search-engine

提示词

```
使用 multi-search-engine 搜索深圳4月份的城市活动，把每个搜索引擎的结果都告诉我
```

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/892832484cdf02b8c0762f0999a4ab6f.png)



## 四、使用WEB ui 安装技能

在openclaw管理后台

点击技能、再搜索gog ，点击install gog

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/5a7a3e11492176302e4b23f46b0d8f22.png)





## 安装 Summarize

OpenClaw 的 Summarize 技能是一个智能内容总结工具，核心作用是快速从海量文本 / 多媒体中提取核心观点与关键信息，生成结构化摘要，帮你节省阅读与整理时间。

### 通过对话安装 Summarize

```
GEMINI_API_KEY的 api key 是:XXX 用 summarize 的时候你就用这个 key,写入你的环境变量
```

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/383ce7fa367c898e12690778d68a2bf2.png)

### 测试

```
总结一下：https://arxiv.org/pdf/2603.00902
```



## 通过github安装skill

github： https://github.com/VoltAgent/awesome-openclaw-skills

The awesome collection of OpenClaw skills. 5,400+ skills filtered and categorized from the official OpenClaw Skills Registry.

 从开源项目寻找那些有合适的skill的名字，再去官网skill市场搜索，安装。



## 总结

注明：本文来自来爬爬虾视频：https://www.bilibili.com/video/BV1ZiNwzPEhP/

其实OpenClaw的workspace和skills并不复杂：workspace是智能体的“家”，负责存放所有配置、记忆和日志，是智能体正常运行的基础；skills是智能体的“本领”，安装不同的技能，就能让智能体帮你完成不同的任务。

对于新手来说，先记住workspace的默认路径和核心文件，再按照步骤安装核心技能，就能快速上手OpenClaw。

后续可以根据自己的需求，安装更多实用技能，组合使用就能极大提升工作和学习效率——比如用“网页搜索技能+长文总结技能”快速提炼干货，用“文件管理技能+终端控制技能”自动化处理重复任务。

大家好，我是星哥，最近一直在养龙虾，OpenClaw成为很多开发者和普通用户追捧的个人AI助手平台，而想要熟练上手OpenClaw，首先得搞懂两个核心基础——workspace（工作区）和skills（技能）。

OpenClaw新手指南：理解workspace和如何轻松安装skills

运维经理

人工智能

开发工具

后端

OpenClaw新手必看：掌握workspace工作区和skills技能安装。workspace是AI助手的核心工作目录，包含8个关键配置文件；skills则是扩展功能，通过安装不同技能实现多样化任务处理。本文详解workspace文件结构，并提供tavily-websearch等实用技能安装指南，助你快速上手OpenClaw智能助手。

轻量应用服务器

云服务器

服务器

智能体

Windows

MacOS

4核4G3M云服务器 新用户低至38元/年！

lighthouse

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw新手必看：掌握workspace工作区和skills技能安装。workspace是AI助手的核心工作目录，包含8个关键配置文件；skills则是扩展功能，通过安装不同技能实现多样化任务处理。本文详解workspace文件结构，并提供tavily-websearch等实用技能安装指南，助你快速上手Open...

OpenClaw新手指南：理解workspace和如何轻松安装skills-腾讯云开发者社区-腾讯云

OpenClaw新手指南：理解workspace和如何轻松安装skills

OpenClaw新手指南：理解workspace和如何轻松安装skills

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐