How should Config Safe be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

Agent DossierCLAWHUBSafety 84/100

Xpersona Agent

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: 安全地

OpenClaw · self-declared

698 downloadsTrust evidence available

View on ClawHub Homepage

clawhub skill install unknown:config-safe

Overall rank

#62

Adoption

698 downloads

Trust

Unknown

Freshness

Mar 1, 2026

Freshness

Last checked Mar 1, 2026

Best For

Config Safe is best for general automation workflows where OpenClaw compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, CLAWHUB, runtime-metrics, public facts pack

Overview Evidence & Timeline Artifacts & Docs API & Reliability Media & Related Machine Appendix

Overview

Key links, install path, reliability highlights, and the shortest practical read before diving into the crawl record.

Verifiededitorial-content

Overview

Executive Summary

No verified compatibility signals698 downloads

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Mar 1, 2026

Vendor

Clawhub

Artifacts

Benchmarks

Last release

1.0.0

Install & run

Setup Snapshot

clawhub skill install unknown:config-safe

1
Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
2
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.

Evidence & Timeline

Public facts grouped by evidence type, plus release and crawl events with provenance and freshness.

Verifiededitorial-content

Public facts

Evidence Ledger

Vendor (1)

Vendor

Clawhub

profilemedium

Observed Apr 15, 2026Source link Provenance

Compatibility (1)

Protocol compatibility

OpenClaw

contractmedium

Observed Apr 15, 2026Source link Provenance

Release (1)

Latest release

1.0.0

releasemedium

Observed Feb 9, 2026Source link Provenance

Adoption (1)

Adoption signal

698 downloads

profilemedium

Observed Apr 15, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Events

Release & Crawl Timeline

Release

Release 1.0.0

releasemedium

初始发布 - 安全修改 OpenClaw 配置的技能

Observed Feb 9, 2026

Artifacts & Docs

Parameters, dependencies, examples, extracted files, editorial overview, and the complete README when available.

Self-declaredCLAWHUB

Captured outputs

Artifacts Archive

Extracted files

Examples

Snippets

Languages

Unknown

Executable Examples

bash

openclaw gateway call config.schema --params '{}'

json

// Schema 返回结构
{
  "schema": {
    "type": "object",
    "properties": {
      "channels": { "type": "object" },
      "agents": { "type": "object" }
    },
    "required": ["agents"]
  }
}

bash

openclaw gateway call config.patch --params '{
  "raw": "{\"channels\":{\"telegram\":{\"enabled\":true}}}",
  "baseHash": "<current-hash>"
}'

bash

# 配置总览和验证规则
cat /opt/homebrew/lib/node_modules/openclaw/docs/gateway/configuration.md

# 配置示例（常见场景）
cat /opt/homebrew/lib/node_modules/openclaw/docs/gateway/configuration-examples.md

bash

openclaw gateway call config.get --params '{}'

bash

openclaw gateway call config.schema --params '{}'

Extracted Files

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
}

Editorial read

Docs & README

Docs source

CLAWHUB

Editorial quality

ready

Full README

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: 安全地修改 OpenClaw 配置。先读取官方最新文档，理解配置结构和验证规则，预览变更，验证无误后再写入。绝不直接修改配置，所有变更都需要用户确认。触发词："修改配置"、"更改配置"、"配置 openclaw"、"设置 openclaw"、"config"。

Config Safe

安全地修改 OpenClaw 配置，避免写入无效配置导致 Gateway 无法启动。

核心理念

配置修改是高风险操作。

OpenClaw 有严格的配置验证，任何错误都会导致 Gateway 拒绝启动
一旦配置损坏，Gateway 崩溃，无法与你通信，只能通过 CLI 修复

核心原则：先预览，后验证，再确认，绝不直接修改。

验证方法

在修改配置之前，可以使用以下方法验证配置是否有效：

方法 1: Schema 验证（静态检查）

获取配置的 JSON Schema，检查字段类型和必填项：

openclaw gateway call config.schema --params '{}'

用途：

检查字段名是否正确
检查值的类型是否正确
检查必填字段是否遗漏

示例：

// Schema 返回结构
{
  "schema": {
    "type": "object",
    "properties": {
      "channels": { "type": "object" },
      "agents": { "type": "object" }
    },
    "required": ["agents"]
  }
}

方法 2: 模拟写入验证（动态检查）

使用 config.patch 尝试验证配置（不会实际写入，除非验证通过）：

openclaw gateway call config.patch --params '{
  "raw": "{\"channels\":{\"telegram\":{\"enabled\":true}}}",
  "baseHash": "<current-hash>"
}'

行为：

如果配置无效 → 返回错误，不写入，Gateway 继续运行
如果配置有效 → 写入并重启 Gateway

注意： 验证通过后会实际写入配置，所以要先向用户展示预览并获得确认。

工作流程

Step 1: 读取官方最新文档

在修改任何配置之前，先阅读相关文档：

# 配置总览和验证规则
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: 获取当前配置（只读）

openclaw gateway call config.get --params '{}'

只读取，不修改。 保存返回的 JSON 和 hash。

Step 3: Schema 验证（可选但推荐）

先用 schema 验证配置结构：

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: 验证并写入

# 部分更新（推荐）
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: 验证结果

重启后检查配置是否生效：

openclaw status
openclaw doctor

常见配置场景

添加/修改 channel

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "your-token",
      dmPolicy: "pairing"
    }
  }
}

配置 agent 身份

{
  agents: {
    list: [{
      id: "main",
      identity: {
        name: "Samantha",
        emoji: "🦥"
      }
    }]
  }
}

配置 sandbox

{
  agents: {
    defaults: {
      sandbox: {
        mode: "all",
        scope: "session"
      }
    }
  }
}

错误处理

如果配置写入后 Gateway 无法启动：

运行 openclaw doctor 查看具体错误
运行 openclaw doctor --fix 尝试自动修复
如果无法修复，手动编辑 ~/.openclaw/openclaw.json

常见错误：

Unknown key: 字段名拼写错误
Invalid type: 值的类型不对
Missing required field: 缺少必填字段

黄金法则

在你这个技能中，永远不要：

❌ 直接写入配置而不预览
❌ 直接写入配置而不确认
❌ 使用 config.apply 而不提醒用户风险

你应该：

✅ 先读取文档
✅ Schema 验证配置结构
✅ 生成变更预览
✅ 明确要求用户确认
✅ 优先使用 config.patch

安全检查清单

在确认配置变更前，确认用户已经：

[ ] 看到变更预览（变更前 vs 变更后）
[ ] 了解潜在风险
[ ] 输入 "确认" 明确同意

记住：Gateway 崩溃 = 通信中断 = 无法修复。预览 + 确认是唯一的防线。

File v1.0.0:_meta.json

{ "ownerId": "kn750dvg901gnsgb8f08mre74580tpyf", "slug": "config-safe", "version": "1.0.0", "publishedAt": 1770613254612 }

API & Reliability

Machine endpoints, contract coverage, trust signals, runtime metrics, benchmarks, and guardrails for agent-to-agent use.

MissingCLAWHUB

Machine interfaces

Contract & API

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

missing

Auth

None

Streaming

Data region

Unspecified

Protocol support

OpenClaw: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/snapshot"

curl -s "https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/contract"

curl -s "https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/trust"

Operational fit

Reliability & Benchmarks

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.

No benchmark suites or observed failure patterns are available.

Machine Appendix

Raw contract, invocation, trust, capability, facts, and change-event payloads for machine-side inspection.

MissingCLAWHUB

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "CLAWHUB",
      "generatedAt": "2026-04-17T04:42:20.003Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile"
}

Facts JSON

[
  {
    "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://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/contract",
    "sourceUrl": "https://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://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-config-safe/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "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
  }
]

Overview

Executive Summary

Setup Snapshot

Evidence & Timeline

Evidence Ledger

Release & Crawl Timeline

Artifacts & Docs

Artifacts Archive

Docs & README

Config Safe

核心理念

验证方法

方法 1: Schema 验证（静态检查）

方法 2: 模拟写入验证（动态检查）

工作流程

Step 1: 读取官方最新文档

Step 2: 获取当前配置（只读）

Step 3: Schema 验证（可选但推荐）

Step 4: 生成预览

Step 5: 用户确认

Step 6: 验证并写入

Step 7: 验证结果

常见配置场景

添加/修改 channel

配置 agent 身份

配置 sandbox

错误处理

黄金法则

安全检查清单

API & Reliability

Contract & API

Reliability & Benchmarks

Media & Related

Media & Demo

Related Agents

Machine Appendix