技能标识：openclaw-expert
>
OpenClaw 使用 CalVer 版本号（YYYY.M.D-N）且频繁变更。
每次变更前请执行此检查清单：
消息频道（WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Teams、Matrix、Google Chat、Zalo、WebChat…）
│
▼
┌───────────────────────────────┐
│ 网关 │ ← ws://127.0.0.1:18789
│ （控制平面，RPC） │ ← 配置：~/.openclaw/openclaw.json（JSON5）
│ systemd 用户服务 │ ← 仪表盘：http://127.0.0.1:18789
└──────────────┬────────────────┘
│
┌──────┴──────┐
│ 代理程序 │ ← 工作空间：~/.openclaw/workspace/
│ 运行时 │ ← 会话：~/.openclaw/agents/
└──────┬──────┘
│
┌──────┴──────────────────────────┐
│ 节点（可选） │
│ iOS / Android / macOS / Pi │
│ + Canvas / A2UI │
└─────────────────────────────────┘
~/.openclaw/
├── openclaw.json # 主配置（JSON5 – 支持注释 + 尾逗号！）
├── credentials/ # API 密钥（chmod 600！）
│ ├── anthropic
│ ├── openai
│ └── openrouter
├── agents/
│ └──
│ ├── agent/ # 认证配置、模型注册表
│ └── sessions/ # 会话日志（*.jsonl）
├── skills/ # 托管/本地技能
├── cron/ # 定时任务（jobs.json、runs/）
└── workspace/ # 代理工作空间（= 大脑）
├── AGENTS.md # 操作指南（每次会话加载）
├── SOUL.md # 个性、语气、边界（每次会话）
├── USER.md # 用户画像（每次会话）
├── TOOLS.md # 工具提示（每次会话）
├── IDENTITY.md # 名称、表情符号、风格
├── HEARTBEAT.md # 定时任务 / Cron 检查清单
├── MEMORY.md # 长期记忆（仅限私密会话！）
├── BOOT.md # 启动检查清单（网关重启时）
├── BOOTSTRAP.md # 一次性设置（执行后删除）
├── memory/ # 每日日志（YYYY-MM-DD.md）
└── skills/ # 工作空间技能
⚡ 快速入门：常见任务
多代理设置
bash
openclaw agents add work # 新建代理
openclaw agents bind work whatsapp:biz # 路由规则
语义搜索记忆
json5
// 在 openclaw.json 中：
agents: {
defaults: {
memorySearch: {
provider: openai,
model: text-embedding-3-small,
query: {
hybrid: { enabled: true },
mmr: { enabled: true, lambda: 0.7 },
temporalDecay: { enabled: true, halfLifeDays: 30 }
}
}
}
}
启用沙箱
json5
agents: {
defaults: {
sandbox: {
mode: non-main,
scope: agent,
workspaceAccess: ro,
docker: { image: openclaw-sandbox:bookworm-slim }
}
}
}
创建定时任务
bash
openclaw cron add --name 每日总结 \
--cron 0 7 * \
--message 总结当天重要事件 \
--announce
调试配置问题
bash
openclaw config validate
openclaw doctor --fix
systemctl --user restart openclaw-gateway
参考文件 — 何时阅读什么
本技能包包含详细的参考文件。在执行操作前请先阅读相关文件。 文件位于技能目录的 references/ 下。
任务 参考文件 内容 快速查阅 references/quick-reference.md 单页参考：目录、最小配置、CLI 单行命令、故障排查模式 安装与入门
references/installation.md | npm/pnpm、Docker、VPS 设置、入门向导 |
| 编辑 openclaw.json | references/config-reference.md | 完整字段参考（agents、models、channels、session、secrets、bindings、$include…） |
| 仪表盘（控制界面） | references/dashboard.md | 所有仪表盘区域、访问方式、故障排查 |
| 编写工作空间文件 | references/workspace-files.md | AGENTS.md、SOUL.md、USER.md、HEARTBEAT.md、MEMORY.md 模板 |
| 配置频道 | references/channels.md | Telegram（完整！）、WhatsApp、Discord、Slack、Signal + 故障排查 |
| 调优记忆与压缩 | references/memory-system.md | memoryFlush、memorySearch、Compaction、语义搜索、衰减 |
| Docker 部署 | references/docker-setup.md | docker-compose、沙箱、alpine/openclaw、权限 |
| 安全加固 | references/security-hardening.md | dmPolicy、SecretRef、令牌轮换、白名单、沙箱、CIS 风格 |
| 开发/安装技能 | references/skills-guide.md | SKILL.md 格式、ClawHub、工作空间技能、安全审查 |
| 多代理路由 | references/multi-agent.md | agents.list、bindings、accountId、agentId、隔离、按代理沙箱/工具 |
| CLI 参考 | references/cli-reference.md | 所有命令及语法和示例（agents、browser、cron、secrets、sandbox…） |
| 仪表盘/控制界面 | references/dashboard.md | 侧边栏导航、区域、CORS、配置、故障排查 |
| 节点与远程访问 | references/nodes-and-remote.md | 节点类型、配对、无头节点、Bonjour/mDNS、执行审批 |
| Tailscale 集成 | references/tailscale-integration.md | Serve vs Funnel vs Tailnet 绑定、SSH 隧道、认证、配置示例 |
| 实践示例 | references/examples.md | 7 个完整设置场景（入门 → 多代理 → 成本优化） |
| 故障排查 | references/troubleshooting.md | 常见错误、日志、诊断步骤、SecretRef、沙箱、技能门控 |
| 技巧与高级用户 | references/tricks-and-hacks.md | 社区技巧、成本节约、Obsidian、Surge、看门狗 |
配套技能：对于 Cognee 知识图谱记忆（Docker 设置、LLM/嵌入配置、
Ollama Cloud + OpenAI 混合、插件故障排查）→ 使用 cognee-openclaw-memory 技能。
快速参考：最重要的 CLI 命令
bash
状态与诊断
openclaw --version # CalVer 版本
openclaw doctor # 健康检查（始终执行！）
openclaw doctor --fix # 自动修复
openclaw status #以下为平台配置的接入选项，并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境：
帮我安装 SkillHub 和 openclaw-expert-1776290592 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 openclaw-expert-1776290592 技能
skillhub install openclaw-expert-1776290592
文件大小: 77.71 KB | 发布时间: 2026-4-16 17:10