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

星哥玩云
0 阅读7分钟

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

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

因为我本地有ollama的模型。


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

img

提示词


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

img

被龙虾鄙视了

给龙虾发消息

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

image-20260313152611178

糟糕，被龙虾鄙视了

img

一、openclaw的工作空间

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

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

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

img

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

一、8个核心文件

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

img

（图片来自 技术爬爬虾）

二、身份与人格定义文件

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-。可以通过~/.openclaw/openclaw.json中的agent.workspace配置覆盖默认位置。

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

二、使用skills修复搜索功能

安装tavily web search skill

skillhub.tencent.com/ 搜索 tavily web search

复制提示词

img

安装

申请tavily的apikey

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

img

给到龙虾安装tavily-search


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

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

img

修改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

安装前

img

安装后

img

三、安装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

修改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

四、使用WEB ui 安装技能

在openclaw管理后台

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

img

安装 Summarize

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

通过对话安装 Summarize


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

img

测试


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

通过github安装skill

github： github.com/VoltAgent/a…

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

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

总结

注明：本文来自来爬爬虾视频：www.bilibili.com/video/BV1Zi…

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

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

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

avatar
文章
阅读
粉丝