安装 OpenClaw 只需要一行命令，但装完之后你会发现，它在你的用户目录下创建了一个 ~/.openclaw/ 文件夹。这个文件夹里有什么？每个目录是干嘛的？为什么重要？
这篇文章带你逐个拆解。
最简安装流程：
npm install -g openclaw@latest
openclaw onboard --install-daemononboard 命令会引导你完成配置，包括选择模型提供商、设置 API key、配置聊天渠道等。完成后，你的 AI 助手就运行起来了。
但真正的”魔法”都在 ~/.openclaw/ 里。
目录结构总览
~/.openclaw/
├── openclaw.json # 核心配置文件
├── workspace/ # 工作区（最重要的目录）
│ ├── AGENTS.md # Agent 行为定义
│ ├── SOUL.md # AI 人格设定
│ ├── USER.md # 用户信息
│ ├── IDENTITY.md # AI 身份设定
│ ├── TOOLS.md # 工具配置
│ ├── MEMORY.md # 长期记忆
│ ├── memory/ # 每日记忆文件
│ ├── skills/ # 已安装的技能
│ └── post-to-wechat/ # 公众号文章草稿
├── agents/ # Agent 运行时数据
├── channels/ # 聊天渠道配置
│ └── telegram/ # Telegram 特定数据
├── config/ # 额外配置
├── credentials/ # 凭证存储（加密）
├── cron/ # 定时任务配置
├── devices/ # 配对设备信息
├── extensions/ # 插件目录
│ └── openclaw-weixin/ # 微信插件
├── identity/ # 身份相关
├── logs/ # 运行日志
├── media/ # 媒体文件缓存
├── memory/ # 记忆系统数据
├── subagents/ # 子代理数据
└── .env # 环境变量核心文件详解
这是整个系统的”大脑”。里面包含：
- models: 配置的 AI 模型（Kimi、DeepSeek、Claude 等）
- agents: Agent 列表和默认设置
- channels: 聊天渠道配置（Telegram、微信等）
- gateway: 网关端口、认证、Tailscale 等
- tools: 工具配置（搜索、浏览器等）
- plugins: 已安装的插件
修改这个文件就能改变 OpenClaw 的行为。比如添加新模型、开启新渠道、调整工具权限等。
关键目录详解
workspace/ – 工作区
最重要的目录，相当于 AI 助手的”办公桌”。
核心文件：
| 文件 | 作用 |
|---|---|
| AGENTS.md | 定义 Agent 如何启动、读取哪些文件 |
| SOUL.md | AI 的人格、语气、行为准则 |
| USER.md | 用户的基本信息，AI 据此调整回应方式 |
| IDENTITY.md | AI 的身份定义（名字、角色等） |
| TOOLS.md | 本地工具的配置说明 |
| MEMORY.md | 长期记忆的汇总，AI 每次启动都会读 |
| HEARTBEAT.md | 定时检查任务的配置 |
子目录：
- memory/: 按日期存储的每日记忆（YYYY-MM-DD.md）
- skills/: 从 ClawHub 安装的技能（如 x-search、agent-browser）
- post-to-wechat/: 准备发布到公众号的文章草稿
channels/ – 聊天渠道
存储各聊天平台的配置和数据。比如 telegram/ 里有：
- 会话历史
- 用户信息缓存
- 媒体文件
credentials/ – 凭证
存储 API key、token 等敏感信息，通常是加密存储的。
logs/ – 日志
运行日志，排查问题时很有用。
cron/ – 定时任务
你设置的定时任务配置，比如每天自动执行某个检查。
devices/ – 设备
配对的手机、平板等设备信息。
为什么了解目录结构很重要？
1. 备份: 知道哪些文件需要备份（主要是 workspace/ 和 openclaw.json）
2. 迁移: 换电脑时，复制整个 ~/.openclaw/ 就能完整迁移
3. 调试: 出问题时有地方可查（logs/、config/）
4. 扩展: 安装 skill 或插件时知道文件放哪
实用技巧
查看配置是否正确：
openclaw doctor备份整个配置：
cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)快速编辑核心配置：
openclaw config edit查看日志：
openclaw logs转载作品，原作者：，文章来源：https://mp.weixin.qq.com/s/YWeq6rceLzdEWA61KCOPTg?scene=1&click_id=4
