欢迎光临
我们一直在努力

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

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机器人
  • • 宝塔面板一键部署OpenClaw,支持QQ、飞书机器人
  • • Windows 11系统OpenClaw安装教程
  • • MacOS系统安装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:工作规范(怎么干活、安全边界)
  • 2. SOUL.md:灵魂文件(性格、语气、价值观)
  • 3. USER.md:对用户的用户认知(了解老板您)
  • 4. IDENTITY.md:身份设定
  • 5. TOOLS.md:工具配置(宝玉技能、微信API等)
  • 6. HEARTBEAT.md:心跳检查(每天自动检查啥)
  • 7. MEMORY.md:长期记忆(重要事情记下来)
  • 8. 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

    https://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: 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。

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

    赞(0)
    未经允许不得转载:171主机测评 » OpenClaw新手指南:理解workspace和如何轻松安装skills
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址