命令
说明
gateway最核心命令 ，启动 WebSocket Gateway 服务，是整个系统的运行基础
configure交互式配置向导，首次使用和修改配置时必用
config非交互式配置辅助（get/set/unset），脚本化管理配置
channels管理聊天渠道连接（Telegram、Discord 等），接入消息平台的入口
agent通过 Gateway 运行一次 agent turn，直接与 AI agent 交互
message收发消息的核心命令，日常使用频率很高
models发现、扫描和配置模型，选择/切换 LLM 时必用
命令
说明
status查看渠道健康状态和最近会话，快速了解系统状况
health从运行中的 Gateway 获取健康信息
doctor健康检查 + 快速修复，排查问题首选
logs查看 Gateway 日志，调试问题时必用
node / nodes管理 headless node host，多节点部署时核心命令
update更新 OpenClaw，保持版本最新
命令
说明
agents管理隔离的 agent（工作空间、认证、路由）
skills查看和检查可用技能
memory搜索和重建索引记忆文件
sessions查看存储的对话会话
cron定时任务管理
setup / onboard初始化配置和 agent 工作空间
tui终端 UI，方便交互式操作
dashboard打开控制面板 Web UI
agents/ # Agent 运行时数据，按名称隔离（默认为 main）
├── main/
│ ├── agent/
│ │ ├── auth-profiles.json # API 认证凭据的运行时副本（含密钥和使用统计）
│ │ └── models.json # 当前生效的模型配置快照（从 openclaw.json 解析后展开的完整模型列表）
│ └── sessions/
│ ├── sessions.json # 会话索引：记录每个对话的 sessionId、渠道来源、使用的模型、技能快照、token 统计等
│ ├── <uuid>.jsonl # 单个对话的完整消息历史（JSONL 格式，一行一条消息）
│ └── <uuid>.jsonl.reset.* # 会话重置前的历史备份（带时间戳后缀）
browser/ # OpenClaw 内置浏览器（Chromium）的用户数据目录
└── openclaw/
└── user-data/ # 完整的 Chrome user-data-dir（Preferences、Session Storage 等）
canvas/ # Canvas 可视化工具的前端页面
└── index.html # Canvas UI 的 HTML 入口文件
completions/ # Shell 自动补全脚本（非 LLM 补全）
├── openclaw.bash # Bash 补全脚本
├── openclaw.zsh # Zsh 补全脚本
├── openclaw.fish # Fish 补全脚本
└── openclaw.ps1 # PowerShell 补全脚本
cron/ # 定时任务配置
├── jobs.json # 已注册的 cron 作业列表（当前为空数组）
└── jobs.json.bak # 备份
delivery-queue/ # 出站消息投递队列
└── failed/ # 投递失败的消息（用于重试或人工排查）
devices/ # 设备配对管理
├── paired.json # 已配对设备列表（含 deviceId、publicKey、角色权限、token）
└── pending.json # 等待配对确认的设备（当前为空）
extensions/ # 已安装的插件/扩展（完整的项目代码）
└── weibo/ # 微博渠道插件（含 TypeScript 源码、node_modules 等）
├── openclaw.plugin.json # 插件清单文件
├── src/ # 插件源代码
└── ...
identity/ # 本机节点的身份标识
├── device.json # 设备标识信息
└── device-auth.json # 本机认证令牌（deviceId + operator token + 权限范围）
install.sh # OpenClaw 一键安装脚本（curl | bash 方式使用）
logs/ # 运行日志
├── gateway.log # Gateway 主日志（~4MB）
├── gateway.err.log # Gateway 错误日志（~2MB）
└── config-audit.jsonl # 配置变更审计日志（每次 openclaw.json 修改时记录）
media/ # Agent 处理的媒体文件缓存
├── inbound/ # 从渠道接收的媒体
├── <uuid>.pdf # PDF 文件（Agent 生成或处理的）
├── <uuid>.jpg # 图片文件
└── <uuid>.png # 图片文件
memory/ # Agent 长期记忆
└── main.sqlite # 记忆数据库（SQLite 格式，支持语义搜索和索引）
openclaw.json # 主配置文件，包含：
# meta - 版本和最后修改时间
# wizard - 配置向导运行记录
# auth - 认证配置档案
# models - LLM 提供商和模型定义（API URL、密钥、模型参数）
# agents - Agent 默认配置（主模型、别名、超时、并发数、工作空间路径）
# messages - 消息行为配置
# commands - 命令行为配置
# channels - 渠道配置（Discord token、微博 appId/appSecret 等）
# gateway - 网关配置（端口、绑定模式、认证 token、Tailscale）
# skills - 技能配置（包管理器、技能专属 API Key）
# plugins - 插件启用/安装状态
update-check.json # 更新检查状态（上次检查时间、最新版本号、更新频道标签）
workspace/ # 默认 Agent 工作空间（见下方详解）
~/.openclaw/workspace 工作空间 .clawhub/ # ClawHub 技能市场集成
└── lock.json # 已安装技能的版本锁定文件（类似 package-lock.json）
.git/ # Git 仓库 — 整个工作空间通过 Git 做版本控制
.openclaw/ # 工作空间级元数据
└── workspace-state.json # 工作空间状态（版本号、onboarding 完成时间）
AGENTS.md # Agent 行为手册 — 定义每次会话的启动流程：
# 1. 先读 SOUL.md（了解自己是谁）
# 2. 再读 USER.md（了解在帮谁）
# 3. 读取 memory/ 中的近期日记
# 还包含记忆管理规则、文件组织规则、工具使用规范等
HEARTBEAT.md # 心跳任务配置 — 定义 Agent 周期性自主执行的任务
# （文件为空或仅含注释时跳过心跳调用）
IDENTITY.md # Agent 身份卡片 — 名字、物种/类型、性格基调、标志性 Emoji、头像路径
SOUL.md # Agent 的"灵魂" — 核心人格定义，包含：
# Core Truths（行为准则）、Boundaries（行为边界）、
# Vibe（性格风格）、擅长领域、Continuity（持续性规则）
TOOLS.md # 本地工具备忘录 — 记录用户环境特有的设备、SSH 主机、TTS 偏好等
# （与 skills/ 分开，避免共享技能时泄露个人基础设施信息）
USER.md # 用户档案 — 主人的名字、称呼、时区、个人偏好和上下文笔记
skills/ # 从 ClawHub 安装的工作空间技能
├── apple-calendar/ # Apple 日历集成技能
│ └── SKILL.md
├── notion/ # Notion API 技能
│ └── SKILL.md
└── pdf-extract/ # PDF 文本提取技能
├── SKILL.md
└── pdf-extract # 技能附带的可执行脚本
weibo-openclaw/ # 微博渠道插件源码（通过 plugins.installs 引用到 extensions/ 中）
https://clawhub.ai/alex3alex/openclaw-backup 我把这个放在第一位就是因为这个是最简单的给龙虾保命的技巧, 安装完毕后让龙虾设定一个每天的定时任务执行备份，这样万一龙虾养死了可以利用备份瞬间恢复。
注意
安装完毕需要让龙虾启动一个定时任务进行备份，不是安装完毕就自动备份了
真的龙虾坏了怎么办? 默认会备份到当前用户目录的 openclaw-backups 文件夹里面, 解压缩后覆盖 .openclaw 文件夹即可
https://clawhub.ai/Shaivpidadi/free-ride 白嫖! 主打一个白嫖! OpenRouter上有很多免费的大模型, 这个 skill 就是帮你整理这些大模型按照性能排序来使用, 也可以在你APiece欠费的时候帮你自动切换到免费模型, 避免你的大型任务中断
注意
不要让 openclaw 直接安装skill, 会把配置文件弄坏, 直接看skill页面按照它指定的来, 或者让 claude code 之类的帮你搞定. 否则 openclaw 会在修改自己配置的过程中因为无法连接 openrouter 直接挂掉.
需要注册个 openrouter 然后配置一下 API key
https://clawhub.ai/pskoett/self-improving-agent 让龙虾持续进化的核心技能。当命令失败、用户纠正、API报错或发现知识过时时，自动记录到 .learnings/ 目录（ERRORS.md、LEARNINGS.md、FEATURE_REQUESTS.md），有价值的学习还会提升到 SOUL.md、AGENTS.md、TOOLS.md。后续可让编码 agent 处理这些日志生成修复，避免重复踩坑。
注意
触发场景：命令意外失败、用户纠正("不对，应该是...")、请求不存在的功能、外部 API 失败、发现知识过时、找到更好的工作方式等
建议在开始重大任务前先让龙虾 review 已有的 learnings
https://clawhub.ai/Spiceman161/playwright-mcp 基于 Playwright MCP 的浏览器自动化。支持导航、点击、填表、提取数据、截图、执行 JS，零代码用自然语言让 AI 生成脚本，能处理 SPA、懒加载、多 Tab 等复杂动态页面。适合网页爬取、表单填写、自动化测试。
注意
需先安装 npm i -g @playwright/mcp 并执行 npx playwright install chromium
https://clawhub.ai/JimLiuxinghai/find-skills 帮你从生态里发现和安装 skill。当你不确定"有没有能办 X 的 skill"时，用这个 skill 问龙虾，它会帮你语义搜索、展示选项、辅助安装。相当于 skill discovery 的入口。
注意
不是装越多 skill 龙虾就越强的, 大模型是有上下文限制和召回能力差别的, prompt 中填充太对 skill 的信息或者多个相似的 skill 相互冲突只会导致糟糕的结果, 保持龙虾的 skill 配置精炼是维持龙虾性能和生产力的关键
https://clawhub.ai/steipete/summarize 快速总结工具，支持 URL、本地文件、YouTube 视频、播客、PDF、图片等。流式输出 Markdown，YouTube 还能提取幻灯片和字幕。可配合 Chrome Side Panel 或 CLI，支持本地和云端模型。
注意
这是个轻量化工具, 如果需要大量精准的处理, 比如识别发票, 建议还是使用专用 skill 处理
