Sync

2026-03-14 20:23:32 +01:00
parent 50d7d1de3d
commit ad79665527
13 changed files with 2724 additions and 0 deletions
--- a/Resources/OpenClaw-Skill-Reference.md
+++ b/Resources/OpenClaw-Skill-Reference.md
@@ -0,0 +1,111 @@
+---
+created: "2026-03-10"
+type: resource
+tags: [openclaw, ai-gateway, claude-code, skill]
+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 工具链]]