�� OpenClaw 命令速查手册

1. 基础命令

命令	作用	示例
`openclaw --version`	查看当前 OpenClaw 版本	`openclaw --version`
`openclaw status`	查看整体状态（网关、渠道、会话等）	`openclaw status`
`openclaw status --deep`	深度状态检查（含健康探测）	`openclaw status --deep`
`openclaw doctor`	诊断配置并给出修复建议	`openclaw doctor`
`openclaw doctor --fix`	自动修复常见配置问题	`openclaw doctor --fix`
`openclaw doctor --repair`	更深入的修复（可能覆盖服务配置）	`openclaw doctor --repair`
`openclaw doctor --force`	强制修复（谨慎使用）	`openclaw doctor --repair --force`

2. 网关（Gateway）管理

命令	作用	示例
`openclaw gateway status`	查看网关服务运行状态	`openclaw gateway status`
`openclaw gateway start`	启动网关服务	`openclaw gateway start`
`openclaw gateway stop`	停止网关服务	`openclaw gateway stop`
`openclaw gateway restart`	重启网关服务	`openclaw gateway restart`
`openclaw gateway install`	安装网关服务（注册为系统服务）	`openclaw gateway install`
`openclaw gateway install --force`	强制重新安装网关服务（同步 token）	`sudo openclaw gateway install --force`
`openclaw gateway uninstall`	卸载网关服务	`openclaw gateway uninstall`
`openclaw gateway run`	前台运行网关（调试用，日志直接输出）	`openclaw gateway run`
`openclaw gateway probe`	探测网关是否可连接	`openclaw gateway probe`

3. 配置管理

命令	作用	示例
`openclaw config get <路径>`	获取配置项的值	`openclaw config get tools.allow`
`openclaw config set <路径> <值> --json`	设置配置项（JSON格式值）	`openclaw config set tools.allow '["tavily_search"]' --json`
`openclaw configure`	启动交互式配置向导	`openclaw configure`
`openclaw onboard`	启动初次安装向导	`openclaw onboard`
`openclaw reset`	重置配置（可选范围）	`openclaw reset --scope full --yes`

4. 插件管理

命令	作用	示例
`openclaw plugins list`	列出所有已安装插件	`openclaw plugins list`
`openclaw plugins install <包名>`	安装插件	`openclaw plugins install openclaw-tavily`
`openclaw plugins uninstall <插件ID>`	卸载插件	`openclaw plugins uninstall feishu`
`openclaw plugins enable <插件ID>`	启用插件	`openclaw plugins enable openclaw-tavily`
`openclaw plugins disable <插件ID>`	禁用插件	`openclaw plugins disable feishu-openclaw-plugin`
`openclaw plugins info <插件ID>`	查看插件详细信息	`openclaw plugins info openclaw-tavily`

5. 技能管理

命令	作用	示例
`openclaw skills list`	列出所有已安装技能	`openclaw skills list`
`openclaw skills info <技能名>`	查看技能详情	`openclaw skills info skill-vetter`
`clawhub search <关键词>`	在 ClawHub 搜索技能	`clawhub search baidu`
`clawhub install <技能名>`	从 ClawHub 安装技能	`clawhub install skill-vetter`
`npx clawhub@latest install <技能名>`	用 npx 安装技能（绕过本地缓存）	`npx clawhub@latest install self-improving-agent`
`openclaw skills enable <技能名>`	启用技能	`openclaw skills enable tavily-search`
`openclaw skills disable <技能名>`	禁用技能	`openclaw skills disable bing-search`

6. 模型管理

命令	作用	示例
`ollama list`	查看已下载的模型列表	`ollama list`
`ollama pull <模型名>`	下载模型	`ollama pull qwen3.5:9b`
`ollama run <模型名>`	运行模型（交互式）	`ollama run qwen3.5:9b`
`ollama run <模型名> --num-ctx <长度>`	指定上下文窗口运行	`ollama run qwen3.5:9b --num-ctx 32768`
`ollama ps`	查看当前内存中运行的模型	`ollama ps`
`ollama stop <模型名>`	停止模型	`ollama stop qwen3.5:9b`
`ollama rm <模型名>`	删除模型	`ollama rm deepseek-r1:7b`
`ollama create <新模型名> -f Modelfile`	从 Modelfile 创建新模型	`ollama create qwen3.5:9b-32k -f Modelfile`
`ollama show <模型名> --modelfile`	查看模型的 Modelfile 内容	`ollama show qwen3.5:9b --modelfile > Modelfile`
`openclaw models status`	查看当前模型配置状态	`openclaw models status`
`openclaw config set agents.defaults.model.primary "<模型ID>"`	设置默认模型	`openclaw config set agents.defaults.model.primary "custom-127-0-0-1-8888/qwen3.5:9b-32k"`

7. 飞书相关

命令	作用	示例
`openclaw pairing approve feishu <配对码>`	批准飞书配对请求	`openclaw pairing approve feishu W9F449Y5`
`openclaw pairing list`	查看待批准的配对请求	`openclaw pairing list`
`openclaw config set channels.feishu.enabled true --json`	启用飞书频道	`openclaw config set channels.feishu.enabled true --json`
`openclaw config set channels.feishu.appId <你的AppID>`	设置飞书 App ID	`openclaw config set channels.feishu.appId "cli_xxx"`
`openclaw config set channels.feishu.appSecret <你的Secret>`	设置飞书 App Secret	`openclaw config set channels.feishu.appSecret "xxx"`
`openclaw config set channels.feishu.streaming true`	开启飞书流式输出	`openclaw config set channels.feishu.streaming true`
`openclaw config set channels.feishu.footer.elapsed true`	开启耗时显示	`openclaw config set channels.feishu.footer.elapsed true`
`feishu-plugin-onboard install`	飞书官方插件安装向导	`feishu-plugin-onboard install`
`feishu-plugin-onboard doctor`	飞书插件诊断	`feishu-plugin-onboard doctor`
`npx @larksuite/openclaw-lark-tools install`	安装飞书官方工具（旧版）	`npx @larksuite/openclaw-lark-tools install`

8. SSH 隧道与远程连接

命令	作用	示例
`ssh -N -L <本地端口>:127.0.0.1:<远程端口> 用户@远程IP`	建立 SSH 本地端口转发	`ssh -N -L 8888:127.0.0.1:11434 73009@192.168.3.8`
`ssh -v -N -L ...`	带调试信息的 SSH 连接	`ssh -v -N -L 8888:127.0.0.1:11434 73009@192.168.3.8`
`autossh -M 0 -N -L ...`	用 autossh 自动重连的隧道	`autossh -M 0 -N -L 8888:127.0.0.1:11434 73009@192.168.3.8`
`ssh-keygen -t rsa`	生成 SSH 密钥对	`ssh-keygen -t rsa`
`ssh-copy-id 用户@远程IP`	复制公钥到远程主机（免密登录）	`ssh-copy-id 73009@192.168.3.8`
`curl http://127.0.0.1:<端口>/v1/models`	测试本地转发是否成功	`curl http://127.0.0.1:8888/v1/models`

9. 日志与调试

命令	作用	示例
`openclaw logs --follow`	实时查看 OpenClaw 日志	`openclaw logs --follow`
`tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log`	直接跟踪日志文件（更可靠）	`tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log`
`export DEBUG=openclaw:*`	开启 OpenClaw 调试输出	`export DEBUG=openclaw:*`
`export OPENCLAW_LOG_LEVEL=debug`	设置日志级别为 debug	`export OPENCLAW_LOG_LEVEL=debug`
`ps aux	grep openclaw`	查看 OpenClaw 相关进程
`lsof -i :18789`	查看端口 18789 占用情况	`lsof -i :18789`
`sudo lsof -ti:8888	xargs kill -9`	强制杀掉占用 8888 端口的进程

10. Windows 特有命令（PowerShell）

命令	作用	示例
`Get-Service sshd`	查看 SSH 服务状态	`Get-Service sshd`
`Start-Service sshd`	启动 SSH 服务	`Start-Service sshd`
`Set-Service -Name sshd -StartupType 'Automatic'`	设置 SSH 服务开机自启	`Set-Service -Name sshd -StartupType 'Automatic'`
`Get-NetFirewallProfile	Format-Table Name, Enabled`	查看防火墙状态
`New-NetFirewallRule -Name sshd -DisplayName 'OpenSSH Server' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22`	新建防火墙规则允许 22 端口	见示例
`Remove-Item -Recurse -Force C:\Users\73009\.openclaw`	强制删除 OpenClaw 配置目录	`Remove-Item -Recurse -Force C:\Users\73009\.openclaw`
`schtasks /Delete /F /TN "OpenClaw Gateway"`	删除 OpenClaw 计划任务	`schtasks /Delete /F /TN "OpenClaw Gateway"`
`Get-WindowsCapability -Online	Where-Object Name -like 'OpenSSH.Server*'`	检查 OpenSSH 服务器是否安装
`Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0`	安装 OpenSSH 服务器	见示例

11. macOS 特有命令

命令	作用	示例
`brew install <包名>`	通过 Homebrew 安装软件	`brew install node git`
`launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist`	加载 OpenClaw 服务	`launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist`
`launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist`	卸载服务	`launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist`
`launchctl list	grep openclaw`	查看 OpenClaw 服务是否在运行
`sudo launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/ai.openclaw.gateway.plist`	强制加载服务	见示例

12. 配置文件手动编辑

常用配置文件路径：

Windows：C:\Users\<用户名>\.openclaw\openclaw.json

macOS：/Users/<用户名>/.openclaw/openclaw.json

飞书插件配置：~/.openclaw/agents/main/agent/auth-profiles.json

Agent 人格文件：~/.openclaw/workspace/SOUL.md和 AGENTS.md

希望这份速查手册能帮你快速定位和解决问题。祝你玩得开心！🦞