共计 4395 个字符，预计需要花费 11 分钟才能阅读完成。
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。
后续可以根据自己的需求，安装更多实用技能，组合使用就能极大提升工作和学习效率——比如用“网页搜索技能 + 长文总结技能”快速提炼干货，用“文件管理技能 + 终端控制技能”自动化处理重复任务。
