OpenClaw新手指南：理解workspace和如何輕松安裝skills

OpenClaw新手指南：理解workspace和如何輕松安裝skills

大家好，我是星哥，最近一直在養(yǎng)龍蝦，OpenClaw成為很多開(kāi)發(fā)者和普通用戶(hù)追捧的個(gè)人AI助手平臺(tái)，而想要熟練上手OpenClaw，首先得搞懂兩個(gè)核心基礎(chǔ)——workspace（工作區(qū)）和skills（技能）。

今天就用最通俗的語(yǔ)言，帶新手快速吃透這兩個(gè)知識(shí)點(diǎn)，全程附實(shí)操命令，看完就能上手操作。

OpenClaw環(huán)境

系統(tǒng)： windows11

openclaw版本： OpenClaw 2026.3.11

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

部署openclaw可以參考：

因?yàn)槲冶镜赜衞llama的模型。

安裝的時(shí)候使用的是kimi的大模型
現(xiàn)在讓openclaw幫我增加一個(gè)ollama的配置。

提示詞

給openclaw增加大模型的配置，ollama的配置，api地址是 http://192.168.1.18:11434 (http://192.168.1.18:11434/api/generate，會(huì)報(bào)錯(cuò)了)
apikey是123456，大模型 qwen3.5:9b
再重啟openclaw

被龍蝦鄙視了

給龍蝦發(fā)消息

它丟給了我一個(gè)黑熊的表情包

糟糕，被龍蝦鄙視了

一、openclaw的工作空間

OpenClaw的.openclaw/workspace目錄是AI智能體的核心工作區(qū)，被形象地稱(chēng)為“智能體的家”。

它是文件工具和上下文使用的唯一工作目錄，存儲(chǔ)了定義AI助手行為、記憶和身份的所有關(guān)鍵配置文件。

這個(gè)目錄與~/.openclaw/（存儲(chǔ)配置、憑證和會(huì)話(huà)）是分開(kāi)的，需要保持私密性并視為記憶庫(kù)。

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

一、8個(gè)核心文件

1. 1.AGENTS.md：工作規(guī)范（怎么干活、安全邊界）

2. 2.SOUL.md：靈魂文件（性格、語(yǔ)氣、價(jià)值觀(guān)）

3. 3.USER.md：對(duì)用戶(hù)的用戶(hù)認(rèn)知（了解老板您）

4. 4.IDENTITY.md：身份設(shè)定

5. 5.TOOLS.md：工具配置（寶玉技能、微信API等）

6. 6.HEARTBEAT.md：心跳檢查（每天自動(dòng)檢查啥）

7. 7.MEMORY.md：長(zhǎng)期記憶（重要事情記下來(lái)）

8. 8.memory/目錄：每日日志（Day01-Day03）

（圖片來(lái)自 技術(shù)爬爬蝦）

二、身份與人格定義文件

IDENTITY.md - 智能體身份設(shè)定

定義AI助手的名稱(chēng)、生物形態(tài)（如AI、機(jī)器人、精靈等）、氣質(zhì)（犀利、溫暖、平靜等）、表情符號(hào)和頭像路徑。這是在引導(dǎo)儀式期間創(chuàng)建/更新的文件，幫助確定“我是誰(shuí)”。

SOUL.md - 智能體靈魂文件

定義AI的人格、語(yǔ)氣、價(jià)值觀(guān)和行為邊界。包含核心準(zhǔn)則：真誠(chéng)提供幫助而非表演、要有自己的觀(guān)點(diǎn)、在求助前自行鉆研、通過(guò)能力贏(yíng)得信任、記住自己是訪(fǎng)客等。這是AI的“靈魂”，每次會(huì)話(huà)都會(huì)加載，并由AI自身進(jìn)化更新。

三、用戶(hù)與環(huán)境認(rèn)知文件

USER.md - 用戶(hù)信息檔案

記錄使用者的姓名、稱(chēng)呼方式、代詞、時(shí)區(qū)、背景信息（關(guān)心什么、正在做什么項(xiàng)目、什么會(huì)讓他們煩惱或開(kāi)心）。AI了解得越多，就能提供越個(gè)性化的幫助，但強(qiáng)調(diào)是在“了解一個(gè)人而非建立檔案”。

TOOLS.md - 本地配置筆記

記錄屬于當(dāng)前環(huán)境的特定配置信息，如攝像頭名稱(chēng)與位置、SSH主機(jī)地址與別名、偏好的TTS音色、設(shè)備昵稱(chēng)等。這與技能（Skills）文件分開(kāi)，因?yàn)榧寄芡ǔＪ枪蚕淼模唧w配置是私有的。

四、行為準(zhǔn)則與工作指南

AGENTS.md - 工作區(qū)操作指南

智能體的工作準(zhǔn)則和安全邊界，定義AI應(yīng)該如何行為、使用記憶的規(guī)則、優(yōu)先級(jí)等。在每個(gè)會(huì)話(huà)開(kāi)始時(shí)加載，適合放置“如何干活”的詳細(xì)信息。

HEARTBEAT.md - 心跳檢查清單

可選文件，用于每天自動(dòng)運(yùn)行的小型檢查任務(wù)。官方建議保持簡(jiǎn)短以避免token消耗。

五、記憶系統(tǒng)文件

MEMORY.md - 長(zhǎng)期記憶庫(kù)

精心整理的長(zhǎng)期記憶，記錄重要事件、想法、決定、觀(guān)點(diǎn)和經(jīng)驗(yàn)教訓(xùn)。僅在主私密會(huì)話(huà)中加載（不在共享/群組上下文中），這是為了安全——包含不應(yīng)泄露給陌生人的個(gè)人背景。

memory/YYYY-MM-DD.md - 每日記憶日志

每天一個(gè)文件，記錄發(fā)生事件的原始日志。建議在會(huì)話(huà)開(kāi)始時(shí)讀取今天和昨天的內(nèi)容以獲取近期背景。

六、引導(dǎo)與啟動(dòng)文件

BOOTSTRAP.md - 首次運(yùn)行引導(dǎo)
一次性首次運(yùn)行儀式文件，僅為全新工作區(qū)創(chuàng)建。引導(dǎo)AI與用戶(hù)通過(guò)自然對(duì)話(huà)確定身份，完成后應(yīng)刪除此文件。

BOOT.md - 網(wǎng)關(guān)重啟檢查清單
當(dāng)啟用內(nèi)部hooks時(shí)，在Gateway網(wǎng)關(guān)重啟時(shí)執(zhí)行的可選啟動(dòng)檢查清單，建議保持簡(jiǎn)短。

工作區(qū)管理建議

官方強(qiáng)烈推薦將workspace放入私有Git倉(cāng)庫(kù)進(jìn)行備份和恢復(fù)。初始化倉(cāng)庫(kù)后，應(yīng)定期提交更新（git add .、git commit -m "Update memory"、git push）。但需注意：不要提交API密鑰、OAuth token、密碼等敏感信息，這些應(yīng)存儲(chǔ)在~/.openclaw/credentials/下或通過(guò)環(huán)境變量管理。

工作區(qū)的默認(rèn)位置是/.openclaw/workspace/，但如果設(shè)置了OPENCLAW_PROFILE且不是"default"，則會(huì)變?yōu)?.openclaw/workspace-。可以通過(guò)~/.openclaw/openclaw.json中的agent.workspace配置覆蓋默認(rèn)位置。

安全性提醒：workspace是默認(rèn)的當(dāng)前工作目錄（cwd），但不是硬性沙箱。工具會(huì)根據(jù)工作區(qū)解析相對(duì)路徑，但絕對(duì)路徑仍然可以訪(fǎng)問(wèn)主機(jī)上的其他位置。如果需要隔離，應(yīng)使用agents.defaults.sandbox配置啟用沙箱隔離

二、使用skills修復(fù)搜索功能 安裝tavily web search skill

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

復(fù)制提示詞

安裝

申請(qǐng)tavily的apikey

訪(fǎng)問(wèn)https://tavily.com點(diǎn)擊登錄，復(fù)制apikey

給到龍蝦安裝tavily-search

請(qǐng)先檢查是否已安裝 SkillHub 商店，若未安裝，請(qǐng)根據(jù) 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
      }
    }
  },

添加

## 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 把這個(gè)skill安裝一下

由于網(wǎng)絡(luò)問(wèn)題安裝失敗，改成騰訊的

請(qǐng)先檢查是否已安裝 SkillHub 商店，若未安裝，請(qǐng)根據(jù) 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 搜索深圳4月份的城市活動(dòng)，把每個(gè)搜索引擎的結(jié)果都告訴我

四、使用WEB ui 安裝技能

在openclaw管理后臺(tái)

點(diǎn)擊技能、再搜索gog ，點(diǎn)擊install gog

安裝 Summarize

OpenClaw 的 Summarize 技能是一個(gè)智能內(nèi)容總結(jié)工具，核心作用是快速?gòu)暮Ａ课谋?/ 多媒體中提取核心觀(guān)點(diǎn)與關(guān)鍵信息，生成結(jié)構(gòu)化摘要，幫你節(jié)省閱讀與整理時(shí)間。

通過(guò)對(duì)話(huà)安裝 Summarize

GEMINI_API_KEY的 api key 是:XXX 用 summarize 的時(shí)候你就用這個(gè) key,寫(xiě)入你的環(huán)境變量

測(cè)試

總結(jié)一下：https://arxiv.org/pdf/2603.00902

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.

從開(kāi)源項(xiàng)目尋找那些有合適的skill的名字，再去官網(wǎng)skill市場(chǎng)搜索，安裝。

總結(jié)

注明：本文來(lái)自來(lái)爬爬蝦視頻：https://www.bilibili.com/video/BV1ZiNwzPEhP/

其實(shí)OpenClaw的workspace和skills并不復(fù)雜：workspace是智能體的“家”，負(fù)責(zé)存放所有配置、記憶和日志，是智能體正常運(yùn)行的基礎(chǔ)；skills是智能體的“本領(lǐng)”，安裝不同的技能，就能讓智能體幫你完成不同的任務(wù)。

對(duì)于新手來(lái)說(shuō)，先記住workspace的默認(rèn)路徑和核心文件，再按照步驟安裝核心技能，就能快速上手OpenClaw。

后續(xù)可以根據(jù)自己的需求，安裝更多實(shí)用技能，組合使用就能極大提升工作和學(xué)習(xí)效率——比如用“網(wǎng)頁(yè)搜索技能+長(zhǎng)文總結(jié)技能”快速提煉干貨，用“文件管理技能+終端控制技能”自動(dòng)化處理重復(fù)任務(wù)。