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的配置。
提示词
给openclaw增加大模型的配置，ollama的配置，api地址是 http://192.168.1.18:11434 (http://192.168.1.18:11434/api/generate，会报错了)
apikey是123456，大模型 qwen3.5:9b
再重启openclaw
被龙虾鄙视了
给龙虾发消息
它丢给了我一个黑熊的表情包
糟糕，被龙虾鄙视了
一、openclaw的工作空间
OpenClaw的.openclaw/workspace目录是AI智能体的核心工作区，被形象地称为“智能体的家”。
它是文件工具和上下文使用的唯一工作目录，存储了定义AI助手行为、记忆和身份的所有关键配置文件。
这个目录与~/.openclaw/（存储配置、凭证和会话）是分开的，需要保持私密性并视为记忆库。
以下是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）
（图片来自 技术爬爬虾）
二、身份与人格定义文件
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
复制提示词
安装
申请tavily的apikey
访问https://tavily.com 点击登录，复制apikey
给到龙虾安装tavily-search
请先检查是否已安装 SkillHub 商店，若未安装，请根据 https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md 安装Skillhub商店，然后安装tavily-search技能。
若已安装，则直接安装tavily-search技能。
我的api key是：XXXXXXX
修改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.
安装前
安装后
三、安装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技能。
安装成功
修改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月份的城市活动，把每个搜索引擎的结果都告诉我
四、使用WEB ui 安装技能
在openclaw管理后台
点击技能、再搜索gog ，点击install gog
安装 Summarize
OpenClaw 的 Summarize 技能是一个智能内容总结工具，核心作用是快速从海量文本 / 多媒体中提取核心观点与关键信息，生成结构化摘要，帮你节省阅读与整理时间。
通过对话安装 Summarize
GEMINI_API_KEY的 api key 是:XXX 用 summarize 的时候你就用这个 key,写入你的环境变量
测试
总结一下：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。
后续可以根据自己的需求，安装更多实用技能，组合使用就能极大提升工作和学习效率——比如用“网页搜索技能+长文总结技能”快速提炼干货，用“文件管理技能+终端控制技能”自动化处理重复任务。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
19
0- 0
已为社区贡献5条内容
所有评论(0)