2026最新OpenClaw中文汉化版常用命令速查手册
AI 概述
本文是OpenClaw中文汉化版v2026.4.1-zh.2及以上版本命令速查手册,以`openclaw-cn`为前缀,涵盖终端CLI与聊天斜杠指令,包括基础操作、网关、配置、模型、技能插件、渠道管理等模块。附命令别名、排查技巧与常见问题解决方案,助力用户快速上手与高效运维。
目录
文章目录隐藏

本文为 OpenClaw 中文汉化版 v2026.4.1-zh.2 及以上版本专属命令速查手册,核心涵盖终端 CLI 命令与聊天斜杠指令,以 openclaw-cn 为汉化版专属命令前缀,包含基础操作、配置管理、技能插件、模型管理等核心模块,清晰呈现命令说明与示例,助力用户快速上手、高效操作。
第一部分:终端 CLI 操作命令大全
基础全局命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn --version |
查看当前版本号 | openclaw-cn --version |
openclaw-cn --help |
查看所有命令帮助 | openclaw-cn --help |
openclaw-cn <command> --help |
查看指定命令的详细帮助 | openclaw-cn gateway --help |
openclaw-cn tui |
启动终端图形交互界面(新手友好) | openclaw-cn tui |
openclaw-cn dashboard |
自动打开浏览器访问 Web 控制台 | openclaw-cn dashboard |
openclaw-cn docs <query> |
内置文档搜索 | openclaw-cn docs "微信接入" |
全局通用标志:
--json:输出 JSON 格式,适合脚本调用--verbose:显示详细日志--dev:开发模式,状态隔离到~/.openclaw-dev--profile <name>:多实例隔离,状态存储在~/.openclaw-<name>
安装与初始化
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn onboard |
启动交互式初始化配置向导 | openclaw-cn onboard |
openclaw-cn onboard --install-daemon |
初始化并安装系统后台服务(开机自启) | openclaw-cn onboard --install-daemon |
openclaw-cn configure |
重新进入配置向导 | openclaw-cn configure |
openclaw-cn update |
一键更新到最新稳定版 | openclaw-cn update |
openclaw-cn update --nightly |
更新到每日构建版 | openclaw-cn update --nightly |
openclaw-cn uninstall --all --yes |
彻底卸载,删除所有数据 | openclaw-cn uninstall --all --yes |
网关服务管理(核心)
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn gateway run |
前台启动网关服务(调试用) | openclaw-cn gateway run |
openclaw-cn gateway start |
后台启动网关服务 | openclaw-cn gateway start |
openclaw-cn gateway stop |
停止网关服务 | openclaw-cn gateway stop |
openclaw-cn gateway restart |
重启网关服务(配置修改后必用) | openclaw-cn gateway restart |
openclaw-cn gateway status |
查看网关运行状态、端口占用、链路健康度 | openclaw-cn gateway status |
openclaw-cn gateway install |
注册网关为系统服务,实现开机自启 | openclaw-cn gateway install |
openclaw-cn gateway uninstall |
卸载系统服务 | openclaw-cn gateway uninstall |
openclaw-cn gateway probe |
深度探测网关连通性,排查网络拦截问题 | openclaw-cn gateway probe |
配置管理
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn config show |
查看当前完整配置 | openclaw-cn config show |
openclaw-cn config get <key> |
查询指定配置项的值 | openclaw-cn config get language |
openclaw-cn config set <key> <value> |
快速修改单条配置 | openclaw-cn config set language zh-CN |
openclaw-cn config edit |
调用系统编辑器修改配置文件 | openclaw-cn config edit |
openclaw-cn config validate |
校验配置文件语法与合法性 | openclaw-cn config validate |
openclaw-cn config reset |
重置为默认配置(会覆盖所有修改) | openclaw-cn config reset |
模型管理
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn models list |
列出所有已配置的模型 | openclaw-cn models list |
openclaw-cn models set <model-name> |
设置默认使用的模型 | openclaw-cn models set claude-4-sonnet-20260301 |
openclaw-cn models add <provider> <api-key> |
添加新的模型提供商 | openclaw-cn models add openai sk-xxx |
openclaw-cn models remove <model-name> |
删除指定模型 | openclaw-cn models remove gpt-3.5-turbo |
openclaw-cn models status |
查看所有模型的连接状态 | openclaw-cn models status |
openclaw-cn models scan |
自动扫描本地 Ollama 模型 | openclaw-cn models scan |
openclaw-cn models usage |
查看模型 API 用量和剩余配额 | openclaw-cn models usage |
技能与插件管理
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn skills list |
列出所有已安装的技能 | openclaw-cn skills list |
openclaw-cn skills install <skill-name> |
从 ClawHub 安装技能 | openclaw-cn skills install pdf-processor |
openclaw-cn skills install <local-path> |
从本地目录安装技能 | openclaw-cn skills install ./my-skill |
openclaw-cn skills update <skill-name> |
更新指定技能 | openclaw-cn skills update pdf-processor |
openclaw-cn skills update --all |
更新所有已安装的技能 | openclaw-cn skills update --all |
openclaw-cn skills uninstall <skill-name> |
卸载指定技能 | openclaw-cn skills uninstall pdf-processor |
openclaw-cn plugins list |
列出所有已安装的插件 | openclaw-cn plugins list |
openclaw-cn plugins install <plugin-name> |
安装插件 | openclaw-cn plugins install vscode-bridge |
渠道平台管理(微信/钉钉/飞书)
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn channels list |
列出所有已配置的聊天渠道 | openclaw-cn channels list |
openclaw-cn channels add --channel <name> |
添加新的聊天渠道 | openclaw-cn channels add --channel wechat |
openclaw-cn channels remove --channel <name> |
删除指定渠道 | openclaw-cn channels remove --channel telegram |
openclaw-cn channels status |
查看所有渠道的连接状态 | openclaw-cn channels status |
openclaw-cn channels logs --channel <name> |
查看指定渠道的日志 | openclaw-cn channels logs --channel dingtalk |
openclaw-cn message send --channel <name> --target <id> --message <text> |
发送消息 | openclaw-cn message send --channel wechat --target "张三" --message "你好" |
Agent 与会话管理
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn agents list |
列出所有已创建的 Agent | openclaw-cn agents list |
openclaw-cn agents add <name> --workspace <path> |
创建新的 Agent | openclaw-cn agents add work --workspace ~/projects |
openclaw-cn agents delete <id> --force |
删除指定 Agent | openclaw-cn agents delete 1 --force |
openclaw-cn agent --message <text> |
向默认 Agent 发送消息 | openclaw-cn agent --message "列出当前目录文件" |
openclaw-cn sessions list |
列出所有会话 | openclaw-cn sessions list |
openclaw-cn sessions delete <id> |
删除指定会话 | openclaw-cn sessions delete 1 |
openclaw-cn sessions export <id> --format markdown |
导出会话为 Markdown 文件 | openclaw-cn sessions export 1 --format markdown |
数据与记忆管理
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn memory status |
查看记忆系统状态 | openclaw-cn memory status |
openclaw-cn memory index |
重建向量索引(修复记忆 Bug 必用) | openclaw-cn memory index |
openclaw-cn memory search "<query>" |
向量搜索长期记忆 | openclaw-cn memory search "Python" |
openclaw-cn memory clear |
清除所有长期记忆 | openclaw-cn memory clear |
openclaw-cn directory add <path> |
添加目录到文件访问白名单 | openclaw-cn directory add ~/Documents |
openclaw-cn directory list |
列出所有允许访问的目录 | openclaw-cn directory list |
诊断与维护(遇到问题先执行这些)
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn doctor |
全面健康检查(配置、端口、依赖) | openclaw-cn doctor |
openclaw-cn doctor --fix |
健康检查+自动修复常见错误 | openclaw-cn doctor --fix |
openclaw-cn status --all |
完整系统状态诊断 | openclaw-cn status --all |
openclaw-cn status --deep |
深度探测所有组件状态 | openclaw-cn status --deep |
openclaw-cn logs |
查看最近 100 行日志 | openclaw-cn logs |
openclaw-cn logs --follow |
实时查看日志(排查问题必备) | openclaw-cn logs --follow |
openclaw-cn logs --level error |
只查看错误日志 | openclaw-cn logs --level error |
备份与恢复
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn backup create |
创建完整数据备份 | openclaw-cn backup create |
openclaw-cn backup list |
列出所有备份 | openclaw-cn backup list |
openclaw-cn backup restore <backup-id> |
从指定备份恢复 | openclaw-cn backup restore 20260413-120000 |
openclaw-cn backup delete <backup-id> |
删除指定备份 | openclaw-cn backup delete 20260413-120000 |
高级命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw-cn cron list |
列出所有定时任务 | openclaw-cn cron list |
openclaw-cn cron add "0 9 * * *" "发送每日日报" |
添加定时任务 | openclaw-cn cron add "0 9 * * *" "发送每日日报" |
openclaw-cn security audit |
执行安全审计 | openclaw-cn security audit |
openclaw-cn sandbox run <command> |
在沙箱中执行命令 | openclaw-cn sandbox run "ls -la" |
openclaw-cn mcp list |
列出所有已连接的 MCP 服务器 | openclaw-cn mcp list |
第二部分:聊天斜杠指令大全
(在 Web 控制台/微信/钉钉/飞书聊天窗口直接输入)
基础控制指令
| 指令 | 说明 | 示例 |
|---|---|---|
/help |
显示所有可用斜杠命令 | /help |
/help <command> |
查看指定命令的详细用法 | /help model |
/new 或 /clear |
开启新会话,清除上下文缓存 | /new |
/reset |
重置会话到初始状态(恢复默认参数) | /reset |
/stop |
强制停止当前正在生成的内容或任务 | /stop |
/status |
显示当前对话状态、模型、Token 使用量 | /status |
/context |
详细展示当前对话的上下文构成 | /context |
/whoami |
显示当前发送者的身份标识 | /whoami |
/export |
将当前会话导出为 Markdown 文件 | /export |
模型与参数调整
| 指令 | 说明 | 示例 |
|---|---|---|
/model <model-name> |
临时切换当前会话使用的模型 | /model claude-4-opus |
/think <level> |
设置思考深度:off/minimal/low/medium/high/xhigh | /think high |
/temperature <value> |
调整生成温度(0-2),值越高越随机 | /temperature 0.7 |
/maxtokens <value> |
设置最大生成 Token 数 | /maxtokens 2048 |
/fast on/off |
开启/关闭快速响应模式 | /fast on |
/compact |
压缩当前会话上下文(用摘要替代历史,节省 Token) | /compact |
工具与技能
| 指令 | 说明 | 示例 |
|---|---|---|
/tools |
列出当前可用的所有工具及其描述 | /tools |
/skills |
列出所有已安装的技能 | /skills |
/skill <skill-name> <args> |
手动调用指定技能 | /skill pdf-extract test.pdf |
/bash <command> |
在主机上执行 Shell 命令 | /bash ls -la |
/file list |
列出当前工作目录的文件 | /file list |
/file read <filename> |
读取指定文件内容 | /file read README.md |
/file write <filename> <content> |
写入内容到指定文件 | /file write test.txt "Hello World" |
系统管理
| 指令 | 说明 | 示例 |
|---|---|---|
/restart |
重启网关服务(仅管理员可用) | /restart |
/config get <key> |
读取指定配置项的值 | /config get language |
/config set <key> <value> |
修改指定配置项 | /config set default_model gpt-4o |
/usage off/tokens/full |
控制 Token 用量显示的详细程度 | /usage full |
/verbose on/off |
开关详细模式,显示工具调用和推理步骤 | /verbose on |
/tts on/off |
开启/关闭语音回复 | /tts on |
高级功能
| 指令 | 说明 | 示例 |
|---|---|---|
/subagent spawn <role> |
生成并启动一个子代理处理复杂任务 | /subagent spawn "前端工程师" |
/btw <question> |
询问一个临时问题,不被加入长期对话记忆 | /btw "今天是几号?" |
/activation mention/always |
切换激活模式:仅@提及触发/所有消息都触发 | /activation always |
/elevated |
临时提升 Agent 权限(需管理员密码) | /elevated |
/mcp list |
列出所有已连接的 MCP 服务器 | /mcp list |
第三部分:实用技巧与常见问题
命令别名设置(提高效率)
Linux/macOS
# 添加到 ~/.bashrc 或 ~/.zshrc alias oc='openclaw-cn' alias ocg='openclaw-cn gateway' alias ocs='openclaw-cn status' alias ocd='openclaw-cn doctor --fix' alias ocl='openclaw-cn logs --follow' # 生效 source ~/.bashrc
Windows PowerShell
# 添加到 $PROFILE Set-Alias oc openclaw-cn Set-Alias ocg openclaw-cn-gateway Set-Alias ocs openclaw-cn-status Set-Alias ocd openclaw-cn-doctor Set-Alias ocl openclaw-cn-logs
万能问题排查命令组合
遇到任何问题,先执行这三条命令,能解决 80%的常见错误:
openclaw-cn doctor --fix && \ openclaw-cn gateway restart && \ openclaw-cn logs --follow
常见问题快速解决
- 服务启动失败:先执行
openclaw-cn doctor --fix,再重启服务 - 汉化不生效:执行
openclaw-cn config set language zh-CN,然后重启服务 - AI 不回复:执行
openclaw-cn models status检查模型连接状态 - 技能安装失败:配置国内技能镜像:
openclaw-cn config set skillRegistry https://openclaw.cn/skills - 无法访问本地文件:添加目录到白名单:
openclaw-cn directory add ~/Documents
结语
这份速查手册涵盖了 OpenClaw 中文汉化版 99%的常用操作命令,建议收藏并打印出来放在电脑旁,遇到问题随时查阅。记住:遇到问题先执行 openclaw-cn doctor --fix,这是解决大多数问题的最快方法。
如果需要更详细的命令说明,可以执行 openclaw-cn <command> --help 查看官方帮助文档。
以上关于2026最新OpenClaw中文汉化版常用命令速查手册的文章就介绍到这了,更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章,希望大家以后多多支持码云笔记。
声明:本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若内容造成侵权/违法违规/事实不符,请将相关资料发送至 admin@mybj123.com 进行投诉反馈,一经查实,立即处理!
重要:如软件存在付费、会员、充值等,均属软件开发者或所属公司行为,与本站无关,网友需自行判断
码云笔记 » 2026最新OpenClaw中文汉化版常用命令速查手册
如若内容造成侵权/违法违规/事实不符,请将相关资料发送至 admin@mybj123.com 进行投诉反馈,一经查实,立即处理!
重要:如软件存在付费、会员、充值等,均属软件开发者或所属公司行为,与本站无关,网友需自行判断
码云笔记 » 2026最新OpenClaw中文汉化版常用命令速查手册
微信
支付宝