mc-skills/catalog

Fork 0

mc-skills 52efc07510 catalog: 更新 2026-04-07 11:44

2026-04-07 11:44:56 +08:00

6.1 KiB

Raw Blame History

OpenClaw 运维管理技能

AI智能体 OpenClaw 多渠道 配置管理 故障排查

Openclaw-config

由 ara.so 提供 — 在 skills.sh 上已有 1.5K+ 次安装

用于管理、调试和运营 OpenClaw 的智能体技能包 —— OpenClaw 是一款开源 AI 智能体运行时，支持 30+ 个 LLM 提供商和 14 个消息渠道。

安装后，你的编程智能体立刻具备诊断问题、搜索会话、编辑配置、排查各渠道故障的能力。

安装

npx skills add adisinghstudent/ara.so

兼容 Claude Code、Cursor、Codex、Windsurf、Cline、GitHub Copilot 以及 30+ 其他智能体。

仓库结构

.
├── README.md
└── skills/
    └── openclaw-config/
        └── SKILL.md          # 850 行运营知识文档

技能包内容

诊断

快速健康检查 —— 一键命令，检查网关、配置 JSON、渠道、插件、凭证、定时任务、近期错误和内存数据库
已知错误模式 —— 12 个已归档的错误，包含精确含义和修复方法

文件结构

~/.openclaw/ 目录下所有内容的完整参考：

~/.openclaw/
├── openclaw.json                    # 主配置 —— 渠道、认证、网关、插件
├── agents/main/
│   ├── agent/auth-profiles.json     # LLM 认证令牌
│   └── sessions/
│       ├── sessions.json            # 会话索引
│       └── *.jsonl                  # 会话记录
├── workspace/                       # 智能体工作空间
│   ├── SOUL.md                      # 个性与语气
│   ├── IDENTITY.md                  # 名称与品牌
│   ├── USER.md                      # 用户背景信息
│   ├── AGENTS.md                    # 运行规则
│   ├── BOOT.md                      # 启动指令
│   ├── HEARTBEAT.md                 # 周期任务清单
│   ├── MEMORY.md                    # 长期记忆
│   ├── TOOLS.md                     # 联系人、SSH 主机
│   ├── memory/                      # 每日日志
│   └── skills/                      # 工作空间级技能
├── memory/main.sqlite               # 向量记忆数据库（Gemini 嵌入）
├── logs/
│   ├── gateway.log                  # 运行时事件
│   └── gateway.err.log              # 错误日志
├── cron/
│   ├── jobs.json                    # 任务定义
│   └── runs/                        # 各任务运行日志
├── credentials/
│   ├── whatsapp/default/            # Baileys 会话（~1400 个文件）
│   ├── telegram/{bot}/token.txt     # Bot 令牌
│   └── bird/cookies.json            # X/Twitter 认证
├── extensions/{name}/               # 自定义插件（TypeScript）
├── browser/openclaw/user-data/      # Chromium 配置文件
└── tools/signal-cli/                # Signal CLI 二进制文件

渠道故障排查

各渠道的深度排查手册：

渠道	涵盖问题
WhatsApp	消息无回复、408 超时、跨上下文阻断、会话查找、白名单/群组策略、队列拥塞、完全断连、凭证清除
Telegram	配置验证错误（`botToken` vs `token`）、轮询超时、偏移量卡死、Bot"失忆"（压缩）、正确配置模板
Signal	RPC 故障、signal-cli 进程健康、频率限制、错误目标格式、资料名称刷屏、守护进程重启
定时任务	任务状态概览、失败详情、运行日志解析、常见故障原因、下次执行时间、禁用异常任务

记忆系统

三层记忆架构：

上下文窗口 —— 会话内，由压缩机制修剪
工作空间文件 —— MEMORY.md + memory/ 下的每日日志
向量数据库 —— SQLite + Gemini 嵌入，支持 FTS5 全文搜索

包含检查各层状态、查看嵌入频率限制、重建索引的命令。

会话搜索

按人物、渠道或日期查找对话
跨所有会话搜索消息内容
以格式化输出读取特定会话记录
理解 JSONL 格式（会话、消息、压缩、模型切换事件）

配置编辑

使用 jq 的安全编辑模式：

切换渠道策略（开放、白名单、配对、禁用）
启用自动驾驶模式
更换 LLM 模型
设置并发限制
启用/禁用插件
备份与恢复

安全模式

模式	行为	风险
`open` + `allowFrom: ["*"]`	任何人均可发消息，Bot 响应所有人	高
`allowlist` + `allowFrom: ["+1..."]`	仅限白名单号码	低
`pairing`	未知发送者获得审批码	低
`disabled`	渠道关闭	无

扩展 OpenClaw

技能包 —— 通过 ClawdHub 或 npx skills add 添加 Markdown 知识包
扩展插件 —— 自定义 TypeScript 渠道插件
定时任务 —— 定期自主执行的任务
多智能体 —— 将 Codex/Claude Code/Pi 作为后台工作进程启动
跨渠道 —— 在 WhatsApp 接收消息，在 Signal 发出通知
画布 —— 向已连接设备推送 HTML/仪表板
语音通话 —— 集成 Twilio/Telnyx/Plivo

使用示例

向你的智能体询问以下任意问题：

为什么我的 WhatsApp 渠道无法连接？
显示 Telegram 上最近 10 个会话
在所有会话中搜索"deployment"
将 Signal 切换为仅允许我的号码的白名单模式
哪些定时任务失败了，原因是什么？
如何添加一个新的 Telegram Bot？

该技能包为智能体提供精确的命令、文件路径和修复方案，无需猜测。

许可证

MIT

6.1 KiB Raw Blame History Unescape Escape