OpenClaw 从入门到真正用好:一篇说清楚所有核心概念

openclaw config set tools.profile coding   # coding / minimal / messaging / full

{tools: {profile: "coding",allow: ["browser"],      // 在 coding 基础上额外开放deny: ["exec"]           // 禁用某个工具  }}

{tools: {byProvider: {"ollama/deepseek-coder:6.7b": {allow: ["group:fs"]  // 只给文件读写权限      }    }  }}

clawhub search gmail                          # 搜索npx clawhub@latest install gmail-skill        # 安装clawhub sync --all                            # 同步更新# 或者直接告诉 Agent：# "搜索一下 ClawHub 上有没有 Notion 相关的 Skill"

{skills: {    allowBundled: ["web-search", "peekaboo", "obsidian"]  }}

// ~/.openclaw/plugins/jira-tools/index.tsimport type { OpenClawPlugin } from'@openclaw/sdk';const plugin: OpenClawPlugin = {name: 'jira-tools',version: '1.0.0',tools: [    {name: 'jira_create_ticket',description: 'Create a JIRA ticket with title, description, and priority',parameters: {type: 'object',properties: {title: { type: 'string' },description: { type: 'string' },priority: { type: 'string', enum: ['low', 'medium', 'high'] }        },required: ['title', 'description']      },async execute({ title, description, priority = 'medium' }) {const response = await fetch(`${process.env.JIRA_BASE_URL}/rest/api/3/issue`, {method: 'POST',headers: { 'Authorization': `Basic ${Buffer.from(`email:${process.env.JIRA_API_TOKEN}`).toString('base64')}` },body: JSON.stringify({ fields: { summary: title, /* ... */ } })        });const data = await response.json();return { ticketId: data.key, url: `${process.env.JIRA_BASE_URL}/browse/${data.key}` };      }    }  ]};exportdefault plugin;

openclaw plugins enable jira-toolsopenclaw gateway restart    # Plugin 修改后需要重启

决策、偏好、持久事实    →  写入 MEMORY.md日常笔记、临时上下文    →  写入 memory/YYYY-MM-DD.md有人说「记住这个」      →  立即写入磁盘，不要留在 RAM 里

~/clawd/├── AGENTS.md     # 操作规则和 SOP              ← 每次加载├── SOUL.md       # 人格、价值观和边界            ← 每次加载├── USER.md       # 关于你的一切                 ← 每次加载├── IDENTITY.md   # Agent 的名字和身份           ← 每次加载├── TOOLS.md      # 工具使用指南和环境备注        ← 每次加载├── MEMORY.md     # 长期记忆                     ← 仅私人会话├── HEARTBEAT.md  # 主动检查清单                 ← 心跳轮询时├── BOOTSTRAP.md  # 首次运行引导                 ← 用后删除├── BOOT.md       # 每次重启的启动仪式            ← 重启时运行└── memory/    └── 2026-03-18.md  # 今天的日记

# SOUL.md - Who You Are_You're not a chatbot. You're becoming someone._## Core TruthsBe genuinely helpful, not performatively helpful.Skip the "Great question!" — just help.Have opinions.You're allowed to disagree, prefer things, find stuff amusing or boring.

## Heartbeat Checks- 检查有没有需要处理的新邮件- 确认今天的日历有没有即将开始的会议- 检查监控的网站有没有更新- 清理过期的 MEMORY.md 条目

{agents: {list: [      { id: "main", default: true },      {id: "work",workspace: "~/.openclaw/workspace-work",model: { primary: "anthropic/claude-opus-4-6" }      },      {id: "family",workspace: "~/.openclaw/workspace-family",sandbox: { mode: "all" },tools: { deny: ["exec", "browser", "web_fetch"] }  // 家庭群禁危险操作      }    ]  },bindings: [    { agentId: "work",   match: { channel: "slack" } },    { agentId: "work",   match: { channel: "telegram" } },    { agentId: "family", match: { channel: "whatsapp",peer: { kind: "group", id: "[email protected]" } } }  ]}

bindings: [  { agentId: "chat", match: { channel: "whatsapp" } },   // Sonnet，快速回复  { agentId: "opus", match: { channel: "telegram" } }    // Opus，深度推理]

bindings: [  { agentId: "alex", match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230001" } } },  { agentId: "mia",  match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230002" } } }]

openclaw cron add --name "会议提醒" --at "20m" \  --session main --system-event "Reminder: standup in 10 min." \  --delete-after-run

openclaw cron add --name "价格监控" --every "6h" \  --session isolated \  --message "检查监控商品价格，只在有明显降幅时通知我。" \  --announce --channel telegram --to"你的ID"

openclaw cron add --name "每日晨报" --cron "0 7 * * 1-5" \  --tz "Asia/Shanghai" --session isolated \  --message "Morning briefing: 今天的日历、未读重要邮件、上海天气、MEMORY.md 中的待办。" \  --model opus --announce --channel whatsapp --to"+861xxxxxxxxx"

{hooks: {enabled: true,token: "${WEBHOOK_SECRET}",mappings: [      {match: { path: "github" },action: "agent",agentId: "main",deliver: true      }    ]  }}

openclaw doctor --fix              # 基础检查 + 自动修复openclaw doctor --deep --yes# 深度扫描openclaw logs --follow             # 实时日志openclaw channels status --probe   # 频道连接状态

openclaw reset--scope config                    # 重置配置，保留会话openclaw reset--scope config+creds+sessions     # 重置配置+凭证+会话，保留工作区openclaw reset--scope full                      # 完全重置（慎用）