目录
一、基础初始化与核心服务操作
-
初始化/重置 ：
openclaw onboard，新安装后做基础配置，服务出问题时可重新初始化，运行后安全提示一般选NO； -
网关 控制 ：网关是核心服务，故障会导致无法使用，常用命令：前台启动
openclaw gateway、后台启动openclaw gateway start、停止stop、重启restart，安装后台服务install（仅一次），启动成功会有大量蓝色文字，修改配置/装插件后需重启网关； -
打开管理面板 ：
openclaw dashboard，生成带token的本地网页地址，token切勿泄露，云端安装更要注意； -
版本更新 ：
openclaw update，检查并更新至最新版本。
二、模型相关操作
-
模型查看 ：查默认模型
openclaw models list、查所有模型（含自定义）list --all、查模型认证/连通性models status/--probe； -
添加自定义模型 ：以阿里云通义千问为例，用
openclaw config set命令配置服务商地址、API密钥和模型信息，不同版本参数略有差异； -
模型切换 ：终端交互界面（
openclaw tui）内输入/model <模型ID>临时切换；用config set命令可永久设置主代理/全局默认模型，修改后需重启网关； -
模型测试 ：
openclaw chat --model <模型ID> --prompt "内容"，直接对话测试模型。
三、配置与设备管理
-
配置操作 ：
openclaw config可单独修改模型、工作区等配置，config get查看配置、config delete删除配置（如模型白名单）； -
设备管理 ：
openclaw devices list查看已配对设备，devices approve <ID>批准新设备连接。
四、问题诊断与修复
-
状态查看 ：
openclaw status快速检查服务整体运行状态，判断是否故障； -
全面诊断/修复 ：
openclaw doctor检测配置、网关、插件等问题，doctor --fix自动修复可处理的故障，配置文件损坏时该命令可能失效，需手动修复； -
日志排查 ：
openclaw logs --follow实时看运行日志，logs --tail 50看最近50条日志，可定位API密钥、模型调用等错误，日志看不懂可复制给AI解析； -
调试模式 ：
OPENCLAW_LOG_LEVEL=debug 命令可调试查看信息，还能搭配关键词过滤； -
缓存清理：删除指定缓存文件可解决部分模型显示问题，模型不显示也可按「重启网关→删模型缓存→查所有模型」的流程排查；
-
Node环境修复：若环境异常，可查看、卸载旧版Node.js，保证版本符合要求。
五、实用小技巧
-
查看模型加
--all参数，避免遗漏自定义模型； -
任何配置修改后，必须重启网关才会生效；
-
openclaw doctor是最实用的诊断工具，故障优先使用； -
定期运行
openclaw security audit --deep做安全审计。