🦞 OpenClaw 命令行完全指南

v3.12
2026年3月更新
Gateway 通道 消息 Agent 模型 定时 更新 工具
💡 提示:使用 openclaw <command> -h 查看子命令帮助,如 openclaw acp -h

🌐 Gateway 服务

gateway start启动 Gateway
gateway stop停止 Gateway
gateway restart重启 Gateway
gateway status查看状态
gateway --force强制重启
health健康检查
doctor诊断修复
dashboard打开控制台
tui终端 UI
logs查看日志

💬 消息通道

channels login登录新通道
channels list列出通道
channels logout登出通道
pairing approve批准配对
directory查询联系人

📨 消息管理

message send发送消息
message list消息列表
message read读取消息
message delete删除消息

🤖 Agent 管理

acpACP 桥接
acp client交互式客户端
agents list列出 Agent
agents add添加 Agent
agents delete删除 Agent
agents bind添加路由
agents bindings查看路由
agent单次对话

🧠 模型配置

models status当前配置
models list可用模型
models scan扫描免费模型
models set设置默认
models set-image设置图像模型
models aliases管理别名
models fallbacks管理回退

⏰ 定时任务

cron list列出任务
cron add添加任务
cron remove删除任务
cron run立即运行
cron status调度状态

⬆️ 更新管理

update检查更新
update status更新状态
update --channel beta切换频道
update --dry-run预览更新
update wizard更新向导

🔧 工具集合

config get查看配置
config set设置配置
models模型(同 models status)
sandbox list沙箱列表
sandbox recreate重建沙箱
security audit安全审计
backup备份恢复
devices设备配对
nodes节点管理
plugins插件管理
skills技能列表
hooks钩子管理
webhooksWebhook
sessions会话管理
memory记忆搜索
qriOS 配对码

⚙️ 初始化配置

setup初始化配置
configure交互式向导
onboard引导向导
completion命令补全
reset重置配置
uninstall卸载服务

🔑 常用示例

# Gateway
openclaw gateway start
openclaw health

# 消息
openclaw message send --target @user --message "Hello"
openclaw channels login --verbose

# Agent
openclaw acp --session-label my-agent acp client
openclaw agents list

# 模型
openclaw models status
openclaw models set minimax-m2.5

# 更新
openclaw update --channel stable