openclaw status
openclaw status --deep     # 探测频道
openclaw health

智能体管理

列出智能体：

openclaw agents list
openclaw agents list --bindings    # 显示路由绑定

添加智能体：

# 交互式向导
openclaw agents add <name>

# 非交互式
openclaw agents add dev \
  --workspace ~/.openclaw/workspace-dev \
  --model claude-sonnet-4.5 \
  --non-interactive

删除智能体：

openclaw agents delete <id>

设置身份：

# 从 IDENTITY.md 文件读取
openclaw agents set-identity --agent main --from-identity

# 显式指定值
openclaw agents set-identity --agent main \
  --name "MyAgent" \
  --emoji "🤖" \
  --avatar avatars/bot.png

技能管理

列出技能：

openclaw skills list
openclaw skills list --eligible    # 仅显示就绪技能
openclaw skills list --json        # JSON 输出

技能信息：

openclaw skills info <skill-name>

检查资格：

openclaw skills check

钩子管理

列出钩子：

openclaw hooks list
openclaw hooks list --eligible
openclaw hooks list --verbose      # 显示缺失的要求

钩子信息：

openclaw hooks info <hook-name>

启用/禁用：

openclaw hooks enable session-memory
openclaw hooks disable command-logger

安装钩子：

# 从 npm 安装
openclaw hooks install @openclaw/my-hooks

# 本地目录
openclaw hooks install ./my-hooks

# 链接（开发模式）
openclaw hooks install -l ./my-hooks

更新钩子：

openclaw hooks update <id>
openclaw hooks update --all

频道管理

列出频道：

openclaw channels list

频道状态：

openclaw channels status
openclaw channels status --probe

添加频道：

# 交互式
openclaw channels add

# Telegram 机器人
openclaw channels add --channel telegram \
  --account alerts \
  --name "Alerts Bot" \
  --token $TELEGRAM_BOT_TOKEN

# Discord
openclaw channels add --channel discord \
  --account work \
  --token $DISCORD_BOT_TOKEN

移除频道：

openclaw channels remove --channel telegram --account alerts
openclaw channels remove --channel discord --account work --delete

WhatsApp 登录：

openclaw channels login --channel whatsapp

频道日志：

openclaw channels logs
openclaw channels logs --channel whatsapp --lines 100

模型与认证

状态：

openclaw models status
openclaw models status --probe               # 实时检查
openclaw models status --probe-provider anthropic

列出模型：

openclaw models list
openclaw models list --all
openclaw models list --provider anthropic

设置默认模型：

openclaw models set claude-sonnet-4.5
openclaw models set-image claude-sonnet-4.5

认证设置：

# Anthropic（推荐）
claude setup-token
openclaw models auth setup-token --provider anthropic

# 或粘贴令牌
openclaw models auth paste-token --provider anthropic

备用模型：

openclaw models fallbacks list
openclaw models fallbacks add claude-opus-4.6
openclaw models fallbacks remove claude-haiku-4.5
openclaw models fallbacks clear

扫描模型：

openclaw models scan
openclaw models scan --set-default

消息发送

发送消息：

openclaw message send \
  --target +15555550123 \
  --message "Hello from OpenClaw"

# Discord 频道
openclaw message send \
  --channel discord \
  --target channel:123456 \
  --message "Deployment complete"

发送投票：

openclaw message poll \
  --channel discord \
  --target channel:123 \
  --poll-question "Lunch?" \
  --poll-option "Pizza" \
  --poll-option "Sushi"

其他消息操作：

openclaw message read --target +15555550123
openclaw message react --target <id> --emoji "👍"
openclaw message edit --target <id> --message "Updated"
openclaw message delete --target <id>

浏览器控制

状态与控制：

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser tabs

导航：

openclaw browser open https://example.com
openclaw browser navigate https://example.com --target-id <id>

交互：

openclaw browser click "#submit-button"
openclaw browser type "#email" "user@example.com"
openclaw browser press Enter

捕获：

openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser snapshot --format ai

配置文件：

openclaw browser profiles
openclaw browser create-profile --name dev
openclaw browser delete-profile --name old

节点与设备

列出节点：

openclaw nodes list
openclaw nodes status --connected

节点操作：

# 描述节点
openclaw nodes describe --node <id>

# 在节点上运行命令
openclaw nodes run --node <id> --cwd /path -- ls -la

# 通知（macOS）
openclaw nodes notify --node <id> \
  --title "Build Complete" \
  --body "Success" \
  --sound default

摄像头：

openclaw nodes camera list --node <id>
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 10s

画布：

openclaw nodes canvas snapshot --node <id>
openclaw nodes canvas present --node <id> --target index.html
openclaw nodes canvas hide --node <id>

屏幕录制：

openclaw nodes screen record --node <id> --duration 30s

系统命令

系统事件：

openclaw system event --text "Deployment complete" --mode now

心跳：

openclaw system heartbeat last
openclaw system heartbeat enable
openclaw system heartbeat disable

在线状态：

openclaw system presence

定时任务

列出任务：

openclaw cron list
openclaw cron list --all
openclaw cron status

添加任务：

# 每小时触发系统事件
openclaw cron add \
  --name "hourly-check" \
  --every "1h" \
  --system-event "Hourly check"

# 在特定时间发送消息
openclaw cron add \
  --name "morning-reminder" \
  --at "09:00" \
  --message "Good morning!"

管理任务：

openclaw cron enable <id>
openclaw cron disable <id>
openclaw cron rm <id>
openclaw cron run <id>

任务运行记录：

openclaw cron runs --id <id> --limit 10

配置

获取/设置配置：

# 获取值
openclaw config get agents.defaults.model.primary

# 设置值
openclaw config set agents.defaults.model.primary "claude-sonnet-4.5"

# 取消设置值
openclaw config unset some.config.path

内存操作

内存状态：

openclaw memory status

索引内存：

openclaw memory index

搜索内存：

openclaw memory search "GraphQL implementation patterns"

日志

跟踪日志：

openclaw logs
openclaw logs --follow
openclaw logs --limit 200
openclaw logs --json

沙盒

列出沙盒：

openclaw sandbox list

重新创建沙盒：

openclaw sandbox recreate

安全

安全审计：

openclaw security audit
openclaw security audit --deep
openclaw security audit --fix

插件

列出插件：

openclaw plugins list
openclaw plugins list --json

插件信息：

openclaw plugins info <plugin-id>

安装插件：

openclaw plugins install <path-or-spec>

启用/禁用：

openclaw plugins enable <id>
openclaw plugins disable <id>

插件健康检查：

openclaw plugins doctor

更新与维护

更新 OpenClaw：

openclaw update

重置配置：

openclaw reset --scope config
openclaw reset --scope config+creds+sessions
openclaw reset --scope full

卸载：

openclaw uninstall --service
openclaw uninstall --state
openclaw uninstall --workspace
openclaw uninstall --all

全局标志

所有命令可用：

--dev               # 使用 ~/.openclaw-dev 进行隔离
--profile <name>    # 使用 ~/.openclaw-<name>
--no-color         # 禁用 ANSI 颜色
--json             # 机器可读输出
-V, --version      # 显示版本

常见工作流

首次设置

# 1. 入门并安装守护进程
openclaw onboard --install-daemon

# 2. 配对 WhatsApp（或其他频道）
openclaw channels login

# 3. 启动网关
openclaw gateway

# 4. 发送消息测试
openclaw message send --target +1234567890 --message "Test"

多智能体设置

# 1. 添加智能体
openclaw agents add work --workspace ~/.openclaw/workspace-work

# 2. 设置身份
openclaw agents set-identity --agent work --from-identity

# 3. 添加绑定（在 openclaw.json 中）
# bindings: [{ agentId: "work", match: { channel: "discord" } }]

# 4. 列出验证
openclaw agents list --bindings

钩子自动化

# 1. 启用会话内存钩子
openclaw hooks enable session-memory

# 2. 启用命令记录器
openclaw hooks enable command-logger

# 3. 验证
openclaw hooks check

# 4. 重启网关
openclaw gateway restart

频道设置

# 1. 添加 Telegram 机器人
openclaw channels add --channel telegram \
  --account alerts \
  --token $TELEGRAM_BOT_TOKEN

# 2. 验证
openclaw channels status

# 3. 发送测试消息
openclaw message send --channel telegram \
  --target <chat-id> \
  --message "Bot online"

模型配置

# 1. 设置认证
claude setup-token

# 2. 设置默认模型
openclaw models set claude-sonnet-4.5

# 3. 添加备用模型
openclaw models fallbacks add claude-opus-4.6
openclaw models fallbacks add claude-haiku-4.5

# 4. 验证
openclaw models status

调试

检查网关状态：

openclaw status --deep
openclaw doctor
openclaw health

查看日志：

openclaw logs --follow
openclaw channels logs --lines 200

测试频道：

openclaw channels status --probe

检查技能/钩子：

openclaw skills check
openclaw hooks check
openclaw plugins doctor

提示

1. 脚本中使用 --json - 所有命令都支持 JSON 输出
2. 配置文件隔离 - 使用 --profile 进行测试，不影响主配置
3. 医生修复 - 定期运行 openclaw doctor 以发现问题
4. 日志位置 - ~/.openclaw/logs/ 存放文件日志
5. 配置位置 - ~/.openclaw/openclaw.json
6. 工作空间 - ~/.openclaw/workspace（或自定义路径）

资源

• OpenClaw 文档
• CLI 参考
• 多智能体路由
• 钩子系统
• 技能系统

每周安装量

205

仓库

irangareddy/ope…sentials

首次出现

2026年2月16日

安全审计

Gen Agent Trust HubWarnSocketPassSnykFail

已安装于

gemini-cli199

opencode199

codex197

cursor196

github-copilot196

kimi-cli194

Gateway health:

openclaw status
openclaw status --deep     # Probe channels
openclaw health

Agent Management

List agents:

openclaw agents list
openclaw agents list --bindings    # Show routing

Add agent:

# Interactive wizard
openclaw agents add <name>

# Non-interactive
openclaw agents add dev \
  --workspace ~/.openclaw/workspace-dev \
  --model claude-sonnet-4.5 \
  --non-interactive

Delete agent:

openclaw agents delete <id>

Set identity:

# From IDENTITY.md
openclaw agents set-identity --agent main --from-identity

# Explicit values
openclaw agents set-identity --agent main \
  --name "MyAgent" \
  --emoji "🤖" \
  --avatar avatars/bot.png

Skills Management

List skills:

openclaw skills list
openclaw skills list --eligible    # Only ready skills
openclaw skills list --json        # JSON output

Skill info:

openclaw skills info <skill-name>

Check eligibility:

openclaw skills check

Hooks Management

List hooks:

openclaw hooks list
openclaw hooks list --eligible
openclaw hooks list --verbose      # Show missing requirements

Hook info:

openclaw hooks info <hook-name>

Enable/disable:

openclaw hooks enable session-memory
openclaw hooks disable command-logger

Install hooks:

# From npm
openclaw hooks install @openclaw/my-hooks

# Local directory
openclaw hooks install ./my-hooks

# Link (development)
openclaw hooks install -l ./my-hooks

Update hooks:

openclaw hooks update <id>
openclaw hooks update --all

Channel Management

List channels:

openclaw channels list

Channel status:

openclaw channels status
openclaw channels status --probe

Add channel:

# Interactive
openclaw channels add

# Telegram bot
openclaw channels add --channel telegram \
  --account alerts \
  --name "Alerts Bot" \
  --token $TELEGRAM_BOT_TOKEN

# Discord
openclaw channels add --channel discord \
  --account work \
  --token $DISCORD_BOT_TOKEN

Remove channel:

openclaw channels remove --channel telegram --account alerts
openclaw channels remove --channel discord --account work --delete

WhatsApp login:

openclaw channels login --channel whatsapp

Channel logs:

openclaw channels logs
openclaw channels logs --channel whatsapp --lines 100

Models & Authentication

Status:

openclaw models status
openclaw models status --probe               # Live check
openclaw models status --probe-provider anthropic

List models:

openclaw models list
openclaw models list --all
openclaw models list --provider anthropic

Set default:

openclaw models set claude-sonnet-4.5
openclaw models set-image claude-sonnet-4.5

Auth setup:

# Anthropic (recommended)
claude setup-token
openclaw models auth setup-token --provider anthropic

# Or paste token
openclaw models auth paste-token --provider anthropic

Fallbacks:

openclaw models fallbacks list
openclaw models fallbacks add claude-opus-4.6
openclaw models fallbacks remove claude-haiku-4.5
openclaw models fallbacks clear

Scan for models:

openclaw models scan
openclaw models scan --set-default

Messaging

Send message:

openclaw message send \
  --target +15555550123 \
  --message "Hello from OpenClaw"

# Discord channel
openclaw message send \
  --channel discord \
  --target channel:123456 \
  --message "Deployment complete"

Send poll:

openclaw message poll \
  --channel discord \
  --target channel:123 \
  --poll-question "Lunch?" \
  --poll-option "Pizza" \
  --poll-option "Sushi"

Other message operations:

openclaw message read --target +15555550123
openclaw message react --target <id> --emoji "👍"
openclaw message edit --target <id> --message "Updated"
openclaw message delete --target <id>

Browser Control

Status & control:

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser tabs

Navigate:

openclaw browser open https://example.com
openclaw browser navigate https://example.com --target-id <id>

Interact:

openclaw browser click "#submit-button"
openclaw browser type "#email" "user@example.com"
openclaw browser press Enter

Capture:

openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser snapshot --format ai

Profiles:

openclaw browser profiles
openclaw browser create-profile --name dev
openclaw browser delete-profile --name old

Nodes & Devices

List nodes:

openclaw nodes list
openclaw nodes status --connected

Node operations:

# Describe node
openclaw nodes describe --node <id>

# Run command on node
openclaw nodes run --node <id> --cwd /path -- ls -la

# Notify (macOS)
openclaw nodes notify --node <id> \
  --title "Build Complete" \
  --body "Success" \
  --sound default

Camera:

openclaw nodes camera list --node <id>
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 10s

Canvas:

openclaw nodes canvas snapshot --node <id>
openclaw nodes canvas present --node <id> --target index.html
openclaw nodes canvas hide --node <id>

Screen recording:

openclaw nodes screen record --node <id> --duration 30s

System Commands

System event:

openclaw system event --text "Deployment complete" --mode now

Heartbeat:

openclaw system heartbeat last
openclaw system heartbeat enable
openclaw system heartbeat disable

Presence:

openclaw system presence

Cron Jobs

List jobs:

openclaw cron list
openclaw cron list --all
openclaw cron status

Add job:

# System event every hour
openclaw cron add \
  --name "hourly-check" \
  --every "1h" \
  --system-event "Hourly check"

# Message at specific time
openclaw cron add \
  --name "morning-reminder" \
  --at "09:00" \
  --message "Good morning!"

Manage jobs:

openclaw cron enable <id>
openclaw cron disable <id>
openclaw cron rm <id>
openclaw cron run <id>

Job runs:

openclaw cron runs --id <id> --limit 10

Configuration

Get/set config:

# Get value
openclaw config get agents.defaults.model.primary

# Set value
openclaw config set agents.defaults.model.primary "claude-sonnet-4.5"

# Unset value
openclaw config unset some.config.path

Memory Operations

Memory status:

openclaw memory status

Index memory:

openclaw memory index

Search memory:

openclaw memory search "GraphQL implementation patterns"

Logs

Tail logs:

openclaw logs
openclaw logs --follow
openclaw logs --limit 200
openclaw logs --json

Sandbox

List sandboxes:

openclaw sandbox list

Recreate sandbox:

openclaw sandbox recreate

Security

Security audit:

openclaw security audit
openclaw security audit --deep
openclaw security audit --fix

Plugins

List plugins:

openclaw plugins list
openclaw plugins list --json

Plugin info:

openclaw plugins info <plugin-id>

Install plugin:

openclaw plugins install <path-or-spec>

Enable/disable:

openclaw plugins enable <id>
openclaw plugins disable <id>

Plugin health:

openclaw plugins doctor

Update & Maintenance

Update OpenClaw:

openclaw update

Reset config:

openclaw reset --scope config
openclaw reset --scope config+creds+sessions
openclaw reset --scope full

Uninstall:

openclaw uninstall --service
openclaw uninstall --state
openclaw uninstall --workspace
openclaw uninstall --all

Global Flags

Available everywhere:

--dev               # Use ~/.openclaw-dev for isolation
--profile <name>    # Use ~/.openclaw-<name>
--no-color         # Disable ANSI colors
--json             # Machine-readable output
-V, --version      # Show version

Common Workflows

First-Time Setup

# 1. Onboard with daemon
openclaw onboard --install-daemon

# 2. Pair WhatsApp (or other channel)
openclaw channels login

# 3. Start gateway
openclaw gateway

# 4. Test with message
openclaw message send --target +1234567890 --message "Test"

Multi-Agent Setup

# 1. Add agent
openclaw agents add work --workspace ~/.openclaw/workspace-work

# 2. Set identity
openclaw agents set-identity --agent work --from-identity

# 3. Add binding (in openclaw.json)
# bindings: [{ agentId: "work", match: { channel: "discord" } }]

# 4. List to verify
openclaw agents list --bindings

Hook Automation

# 1. Enable session memory hook
openclaw hooks enable session-memory

# 2. Enable command logger
openclaw hooks enable command-logger

# 3. Verify
openclaw hooks check

# 4. Restart gateway
openclaw gateway restart

Channel Setup

# 1. Add Telegram bot
openclaw channels add --channel telegram \
  --account alerts \
  --token $TELEGRAM_BOT_TOKEN

# 2. Verify
openclaw channels status

# 3. Send test message
openclaw message send --channel telegram \
  --target <chat-id> \
  --message "Bot online"

Model Configuration

# 1. Setup auth
claude setup-token

# 2. Set default model
openclaw models set claude-sonnet-4.5

# 3. Add fallbacks
openclaw models fallbacks add claude-opus-4.6
openclaw models fallbacks add claude-haiku-4.5

# 4. Verify
openclaw models status

Debugging

Check gateway status:

openclaw status --deep
openclaw doctor
openclaw health

View logs:

openclaw logs --follow
openclaw channels logs --lines 200

Test channel:

openclaw channels status --probe

Check skills/hooks:

openclaw skills check
openclaw hooks check
openclaw plugins doctor

Tips

1. Use--json for scripting - All commands support JSON output
2. Profile isolation - Use --profile for testing without affecting main config
3. Doctor fixes - Run openclaw doctor regularly to catch issues
4. Logs location - ~/.openclaw/logs/ for file logs
5. Config location - ~/.openclaw/openclaw.json
6. Workspace - ~/.openclaw/workspace (or custom path)

Resources

• OpenClaw Docs
• CLI Reference
• Multi-Agent Routing
• Hooks System
• Skills System

Weekly Installs

205

Repository

irangareddy/ope…sentials

First Seen

Feb 16, 2026

Security Audits

Gen Agent Trust HubWarnSocketPassSnykFail

Installed on

gemini-cli199

opencode199

codex197

cursor196

github-copilot196

kimi-cli194