---
created: "2026-03-10"
type: resource
tags: [resource, openclaw, ai-gateway, claude-code, skill, homelab]
source: "https://docs.openclaw.ai/"
---

# OpenClaw Skill 参考

## 概述

OpenClaw 是一个自托管的 AI 网关，将聊天应用（WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等 20+ 渠道）连接到 AI 编码代理。基于 Node.js 22+，使用 WebSocket 控制平面。

- 配置文件: `~/.openclaw/openclaw.json`（JSON5 格式，热重载）
- 默认端口: `18789`
- 本地仓库: `C:\Users\yaoji\git\OpenSource\openclaw`
- 文档: https://docs.openclaw.ai/
- Claude Code Skill 位置: `~/.claude/skills/openclaw/SKILL.md`

## Skill 覆盖内容

### 核心操作

| 模块 | 功能 | 关键命令 |
|------|------|----------|
| Gateway | 启动/停止/重启/状态/服务安装 | `openclaw gateway run/start/stop/restart/status` |
| 配置 | JSON5 配置读写/验证/向导 | `openclaw config get/set/unset/validate` |
| Agent | 多 agent 隔离/路由绑定/身份 | `openclaw agents add/bind/unbind/list` |
| Session | 会话列表/清理/作用域管理 | `openclaw sessions/cleanup` |

### 通讯渠道

| 模块 | 功能 | 关键命令 |
|------|------|----------|
| Channel | 添加/登录/状态/能力探测 | `openclaw channels add/login/status/capabilities` |
| Message | 发送/回复/投票/反应/广播/线程 | `openclaw message send/poll/react/broadcast` |

### 扩展能力

| 模块 | 功能 | 关键命令 |
|------|------|----------|
| Skills | 列出/检查 agent 技能 | `openclaw skills list/info/check` |
| Plugins | 安装/启用/更新/卸载 | `openclaw plugins install/enable/update` |
| Hooks（内部） | 事件驱动自动化 | `openclaw hooks list/enable/disable` |
| Webhooks（外部） | HTTP 触发 agent | `POST /hooks/wake`, `POST /hooks/agent` |
| Cron | 定时任务 | `openclaw cron add/edit` |

### API 与集成

- **OpenAI 兼容 API**: `POST /v1/chat/completions`（需开启）
- **RPC 调用**: `openclaw gateway call <method>`
- **25+ 模型提供商**: Anthropic、OpenAI、Ollama、OpenRouter、Bedrock 等

## 关键配置结构

```
openclaw.json
├── identity          # 名称/主题/表情
├── agents            # agent 列表/默认值/workspace/model/skills
├── channels          # 各渠道配置（whatsapp/telegram/discord/slack...）
├── session           # 作用域/重置/维护
├── skills            # 技能条目/加载/安装
├── plugins           # 插件条目/允许/拒绝
├── tools             # web/browser/canvas/media
├── gateway           # 端口/绑定/认证/HTTP端点
├── hooks             # webhook + 内部钩子
├── cron              # 定时任务
├── acp               # Agent Control Protocol
├── logging           # 日志级别/脱敏
└── env               # 环境变量
```

## Bootstrap 文件

放在 agent workspace 根目录:

- `AGENTS.md` - 操作指令 + 记忆
- `SOUL.md` - 人格/边界/语气
- `TOOLS.md` - 用户工具说明
- `BOOTSTRAP.md` - 一次性引导（运行后删除）
- `IDENTITY.md` - agent 名称/风格
- `USER.md` - 用户画像

## SKILL.md 格式（创建自定义技能）

```markdown
---
name: my-skill
description: 技能描述
requires:
  bins: [node]
  env: [API_KEY]
install:
  - kind: node
    package: my-package
---
# 技能说明和工具定义
```

## 常见工作流

1. **初始化**: `npm install -g openclaw@latest && openclaw onboard --install-daemon`
2. **添加渠道**: `openclaw channels add --channel telegram --token TOKEN`
3. **多 agent**: `openclaw agents add work --workspace ~/.openclaw/workspace-work`
4. **API 触发**: `curl -X POST http://127.0.0.1:18789/hooks/agent -H 'Authorization: Bearer TOKEN' -d '{"message":"..."}'`
5. **诊断**: `openclaw doctor --fix && openclaw status --deep`

## Related

- [[Claude Code 配置]]
- [[AI 工具链]]
