Claws

Claws 문서는 OpenClaw 공식 문서(cli/claws)를 한국어로 정리한 가이드입니다. Create, add, update, and remove experimental Claw agent packages 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Create, add, update, and remove experimental Claw agent packages

한국어 가이드 범위: cli/claws 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Create a Claw package
Incident triage
Inspect and preview
Inspect installed state
Update an installed Claw
Remove an installed Claw
Export an installed agent
Command reference
함께 보기

상세 내용

openclaw claws

A Claw is a versioned setup for one new OpenClaw agent. It can describe the agent's portable identity, workspace files, skills, plugins, MCP servers, and cron jobs. Harness-specific agent settings may be carried in a referenced package profile. A Claw does not replace or modify an existing agent.

Create a Claw package

A package contains package.json, a CLAW.md manifest, and any profiles or workspace sidecars referenced by that manifest:

{
  "name": "@acme/incident-triage-claw",
  "version": "1.0.0",
  "type": "module",
  "openclaw": { "claw": "CLAW.md" }
}

Incident triage

Creates one agent for reviewing and routing incidents. yaml schemaVersion: 1 agent: tools: profile: coding alsoAllow: [cron] deny: [exec] fs: workspaceOnly: true memory: search: enabled: true rememberAcrossConversations: true sources: [memory, sessions] json { "workspace": { "bootstrapFiles": { "SOUL.md": { "source": "workspace/SOUL.md" } }, "files": [ { "source": "workspace/reference/policy.md", "path": "reference/policy.md" } ] } } json { "packages": [ { "kind": "skill", "source": "clawhub", "ref": "incident-triage", "version": "1.0.0" }, { "kind": "plugin", "source": "clawhub", "ref": "@acme/audit-plugin", "version": "2.0.0" } ] } json { "cronJobs": [ { "id": "daily-summary", "name": "Daily incident summary", "schedule": { "cron": "0 9 * * *", "timezone": "UTC" }, "session": "isolated", "message": "Summarize active incidents." } ] } json { "mcpServers": { "statuspage": { "command": "npx", "args": ["--yes", "@acme/statuspage-mcp@1.0.0"], "env": { "STATUSPAGE_TOKEN": "${STATUSPAGE_TOKEN}" } } } } ```

`metadata` is a string-to-string map for portable consumer hints. OpenClaw's
`openclaw.config` key points to an optional, package-relative YAML profile. The
exported default is `profiles/openclaw.yml`; the pointer is normative, so a
package may choose another safe relative `.yml` or `.yaml` path.

This profile exists only inside the Claw package. OpenClaw validates and uses it
while inspecting, adding, updating, and exporting that Claw; it is not copied
to the user's normal OpenClaw configuration path. Other harnesses can ignore
the namespaced metadata key and consume the portable manifest fields.

The same strict version 1 schema continues to accept grouped JSON manifests.
Grouped JSON uses the same `metadata.openclaw.config` pointer rather than
embedding a second copy of the OpenClaw profile. The remaining schema fragments
on this page use JSON, with equivalent keys available in `CLAW.md` frontmatter.

The OpenClaw package profile may select any built-in tool profile registered by
the running OpenClaw version, then refine it with `alsoAllow`, `deny`, and
`tools.fs.workspaceOnly: true`. A Claw cannot set that field to `false` and
weaken host filesystem confinement. `tools.allow` remains available as an
explicit allowlist but cannot be combined with `alsoAllow`. A Claw may also set
`memory.search.enabled`, choose the portable `memory` and `sessions` sources,
and opt into cross-conversation memory with `rememberAcrossConversations`.
Declaring the `sessions` source requires that opt-in.
Host policy still constrains these settings, and Claws do not carry custom
profile definitions, providers, credentials, bindings, or local memory paths.
The referenced profile is limited to 256 KiB, must be JSON-compatible YAML, may
not use aliases, anchors, tags, or merge keys, and must be a regular,
non-symlinked, non-hardlinked file inside the package.

Package and workspace paths must remain inside the package root. Manifests are
limited to 1 MiB, package metadata to 256 KiB, and workspace sources enforce
separate per-file and aggregate limits. Workspace sources also reject symlinked
parents.

Workspace files are declared by path and read from package sidecars. Bootstrap
files such as `SOUL.md` use named entries; additional files use package-relative
sources and workspace-relative targets:

Skills and plugins use exact ClawHub versions:

The dry run uses the existing skill and plugin preflight paths to resolve the
exact artifact, integrity, and any ClawHub trust warning before consent. The
warning remains visible in the integrity-bound plan. Apply installs missing artifacts
or reuses matching ones and records whether the Claw introduced or referenced
each resource. Plugins remain process-wide OpenClaw capabilities rather than
per-agent installations.

Cron jobs declare scheduled work for the new agent:

Inspect and preview

Validate the source without planning local changes:

openclaw claws inspect ./incident-triage.claw.json

openclaw claws add ./incident-triage.claw.json --dry-run --json

openclaw claws add ./incident-triage.claw.json \
  --yes \
  --plan-integrity <SHA256_FROM_DRY_RUN>

Inspect installed state

status compares the installed agent and its recorded workspace, package, MCP, and cron provenance with current state. It reports incomplete installs, missing resources, and drift without changing local state. openclaw doctor adds Claw-specific diagnostics for incomplete ownership records, unsafe managed files, and cron jobs that cannot be corroborated with live Gateway inventory.

주요 항목:

Managed: the Claw introduced and currently manages the resource. It is a
Referenced: the resource existed independently or is shared. Removal

openclaw claws status
openclaw claws status incident-triage --json
openclaw doctor

Update an installed Claw

By default, update uses the source recorded when the Claw was added. Use --from when that source moved or when testing another package directory:

openclaw claws update incident-triage --dry-run --json
openclaw claws update incident-triage \
  --from ./incident-triage-next \
  --dry-run --json

openclaw claws update incident-triage \
  --yes \
  --plan-integrity <SHA256_FROM_DRY_RUN>

Remove an installed Claw

Preview removal before selecting cleanup:

openclaw claws remove incident-triage --dry-run --json
openclaw claws remove incident-triage \
  --yes \
  --plan-integrity <SHA256_FROM_DRY_RUN>

openclaw claws remove incident-triage \
  --dry-run \
  --remove-referenced 'plugin:@acme/audit-plugin@2.0.0'

Export an installed agent

Export creates a new package directory and fails if the destination exists or managed state has drifted:

openclaw claws export incident-triage --out ./incident-triage-export --json

Command reference

Use --json for experimental machine-readable output.

Command	Purpose
`claws inspect <source>`	Validate a package directory or grouped manifest.
`claws add <source>`	Preview or create one new agent and workspace.
`claws status [claw-or-agent]`	Report installed state, ownership, and drift.
`claws update <claw-or-agent>`	Preview or apply changes from the selected source.
`claws remove <claw-or-agent>`	Preview or remove the agent and eligible resources.
`claws export <agent> --out <path>`	Create a portable package from an installed agent.

함께 보기

주요 항목:

Agents
Skills
Plugins
Cron jobs
MCP configuration

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/cli/claws
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

{
  "name": "@acme/incident-triage-claw",
  "version": "1.0.0",
  "type": "module",
  "openclaw": { "claw": "CLAW.md" }
}

---
schemaVersion: 1
agent:
  id: incident-triage
  name: Incident triage
metadata:
  openclaw.config: profiles/openclaw.yml
workspace:
  bootstrapFiles: {}
packages: []
mcpServers: {}
cronJobs: []
---

# Incident triage

Creates one agent for reviewing and routing incidents.

schemaVersion: 1
agent:
  tools:
    profile: coding
    alsoAllow: [cron]
    deny: [exec]
    fs:
      workspaceOnly: true
  memory:
    search:
      enabled: true
      rememberAcrossConversations: true
      sources: [memory, sessions]

{
  "workspace": {
    "bootstrapFiles": {
      "SOUL.md": { "source": "workspace/SOUL.md" }
    },
    "files": [
      {
        "source": "workspace/reference/policy.md",
        "path": "reference/policy.md"
      }
    ]
  }
}

{
  "packages": [
    {
      "kind": "skill",
      "source": "clawhub",
      "ref": "incident-triage",
      "version": "1.0.0"
    },
    {
      "kind": "plugin",
      "source": "clawhub",
      "ref": "@acme/audit-plugin",
      "version": "2.0.0"
    }
  ]
}

Claws

핵심 요약

Create, add, update, and remove experimental Claw agent packages

한국어 가이드 범위: cli/claws 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Create a Claw package
Incident triage
Inspect and preview
Inspect installed state
Update an installed Claw
Remove an installed Claw
Export an installed agent
Command reference
함께 보기

상세 내용

openclaw claws

Create a Claw package

A package contains package.json, a CLAW.md manifest, and any profiles or workspace sidecars referenced by that manifest:

{
  "name": "@acme/incident-triage-claw",
  "version": "1.0.0",
  "type": "module",
  "openclaw": { "claw": "CLAW.md" }
}

Incident triage

`metadata` is a string-to-string map for portable consumer hints. OpenClaw's
`openclaw.config` key points to an optional, package-relative YAML profile. The
exported default is `profiles/openclaw.yml`; the pointer is normative, so a
package may choose another safe relative `.yml` or `.yaml` path.

This profile exists only inside the Claw package. OpenClaw validates and uses it
while inspecting, adding, updating, and exporting that Claw; it is not copied
to the user's normal OpenClaw configuration path. Other harnesses can ignore
the namespaced metadata key and consume the portable manifest fields.

The same strict version 1 schema continues to accept grouped JSON manifests.
Grouped JSON uses the same `metadata.openclaw.config` pointer rather than
embedding a second copy of the OpenClaw profile. The remaining schema fragments
on this page use JSON, with equivalent keys available in `CLAW.md` frontmatter.

The OpenClaw package profile may select any built-in tool profile registered by
the running OpenClaw version, then refine it with `alsoAllow`, `deny`, and
`tools.fs.workspaceOnly: true`. A Claw cannot set that field to `false` and
weaken host filesystem confinement. `tools.allow` remains available as an
explicit allowlist but cannot be combined with `alsoAllow`. A Claw may also set
`memory.search.enabled`, choose the portable `memory` and `sessions` sources,
and opt into cross-conversation memory with `rememberAcrossConversations`.
Declaring the `sessions` source requires that opt-in.
Host policy still constrains these settings, and Claws do not carry custom
profile definitions, providers, credentials, bindings, or local memory paths.
The referenced profile is limited to 256 KiB, must be JSON-compatible YAML, may
not use aliases, anchors, tags, or merge keys, and must be a regular,
non-symlinked, non-hardlinked file inside the package.

Package and workspace paths must remain inside the package root. Manifests are
limited to 1 MiB, package metadata to 256 KiB, and workspace sources enforce
separate per-file and aggregate limits. Workspace sources also reject symlinked
parents.

Workspace files are declared by path and read from package sidecars. Bootstrap
files such as `SOUL.md` use named entries; additional files use package-relative
sources and workspace-relative targets:

Skills and plugins use exact ClawHub versions:

The dry run uses the existing skill and plugin preflight paths to resolve the
exact artifact, integrity, and any ClawHub trust warning before consent. The
warning remains visible in the integrity-bound plan. Apply installs missing artifacts
or reuses matching ones and records whether the Claw introduced or referenced
each resource. Plugins remain process-wide OpenClaw capabilities rather than
per-agent installations.

Cron jobs declare scheduled work for the new agent:

Inspect and preview

Validate the source without planning local changes:

openclaw claws inspect ./incident-triage.claw.json

openclaw claws add ./incident-triage.claw.json --dry-run --json

openclaw claws add ./incident-triage.claw.json \
  --yes \
  --plan-integrity <SHA256_FROM_DRY_RUN>

Inspect installed state

주요 항목:

Managed: the Claw introduced and currently manages the resource. It is a
Referenced: the resource existed independently or is shared. Removal

openclaw claws status
openclaw claws status incident-triage --json
openclaw doctor

Update an installed Claw

By default, update uses the source recorded when the Claw was added. Use --from when that source moved or when testing another package directory:

openclaw claws update incident-triage --dry-run --json
openclaw claws update incident-triage \
  --from ./incident-triage-next \
  --dry-run --json

openclaw claws update incident-triage \
  --yes \
  --plan-integrity <SHA256_FROM_DRY_RUN>

Remove an installed Claw

Preview removal before selecting cleanup:

openclaw claws remove incident-triage --dry-run --json
openclaw claws remove incident-triage \
  --yes \
  --plan-integrity <SHA256_FROM_DRY_RUN>

openclaw claws remove incident-triage \
  --dry-run \
  --remove-referenced 'plugin:@acme/audit-plugin@2.0.0'

Export an installed agent

Export creates a new package directory and fails if the destination exists or managed state has drifted:

openclaw claws export incident-triage --out ./incident-triage-export --json

Command reference

Use --json for experimental machine-readable output.

Command	Purpose
`claws inspect <source>`	Validate a package directory or grouped manifest.
`claws add <source>`	Preview or create one new agent and workspace.
`claws status [claw-or-agent]`	Report installed state, ownership, and drift.
`claws update <claw-or-agent>`	Preview or apply changes from the selected source.
`claws remove <claw-or-agent>`	Preview or remove the agent and eligible resources.
`claws export <agent> --out <path>`	Create a portable package from an installed agent.

함께 보기

주요 항목:

Agents
Skills
Plugins
Cron jobs
MCP configuration

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/cli/claws
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

{
  "name": "@acme/incident-triage-claw",
  "version": "1.0.0",
  "type": "module",
  "openclaw": { "claw": "CLAW.md" }
}

---
schemaVersion: 1
agent:
  id: incident-triage
  name: Incident triage
metadata:
  openclaw.config: profiles/openclaw.yml
workspace:
  bootstrapFiles: {}
packages: []
mcpServers: {}
cronJobs: []
---

# Incident triage

Creates one agent for reviewing and routing incidents.

schemaVersion: 1
agent:
  tools:
    profile: coding
    alsoAllow: [cron]
    deny: [exec]
    fs:
      workspaceOnly: true
  memory:
    search:
      enabled: true
      rememberAcrossConversations: true
      sources: [memory, sessions]

{
  "workspace": {
    "bootstrapFiles": {
      "SOUL.md": { "source": "workspace/SOUL.md" }
    },
    "files": [
      {
        "source": "workspace/reference/policy.md",
        "path": "reference/policy.md"
      }
    ]
  }
}

{
  "packages": [
    {
      "kind": "skill",
      "source": "clawhub",
      "ref": "incident-triage",
      "version": "1.0.0"
    },
    {
      "kind": "plugin",
      "source": "clawhub",
      "ref": "@acme/audit-plugin",
      "version": "2.0.0"
    }
  ]
}

Claws

핵심 요약

문서 구성

상세 내용

openclaw claws

Create a Claw package

Incident triage

Inspect and preview

Inspect installed state

Update an installed Claw

Remove an installed Claw

Export an installed agent

Command reference

함께 보기

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

Claws

핵심 요약

문서 구성

상세 내용

openclaw claws

Create a Claw package

Incident triage

Inspect and preview

Inspect installed state

Update an installed Claw

Remove an installed Claw

Export an installed agent

Command reference

함께 보기

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드