OpenClaw 命令速查手册（2026 全面指南）

教程指南应用分享

先说结论： 这篇文章是 OpenClaw 的中文命令速查手册，覆盖 8 大模块、100+ 条常用命令，每条都附有中文解释，并新增钉钉企业机器人完整接入教程。无论你是刚入门还是已经在用，建议收藏备查。

OpenClaw 是什么？为什么值得学？

用一句话解释：OpenClaw 是一个跑在你自己电脑上的 AI 助手调度系统。

它不同于 ChatGPT、Claude 这类网页版聊天工具——那些工具你得主动打开浏览器去找它。OpenClaw 反过来，让 AI 嵌入你的工作流，主动替你干活：定时整理邮件、操控浏览器填表单、连接 Telegram 或钉钉随叫随到……

核心能力一览：

模块	能做什么	典型命令
Gateway	启动/管理 AI 核心服务	`gateway start` / `gateway status`
Channels	接入 Telegram/钉钉/Discord 等平台	`channels add` / `channels status`
Skills	安装邮件、日历等功能插件	`skills list` / `skills install`
Models	切换 Claude/GPT 等 AI 模型	`models set` / `models status`
Browser	让 AI 直接操控你的浏览器	`browser click` / `browser screenshot`
Nodes	连接手机、远程设备	`nodes list` / `nodes camera snap`
Cron	设置定时自动任务	`cron add` / `cron list`
钉钉接入	企业级钉钉机器人对接全流程	见第十节专题

💡 对普通用户的建议： 先看 Gateway、Channels、Skills 三个模块，就能覆盖日常 80% 的使用场景。Browser 和 Nodes 是进阶玩法，有兴趣再深入。国内企业用户重点看第十节钉钉接入。

一、基础设置命令

刚装完 OpenClaw，先把这几个命令跑一遍，把环境配置好。

# 启动交互式安装向导，新手必跑，会引导你一步步完成配置
openclaw setup --wizard

# 快速初始化，自动配置 Gateway、工作区和常用技能，比 wizard 更快
openclaw onboard

# 进入配置菜单，可手动配置 AI 模型、消息平台、系统参数等
openclaw configure

# 全面体检：扫描配置问题并自动修复，遇到奇怪问题先跑这个
openclaw doctor

# 安全审计：检查潜在的安全漏洞，加上 --fix 自动修复
openclaw security audit --fix

配置项读写

OpenClaw 的所有行为都由配置文件控制，下面三条命令让你随时查改：

# 读取某个配置项的当前值，比如查默认 AI 模型
openclaw config get agents.defaults.model.primary

# 修改某个配置项，比如把 AI 请求超时改为 300 秒
openclaw config set agents.defaults.timeoutSeconds 300

# 删除某个配置项，恢复默认值
openclaw config unset agents.defaults.timeoutSeconds

常用配置项速查：

配置项	含义
`agents.defaults.model.primary`	默认使用的 AI 模型
`agents.defaults.timeoutSeconds`	AI 响应超时时间（秒）
`gateway.port`	Gateway 监听端口
`skills.nodeManager`	技能包管理器（npm 或 pnpm）

全局参数

这些参数可以加在任意命令后面，非常实用：

# --dev：使用开发环境，配置文件存在 ~/.openclaw-dev，不影响生产环境
openclaw --dev status

# --profile：使用独立配置空间，适合工作/个人场景分离
openclaw --profile work gateway status

# --json：输出 JSON 格式，方便其他脚本处理结果
openclaw status --json

# --no-color：关闭彩色输出，日志写入文件时用这个
openclaw logs --no-color

二、Gateway 核心服务命令

Gateway 是 OpenClaw 的"心脏"，所有 AI 请求、消息收发、定时任务都经过它。掌握这几个命令是重中之重。

基础操作

# 查看 Gateway 运行状态，确认服务是否正常在线
openclaw gateway status

# 启动 Gateway 服务（安装后第一次需要手动启动）
openclaw gateway start

# 停止 Gateway 服务
openclaw gateway stop

# 重启 Gateway，修改配置或遇到异常时用这个
# 👉 90% 的问题重启能解决，遇事不决先重启
openclaw gateway restart

系统服务管理

让 Gateway 随系统自动启动，不用每次手动开：

# 把 Gateway 注册为系统服务（macOS 用 launchd，Linux 用 systemd）
# 注册后开机自启，不需要手动 start
openclaw gateway install

# 取消系统服务注册
openclaw gateway uninstall

# 前台直接运行 Gateway（不注册为服务），适合调试时用
openclaw gateway run

高级远程控制（RPC）

通过命令行直接调用 Gateway 内部接口，适合自动化脚本：

# 调用 config.patch 接口，动态开启某个技能（无需重启）
openclaw gateway call --method config.patch --params '{"skills.enabled":["notion"]}'

# 探测 Gateway 是否在线，自定义超时时间（毫秒），适合健康监控脚本
openclaw gateway probe --timeout 5000

# 扫描局域网内所有运行中的 Gateway 实例（多设备用户很有用）
openclaw gateway discover

三个最常用的 RPC 接口：

接口	作用	适合场景
`config.apply`	验证并写入完整配置，然后重启	大改配置时用
`config.patch`	合并局部配置更新，然后重启	小调参数时用
`update.run`	更新依赖并重启	版本升级时用

日志查看

排查问题时，日志是你最好的朋友：

# 实时滚动显示日志（类似 tail -f），调试时保持这个窗口打开
openclaw logs --follow

# 只看最近 200 行日志，快速回顾最近发生了什么
openclaw logs --limit 200

# 纯文本输出，不带颜色和样式（写入文件时用）
openclaw logs --plain

# 输出 JSON 格式日志，方便用脚本解析
openclaw logs --json

💡 调试技巧： 打开两个终端窗口，一个跑 openclaw logs --follow --limit 100，一个执行命令——出错了立刻能看到原因。

三、消息平台接入命令（Channels）

OpenClaw 支持 8 个主流消息平台。接入之后，你可以直接在聊天软件里给 AI 发命令，就像跟人聊天一样自然。

支持的平台：

平台	认证方式	说明
Telegram	Bot Token	最简单，推荐新手首选
Discord	Bot Token	支持富文本、表情反应
WhatsApp	OAuth/扫码	支持文字和多媒体
Google Chat	OAuth	适合 Google Workspace 用户
Slack	OAuth 插件	企业团队常用
Signal	OAuth	端对端加密，注重隐私
iMessage	插件	仅限 macOS
Microsoft Teams	OAuth 插件	企业办公环境

查看平台状态

# 列出所有已配置的消息平台
openclaw channels list

# 检查各平台连接是否正常（会主动发探测请求）
openclaw channels status --probe

# 查看 Telegram 平台最近 50 条日志，排查消息收发问题
openclaw channels logs --channel telegram --lines 50

添加新平台

# 接入 Telegram，需要提前在 @BotFather 申请 Bot Token
openclaw channels add \
  --channel telegram \       # 平台名称
  --account alerts \         # 账号别名（自己起名，用于区分多个账号）
  --name "消息提醒Bot" \      # Bot 显示名称
  --token $TELEGRAM_BOT_TOKEN  # 替换为你的 Token

# 接入 Discord
openclaw channels add \
  --channel discord \
  --account work \
  --name "工作群Bot" \
  --token $DISCORD_BOT_TOKEN

# 接入 WhatsApp（会弹出交互式引导，扫码登录）
openclaw channels add --channel whatsapp

# 接入 Google Chat
openclaw channels add \
  --channel googlechat \
  --account default \
  --name "谷歌聊天Bot"

删除平台

# 禁用某个平台（保留配置，随时可以重新启用）
openclaw channels remove --channel discord --account work

# 彻底删除平台配置（不可恢复）
openclaw channels remove --channel discord --account work --delete

登录 / 登出

# 交互式登录（WhatsApp 扫码流程）
openclaw channels login --channel whatsapp

# 退出登录（不删除配置，只清除登录状态）
openclaw channels logout --channel whatsapp --account default

⚠️ 提醒： 添加新平台后，记得跑一下 openclaw channels status --probe 确认连接正常，再去聊天软件里测试发条消息。

四、技能插件命令（Skills）

技能（Skills）是 OpenClaw 的功能扩展包，类似手机 App。装了邮件技能，AI 能帮你处理 Gmail；装了 Notion 技能，AI 能直接往你的知识库写内容。

查看技能

# 列出所有可用技能（包括未安装的）
openclaw skills list

# 只显示当前已满足安装条件的技能（环境没问题的才显示）
openclaw skills list --eligible

# 查看某个技能的详细说明、所需依赖、配置方法
openclaw skills info seo-blog-generator

# 检查哪些技能缺少依赖或配置不完整
openclaw skills check

安装技能

# 搜索技能（clawhub 是官方技能市场）
npx clawhub search email    # 搜索邮件相关技能
npx clawhub search notion   # 搜索 Notion 相关技能

# 安装技能
npx clawhub install email   # 安装邮件技能

# 同步技能到最新版本
npx clawhub sync

插件管理

插件（Plugins）和技能类似，但更底层，通常用于扩展 OpenClaw 本身的能力：

# 列出已安装的插件
openclaw plugins list

# 查看某个插件的详情
openclaw plugins info voicecall

# 从本地路径安装自定义插件
openclaw plugins install --path ./my-custom-plugin

# 启用插件（安装后默认可能是禁用状态）
openclaw plugins enable voicecall

# 禁用插件（保留安装，只是不运行）
openclaw plugins disable voicecall

# 检查插件是否有报错或依赖缺失
openclaw plugins doctor

⚠️ 重要： 安装或启用插件后，必须重启 Gateway 才能生效：openclaw gateway restart

推荐新手先装的技能：

技能名	用途	推荐理由
`notion`	读写 Notion 笔记和数据库	知识管理效率大幅提升
`email`	处理 Gmail 邮件	自动分类、快速回复
`calendar`	查询和管理日历事件	再也不会忘记会议
`weather`	获取天气预报	自动化任务里常用到
`healthcheck`	安全审计	定期跑，保持系统健康

记忆管理

OpenClaw 有记忆功能，可以存储上下文信息供 AI 调用：

# 查看记忆索引状态
openclaw memory status

# 重建记忆索引（内容更新后需要运行）
openclaw memory index

# 用自然语言搜索记忆内容
openclaw memory search "OpenClaw 安装步骤"

五、AI 模型管理命令（Models）

OpenClaw 支持 10+ 个 AI 提供商，包括 Anthropic Claude、OpenAI GPT、本地 Ollama 模型等，可以随时切换。

查看模型状态

# 查看所有已配置的模型和认证状态
openclaw models status

# 列出所有可用模型（包括未配置的）
openclaw models list --all

# 只列出本地已安装的模型（Ollama 等本地模型）
openclaw models list --local

# 按提供商过滤，只看 Anthropic 的模型
openclaw models list --provider anthropic

设置默认模型

# 设置默认文字模型（推荐用 Claude Sonnet，性价比高）
openclaw models set claude-3-5-sonnet-20241022

# 设置默认图像模型
openclaw models set-image claude-3-5-sonnet-20241022

配置 API 密钥

# 交互式添加认证，会引导你选择提供商并输入 Key（推荐新手用这个）
openclaw models auth add

# 快速为 Anthropic 设置 API Token（适合已有 Key 的用户）
openclaw models auth setup-token --provider anthropic

# 直接粘贴 API Key（适合脚本自动化场景）
openclaw models auth paste-token --provider openai --token $OPENAI_API_KEY

# 检查所有 API Key 是否即将过期
# 👉 建议每周跑一次，防止 Key 过期导致服务中断
openclaw models status --check

模型别名和备用模型

# 查看已设置的模型别名
openclaw models aliases list

# 给模型设置简短别名，方便日常引用
openclaw models aliases add "claude" "claude-3-5-sonnet-20241022"

# 查看备用模型链（主模型挂了自动切换）
openclaw models fallbacks list

# 添加备用模型：Claude 失败了自动切换到 GPT-4o
openclaw models fallbacks add "claude-3-5-sonnet-20241022" "gpt-4o"

扫描新模型

# 扫描所有提供商，获取最新模型列表，并自动设为默认
openclaw models scan --set-default --yes

# 扫描时加限制条件（参数量小于 100B，发布时间在 30 天内，3 线程并发）
openclaw models scan --max-params 100000 --max-age-days 30 --concurrency 3

六、浏览器控制命令（Browser）

这是 OpenClaw 最"科技感"的功能：让 AI 直接操控你的 Chrome、Brave、Edge 浏览器，就像有个人坐在键盘前帮你点鼠标。

启动和状态

# 查看浏览器控制服务是否在运行
openclaw browser status

# 启动浏览器控制服务（需要先运行这个，后面的命令才能用）
openclaw browser start

# 停止浏览器控制服务
openclaw browser stop

# 重置浏览器配置文件（清除所有 Cookie、登录状态，慎用）
openclaw browser reset-profile

标签页管理

# 列出当前所有打开的标签页（会显示每个标签的 ID，后续命令需要用到）
openclaw browser tabs

# 在新标签页打开指定网址
openclaw browser open --url https://docs.openclaw.ai

# 切换到指定标签页（e12 是标签 ID，从 tabs 命令里查）
openclaw browser focus --target-id e12

# 关闭指定标签页
openclaw browser close --target-id e12

页面操作（自动化核心）

# 截图，保存为 PNG 格式（监控页面变化、留存证据常用）
openclaw browser screenshot --target-id e12 --type png

# 获取页面的可访问结构（比 HTML 源码更易读，AI 分析页面时用这个）
openclaw browser snapshot --format aria --target-id e12

# 让浏览器跳转到新网址
openclaw browser navigate --url https://example.com --target-id e12

# 点击页面上的某个元素（button-submit 是元素的 ref 标识符）
openclaw browser click --ref button-submit --target-id e12

# 在输入框里输入文字（textarea-message 是输入框的 ref）
openclaw browser type \
  --text "你好，我想咨询一下" \
  --input-ref textarea-message \
  --target-id e12

# 模拟按键（Enter 键提交表单，Escape 键关闭弹窗）
openclaw browser press --key Enter --target-id e12

# 鼠标悬停在某个元素上（触发下拉菜单等悬停效果）
openclaw browser hover --ref menu-item --target-id e12

# 拖拽元素（start-ref 是起点，end-ref 是终点）
openclaw browser drag --start-ref draggable --end-ref drop-zone --target-id e12

# 在下拉菜单中选择选项
openclaw browser select --ref country-select --values "中国" --target-id e12

# 上传文件到文件选择框
openclaw browser upload --ref file-input --path /tmp/document.pdf --target-id e12

# 批量填写表单（一次性填多个字段，比逐个 type 快）
openclaw browser fill \
  --fields '[{"ref":"name","value":"张三"},{"ref":"email","value":"zhangsan@example.com"}]' \
  --target-id e12

浏览器配置文件

类似 Chrome 的"多人账号"，可以给不同场景设置独立的浏览器环境：

# 创建新的浏览器配置（购物、工作、娱乐分开，互不干扰）
openclaw browser create-profile --name "工作" --color "#2D7BE5"

# 删除配置文件（会清除该配置下的所有数据）
openclaw browser delete-profile --name "工作"

# 列出所有已创建的配置文件
openclaw browser profiles

调试和高级操作

# 在页面上执行 JavaScript 代码并返回结果
openclaw browser evaluate --fn "document.title" --target-id e12

# 查看浏览器控制台的错误日志（调试页面问题时用）
openclaw browser console --level error --target-id e12

# 把当前页面导出为 PDF 文件
openclaw browser pdf --target-id e12

💡 实用场景举例：

每天自动截图财经网站，存档价格变动

批量填写重复性表单，告别复制粘贴

监控某个页面内容，有变化就发通知到 Telegram

七、设备节点命令（Nodes）

OpenClaw 可以配对手机、Mac 等设备，实现跨设备控制——包括调用手机摄像头、远程录屏等。

节点管理

# 列出所有已配对的设备
openclaw nodes list

# 只显示当前在线的设备
openclaw nodes list --connected

# 查看某台设备的详细信息（系统版本、连接状态等）
openclaw nodes describe --node my-iphone

# 重命名设备（方便记忆）
openclaw nodes rename --node my-iphone --name "个人iPhone"

# 在远程设备上执行命令（让那台设备运行 openclaw status）
openclaw nodes run --node my-iphone --command "openclaw status"

# 调用设备上的特定功能（比如调用后置摄像头拍照）
openclaw nodes invoke \
  --node my-iphone \
  --command camera_snap \
  --params '{"facing":"back"}'

配对申请管理

# 查看等待审批的配对请求
openclaw nodes pending

# 批准某台设备的配对请求
openclaw nodes approve --node my-iphone

# 拒绝配对请求（陌生设备发来的请求，直接拒绝）
openclaw nodes reject --node unknown-device

摄像头控制

# 列出设备上所有可用的摄像头
openclaw nodes camera list --node my-iphone

# 用后置摄像头拍照（最大宽度 1920px，高质量）
openclaw nodes camera snap \
  --node my-iphone \
  --facing back \       # back=后置，front=前置
  --max-width 1920 \
  --quality high

# 用后置摄像头录制 30 秒视频
openclaw nodes camera clip \
  --node my-iphone \
  --facing back \
  --duration 30s \
  --invoke-timeout 40000  # 给足够的超时时间

屏幕控制

# 截取设备屏幕（远程查看设备当前状态）
openclaw nodes canvas snapshot --node my-iphone --format png --max-width 1920

# 在设备屏幕上显示网页内容（在指定坐标显示，宽600高400）
openclaw nodes canvas present \
  --node my-iphone \
  --x 100 --y 200 \
  --width 600 --height 400

# 隐藏设备屏幕上显示的内容
openclaw nodes canvas hide --node my-iphone

# 在设备上打开某个网址
openclaw nodes canvas navigate --node my-iphone --url https://example.com

# 在设备屏幕的网页上执行 JavaScript
openclaw nodes canvas eval --node my-iphone --js "document.body.style.backgroundColor='red'"

# 录制设备屏幕（60秒，30帧，保存到本地）
openclaw nodes screen record \
  --node my-iphone \
  --duration 60 \
  --fps 30 \
  --out /tmp/screen-recording.mp4

位置服务

# 获取设备当前 GPS 位置（精确模式，等待最多10秒）
openclaw nodes location get \
  --node my-iphone \
  --accuracy precise \
  --location-timeout 10000

⚠️ 隐私提醒： 使用摄像头、录屏、位置等功能前，请务必取得设备所有者的明确同意。

八、定时任务命令（Cron）

让 AI 按计划自动干活，是 OpenClaw 最"省力"的用法。

查看任务状态

# 列出所有定时任务（包括已禁用的）
openclaw cron list --all

# 查看定时任务服务的整体运行状态
openclaw cron status

添加定时任务

# 每天早上 9 点（UTC 时间）发送一条系统事件，触发 AI 处理
openclaw cron add \
  --name "daily-summary" \          # 任务名称（自己起，要有意义）
  --at "2026-02-11T09:00:00Z" \    # 执行时间（UTC 时区，+8 小时换算北京时间）
  --system-event "检查邮件和日历"   # 触发的 AI 指令内容

# 每小时执行一次（3600000 毫秒 = 1 小时）
openclaw cron add \
  --name "hourly-check" \
  --every 3600000 \
  --message "检查是否有新消息需要处理"

# 用 Cron 表达式设置（每周一早上 9 点执行）
# Cron 格式：分 时 日 月 周
openclaw cron add \
  --name "weekly-report" \
  --cron "0 9 * * 1" \             # 0分 9时 每天 每月 周一
  --message "生成本周工作总结"

定时任务触发方式对比：

参数	作用	适合场景
`--system-event <内容>`	注入一条系统事件，AI 自主处理	触发 AI 自动决策
`--message <内容>`	向当前会话发送一条消息	需要 AI 在会话中回复

管理任务

# 立即运行某个任务（不等到预定时间，测试时很有用）
openclaw cron run --id daily-summary

# 启用被禁用的任务
openclaw cron enable --id daily-summary

# 临时禁用任务（保留配置，随时可以重新启用）
openclaw cron disable --id daily-summary

# 查看某个任务的历史运行记录（最近 10 次）
openclaw cron runs --id daily-summary --limit 10

💡 推荐工作流： 设置一个早晨任务，让 AI 自动汇总邮件、天气、日程发到 Telegram，醒来就能看到当天概况，效率翻倍。

九、系统管理命令（System）

控制 OpenClaw 整体行为的系统级命令，偏向进阶用户。

# 向系统发送一条事件，触发 AI 处理
openclaw system event --text "进行每日摘要整理"

# 发送事件并立即执行（加 --mode now 不等排队）
openclaw system event --text "检查邮件" --mode now

# 查看最近一次心跳记录（确认 AI 服务是否还活着）
openclaw system heartbeat last

# 开启心跳机制（定时确认系统存活）
openclaw system heartbeat enable

# 关闭心跳机制
openclaw system heartbeat disable

# 查看系统当前在线状态
openclaw system presence

十、钉钉企业机器人接入全流程（国内用户专题）

国内企业用户问得最多的问题就是：OpenClaw 能接钉钉吗？ 答案是可以，而且完全支持群聊 @机器人、单聊对话、AI 卡片流式输出。

下面这套流程我自己跑通过，个人测试完全免费，不需要营业执照。

第一步：创建钉钉测试企业（已有企业跳过）

如果你只是个人测试，可以免费注册一个"企业"，5分钟搞定：

打开钉钉客户端，右上角点击「创建或加入企业」
选择「创建企业/团队」，填写企业名称（比如"OpenClaw测试团队"）、行业选「互联网/科技」、规模选「1-50人」
创建完成后，进入「企业设置 → 企业信息」，找到并记录 CorpID（后面要用）

第二步：在钉钉开放平台创建自建应用

⚠️ 注意： 钉钉开放平台的地址是 open.feishu.cn，不要搜错了。

打开 https://open.feishu.cn，用钉钉企业账号登录
点击「创建应用」→ 选择「企业自建应用」，填写如下信息：
- 应用名称：随意，比如「OpenClaw团队助手」
- 应用类型：选「机器人」
- 可见范围：测试阶段选「仅自己可见」，稳定后改为「整个企业」
创建完成后，在应用详情页记录两个关键凭证：
- AppKey（也叫 ClientID）
- AppSecret（也叫 ClientSecret）

第三步：配置权限和事件订阅

权限配置： 在应用详情页点击「权限管理」，勾选以下权限：

权限标识	说明	是否必须
`im.message.send`	发送消息	✅ 必须
`im.message.receive`	接收消息	✅ 必须
`contact.department.read`	读取部门信息	✅ 必须
`contact.user.read`	读取成员信息	✅ 必须
`Card.Instance.Write`	支持 AI 卡片	可选（推荐勾选）
`Card.Streaming.Write`	支持流式输出	可选（推荐勾选）

事件订阅： 点击「事件订阅」，填写回调地址和 Token：

回调地址：http://你的服务器公网IP:18789/dingtalk/callback
加密方式：兼容模式
订阅事件：im.message.receive_v1（接收群聊和单聊消息）

💡 回调地址说明： 18789 是 OpenClaw 默认监听端口，确保阿里云安全组已放行该端口，否则收不到消息。

IP 白名单： 在「安全设置」中添加服务器的公网 IP，否则接口调用会报"IP 未授权"。

第四步：发布应用

钉钉自建应用必须发布后才能正常使用：

在应用详情页点击「版本管理与发布」
创建新版本（版本号如 v1.0.0），填写版本描述
选择可见范围，点击发布
发布完成后，在钉钉客户端搜索应用名称，就能找到你的 OpenClaw 机器人了

第五步：将钉钉绑定到 OpenClaw

前四步是在钉钉侧操作，这一步回到服务器，把两边打通。

方式一：Web 控制台（新手推荐）

方式二：命令行绑定（进阶用户）

直接复制下面的命令，替换掉尖括号里的内容执行：

# 第一步：安装钉钉官方对接插件
openclaw plugins install @openclaw-china/channels-dingtalk

# 第二步：写入钉钉通道配置（把尖括号内容替换为你的实际凭证）
openclaw config set channels.dingtalk '{
  "enabled": true,
  "corpId": "<你的钉钉企业CorpID>",
  "clientId": "<你的应用AppKey>",
  "clientSecret": "<你的应用AppSecret>",
  "eventToken": "<你的事件订阅Token>",
  "enableAICard": true,       # true=开启AI卡片，支持流式输出
  "groupPolicy": "open"       # open=所有群成员都能触发机器人
}' --json

# 第三步：重启 Gateway，让钉钉通道配置生效
openclaw gateway restart

# 第四步：验证钉钉通道是否连接成功
openclaw channels test dingtalk

第六步：验证功能是否正常

单聊验证： 在钉钉搜索你的机器人，发送：

"你好，介绍一下你的核心功能"

群聊验证： 创建钉钉测试群，把机器人加进去，然后 @ 它发送：

"@OpenClaw团队助手生成一份2026年Q1团队周会模板"

3-5 秒内收到回复，说明整套流程跑通了。

钉钉常用排查命令

遇到机器人不回复？按顺序跑这几条命令：

# 查看 OpenClaw 实时日志，看有没有报错信息
openclaw logs --follow

# 单独查看钉钉通道的日志，定位对接层的问题
openclaw logs --channel dingtalk

# 重启钉钉通道（不重启整个 Gateway）
openclaw channels restart dingtalk

# 重启整个 Gateway（上面没解决再用这个）
openclaw gateway restart

钉钉专属技能安装

连接钉钉之后，可以继续安装专属技能，实现审批、考勤、文件等更深度的自动化：

# 安装钉钉审批技能（可自动查询、提交审批流）
openclaw skills install @openclaw-china/skill-dingtalk-approval

# 安装钉钉考勤统计技能（查迟到、统计出勤等）
openclaw skills install @openclaw-china/skill-dingtalk-attendance

# 安装钉钉文件管理技能（上传下载钉钉网盘文件）
openclaw skills install @openclaw-china/skill-dingtalk-file

# 查看已安装的所有技能
openclaw skills list

安装完成后，在钉钉里直接发送自然语言指令即可触发：

"统计本月团队考勤迟到情况"
"查询我的未审批流程"
"整理本周群聊工作汇报，生成文档"

钉钉运维优化（服务器部署必看）

如果你把 OpenClaw 部署在云服务器（比如阿里云 2G 内存的机器），建议做以下优化：

# ===== 内存优化（2GiB 服务器必做）=====
# 创建 4GiB 虚拟内存（Swap），防止多技能运行时内存不足崩溃
fallocate -l 4G /swapfile          # 创建 4G 的 Swap 文件
chmod 600 /swapfile                # 设置权限，只有 root 可读
mkswap /swapfile                   # 格式化为 Swap 格式
echo "/swapfile none swap sw 0 0" | tee -a /etc/fstab  # 写入启动配置，重启后自动挂载
swapon --all                       # 立即激活 Swap
free -h                            # 验证：看到 Swap 一行有数值说明成功

# ===== 开机自启配置 =====
# 服务器重启后不需要手动拉起服务
systemctl enable openclaw-gateway  # OpenClaw Gateway 开机自启
systemctl enable nginx             # Nginx 反向代理开机自启

# ===== 版本升级 =====
# 及时更新，获取新功能和安全补丁
openclaw update --latest                                    # 升级 OpenClaw 主程序
openclaw plugins update @openclaw-china/channels-dingtalk  # 升级钉钉对接插件

钉钉对接常见问题速查：

问题现象	可能原因	解决方法
发消息无响应	端口未放行或 IP 白名单未配置	检查安全组放行 18789 端口，钉钉添加服务器 IP
AI 卡片不显示	权限未勾选	确认勾选 `Card.Instance.Write`，重新发布应用
Skills 运行失败	API Key 无效或网络问题	执行 `openclaw skills repair <技能名>`
Gateway 启动失败	内存不足	先做 Swap 配置，再执行 `openclaw gateway reset`

十一、命令速查总表

这是全文的精华版，收藏备用：

🔧 基础配置

openclaw setup --wizard        # 交互式初始化向导
openclaw onboard               # 快速一键初始化
openclaw configure             # 打开配置菜单
openclaw doctor                # 自动扫描并修复问题
openclaw security audit --fix  # 安全审计并修复

openclaw config get <配置项>   # 读取配置值
openclaw config set <配置项> <值>  # 修改配置值
openclaw config unset <配置项>    # 删除配置项，恢复默认

💓 Gateway 核心服务

openclaw gateway status    # 查看运行状态
openclaw gateway start     # 启动服务
openclaw gateway stop      # 停止服务
openclaw gateway restart   # 重启服务（遇问题首选）
openclaw gateway install   # 注册为开机自启服务
openclaw gateway run       # 前台运行（调试用）
openclaw logs --follow     # 实时查看日志

📱 消息平台（Channels）

openclaw channels list              # 列出所有平台
openclaw channels status --probe    # 检测连接是否正常
openclaw channels add --channel telegram --token <Token>  # 接入 Telegram
openclaw channels remove --channel <平台> --delete        # 彻底删除平台

🧩 技能插件（Skills）

openclaw skills list           # 查看所有技能
openclaw skills list --eligible  # 只看满足条件的技能
openclaw skills info <技能名>  # 查看技能详情
openclaw skills check          # 检查缺失依赖
npx clawhub install <技能名>   # 安装技能
openclaw plugins enable <插件> # 启用插件

🤖 AI 模型（Models）

openclaw models status              # 查看模型状态
openclaw models list --all          # 列出所有模型
openclaw models set <模型名>        # 设置默认模型
openclaw models auth add            # 交互式添加 API Key
openclaw models status --check      # 检查 Key 是否过期
openclaw models fallbacks add <主> <备>  # 设置备用模型

🌐 浏览器控制（Browser）

openclaw browser start             # 启动浏览器控制服务
openclaw browser tabs              # 列出所有标签页
openclaw browser navigate --url <网址> --target-id <ID>   # 跳转网址
openclaw browser screenshot --target-id <ID> --type png  # 截图
openclaw browser click --ref <元素> --target-id <ID>      # 点击元素
openclaw browser type --text <文字> --input-ref <输入框> --target-id <ID>  # 输入文字
openclaw browser fill --fields '[...]' --target-id <ID>   # 批量填表

📅 定时任务（Cron）

openclaw cron list --all            # 列出所有任务
openclaw cron add --name <名> --at <时间> --system-event <指令>  # 按时间添加
openclaw cron add --name <名> --every <毫秒> --message <内容>    # 按间隔添加
openclaw cron run --id <任务名>     # 立即执行某任务
openclaw cron enable --id <任务名>  # 启用任务
openclaw cron disable --id <任务名> # 禁用任务

🏢 钉钉接入（国内企业）

# 安装钉钉插件
openclaw plugins install @openclaw-china/channels-dingtalk

# 写入钉钉配置（替换尖括号内容）
openclaw config set channels.dingtalk '{"enabled":true,"corpId":"<CorpID>","clientId":"<AppKey>","clientSecret":"<AppSecret>","eventToken":"<Token>","enableAICard":true}' --json

openclaw gateway restart               # 重启让配置生效
openclaw channels test dingtalk        # 验证连接状态
openclaw logs --channel dingtalk       # 查看钉钉通道日志
openclaw channels restart dingtalk     # 重启钉钉通道

# 安装钉钉专属技能
openclaw skills install @openclaw-china/skill-dingtalk-approval    # 审批技能
openclaw skills install @openclaw-china/skill-dingtalk-attendance  # 考勤技能
openclaw skills install @openclaw-china/skill-dingtalk-file        # 文件技能

写在最后

OpenClaw 不是"银弹"，它需要你愿意花时间配置。但一旦搭好，它带来的效率提升是持续的、复利式的。

推荐入门顺序：

跑通 setup + gateway start，确保基础环境正常
接入 Telegram 或钉钉，感受在聊天窗口里调用 AI 的感觉
装两三个技能（邮件、日历），把常用场景自动化
设置一两个定时任务，让 AI 开始帮你"值班"

等这四步都玩熟了，再去研究浏览器控制和设备节点——那是另一个层次的自动化。

如果觉得文章对你有用，请随意赞赏

OpenClaw 命令速查手册（2026 全面指南）

http://devmanapp.com/archives/openclaw-ming-ling-su-cha-shou-ce-2026-quan-mian-zhi-nan

作者

devmanapp

发布于

2026-04-18

更新于

2026-04-18

许可协议

CC BY 4.0

OpenClaw 命令速查手册（2026 全面指南）

OpenClaw 是什么？为什么值得学？

一、基础设置命令

配置项读写

全局参数

二、Gateway 核心服务命令

基础操作

系统服务管理

高级远程控制（RPC）

日志查看

三、消息平台接入命令（Channels）

查看平台状态

添加新平台

删除平台

登录 / 登出

四、技能插件命令（Skills）

查看技能

安装技能

插件管理

记忆管理

五、AI 模型管理命令（Models）

查看模型状态

设置默认模型

配置 API 密钥

模型别名和备用模型

扫描新模型

六、浏览器控制命令（Browser）

启动和状态

标签页管理

页面操作（自动化核心）

浏览器配置文件

调试和高级操作

七、设备节点命令（Nodes）

节点管理

配对申请管理

摄像头控制

屏幕控制

位置服务

八、定时任务命令（Cron）

查看任务状态

添加定时任务

管理任务

九、系统管理命令（System）

十、钉钉企业机器人接入全流程（国内用户专题）

第一步：创建钉钉测试企业（已有企业跳过）

第二步：在钉钉开放平台创建自建应用

第三步：配置权限和事件订阅

第四步：发布应用

第五步：将钉钉绑定到 OpenClaw

第六步：验证功能是否正常

钉钉常用排查命令

钉钉专属技能安装

钉钉运维优化（服务器部署必看）

十一、命令速查总表

🔧 基础配置

💓 Gateway 核心服务

📱 消息平台（Channels）

🧩 技能插件（Skills）

🤖 AI 模型（Models）

🌐 浏览器控制（Browser）

📅 定时任务（Cron）

🏢 钉钉接入（国内企业）

写在最后

作者

发布于

更新于

许可协议

评论