🦞 OpenClaw全指令研究手册：从安装到精通，一篇搞定所有命令
这篇文章不绑定任何个人项目、技术栈或工作环境，属于通用型教程。无论你是用在本地开发、日常办公、还是自动化脚本，都能直接照抄。
一、前言：OpenClaw指令体系到底是什么？
OpenClaw是一款AI执行Agent，所有操作都通过命令行指令完成。它的指令体系清晰、分层明确，只要掌握了核心指令，就能自由控制模型、渠道、技能、日志与运行环境。
这篇手册按照功能模块整理，附：
- 指令作用
- 实战示例
- 常见坑与解决方法
新手到进阶都能用。
二、基础指令：安装与环境检查
这一组是入门第一课，用来确认环境与版本。
指令 作用 示例 注意点
openclaw --version 查看版本 openclaw --version 版本过低会导致功能异常
openclaw --help 显示所有指令列表 openclaw --help 忘记指令直接查它
openclaw onboard 初始化配置向导 openclaw onboard 首次安装必做
openclaw status 查看整体运行状态 openclaw status 快速判断Agent是否正常
openclaw health 全局健康检查 openclaw health 模型/渠道/服务连通性检测
三、网关管理：Agent运行的核心
OpenClaw所有任务都依赖网关，因此启停、重启、状态查看都非常关键。
指令 作用 示例 必知点
openclaw gateway start 启动网关 openclaw gateway start 后台运行
openclaw gateway stop 停止网关 openclaw gateway stop 做配置修改前必停
openclaw gateway restart 重启网关（最常用） openclaw gateway restart ⚠️ 改配置/装技能后必须重启
openclaw gateway status 查看网关状态 openclaw gateway status 查是否运行、端口、连接情况
openclaw gateway run 前台启动（调试用） openclaw gateway run --verbose 实时打印日志，排查错误
openclaw logs 查看日志 openclaw logs --follow 排错必备
四、模型管理：切换AI大脑
OpenClaw支持本地模型（Ollama）、云端模型（通义千问、智谱等）。
指令 作用 示例 说明
openclaw models list 列出所有可用模型 openclaw models list 查看已安装/已配置模型
openclaw models set <id> 设置默认模型 openclaw models set ollama/llama3:8b 重启网关生效
openclaw models status 查看当前模型 openclaw models status 验证是否切换成功
openclaw models auth add 添加模型认证 openclaw models auth add zhiPu 配置API密钥
五、渠道管理：接入飞书、微信等沟通工具
以飞书（Lark） 为例，是最常用的Agent入口。
指令 作用 示例 说明
openclaw channels add 新增渠道（交互式） openclaw channels add 按步骤选择Feishu
openclaw channels list 查看已添加渠道 openclaw channels list 确认是否启用
openclaw channels show <channel> 查看渠道详情 openclaw channels show feishu 排查连接异常
openclaw pairing approve 授权设备配对 openclaw pairing approve feishu abc123 飞书私聊必须授权
六、通用配置：修改任意参数
OpenClaw支持通过指令直接修改配置文件。
指令 作用 示例
openclaw config get <path> 读取配置 openclaw config get agents.defaults
openclaw config set <path> <value> 修改配置 openclaw config set models.default.provider "ollama"
openclaw config delete <path> 删除配置项 openclaw config delete agents.defaults
openclaw config file 查看配置文件路径 openclaw config file
openclaw config validate 校验配置 openclaw config validate
七、技能管理：扩展Agent能力
技能就像“插件”，可以安装、卸载、搜索。
指令 作用 示例
clawhub search <keyword> 搜索技能 clawhub search file
clawhub install <skill> 安装技能 clawhub install fileops
clawhub list 查看已安装技能 clawhub list
clawhub uninstall <skill> 卸载技能 clawhub uninstall log-analyze
八、日常任务与执行：让Agent真正“做事”
这一组是OpenClaw的核心能力——执行自然语言任务。
指令 作用 示例
openclaw agents run --task "任务内容" 执行任务 openclaw agents run --task "帮我整理文件夹结构"
openclaw sessions 查看历史任务 openclaw sessions
openclaw devices list 查看已配对设备 openclaw devices list
九、故障排查：90%问题靠这些指令解决
指令 作用 示例
openclaw doctor 一键诊断与修复 openclaw doctor --deep
openclaw logs --follow 实时日志 openclaw logs --follow --filter gateway
openclaw status --all 查看所有连接状态 openclaw status --all
十、常见坑与解决方法（超实用）
1. 改配置必须重启网关
不执行 gateway restart ，配置不会生效。
2. 端口被占用导致打不开面板
用 lsof -i :18789 找到占用进程，杀掉或改端口。
3. 模型调用失败
先确认模型服务是否启动（如 ollama serve ）。
4. 飞书收不到消息
开放平台必须订阅 im.message.receive_v1 事件。
5. 权限问题
WSL/Linux 请勿用 root 运行，会造成文件权限混乱。
十一、总结：如何高效使用 OpenClaw？
1. 先用 onboard 完成初始化
2. 配置模型 → 配渠道 → 安装技能
3. 所有配置改完 → 必须重启网关
4. 日常任务：直接用 agents run
5. 出问题永远先看 logs
你只要掌握以上指令，就可以完全驾驭 OpenClaw，无需任何额外技术栈依赖。
🎁 附赠：OpenClaw常用指令速查表
分类 核心指令
基础 --version / onboard / health
网关 gateway restart / status / logs
模型 models set / list
渠道 channels add / list
技能 clawhub install / list
排错 logs / doctor
