乐于分享
好东西不私藏

OpenClaw 实战(二):核心操作与指令

OpenClaw 实战(二):核心操作与指令

完成 OpenClaw 基础部署后,我们需要考虑如何维护其稳定运行,以及如何使其更加方便访问和使用。

这一篇,聊聊OpenClaw的 核心操作与指令——我们是如何通过这些命令来“养”好一只小龙虾。


一、常用服务器命令

OpenClaw 的官方文档(有中文版)是首选参考资料:

https://docs.openclaw.ai/zh-CN

网站提供了从部署安装到升级维护的完整说明,包括程序结构原理和应用示例。想"养"好小龙虾,多研究官方文档准没错。

我们在完成了 OpenClaw 的搭建之后,接下来熟悉一些基本操作。

几个常用命令

openclaw status            # 检查服务状态openclaw gateway restart   # 重启服务网关 

OpenClaw的版本更新很快,用以下命令及时升级到最新版本

openclaw update

WebUI 界面管理

OpenClaw提供了WebUI界面,可管理和配置服务。运行

openclaw dashboard

即可看到 Dashboard URL 等相关信息。这里会提供一串 token 值,作为网关令牌用于连接应用。同时也提供了对于无 GUI 电脑的情况下如何在本地电脑访问的命令。

为了保证安全性,OpenClaw的Dashboard默认仅允许服务器本机访问,

http://127.0.0.1:18789/

http://localhost:18789/

且首次访问需要做一次性配对授权批准。

可通过修改配置文件 OpenClaw.json 改为允许局域网或外网地址访问,但出于安全考虑不建议这么做

远程服务器访问

如果 OpenClaw 部署在远端 Linux 服务器上(无用户界面),可在自己电脑上运行以下命令,通过 SSH 代理将远端端口映射到本地:

ssh -N -L 18789:127.0.0.1:18789 服务器ssh账号@服务器IP

输入 SSH 密码后,即可在本地电脑上访问 http://127.0.0.1:18789/ 打开远端服务器 Control UI。

注意:这里用了 SSH 提供的代理通道,所以在访问过程中运行 SSH 命令的终端界面不能退出或关闭

配对授权

初次打开 Control UI 界面,会看到"disconnected (1008): pairing required"的提示,需要做配对授权。

在服务器上运行命令:

# 列出待处理的请求openclaw devices  list# 按请求 ID 批准openclaw devices approve <requestId>
之后即可在 Control UI 面板上进行管理操作。如果状态显示未连接,在网关令牌处输入之前获得的 token 即可连接。

Control UI 面板功能

  • 基本的运行信息

  • 使用情况统计

  • 查看及导出对话记录

  • 在 UI 界面上进行对话

  • 定时任务管理

  • 各种配置管理

配置修改与问题排查

我习惯直接编辑 openclaw.json 文件修改配置,修改后运行 openclaw gateway restart 重启使配置生效。

如果服务运行失败,可以通过以下命令修复:

openclaw doctor          # 检查问题原因openclaw doctor --fix    # 自动修复

也可以跟踪日志记录来排查问题。

openclaw logs --follow

以上命令和操作,基本上能帮助我们解决大部分运行或配置的问题。

如果实在遇到难题,还记得我们在公众号最早一篇文章中提倡的吗?养成问 AI 的习惯。打开 DeepSeek 或豆包等应用,开启深度思考和智能搜索,把问题描述给它。跟着 AI 的建议操作,基本都能解决。


二、升级与备份

熟悉基本命令,确保服务正常运行后,后续操作都可通过和机器人对话完成。

出于应用最大可用性考虑,如果遇到服务器故障或者需要迁移,应该有套备份机制保障平滑迁移。

我直接向启辰提出需求,让它设计备份方案。

我提出的需求

请考虑一下 openclaw 的服务备份机制,如果服务器故障,或者后续需要迁移服务到其他服务器上的话,需要有一套快速恢复机制。

启辰的完整方案

启辰经过思考后,给出了一套完整的服务备份与快速恢复机制

一、核心备份对象

OpenClaw 的关键数据分布在以下位置,需要全部备份:

  • 配置文件(含渠道、模型、网关设置)(关键):

    ~/.openclaw/openclaw.json

  • 各 Agent 的配置、会话状态、认证信息(关键):

    ~/.openclaw/agents/

  • 工作空间(用户文档、技能、记忆文件)(关键):

    ~/.openclaw/workspace/

  • 配对设备信息(移动端节点)(重要)

    ~/.openclaw/devices/

  • 已安装的扩展插件(重要)

    ~/.openclaw/extensions/

  • 已安装的技能(重要):

    ~/.openclaw/skills/

  • 定时任务配置和运行记录(重要)

    ~/.openclaw/cron/

  • 运行日志(可选)

    ~/.openclaw/logs/

  • 缓存的媒体文件(可选)

    ~/.openclaw/media/

二、备份策略

方案 A:简单脚本备份(推荐快速部署)

创建备份脚本 /root/.openclaw/backup.sh,一键打包所有关键数据。

方案 B:使用 rsync 增量备份(适合频繁备份)

适合需要高频备份的场景,只备份变化的部分,节省存储空间。

三、自动化备份(Cron 定时任务)

编辑 crontab:crontab -e

设置定时任务,比如每天凌晨 3 点自动备份。
# 每天凌晨 2 点自动备份0 2 * * * /root/.openclaw/backup.sh >> /root/.openclaw/logs/backup.log 2>&1# 或每小时备份一次(高频场景)0 * * * * /root/.openclaw/backup.sh >> /root/.openclaw/logs/backup.log 2>&1

四、快速恢复流程

场景 1:本机故障后恢复

直接运行恢复脚本,解压备份文件到原位置。

场景 2:迁移到新服务器

  1. 在新服务器安装 OpenClaw

  2. 复制备份文件

  3. 运行恢复脚本

  4. 验证服务正常

五、敏感信息保护

重要安全提示

  1. API 密钥保护:openclaw.json 中包含 API 密钥,备份文件必须加密存储

  2. 加密备份:使用 gpg 或 openssl 加密备份文件

  3. 使用 SecretRef:将敏感信息迁移到 SecretRef 管理(参考 /gateway/secrets 文档)

六、备份验证(定期演练)

创建验证脚本 /root/.openclaw/verify-backup.sh,定期测试备份文件是否可用。

七、灾难恢复检查清单

  • 备份文件完整性验证

  • 加密密钥安全存储

  • 恢复流程文档化

  • 定期演练(至少每季度一次)

八、推荐的最佳实践

3-2-1 备份原则

  • 至少 3 份 备份

  • 存储在 2 种 不同介质

  • 其中 1 份 异地存储

备份频率

  • 配置变更时:立即备份

  • 日常:每天 1 次

  • 高频使用:每小时 1 次

监控告警

  • 备份失败时发送通知

  • 磁盘空间不足时告警

  • 定期测试恢复流程

文档化

  • 记录备份位置和加密密码

  • 维护恢复流程文档

  • 定期演练(至少每季度一次)

在我看来,这份方案相当完整可落地,放手让其执行即可。

三、模型调用优化

基本解决了服务可用性问题后,可做一些模型调用优化。

我提出了以下要求

  1. 检查现有模型列表,理解每个模型的能力和适合的任务

  2. 设置三个模型池:

    高速池:简单日常会话、要求回应快,token 便宜

    智能池:大型复杂任务以及高强度推理,要求模型能力强

    文本池:处理文本相关任务,要求模型有推理能力和较强上下文处理能力,一定的多模态能力

  3. 每个模型至少配置一主一备两个模型,遇到 token 耗尽或者 rate limit 问题时自动 fallback

  4. 每 6 个小时检查一次模型健康程度

  5. 根据任务类别,分别匹配到三个模型池

启辰的配置结果

启辰经过分析后,完成了模型池配置:

模型池配置完成!配置摘要:- 三个模型池已创建- 每个池配置主备模型- 自动健康检查已启用当前健康状态:所有 8 个模型健康状态:正常自动 Fallback 规则:当主模型遇到以下情况时自动切换到备选模型:- HTTP 429 (Rate Limit / Token 耗尽)- HTTP 5xx (服务器错误)- 超时 (60s 无响应)- 连接失败Fallback 顺序:主模型 → 备 1 → 备 2 → 报错详细使用指南保存在:/root/.openclaw/workspace/MODEL-POOLS-GUIDE.md

这样就调整好了模型池,以便节约大模型调用的 token 费用。

四、OpenClaw的自动化能力

接下来我们看一看 OpenClaw 的自动化能力。这是 OpenClaw 作为 Agent 区分于传统对话式 AI 的核心能力。

它包含这三个概念:工具(Tools)、技能(Skills)和扩展插件(Plugins)

三者对比

维度
Tools
Skills
Plugins
定位

底层原子能力

封装好的功能模块

外部服务集成

提供方

OpenClaw 核心

社区/官方技能库

第三方服务/扩展

数量

~20 个固定

50+ 可扩展

按需安装

调用方式

直接调用

通过 skill 名称调用

配置后自动启用

示例

read

write

exec

weather

word-docx

dingtalk

whatsapp

实际场景举例:

场景:用户通过钉钉询问"北京天气"

1. Plugin (dingtalk) 接收消息   ↓2. Agent Core 理解意图   ↓3. 根据 SKILL.md 规则匹配到 weather skill   ↓4. Skill 内部调用 Tools:   - web_search 或 web_fetch 获取天气数据   ↓5. Agent 整理回复   ↓6. Plugin (dingtalk) 发送回复到钉钉

核心区别

问题

Tools

Skills

Plugins

是什么?

原子 API

功能模块

服务集成

谁提供?

OpenClaw 

社区/官方

第三方

能扩展吗?

 固定

 可安装

 可安装

需要配置?

不需要

部分需要

必须配置

调用层级

底层

中层

外层

典型用途

读写文件、

执行命令

天气、

文档处理

钉钉、

WhatsApp

智能手机类比

为了方便理解,可以用智能手机来类比:

OpenClaw组件

智能手机类比

Tools

手机硬件能力(摄像头、GPS、麦克风)

Skills

App(天气 App、地图 App、音乐 App)

Plugins

通信模块(4G/5G、WiFi、蓝牙)

从对比可以看出,Skills 是帮助我们实现各种需求的直接功能手段,也就能理解为何现在 Skills 这么火。

OpenClaw 自带了哪些 skills呢?

系统内置 Skills 列表

(/usr/lib/node_modules/openclaw/skills/)

共 53 个 系统技能,按类别分类:

 核心工具类

Skill

说明

clawhub

从 clawhub.com 搜索、安装、更新、发布技能

skill-creator

创建、编辑、审查 AgentSkills

mcporter

调用 MCP 服务器/工具(HTTP 或 stdio)

coding-agent

编码代理任务

healthcheck

主机安全加固和风险配置审计

node-connect

诊断 OpenClaw 节点连接和配对问题

 笔记与知识管理类

Skill

说明

apple-notes

Apple 笔记集成

apple-reminders

Apple 提醒事项集成

bear-notes

Bear 笔记集成

notion

Notion 集成

obsidian

Obsidian 知识库集成

things-mac

Things 任务管理(Mac)

 多媒体与图像类

Skill

说明

nano-banana-pro

图像生成与编辑

nano-pdf

PDF 处理

openai-image-gen

OpenAI 图像生成

openai-whisper

语音转文字(本地)

openai-whisper-api

语音转文字(API)

video-frames

视频帧提取

sherpa-onnx-tts

文本转语音(ONNX)

sag

ElevenLabs TTS 语音合成

voice-call

语音通话

 通讯与社交类

Skill

说明

discord

Discord 集成

slack

Slack 集成

bluebubbles

BlueBubbles(iMessage 非官方)

imsg

iMessage 集成

wacli

WhatsApp CLI

trello

Trello 看板集成

github

GitHub 集成

gh-issues

GitHub Issues 管理

 音乐与娱乐类

Skill

说明

spotify-player

Spotify 播放器集成

sonoscli

Sonos 音响控制

gog

Google workspace集成

goplaces

Google Places查询

songsee

歌曲搜索

 网络与工具类

Skill

说明

weather

天气预报(wttr.in / Open-Meteo)

blogwatcher

博客监控

blucli

蓝牙 CLI 工具

eightctl

8 号控制器

openhue

Philips Hue 灯光控制

oracle

Oracle 云服务 CLI

ordercli

Foodora外卖平台单 CLI

xurl

URL 处理工具

summarize

多源内容摘要

peekaboo

隐私/隐藏工具

 办公与生产力类

Skill

说明

himalaya

邮件客户端(Himalaya)

1password

1Password 密码管理器

session-logs

会话日志管理

model-usage

模型使用统计

 系统与开发类

Skill

说明

canvas

Canvas UI 控制

camsnap

摄像头快照

gifgrep

GIF 搜索

tmux

Tmux 终端复用器

我们也可以在实际工作中根据需要,要求OpenClaw使用skill-creator这个技能,将我们固定工作流程或者常用的工具或脚本,包装为Skill,以便后续的工作中可以复用这些总结下来的经验和做法。

所创建的自定义Skill通常位于如下目录:

/root/.openclaw/skills

每个 Skill 开发遵循 OpenClaw 标准格式:

skills/└── bid-management/   # skill名称为目录名     ├── SKILL.md      # 技能说明和规则    ├── index.js      # 技能入口    └── utils/        # 工具函数

在 SKILL.md 中明确:

  • 技能用途和适用场景

  • 调用的 Tools 列表

  • 输入输出格式

  • 错误处理策略


五、小结

这一篇我们介绍了 OpenClaw 的核心操作与指令:

  1. 常用命令 - doctor、status、dashboard、update、logs

  2. WebUI 管理 - 远程访问、配对授权、配置管理

  3. 备份机制 - 完整备份方案、快速恢复流程

  4. 模型优化 - 三池配置、自动 fallback、健康检查

  5. 自动化能力 - Tools/Skills/Plugins 的区别与应用

下一篇:我们详细聊聊关于Skills的相关内容包括:

  • OpenClaw的文件目录结构及核心文件内容

  • SOUL.md、AGENT.md等文件的进阶用法

  • 一些好用的Skills,以及如何创建所需的Skills

  • 复杂任务拆解

(完)


欢迎交流:如果你有 OpenClaw 使用经验或问题,欢迎在公众号留言交流。