🦞 OpenClaw 配置目录说明

发布于 2026年03月01日 08:32

OpenClaw 配置目录说明

本文档介绍 OpenClaw 配置目录 (~/.openclaw) 的结构和用途。

仓库概述

这是 OpenClaw 的配置目录，而非 OpenClaw 源代码。OpenClaw 是一个本地运行的个人 AI 代理系统，具备 WebSocket 网关、聊天平台集成和持久化记忆功能。

目录结构

~/.openclaw/
├── openclaw.json           # 主配置文件
├── completions/            # Shell 自动补全脚本（bash、zsh、fish、powershell）
├── workspace/              # 代理工作区（独立的 git 仓库，包含记忆/身份信息）
├── agents/                 # 代理配置和会话
│   └── main/               # 主代理
├── cron/                   # 定时任务配置
├── devices/                # 已配对的设备（移动节点）
├── identity/               # 设备身份和认证信息
├── canvas/                 # Canvas UI 文件
├── credentials/            # 凭证存储
├── extensions/             # 扩展插件
├── feishu/                 # 飞书集成配置
├── memory/                 # 记忆存储
├── logs/                   # 网关日志
└── node.json               # 节点配置

关键配置文件

文件	说明
`openclaw.json`	主配置文件，包含模型提供商、网关设置、代理默认值、钩子和命令行为
`agents/main/agent/models.json`	模型提供商配置（zai/GLM 模型）
`agents/main/agent/auth-profiles.json`	模型提供商的认证配置文件
`cron/jobs.json`	定时任务配置
`node.json`	节点配置文件
`exec-approvals.json`	执行批准配置

工作区（独立仓库）

workspace/ 目录是一个独立的 git 仓库，包含：

文件	说明
`IDENTITY.md`	代理的身份信息（名称、生物类型、氛围、表情符号）
`USER.md`	用户档案和偏好设置
`SOUL.md`	核心个性和行为准则
`AGENTS.md`	代理会话管理和记忆协议
`TOOLS.md`	本地笔记（摄像头、SSH 主机、设备名称等）
`HEARTBEAT.md`	定期检查的主动检查清单
`MEMORY.md`	长期精选记忆（仅主会话）
`memory/YYYY-MM-DD.md`	每日记忆日志

系统架构

OpenClaw 运行一个 WebSocket 网关（默认端口 18789），提供以下功能：

接受来自聊天平台的代理轮次请求
管理会话对话
处理定时任务执行
与已配对的移动节点设备协调
提供浏览器自动化（通过 Chrome CDP）

常用命令

# 检查网关状态
openclaw status

# 查看健康状态
openclaw health

# 本地运行代理轮次
openclaw agent --local --message "你好"

# 列出/管理会话
openclaw sessions
openclaw sessions cleanup

# 管理定时任务
openclaw cron list
openclaw cron add --name "daily-check" --every 1d --message "每日检查"
openclaw cron remove <id>

# 网关控制
openclaw gateway status
openclaw logs

# 配置管理
openclaw config get <path>
openclaw config set <path> <value>

# 运行入门向导
openclaw onboard

目录文件详解

完整目录列表

.openclaw/
├── .git/                  # Git 版本控制
├── .gitignore             # Git 忽略规则
├── CLAUDE.md              # 给 Claude Code 的指导文档
├── openclaw.json          # 主配置文件
├── openclaw.json.bak*     # 配置备份文件
├── update-check.json      # 更新检查记录
├── node.json              # 节点配置
├── exec-approvals.json    # 执行批准配置
├── completions/           # Shell 自动补全脚本
│   ├── bash/
│   ├── fish/
│   ├── powershell/
│   └── zsh/
├── workspace/             # 代理工作区（独立仓库）
├── agents/                # 代理配置
│   └── main/
├── canvas/                # Canvas UI 文件
├── credentials/           # 凭证存储
├── cron/                  # 定时任务
│   └── jobs.json
├── devices/               # 已配对设备
├── extensions/            # 扩展插件
├── feishu/                # 飞书集成
├── identity/              # 设备身份
├── logs/                  # 网关日志
└── memory/                # 记忆存储

重要说明

工作区被 gitignore：workspace 目录是一个独立的仓库，不会被此配置仓库跟踪
敏感数据：此目录包含 API 密钥、设备认证令牌和个人数据，请妥善保管
配置隔离：使用 --dev 或 --profile <name> 可以在不同目录下隔离状态
网关令牌：网关通信需要认证令牌（存储在 openclaw.json 中）

备份文件

系统会自动生成配置文件的备份：

openclaw.json.bak - 最新备份
openclaw.json.bak.1 ~ openclaw.json.bak.4 - 历史备份