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 格式（创建自定义技能）

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

常见工作流

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

3.8 KiB Raw Blame History Unescape Escape

OpenClaw Skill 参考

概述

Skill 覆盖内容

核心操作

通讯渠道

扩展能力

API 与集成

关键配置结构

Bootstrap 文件

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

常见工作流

Related

3.8 KiB

Raw Blame History