> ## Documentation Index
> Fetch the complete documentation index at: https://openclawdoc.org/llms.txt
> Use this file to discover all available pages before exploring further.

> OpenClaw Gateway를 통해 단일 agent turn을 실행하는 `openclaw agent` 명령의 사용 예시와 credential marker 동작을 간단히 정리합니다.

# agent

# `openclaw agent`

Gateway를 통해 agent turn 하나를 실행합니다. embedded mode를 쓰려면 `--local`을 사용하세요. 특정 configured agent를 직접 target하려면 `--agent <id>`를 사용합니다.

Related:

* Agent send tool: [Agent send](/tools/agent-send)

## Examples

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agent --to +15555550123 --message "status update" --deliver
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
```

## Notes

* 이 명령이 `models.json` 재생성을 트리거하면, SecretRef-managed provider credential은 resolved secret plaintext가 아니라 non-secret marker로 저장됩니다. 예: env var name, `secretref-env:ENV_VAR_NAME`, `secretref-managed`
* marker write는 source-authoritative입니다. OpenClaw는 resolved runtime secret value가 아니라 active source config snapshot의 marker를 저장합니다.