前言

自从🦞让大模型从 “聊天建议” 升级为能在电脑端自主完成系统级任务的 “数字员工”后，日常沟通时总是记不住命令，需要各种翻阅api手册……

于是总结了openclaw最常用场景下的各种指令，方便随用随查。

核心 CLI 命令

安装

#安装
npm install -g openclaw@latest

#新手引导
openclaw onboard --install-daemon

系统与状态管理

用于环境排查、功能异常自检、错误定位等

# 查看系统/模型/设备状态（环境排查、确认运行状态）
openclaw status
openclaw status --deep

# 诊断系统问题 （启动失败、功能异常自检）
openclaw doctor

# 自动修复常见问题（快速解决配置 / 权限故障）
openclaw doctor --fix

# 查看系统日志（深度排错、定位报错）
openclaw logs --limit 100

# 健康检查
openclaw health

# 重启服务
openclaw restart

网关管理

# 启动网关
openclaw gateway --port 8089 --verbose

# 后台运行
openclaw gateway --daemon

# 停止
openclaw gateway stop

# 重启网关
openclaw gateway restart

# 新设备（手机 / 服务器）认证, 生成设备接入 Token	
openclaw gateway tokens generate

设备管理

# 列出已连接设备、查看在线状态
openclaw devices list

# 移除指定设备
openclaw devices remove <id>	

会话管理

# 创建新会话,隔离上下文
openclaw session new --agent <name>

# 列出所有会话
openclaw sessions list

# 查看特定的会话详情
openclaw sessions show <id>

# 重置会话（清除上下文）
openclaw sessions reset <id>

# 删除会话
openclaw sessions delete <id>

与智能体对话

# 与智能体对话
openclaw agent --message "Task description" --thinking high

# 发送消息
openclaw message send --to "+1234567890" --message "Hello"

# 快捷方式
openclaw msg -t "@username" -m "Hello"

配置与记忆

基础配置的参数如下：

{
  "gateway": {
    "port": 18789,
    "bind": "127.0.0.1",
    "auth": {
      "mode": "token",
      "token": "your_secure_token"
    }
  },
"agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4"

###
# 模型的别名
# kimi → moonshot/kimi-k2.5
# kimi K2.5 → kimi-coding/k2p5
# opus → anthropic/claude-opus-4
###
      }
    }
  }
}

一些常用的命令：

# 查看/设置/删除配置	切换模型、调整超时参数
openclaw config get/set/unset <key>	
# 
# 例"Browser disabled"
openclaw config set browser.enabled true
openclaw gateway restart

# 端口冲突
lsof -i :18789
openclaw config set gateway.port 18790

# 验证配置合法性
openclaw config validate
	
# 搜索历史记忆，用于找回过往任务和偏好设置
openclaw memory search <keyword>

# 记忆查询缓慢、数据异常时重建记忆索引	
openclaw memory reindex	


# "Missing API Key"
openclaw configure --section web

Docker 命令

用于部署：

docker compose up -d
docker compose logs -f
docker compose ps
docker compose pull && docker compose up -d

# docker-compose.yml

version: '3.8'
services:
openclaw:
    image:openclaw/openclaw:latest
    ports:
      -"18789:18789"
    volumes:
      -./data:/root/.openclaw
    environment:
      -ANTHROPIC_API_KEY=sk-ant-...
    restart:unless-stopped

浏览器自动化

# 检查状态
openclaw browser status

# 启动浏览器实例	开始网页自动化操作
openclaw browser start	

# 打开指定网页	自动访问目标站点
openclaw browser open --url <url>	
# openclaw browser open https://example.com

# 点击页面元素	模拟按钮 / 链接点击
openclaw browser click --ref <selector>	

# 输入文本	自动填表、搜索
openclaw browser type --ref <selector> --text <content>	

# 页面截图
openclaw browser screenshot --output <file>	
# openclaw browser screenshot --full-page

# 保存页面为 PDF	网页存档、报告生成
openclaw browser pdf --output <file>	

# 获取快照
openclaw browser snapshot

工具调用

// 导航
browser({ action: "open", targetUrl: "https://example.com" })

// 点击
browser({ action: "act", request: { kind: "click", ref: "e12" } })

// 输入
browser({ action: "act", request: { kind: "type", ref: "e15", text: "value", submit: true } })

// 截图
browser({ action: "screenshot", fullPage: true })

// PDF
browser({ action: "pdf", path: "page.pdf" })

斜杠命令及web工具

# 查看所有可用命令	忘记用法、探索新功能
/commands	

# 查看当前会话状态	了解模型 / 资源使用情况
/status

# 切换大模型（GPT/Claude/Llama 等）	按任务需求更换模型
/model <模型名>	

# 新建对话、清空上下文	切换话题、避免上下文干扰
/new

# 重置当前会话状态	会话跑偏、重新开始	
/reset	

# 调整思考深度	复杂任务加深推理、简单任务提速
/think <1-10>	

# 开启详细执行日志	排错、查看执行细节
/verbose	

web 工具

// 基础搜索
web_search({ query: "OpenClaw AI agent" })

// 高级搜索
web_search({
query: "search term",
count: 10,
country: "US",
search_lang: "en",
freshness: "pw"// past week
})


// 获取内容
web_fetch({ url: "https://example.com" })

// 指定格式
web_fetch({
  url: "https://example.com",
  extractMode: "markdown",
  maxChars: 10000
})

成本控制

// 主代理用高质量模型
// 子代理用便宜模型
sessions_spawn({
  task: "Simple task",
  model: "kimi",
  thinking: "low"
})

Skills模版

---
name: my-skill
description: Skill description
metadata:
  { "openclaw": { "emoji": "✨" } }
---

# My Skill

## Usage
Instructions here...

clawhub

clawhub search keyword
clawhub install skill-name
clawhub update --all
clawhub info skill-name

总结

一些特高频应用场景:

文件：自动整理文件、生成报表、处理邮件

openclaw run --agent file_manage --command "整理桌面文件"

网页：网页抓取、表单填写、定时监控

openclaw browser start 
openclaw browser open --url <网址> 
openclaw browser screenshot --output <路径>

故障排查：快速定位并修复运行异常

openclaw status 
openclaw doctor 
openclaw logs

自定义任务：批量 / 定时执行复杂任务链

openclaw run-file <任务.yaml>

openclaw run --agent <name> --command <task>

多设备协作：多终端接入、统一管理

openclaw gateway tokens generate 
openclaw devices list

通过命令可实现本地 AI 智能体的全生命周期管理，从环境诊断、任务执行到多设备协作全覆盖。

排错优先用status/doctor/logs，批量任务用run-file，网页操作优先调用浏览器系列命令。