OpenClaw Basics

Agents Management

List Agents

View all configured agents and their current status.

openclaw agents list

List Agents with Bindings

View agents along with their active communication channel bindings (e.g., Telegram, Discord).

openclaw agents list --bindings

Add a New Agent

Create a new agent by pointing it to a specific workspace directory.

openclaw agents add [agent_name] --workspace [path]

Add Agent with Automated Binding

Create an agent, bind it to a channel, and disable interactive prompts for automation scripts.

openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive

Manage Bindings

View, create, or remove connections between agents and specific communication channels.

List current bindings.

openclaw agents bindings

Bind an existing agent to a channel.

openclaw agents bind --agent [agent_name] --bind telegram:ops

Unbind an agent from a channel.

openclaw agents unbind --agent [agent_name] --bind telegram:ops

Identity & Branding

Set the persona and visual avatar for your agents.

Set identity from a specific workspace.

openclaw agents set-identity --workspace [path] --from-identity

Set a custom avatar image for an agent.

openclaw agents set-identity --agent [agent_name] --avatar avatars/openclaw.png

Delete Agent

Permanently remove an agent configuration.

openclaw agents delete [agent_name]

Cron & Task Automation

Scheduled Jobs (Cron)

Manage automated tasks like weather reports or news digests.

List all scheduled cron jobs.

openclaw cron list

Add a new cron job.

openclaw cron add --name "Morning Brief" --cron "0 8 * * *" --message "Find weather for Poltava"

Run a job manually by ID.

openclaw cron run [job_id]

Edit an existing job.

openclaw cron edit [job_id] --message "New prompt text"

System & Resources

Model Management

Interact with the underlying AI models.

List available AI models.

openclaw models list

Scan the environment for new models.

openclaw models scan --yes

Skill Management

List installed capabilities (skills) available to the agents.

openclaw skills list

Device Management

Approve and manage external devices connecting to the gateway.

List connecting devices.

openclaw devices list

Approve a device.

openclaw devices approve [device_id]

Useful File Paths

Troubleshooting

• Logs: Check real-time activity using docker logs -f openclaw-gateway.
• Restart: Apply config changes with docker restart openclaw-gateway.
• Dashboard: Access the CLI dashboard using openclaw dashboard.