158 lines
6.1 KiB
Markdown
158 lines
6.1 KiB
Markdown
# OpenClaw 运维管理技能
|
||
|
||
`AI智能体` `OpenClaw` `多渠道` `配置管理` `故障排查`
|
||
|
||
# Openclaw-config
|
||
|
||
> 由 [ara.so](https://ara.so) 提供 — 在 [skills.sh](https://skills.sh/adisinghstudent/ara.so/openclaw-config) 上已有 1.5K+ 次安装
|
||
|
||
用于管理、调试和运营 [OpenClaw](https://github.com/Aradotso/zeroclaw) 的智能体技能包 —— OpenClaw 是一款开源 AI 智能体运行时，支持 30+ 个 LLM 提供商和 14 个消息渠道。
|
||
|
||
安装后，你的编程智能体立刻具备诊断问题、搜索会话、编辑配置、排查各渠道故障的能力。
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
npx skills add adisinghstudent/ara.so
|
||
```
|
||
|
||
兼容 Claude Code、Cursor、Codex、Windsurf、Cline、GitHub Copilot 以及 [30+ 其他智能体](https://skills.sh/adisinghstudent/ara.so/openclaw-config)。
|
||
|
||
## 仓库结构
|
||
|
||
```
|
||
.
|
||
├── 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 进程健康、频率限制、错误目标格式、资料名称刷屏、守护进程重启 |
|
||
| **定时任务** | 任务状态概览、失败详情、运行日志解析、常见故障原因、下次执行时间、禁用异常任务 |
|
||
|
||
### 记忆系统
|
||
|
||
三层记忆架构：
|
||
|
||
1. **上下文窗口** —— 会话内，由压缩机制修剪
|
||
2. **工作空间文件** —— `MEMORY.md` + `memory/` 下的每日日志
|
||
3. **向量数据库** —— 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？
|
||
```
|
||
|
||
该技能包为智能体提供精确的命令、文件路径和修复方案，无需猜测。
|
||
|
||
## 相关链接
|
||
|
||
- [skills.sh](https://skills.sh/adisinghstudent/ara.so/openclaw-config)
|
||
- [OpenClaw (ZeroClaw)](https://github.com/Aradotso/zeroclaw)
|
||
- [ara.so](https://ara.so) —— 云端即时 AI 智能体环境
|
||
- [Trending Skills](https://github.com/Aradotso/trending-skills) —— 从 GitHub 热门项目自动生成的技能包
|
||
|
||
## 许可证
|
||
|
||
MIT |