OpenClaw 首次启动基础配置修改：工作目录/记忆存储/技能源一篇搞定

摘要：安装完 OpenClaw 后，首次启动时如何修改基础配置？本文详解工作目录、记忆存储位置、默认技能源等关键配置的修改方法，包含配置文件位置、修改步骤、最佳实践和常见问题，帮你打造完全个性化的 AI 助手。

数据更新时间：2026 年 4 月 1 日
阅读时间：约 10 分钟
适用对象：OpenClaw 新手、首次配置者

一、为什么首次配置很重要？

1.1 新手常见问题

很多新手在安装完 OpenClaw 后直接开始使用，结果遇到这些问题：

问题 1：文件到处都是

问题 2：记忆丢失

❌ 不知道记忆存储在哪里
✅ 正确做法：配置记忆存储位置

问题 3：技能安装失败

❌ 默认技能源访问慢
✅ 正确做法：配置国内技能源

1.2 首次配置的价值

避免后期麻烦：

一次性配置好，避免后续频繁修改
建立规范的文件结构，便于管理
配置合适的存储位置，避免磁盘空间不足

提升使用体验：

合理的工作目录，文件查找更方便
优化的技能源，安装速度更快
个性化的记忆系统，AI 更懂你

二、OpenClaw 配置文件位置

2.1 核心配置文件

配置文件位置：

Windows: C:\Users\你的用户名\.openclaw\
macOS/Linux: ~/.openclaw/

重要文件：

~/.openclaw/
├── openclaw.json        # 主配置文件（全局设置）
├── workspace/           # 工作目录（AI 的"灵魂"文件夹）
│   ├── SOUL.md         # 人格设定（语气、风格）
│   ├── USER.md         # 用户信息（个人偏好）
│   ├── AGENTS.md       # Agent 配置（行为宪法）
│   └── MEMORY.md       # 记忆存储（知识库）
├── skills/             # 技能目录
└── logs/              # 日志目录

2.2 配置文件说明

文件名	作用	修改频率	重要性
openclaw.json	全局配置（模型、渠道、端口）	低	⭐⭐⭐⭐⭐
workspace/SOUL.md	AI 人格设定	中	⭐⭐⭐⭐
workspace/USER.md	用户信息	低	⭐⭐⭐⭐
workspace/AGENTS.md	Agent 行为规范	中	⭐⭐⭐⭐⭐
workspace/MEMORY.md	记忆存储	高	⭐⭐⭐⭐⭐

三、工作目录配置

3.1 什么是工作目录？

官方定义：

工作目录（workspace）是 OpenClaw 的核心文件夹，包含 AI 的人格设定、用户信息、记忆系统等所有配置文件。

通俗理解：

工作目录就是 AI 的"家"，所有重要文件都放在这里。

生活化比喻：

想象你请了一个私人助理👨‍💼：

工作目录 = 助理的办公室
SOUL.md = 助理的性格设定
USER.md = 你的个人信息
MEMORY.md = 助理的工作笔记
AGENTS.md = 助理的工作手册

3.2 默认工作目录位置

Windows：

C:\Users\你的用户名\.openclaw\workspace\

macOS/Linux：

~/.openclaw/workspace/

3.3 修改工作目录位置

方法 1：使用环境变量（推荐）

步骤 1：设置环境变量

bash

# Windows（PowerShell）
$env:OPENCLAW_WORKSPACE="D:\OpenClaw\workspace"

# Windows（永久生效）
setx OPENCLAW_WORKSPACE "D:\OpenClaw\workspace"

# macOS/Linux
export OPENCLAW_WORKSPACE="/path/to/workspace"

# macOS/Linux（永久生效）
echo 'export OPENCLAW_WORKSPACE="/path/to/workspace"' >> ~/.bashrc
source ~/.bashrc

步骤 2：验证配置

bash

# 查看环境变量
echo $OPENCLAW_WORKSPACE  # macOS/Linux
echo %OPENCLAW_WORKSPACE% # Windows

方法 2：修改配置文件

步骤 1：打开配置文件

bash

# 编辑 openclaw.json
nano ~/.openclaw/openclaw.json

步骤 2：添加 workspace 配置

json

{
  "workspace": {
    "path": "D:\\OpenClaw\\workspace"
  }
}

步骤 3：重启 OpenClaw

bash

# 停止服务
openclaw stop

# 启动服务
openclaw start

3.4 工作目录最佳实践

推荐结构：

D:\OpenClaw\
├── workspace/           # 工作目录
│   ├── personal/       # 个人使用
│   │   ├── SOUL.md
│   │   ├── USER.md
│   │   └── MEMORY.md
│   ├── work/          # 工作使用
│   │   ├── SOUL.md
│   │   ├── USER.md
│   │   └── MEMORY.md
│   └── projects/      # 项目使用
│       └── project-name/
├── skills/            # 技能目录
└── backups/          # 备份目录

备份建议：

bash

# 定期备份工作目录
cp -r ~/.openclaw/workspace/ ~/backups/workspace-$(date +%Y%m%d)/

四、记忆存储位置配置

4.1 什么是记忆系统？

官方定义：

记忆系统是 OpenClaw 的跨会话信息沉淀机制，通过 MEMORY.md 文件存储用户偏好、项目规范等长期信息。

通俗理解：

记忆系统就是 AI 的"笔记本"，记录重要信息供以后使用。

记忆内容示例：

markdown

# 用户偏好
- 对花生过敏
- 喜欢喝美式咖啡
- 工作时间：9:00-18:00

# 项目规范
- 使用 Python 3.10
- 代码风格：PEP8
- Git 分支策略：GitFlow

# 重要信息
- 邮箱：user@example.com
- GitHub: username
- 服务器 IP: 192.168.1.100

4.2 默认记忆存储位置

记忆文件位置：

~/.openclaw/workspace/MEMORY.md

4.3 修改记忆存储位置

方法 1：修改 MEMORY.md 路径

步骤 1：编辑配置文件

bash

nano ~/.openclaw/openclaw.json

步骤 2：添加记忆配置

json

{
  "memory": {
    "path": "D:\\OpenClaw\\memory\\MEMORY.md"
  }
}

步骤 3：创建目录并迁移

bash

# 创建新目录
mkdir -p D:\OpenClaw\memory

# 迁移记忆文件
cp ~/.openclaw/workspace/MEMORY.md D:\OpenClaw\memory\

方法 2：使用符号链接

步骤 1：移动记忆文件

bash

# 移动到新位置
mv ~/.openclaw/workspace/MEMORY.md D:\OpenClaw\memory\

步骤 2：创建符号链接

bash

# Windows（管理员 PowerShell）
New-Item -ItemType SymbolicLink -Path "~\.openclaw\workspace\MEMORY.md" -Target "D:\OpenClaw\memory\MEMORY.md"

# macOS/Linux
ln -s /path/to/memory/MEMORY.md ~/.openclaw/workspace/MEMORY.md

4.4 记忆管理最佳实践

分类存储：

markdown

# MEMORY.md 结构建议

## 用户信息
- 个人偏好
- 生活习惯
- 重要日期

## 工作规范
- 代码规范
- 工作流程
- 项目信息

## 技能配置
- 已安装技能
- 技能配置
- 使用技巧

## 常见问题
- 已解决问题
- 解决方案
- 注意事项

定期整理：

bash

# 每月整理一次记忆
# 删除过期信息
# 更新重要信息

五、默认技能源配置

5.1 什么是技能源？

官方定义：

技能源（Skill Source）是 OpenClaw 获取和安装技能的远程仓库，类似 npm 或 pip 的包管理器。

通俗理解：

技能源就是"技能应用商店"，从这里下载和安装技能。

主流技能源：

ClawHub - 官方技能市场（1700+ 技能）
GitHub - 社区技能仓库
国内镜像 - 加速访问

5.2 默认技能源配置

默认配置：

json

{
  "skills": {
    "sources": [
      "https://clawhub.ai"
    ]
  }
}

问题：

❌ 国内访问慢
❌ 经常超时
❌ 安装失败率高

5.3 配置国内技能源

方法 1：修改配置文件

步骤 1：编辑配置文件

bash

nano ~/.openclaw/openclaw.json

步骤 2：添加国内技能源

json

{
  "skills": {
    "sources": [
      "https://clawhub.uiscale.cn",
      "https://clawhub.tencentcloudapi.com",
      "https://clawhub.ai"
    ]
  }
}

步骤 3：验证配置

bash

# 查看技能源配置
openclaw skills list

方法 2：使用环境变量

步骤 1：设置环境变量

bash

# Windows
setx OPENCLAW_SKILL_SOURCE "https://clawhub.uiscale.cn"

# macOS/Linux
export OPENCLAW_SKILL_SOURCE="https://clawhub.uiscale.cn"
echo 'export OPENCLAW_SKILL_SOURCE="https://clawhub.uiscale.cn"' >> ~/.bashrc

步骤 2：验证配置

bash

echo $OPENCLAW_SKILL_SOURCE

5.4 推荐技能源列表

国内技能源（按优先级排序）：

https://clawhub.uiscale.cn - 七牛云镜像（最快）
https://clawhub.tencentcloudapi.com - 腾讯云镜像
https://clawhub.ai - 官方源（备选）

配置建议：

json

{
  "skills": {
    "sources": [
      "https://clawhub.uiscale.cn",
      "https://clawhub.tencentcloudapi.com",
      "https://clawhub.ai"
    ],
    "timeout": 30,
    "retry": 3
  }
}

六、其他基础配置

6.1 模型配置

配置文件：

bash

nano ~/.openclaw/openclaw.json

配置示例：

json

{
  "models": {
    "default": "qwen-max",
    "providers": {
      "aliyun": {
        "api_key": "your_api_key",
        "models": ["qwen-max", "qwen-plus"]
      }
    }
  }
}

6.2 渠道配置

配置示例：

json

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "your_bot_token"
    },
    "feishu": {
      "enabled": true,
      "app_id": "your_app_id",
      "app_secret": "your_app_secret"
    }
  }
}

6.3 安全配置

配置示例：

json

{
  "security": {
    "require_approval_for": ["shell", "file_write"],
    "allowed_commands": ["ls", "cd", "cat"],
    "blocked_commands": ["rm", "sudo", "chmod"]
  }
}

七、配置验证与测试

7.1 验证配置文件

检查配置语法：

bash

# 验证 JSON 格式
openclaw config validate

查看当前配置：

bash

# 查看完整配置
openclaw config show

# 查看特定配置
openclaw config show workspace
openclaw config show memory
openclaw config show skills

7.2 测试配置

测试工作目录：

bash

# 创建工作目录测试文件
echo "test" > ~/.openclaw/workspace/test.txt

# 验证文件创建成功
cat ~/.openclaw/workspace/test.txt

测试记忆系统：

bash

# 添加测试记忆
用户：记住我的邮箱是 test@example.com
AI：好的，已记录你的邮箱。

# 验证记忆
用户：我的邮箱是什么？
AI：你的邮箱是 test@example.com。

测试技能源：

bash

# 列出可用技能
openclaw skills list

# 测试安装技能
openclaw skills install browser

八、常见问题

Q1：配置文件在哪里？

答：在用户主目录下的 .openclaw 文件夹。

位置：

Windows: C:\Users\你的用户名\.openclaw\
macOS/Linux: ~/.openclaw/

Q2：工作目录可以放在其他磁盘吗？

答：可以，使用环境变量或修改配置文件。

方法：

bash

# 使用环境变量
setx OPENCLAW_WORKSPACE "D:\OpenClaw\workspace"

Q3：记忆文件太大怎么办？

答：定期整理和清理。

方法：

每月整理一次 MEMORY.md
删除过期信息
分类存储

Q4：技能源配置后不生效？

答：需要重启 OpenClaw。

方法：

bash

# 停止服务
openclaw stop

# 启动服务
openclaw start

Q5：配置错了怎么恢复？

答：使用备份恢复。

方法：

bash

# 恢复备份
cp ~/backups/workspace-20260401/* ~/.openclaw/workspace/

九、配置检查清单

9.1 首次配置必做

基础配置：

验证测试：

运行 openclaw config validate
测试记忆系统
测试技能安装
测试聊天渠道

9.2 推荐配置

性能优化：

配置缓存目录
配置日志级别
配置超时时间

安全配置：

配置命令白名单
配置审批流程
配置访问权限

备份配置：

定期备份工作目录
配置自动备份
测试恢复流程

十、总结与快速查阅表

10.1 核心配置文件

文件	位置	作用	修改频率
openclaw.json	~/.openclaw/	全局配置	低
SOUL.md	~/.openclaw/workspace/	人格设定	中
USER.md	~/.openclaw/workspace/	用户信息	低
AGENTS.md	~/.openclaw/workspace/	行为规范	中
MEMORY.md	~/.openclaw/workspace/	记忆存储	高

10.2 常用命令

配置管理：

bash

openclaw config show      # 查看配置
openclaw config validate  # 验证配置
openclaw config edit      # 编辑配置

技能管理：

bash

openclaw skills list      # 列出技能
openclaw skills install   # 安装技能
openclaw skills update    # 更新技能

服务管理：

bash

openclaw start            # 启动服务
openclaw stop             # 停止服务
openclaw restart          # 重启服务

10.3 快速决策表

需求	配置文件	修改方法
修改工作目录	openclaw.json	设置 workspace.path
修改记忆位置	openclaw.json	设置 memory.path
修改技能源	openclaw.json	设置 skills.sources
修改模型	openclaw.json	设置 models.default
修改渠道	openclaw.json	设置 channels

配置好这些基础设置，你的 OpenClaw 就能稳定运行了！

小龙虾 OpenClaw 首次配置教程：个性化设置完整指南（2026 版）

OpenClaw 首次启动基础配置修改：工作目录/记忆存储/技能源一篇搞定 ​

一、为什么首次配置很重要？ ​

1.1 新手常见问题 ​

1.2 首次配置的价值 ​

二、OpenClaw 配置文件位置 ​

2.1 核心配置文件 ​

2.2 配置文件说明 ​

三、工作目录配置 ​

3.1 什么是工作目录？ ​

3.2 默认工作目录位置 ​

3.3 修改工作目录位置 ​

3.4 工作目录最佳实践 ​

四、记忆存储位置配置 ​

4.1 什么是记忆系统？ ​

4.2 默认记忆存储位置 ​

4.3 修改记忆存储位置 ​

4.4 记忆管理最佳实践 ​

五、默认技能源配置 ​

5.1 什么是技能源？ ​

5.2 默认技能源配置 ​

5.3 配置国内技能源 ​

5.4 推荐技能源列表 ​

六、其他基础配置 ​

6.1 模型配置 ​

6.2 渠道配置 ​

6.3 安全配置 ​

七、配置验证与测试 ​

7.1 验证配置文件 ​

7.2 测试配置 ​

八、常见问题 ​

Q1：配置文件在哪里？ ​

Q2：工作目录可以放在其他磁盘吗？ ​

Q3：记忆文件太大怎么办？ ​

Q4：技能源配置后不生效？ ​

Q5：配置错了怎么恢复？ ​

九、配置检查清单 ​

9.1 首次配置必做 ​

9.2 推荐配置 ​

十、总结与快速查阅表 ​

10.1 核心配置文件 ​

10.2 常用命令 ​

10.3 快速决策表 ​

小龙虾 OpenClaw 首次配置教程：个性化设置完整指南（2026 版）

OpenClaw 新手必装 5 个核心技能 2026：从入门到精通

小龙虾 OpenClaw 安装教程 2026 最新版：零基础 10 分钟搞定本地部署

OpenClaw界面5分钟上手：每个按钮都有用

小龙虾 OpenClaw 入门：认识你的本地 AI 助手

OpenClaw 安装教程：10分钟跑通全流程（2026最新）

小龙虾 OpenClaw 基础概念扫盲：Skill/心跳/记忆/子会话/ACP 一篇讲清楚

OpenClaw 选型指南：新手入门版本选择与大模型套餐推荐（2026 年 4 月最新）

OpenClaw和Cursor同日杀入手机！AI Agent从此塞进口袋

不要孤军奋战啦！

OpenClaw 首次启动基础配置修改：工作目录/记忆存储/技能源一篇搞定

一、为什么首次配置很重要？

1.1 新手常见问题

1.2 首次配置的价值

二、OpenClaw 配置文件位置

2.1 核心配置文件

2.2 配置文件说明

三、工作目录配置

3.1 什么是工作目录？

3.2 默认工作目录位置

3.3 修改工作目录位置

3.4 工作目录最佳实践

四、记忆存储位置配置

4.1 什么是记忆系统？

4.2 默认记忆存储位置

4.3 修改记忆存储位置

4.4 记忆管理最佳实践

五、默认技能源配置

5.1 什么是技能源？

5.2 默认技能源配置

5.3 配置国内技能源

5.4 推荐技能源列表

六、其他基础配置

6.1 模型配置

6.2 渠道配置

6.3 安全配置

七、配置验证与测试

7.1 验证配置文件

7.2 测试配置

八、常见问题

Q1：配置文件在哪里？

Q2：工作目录可以放在其他磁盘吗？

Q3：记忆文件太大怎么办？

Q4：技能源配置后不生效？

Q5：配置错了怎么恢复？

九、配置检查清单

9.1 首次配置必做

9.2 推荐配置

十、总结与快速查阅表

10.1 核心配置文件

10.2 常用命令

10.3 快速决策表