OpenClaw 体系资料汇编

## 查看可用 Skills
openclaw skills list
 
## 查看已安装 Plugins
openclaw plugins list

openclaw channels list          # 查看已配置渠道
openclaw channels login --channel whatsapp  # 登录渠道
openclaw channels status --probe  # 检测渠道状态

openclaw memory status          # 查看索引状态
openclaw memory search "关键词"  # 语义搜索
openclaw memory index --force   # 强制重建索引

openclaw browser start                    # 启动浏览器
openclaw browser open https://example.com
openclaw browser snapshot                 # 获取页面快照
openclaw browser click 12                 # 点击 ref=12 的元素
openclaw browser type 23 "hello"          # 输入文本

openclaw agents list           # 列出所有 agent
openclaw agents add            # 添加新 agent
openclaw agents bind           # 绑定路由规则

openclaw approvals get         # 查看审批配置
openclaw approvals allowlist   # 编辑白名单
openclaw pairing approve feishu <code>  # 批准配对请求

openclaw gateway status        # Gateway 状态
openclaw node run              # 运行节点服务

## 系统状态
openclaw status --all           # 完整状态
openclaw doctor                 # 健康检查
 
## 配置管理
openclaw config get <key>       # 获取配置
openclaw config set <key> <val> # 设置配置
 
## 消息操作
openclaw message send --to +123 --message "Hi"
openclaw message read --from +123
 
## 日志查看
openclaw logs --follow          # 实时日志
openclaw channels logs          # 渠道日志
 
## Dashboard
openclaw dashboard              # 打开控制面板

外部系统 ──HTTP POST──► Gateway /hooks/<name> ──► 执行对应操作

┌─────────────────────────────────────────────────────────────┐
│                      触发来源                                │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Hooks (内部事件)           Webhooks (外部请求)              │
│  ├── message:received       ├── POST /hooks/gmail          │
│  ├── command:new            ├── POST /hooks/github         │
│  ├── gateway:startup        └── POST /hooks/custom         │
│  └── agent:bootstrap                                       │
│         │                          │                        │
│         ▼                          ▼                        │
│  ┌─────────────────────────────────────────┐               │
│  │              Gateway                     │               │
│  └─────────────────────────────────────────┘               │
│                                                             │
└─────────────────────────────────────────────────────────────┘

{
  "hooks": {
    "enabled": true,
    "token": "your-shared-secret",
    "path": "/hooks",
    "mappings": [
      {
        "name": "gmail",
        "url": "https://gmail.googleapis.com/...",
        "model": "coze/auto"
      },
      {
        "name": "custom-hook",
        "handler": "./workspace/hooks/custom/index.js"
      }
    ]
  }
}

## 设置 Gmail Pub/Sub webhook
openclaw webhooks gmail setup
 
## 运行监听服务
openclaw webhooks gmail run

Gmail 收到新邮件 → Pub/Sub 推送 → POST /hooks/gmail → Agent 处理邮件

GitHub 仓库事件 → POST /hooks/github → Agent 执行 CI/CD 操作

## 任何支持 webhook 的服务都可以调用
curl -X POST http://your-gateway:5000/hooks/custom \
  -H "Authorization: Bearer your-token" \
  -H "Content-Type: application/json" \
  -d '{"event": "deploy", "status": "success"}'

POST /hooks/<name>
Authorization: Bearer <hooks.token>
Content-Type: application/json
 
{
  "event": "string",
  "data": { ... },
  "timestamp": "2026-03-16T00:00:00Z"
}

{
  "hooks": {
    "token": "secure-token-here",
    "allowedAgentIds": ["main", "hooks"]
  }
}

// workspace/hooks/custom-webhook/index.js
module.exports.handler = async function(event) {
  const { event: eventType, data } = event;
  
  console.log(`收到 Webhook: ${eventType}`);
  console.log('数据:', JSON.stringify(data));
  
  // 处理逻辑
  if (eventType === 'deploy') {
    // 执行部署后操作
  }
  
  return { processed: true };
};

{
  "hooks": {
    "mappings": [
      {
        "name": "deploy",
        "handler": "./workspace/hooks/custom-webhook/index.js"
      }
    ]
  }
}

curl -X POST http://localhost:5000/hooks/deploy \
  -H "Authorization: Bearer your-token" \
  -d '{"event": "deploy", "data": {"app": "myapp"}}'

外部系统
    │
    ▼
Webhook (POST /hooks/xxx)
    │
    ▼
触发内部 Hook
    │
    ▼
执行任务 (runner.js / scripts)

❌ Webhooks: 外部系统 → HTTP 请求 → Gateway
   （比如：GitHub 通知、Gmail 邮件）
 
✅ Hooks: 内部事件 → 自动触发 → 执行任务
   （比如：微信收到消息 → 触发任务）

// workspace/hooks/message-received-check-state/index.js
 
// 配置特定发送者和对应任务
const CONFIG = {
  // ...
  
  // 特定发送者触发规则
  senderTriggers: {
    // 微信用户 ID 或手机号
    '+8613800138000': {
      name: '老板',
      tasks: ['git-sync', 'tree-diagram'],
      notify: true
    },
    'wxid_abc123': {
      name: '重要客户', 
      tasks: ['step-trace'],
      keywords: {
        '紧急': { action: 'urgent', tasks: ['all'] },
        '报告': { action: 'report', tasks: ['git-sync'] }
      }
    }
  }
};
 
// Handler 中判断
module.exports.handler = async function(event) {
  const { from, content } = event.context;
  
  // 检查是否是特定发送者
  const trigger = CONFIG.senderTriggers[from];
  
  if (trigger) {
    console.log(`[Hook] 检测到 ${trigger.name} 的消息`);
    
    // 执行对应任务
    const { runTasks } = require('../../../workspace/projects/novel-sync/任务日志/runner.js');
    await runTasks(trigger.tasks);
    
    // 可选：回复确认
    if (trigger.notify) {
      event.messages.push(`✓ 已自动执行: ${trigger.tasks.join(', ')}`);
    }
  }
};