完成 OpenClaw 基础部署后,我们需要考虑如何维护其稳定运行,以及如何使其更加方便访问和使用。
这一篇,聊聊OpenClaw的 核心操作与指令——我们是如何通过这些命令来“养”好一只小龙虾。
一、常用服务器命令
OpenClaw 的官方文档(有中文版)是首选参考资料:
https://docs.openclaw.ai/zh-CN
网站提供了从部署安装到升级维护的完整说明,包括程序结构原理和应用示例。想"养"好小龙虾,多研究官方文档准没错。
我们在完成了 OpenClaw 的搭建之后,接下来熟悉一些基本操作。
几个常用命令
openclaw status # 检查服务状态openclaw gateway restart # 重启服务网关
OpenClaw的版本更新很快,用以下命令及时升级到最新版本
openclaw updateWebUI 界面管理
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 面板功能:
基本的运行信息
使用情况统计
查看及导出对话记录
在 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
# 每天凌晨 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:迁移到新服务器
在新服务器安装 OpenClaw
复制备份文件
运行恢复脚本
验证服务正常
五、敏感信息保护
重要安全提示:
API 密钥保护:openclaw.json 中包含 API 密钥,备份文件必须加密存储
加密备份:使用 gpg 或 openssl 加密备份文件
使用 SecretRef:将敏感信息迁移到 SecretRef 管理(参考 /gateway/secrets 文档)
六、备份验证(定期演练)
创建验证脚本 /root/.openclaw/verify-backup.sh,定期测试备份文件是否可用。
七、灾难恢复检查清单
备份文件完整性验证
加密密钥安全存储
恢复流程文档化
定期演练(至少每季度一次)
八、推荐的最佳实践
3-2-1 备份原则:
至少 3 份 备份
存储在 2 种 不同介质
其中 1 份 异地存储
备份频率:
配置变更时:立即备份
日常:每天 1 次
高频使用:每小时 1 次
监控告警:
备份失败时发送通知
磁盘空间不足时告警
定期测试恢复流程
文档化:
记录备份位置和加密密码
维护恢复流程文档
定期演练(至少每季度一次)
在我看来,这份方案相当完整可落地,放手让其执行即可。
三、模型调用优化
基本解决了服务可用性问题后,可做一些模型调用优化。
我提出了以下要求:
检查现有模型列表,理解每个模型的能力和适合的任务
设置三个模型池:
高速池:简单日常会话、要求回应快,token 便宜
智能池:大型复杂任务以及高强度推理,要求模型能力强
文本池:处理文本相关任务,要求模型有推理能力和较强上下文处理能力,一定的多模态能力
每个模型至少配置一主一备两个模型,遇到 token 耗尽或者 rate limit 问题时自动 fallback
每 6 个小时检查一次模型健康程度
根据任务类别,分别匹配到三个模型池
启辰的配置结果
启辰经过分析后,完成了模型池配置:
模型池配置完成!配置摘要:- 三个模型池已创建- 每个池配置主备模型- 自动健康检查已启用当前健康状态:所有 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)
三者对比
底层原子能力 | 封装好的功能模块 | 外部服务集成 | |
OpenClaw 核心 | 社区/官方技能库 | 第三方服务/扩展 | |
~20 个固定 | 50+ 可扩展 | 按需安装 | |
直接调用 | 通过 skill 名称调用 | 配置后自动启用 | |
read, write, exec | weather, word-docx | dingtalk, |
实际场景举例:
场景:用户通过钉钉询问"北京天气"
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 | 社区/官方 | 第三方 |
能扩展吗? | 固定 | 可安装 | 可安装 |
需要配置? | 不需要 | 部分需要 | 必须配置 |
调用层级 | 底层 | 中层 | 外层 |
典型用途 | 读写文件、 执行命令 | 天气、 文档处理 | 钉钉、 |
智能手机类比
为了方便理解,可以用智能手机来类比:
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 的核心操作与指令:
常用命令 - doctor、status、dashboard、update、logs
WebUI 管理 - 远程访问、配对授权、配置管理
备份机制 - 完整备份方案、快速恢复流程
模型优化 - 三池配置、自动 fallback、健康检查
自动化能力 - Tools/Skills/Plugins 的区别与应用
下一篇:我们详细聊聊关于Skills的相关内容,包括:
OpenClaw的文件目录结构及核心文件内容
SOUL.md、AGENT.md等文件的进阶用法
一些好用的Skills,以及如何创建所需的Skills
复杂任务拆解
(完)
欢迎交流:如果你有 OpenClaw 使用经验或问题,欢迎在公众号留言交流。
夜雨聆风