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可以參考：

因為我本地有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. 1.AGENTS.md：工作規范（怎么干活、安全邊界）

2. 2.SOUL.md：靈魂文件（性格、語氣、價值觀）

3. 3.USER.md：對用戶的用戶認知（了解老板您）

4. 4.IDENTITY.md：身份設定

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

6. 6.HEARTBEAT.md：心跳檢查（每天自動檢查啥）

7. 7.MEMORY.md：長期記憶（重要事情記下來）

8. 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
      }
    }
  },

添加

## 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 搜索深圳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： 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。

后續可以根據自己的需求，安裝更多實用技能，組合使用就能極大提升工作和學習效率——比如用“網頁搜索技能+長文總結技能”快速提煉干貨，用“文件管理技能+終端控制技能”自動化處理重復任務。