OpenClaw 小白完全指南 - 从安装到精通

1

基础概念：先搞懂这6个核心名词

理解这些概念是掌握OpenClaw的第一步

🤖

Agent（智能代理）

你的AI助手/员工

执行对话任务的主体，你直接聊天的对象。OpenClaw里，Agent是"干活的人"。

💡 理解：没有Agent，就没有人帮你干活

🛠️

Skill（技能/工具）

工具箱里的各种工具

让Agent具备具体能力（发邮件、搜网页、处理PDF等）。没有Skill的Agent只会聊天，装了Skill才能干活。

💡 理解：Skill是Agent的"超能力"来源

📁

Workspace（工作区）

Agent的办公桌+文件柜

存放规则文件、记忆、用户数据、Skill代码。每个Agent可以有独立的工作区，互不干扰。

💡 理解：Workspace是Agent的"私人空间"

💬

Session（会话）

一次完整的"值班过程"

记录从启动到关闭期间的对话历史、临时状态。今天聊的和昨天聊的，可能是不同Session。

💡 理解：Session是Agent的"当班记录"

🚪

Gateway（网关/入口）

前台接待处

管理多个Agent，决定用户请求交给哪个Agent处理。小公司可能只有1个Agent，大公司需要Gateway分发。

💡 理解：Gateway是"调度中心"

🧠

Memory（长期记忆）

助手的笔记本+档案库

跨会话记住用户信息、偏好、历史任务、重要结论。没有记忆，每次重启都"失忆"；有了记忆，Agent越用越懂你！

💡 理解：Memory让Agent从"临时工"变成"老搭档"

📊

记忆类型对比

了解Session记忆和长期记忆的区别

类型	存储内容	有效期	举例
Session记忆	当前对话上下文	重启即丢	刚才说的"继续"指什么
长期记忆	用户偏好、历史任务、重要结论	永久保存	你喜欢Python、你上周让查的资料

2

目录结构：文件都存放在哪里

搞清楚文件位置，管理更有条理

🗂️

~/.openclaw/ 下的文件组织

~/.openclaw/# 【配置目录】不提交Git

├── openclaw.json# ⭐ 主配置文件（最重要）

├── credentials/# API密钥、OAuth令牌（敏感）

├── agents/<agentId>/sessions/# 会话历史记录

└── skills/# 官方下载的Skills

~/.openclaw/workspace/# 【工作目录】建议Git备份

├── claw.md# ⭐ 全局系统规则

├── SOUL.md# 人格设定（语气风格）

├── IDENTITY.md# 自我认知（我是谁）

├── USER.md# ⭐ 用户画像（长期记忆核心）

├── memory/# ⭐ 记忆文件存储目录

│ ├── user_profile.json# 用户画像数据

│ ├── task_history/# 任务历史

│ ├── learned_facts.json# 学习到的事实

│ └── preferences/# 偏好设置

└── skills/# 自定义Skills

💡 小贴士

~/.openclaw/ 是配置目录，包含敏感信息，不要提交到Git。workspace/ 是工作目录，可以安全备份和版本控制。

3

全局配置：打造你的专属助手

通过openclaw.json配置核心参数

JSON

{
  // 工作区路径配置
  "workspace": {
    "path": "~/.openclaw/workspace",
    "rules": {
      "system": "claw.md",
      "soul": "SOUL.md",
      "identity": "IDENTITY.md",
      "user": "USER.md"
    }
  },

  // Agent默认配置
  "agents": {
    "defaults": {
      "model": "gpt-4",
      "temperature": 0.7,
      "maxTokens": 4000,
      "memory": {
        "enabled": true,
        "storage": "local",
        "path": "~/.openclaw/workspace/memory"
      }
    }
  }
}

配置项	说明	推荐值
`workspace.path`	工作区根目录	`~/.openclaw/workspace`
`agents.defaults.model`	默认AI模型	`gpt-4` 或 `claude-3`
`temperature`	创造性程度（0-1）	0.7（平衡）
`memory.enabled`	是否开启长期记忆	`true`

4

Skill管理：给助手安装工具

安装、配置、使用Skill的完整流程

📦

常用Skill安装命令

使用clawhub安装官方Skill

Bash

# 搜索Skill
clawhub search tavily

# 安装Skill
clawhub install tavily-search
clawhub install nano-pdf
clawhub install Bio-MemoryPro

# 查看已安装Skill
clawhub list

# 更新Skill
clawhub update tavily-search

# 卸载Skill
clawhub uninstall nano-pdf

⚙️

Skill配置示例

在openclaw.json中配置Skill参数

JSON

{
  "skills": {
    "entries": {
      "tavily-search": {
        "enabled": true,
        "env": {
          "TAVILY_API_KEY": "${TAVILY_API_KEY}"
        }
      },
      "nano-pdf": {
        "enabled": true,
        "config": {
          "maxFileSize": "50MB",
          "extractImages": false
        }
      }
    }
  }
}

🔧 Skill调用方式

自动调用：Agent根据任务自动选择合适的Skill
显式调用：在对话中指定 用tavily-search搜索...

5

存储与路径配置：管好文件存放

合理规划文件存储位置

路径类型	默认路径	用途	是否Git
配置目录	`~/.openclaw/`	主配置、密钥、会话	❌ 否
工作目录	`~/.openclaw/workspace/`	规则文件、自定义Skill	✅ 是
记忆目录	`workspace/memory/`	长期记忆数据	可选
会话目录	`~/.openclaw/agents/.../sessions/`	对话历史	❌ 否

6

长期记忆系统：让助手记住你

跨会话持久化信息，Agent越用越懂你

🧠

记忆的三种类型

了解不同类型记忆的用途

类型	存储内容	更新频率	存储位置
用户画像（Profile）	你是谁、职业、技术栈、习惯	每次对话自动提取	`memory/user_profile.json`
任务历史（History）	做过什么任务、结果如何	任务完成时记录	`memory/task_history/`
事实知识（Facts）	你教过的东西、确认过的信息	实时学习	`memory/learned_facts.json`
偏好设置（Preferences）	喜欢的格式、常用工具、禁忌	显式设定或观察	`memory/preferences/`

⚙️

开启和配置长期记忆

方式A：通过openclaw.json配置（推荐）

JSON

{
  "agents": {
    "defaults": {
      "memory": {
        "enabled": true,
        "storage": "local",
        "path": "~/.openclaw/workspace/memory",
        "maxSize": "100MB",
        "retention": {
          "taskHistory": "90d",
          "sessionContext": "7d"
        }
      }
    }
  }
}

方式B：通过Skill增强记忆（Bio-MemoryPro）

Bash

# 安装专业记忆管理Skill
clawhub install Bio-MemoryPro

自动提取对话中的关键信息
智能压缩记忆，节省Token（最高省72%）
自动关联相关记忆

📄

记忆存储格式示例

了解记忆文件的结构

用户画像（user_profile.json）

JSON

{
  "user_id": "user_xxx",
  "basic_info": {
    "name": "张三",
    "role": "后端工程师",
    "tech_stack": ["Python", "Go", "K8s"]
  },
  "preferences": {
    "code_style": "简洁优先，注释清晰",
    "output_format": "先给结论，再展开"
  },
  "learned_facts": [
    {
      "fact": "负责支付系统重构项目",
      "confidence": 0.95
    }
  ]
}

🎯

如何使用长期记忆

自动使用与显式操作

自动使用（默认）

对话开始时读取用户画像，调整语气
检测到相关历史任务时主动关联
根据偏好调整输出格式

显式操作（高级控制）

操作	指令示例	效果
查看记忆	"查看你记得关于我的哪些信息"	展示用户画像
更新记忆	"记住我喜欢用Python处理数据"	写入preferences
删除记忆	"忘记我之前说的那个错误信息"	标记fact为失效
关联历史	"参考上周排查数据库的经验"	检索并应用历史任务

🔒 记忆隐私与安全

风险	解决方案
敏感信息泄露	启用记忆加密 `"encryption": "aes-256"`
记忆无限增长	设置自动清理 `"retention": {"maxAge": "90d"}`
误记错误信息	置信度机制，低置信度记忆需确认

7

规则与行为配置：设定工作方式

通过规则文件定义Agent的行为

📋

claw.md

全局系统规则

定义Agent的核心行为准则、工作方式、边界限制。这是最重要的规则文件。

💫

SOUL.md

人格设定

定义Agent的语气、风格、性格特点。是专业严谨还是轻松幽默？

🪪

IDENTITY.md

自我认知

定义Agent的身份、角色定位、能力范围。"我是谁？我能做什么？"

👤

USER.md

用户画像

记录用户的基本信息、偏好、习惯。让Agent更了解你。

8

多环境管理：进阶使用技巧

用OPENCLAW_PROFILE隔离不同环境

Bash

# 设置环境变量，使用工作配置
export OPENCLAW_PROFILE=work
openclaw chat

# 切换到个人配置
export OPENCLAW_PROFILE=personal
openclaw chat

# 临时指定（不影响默认配置）
OPENCLAW_PROFILE=testing openclaw chat

💡 使用场景

工作/个人分离：不同场景使用不同的Agent配置和记忆
测试/生产隔离：避免测试操作影响生产环境
多项目管理：为不同项目配置专门的Skill组合

9

快速查询表

常用配置速查，一目了然

想配置什么	修改哪个文件/变量	关键配置项
开启长期记忆	`openclaw.json`	`agents.defaults.memory.enabled`
记忆存储路径	`openclaw.json`	`agents.defaults.memory.path`
记忆保留时间	`openclaw.json`	`agents.defaults.memory.retention`
记忆加密	`openclaw.json`	`agents.defaults.memory.encryption`
安装记忆增强Skill	命令行	`clawhub install Bio-MemoryPro`
多Agent共享记忆	Skill配置	`nemp-memory` 的 `SHARED_MEMORY_PATH`
查看当前记忆	对话指令	"查看你记得关于我的哪些信息"
手动更新记忆	对话指令	"记住我喜欢..." / "忘记..."
记忆清理	命令行	`openclaw memory cleanup`

✓

完整起步清单

按顺序完成这些步骤，快速上手OpenClaw

确认目录结构 → 检查 ~/.openclaw/ 和 workspace/
写 claw.md → 设定全局行为规则
改 openclaw.json → 配置工作区路径 + 开启记忆系统
安装核心Skills → tavily-search nano-pdf Bio-MemoryPro
配置记忆路径 → 确认 memory/ 目录权限
试记忆功能 → 说"记住我是Python后端工程师"
重启验证 → 问"你知道我是谁吗？"看是否记得
试自动调用 → 说"搜索今天的科技新闻"
试指定调用 → 说"用tavily-search搜AI趋势"
配置Skill路径 → 给常用Skill设默认目录
（进阶）配多环境 → 用 OPENCLAW_PROFILE 隔离工作/个人

🎯

一句话总结

OpenClaw = Agent（干活的人）+ Skill（工具）+ Workspace（办公桌）+ Memory（笔记本）+ Rules（工作手册）

记忆让Agent从"临时工"变成"老搭档"，越用越懂你！