# OpenClaw 配置管理技能

`AI代理` `配置管理` `多渠道` `故障排查` `LLM`

# 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) 的 Agent 技能包 —— 这是一个支持 30+ LLM 提供商和 14 个消息渠道的开源 AI 代理运行时。

安装后，你的编程代理即可立刻掌握如何诊断问题、搜索会话、编辑配置，以及对每个渠道进行故障排查。

## 安装

```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 作为后台 Worker 启动
- **跨渠道** —— 在 WhatsApp 接收消息，在 Signal 推送通知
- **Canvas** —— 向已连接设备推送 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 代理环境
- [热门技能](https://github.com/Aradotso/trending-skills) —— 从 GitHub 热门仓库自动生成的技能包

## 许可证

MIT