Config Safe
安全地修改 OpenClaw 配置。先读取官方最新文档，理解配置结构和验证规则，预览变更，验证无误后再写入。**绝不直接修改配置**，所有变更都需要用户确认。触发词："修改配置"、"更改配置"、"配置 openclaw"、"设置 openclaw"、"config"。 Skill: Config Safe Summary: 安全地修改 OpenClaw 配置。先读取官方最新文档，理解配置结构和验证规则，预览变更，验证无误后再写入。**绝不直接修改配置**，所有变更都需要用户确认。触发词："修改配置"、"更改配置"、"配置 openclaw"、"设置 openclaw"、"config"。 Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-09T05:00:54.612Z | user 初始发布 - 安全修改 OpenClaw 配置的技能 Archive index: Archive v1.0.0: 2 files, 2749 bytes Files: SKILL.md (5398b), _meta.json (130b) File v1.0.0:SKILL.md --- name: config-safe description: 安全地
Rank
62
Safety
84
Downloads
698
Updated
Apr 15, 2026
Version
1.0.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 698 downloads reported by the source. Last updated 4/15/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Apr 15, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Apr 15, 2026
- Adoption signal
- 698 downloadsadoption · observed Apr 15, 2026
- Latest release
- 1.0.0release · observed Feb 9, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install unknown:config-safe- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-unknown-config-safe/snapshot"
Documentation
CLAWHUB
4,073 characters of source documentation, loaded on request.
Extracted files
2 files captured from the source.
SKILL.md
---
name: config-safe
description: 安全地修改 OpenClaw 配置。先读取官方最新文档，理解配置结构和验证规则，预览变更，验证无误后再写入。**绝不直接修改配置**，所有变更都需要用户确认。触发词："修改配置"、"更改配置"、"配置 openclaw"、"设置 openclaw"、"config"。
---
# Config Safe
安全地修改 OpenClaw 配置，避免写入无效配置导致 Gateway 无法启动。
## 核心理念
**配置修改是高风险操作。**
- OpenClaw 有严格的配置验证，**任何错误都会导致 Gateway 拒绝启动**
- 一旦配置损坏，Gateway 崩溃，**无法与你通信**，只能通过 CLI 修复
**核心原则：先预览，后验证，再确认，绝不直接修改。**
## 验证方法
在修改配置之前，可以使用以下方法验证配置是否有效：
### 方法 1: Schema 验证（静态检查）
获取配置的 JSON Schema，检查字段类型和必填项：
```bash
openclaw gateway call config.schema --params '{}'
```
**用途：**
- 检查字段名是否正确
- 检查值的类型是否正确
- 检查必填字段是否遗漏
**示例：**
```json
// Schema 返回结构
{
"schema": {
"type": "object",
"properties": {
"channels": { "type": "object" },
"agents": { "type": "object" }
},
"required": ["agents"]
}
}
```
### 方法 2: 模拟写入验证（动态检查）
使用 `config.patch` 尝试验证配置（**不会实际写入**，除非验证通过）：
```bash
openclaw gateway call config.patch --params '{
"raw": "{\"channels\":{\"telegram\":{\"enabled\":true}}}",
"baseHash": "<current-hash>"
}'
```
**行为：**
- 如果配置无效 → 返回错误，**不写入**，Gateway 继续运行
- 如果配置有效 → 写入并重启 Gateway
**注意：** 验证通过后会实际写入配置，所以要先向用户展示预览并获得确认。
## 工作流程
### Step 1: 读取官方最新文档
在修改任何配置之前，先阅读相关文档：
```bash
# 配置总览和验证规则
cat /opt/homebrew/lib/node_modules/openclaw/docs/gateway/configuration.md
# 配置示例（常见场景）
cat /opt/homebrew/lib/node_modules/openclaw/docs/gateway/configuration-examples.md
```
**必读内容：**
- 严格配置验证 (Strict config validation)
- 配置字段的类型和默认值
- 相关功能的具体配置示例
### Step 2: 获取当前配置（只读）
```bash
openclaw gateway call config.get --params '{}'
```
**只读取，不修改。** 保存返回的 JSON 和 hash。
### Step 3: Schema 验证（可选但推荐）
先用 schema 验证配置结构：
```bash
openclaw gateway call config.schema --params '{}'
```
检查你的变更是否符合 schema 要求。
### Step 4: 生成预览
向用户展示变更内容：
```
=== 配置变更预览 ===
要修改:
- channels.telegram.enabled: false → true
- channels.telegram.botToken: [已隐藏]
变更前:
{
"channels": { "telegram": { "enabled": false } }
}
变更后:
{
"channels": { "telegram": { "enabled": true, "botToken": "***" } }
}
⚠️ 风险检查:
- 字段名正确 ✓
- 类型正确 ✓
- botToken 必填 ✓
```
### Step 5: 用户确认
**必须明确获得用户确认后才继续：**
```
请确认以上变更？输入 "确认" 继续，或 "取消" 放弃。
```
### Step 6: 验证并写入
```bash
# 部分更新（推荐）
openclaw gateway call config.patch --params '{
"raw": "{\"channels\":{\"telegram\":{\"enabled\":true}}}",
"baseHash": "<hash>"
}'
# 全量替换（仅当你完全理解风险时使用）
openclaw gateway call config.apply --params '{
"raw": "<完整配置>",
"baseHash": "<hash>"
}'
```
**注意：** 写入成功后 Gateway 会自动重启。
### Step 7: 验证结果
重启后检查配置是否生效：
```bash
openclaw status
openclaw doctor
```
## 常见配置场景
### 添加/修改 channel
```json5
{
channels: {
telegram: {
enabled: true,
botToken: "your-token",
dmPolicy: "pairing"
}
}
}
```
### 配置 agent 身份
```json5
{
agents: {
list: [{
id: "main",
identity: {
name: "Samantha",
emoji: "🦥"
}
}]
}
}
```
### 配置 sandbox
```json5
{
agents: {
defaults: {
sandbox: {
mode: "all",
scope: "session"
}
}
}
}
```
## 错误处理
**如果配置写入后 Gateway 无_meta.json
{
"ownerId": "kn750dvg901gnsgb8f08mre74580tpyf",
"slug": "config-safe",
"version": "1.0.0",
"publishedAt": 1770613254612
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/glfruit/config-safe",
"sourceUrl": "https://clawhub.ai/glfruit/config-safe",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-unknown-config-safe/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-unknown-config-safe/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "698 downloads",
"href": "https://clawhub.ai/unknown/config-safe",
"sourceUrl": "https://clawhub.ai/unknown/config-safe",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.0",
"href": "https://clawhub.ai/unknown/config-safe",
"sourceUrl": "https://clawhub.ai/unknown/config-safe",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-09T05:00:54.612Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-unknown-config-safe/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-unknown-config-safe/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.0",
"description": "初始发布 - 安全修改 OpenClaw 配置的技能",
"href": "https://clawhub.ai/unknown/config-safe",
"sourceUrl": "https://clawhub.ai/unknown/config-safe",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-09T05:00:54.612Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.