openclaw快速上手与高效运维的必备指南
·
文章目录
OpenClaw(小龙虾) AI Agent 常用命令全详解
OpenClaw（中文昵称"小龙虾"）CLI核心命令的系统分类详解，涵盖从安装到日常使用、技能管理、问题排查的全流程，是快速上手与高效运维的必备指南。
一、基础管理命令（入门必用）
用于安装、初始化、升级与卸载，是使用OpenClaw的第一步。
| 命令 | 作用 | 实用参数 | 示例 |
|---|---|---|---|
openclaw --help |
查看完整命令手册 | - | openclaw -h（简写） |
openclaw onboard |
新手引导（自动配置基础环境） | --install-daemon（安装网关服务） |
openclaw onboard --install-daemon |
openclaw upgrade |
升级到最新版本 | --force（强制覆盖） |
openclaw upgrade |
openclaw uninstall |
卸载OpenClaw | --all（彻底删除所有数据）、--yes（自动确认） |
openclaw uninstall --all --yes |
openclaw version |
查看当前版本号 | - | openclaw version |
二、配置管理命令（核心设置）
管理OpenClaw的大模型、API密钥、工具集成等关键配置，决定AI能力边界。
| 命令 | 作用 | 常用参数 | 示例 |
|---|---|---|---|
openclaw configure |
交互式配置向导 | --section <section>（指定配置模块） |
openclaw configure --section web（配置网络搜索） |
openclaw config get <key> |
读取配置值 | - | openclaw config get gateway.auth.token |
openclaw config set <key> <value> |
设置配置值 | - | openclaw config set model.provider openai |
openclaw config list |
列出所有配置 | --json（JSON格式输出） |
openclaw config list --json |
openclaw config reset <key> |
重置配置为默认值 | - | openclaw config reset tools.terminal.enabled |
三、网关控制命令（核心组件管理）
网关(Gateway)是OpenClaw的控制平面，管理会话、路由消息、执行工具。
| 命令 | 作用 | 实用参数 | 示例 |
|---|---|---|---|
openclaw gateway run |
启动网关服务 | --bind <addr>（绑定地址）、--port <port>（端口） |
openclaw gateway run --bind loopback --port 18789 |
openclaw gateway stop |
停止网关服务 | - | openclaw gateway stop |
openclaw gateway status |
查看网关运行状态 | - | openclaw gateway status |
openclaw gateway logs |
查看网关日志 | --follow（实时跟踪） |
openclaw gateway logs --follow |
四、技能管理命令（能力扩展核心）
通过ClawHub安装/管理技能(Skills)，为AI"安装手脚"，实现网页浏览、文件处理等功能。
1. 基础技能管理
| 命令 | 作用 | 示例 |
|---|---|---|
clawhub search <keyword> |
搜索技能 | clawhub search "browser"（搜索浏览器相关技能） |
clawhub install <skill> |
安装技能 | clawhub install agent-browser（安装网页浏览技能） |
clawhub list |
列出已安装技能 | clawhub list |
clawhub uninstall <skill> |
卸载技能 | clawhub uninstall code-executor |
clawhub update <skill> |
更新技能 | clawhub update git |
2. 核心技能推荐安装
# 必备基础技能（建议全装）
openclaw skills install code-executor git terminal file-manager web-search
# 实用扩展技能
openclaw skills install agent-browser pdf-parser email-client calendar
五、代理(Agent)管理命令（AI分身创建）
创建、管理多个AI代理，分工协作完成复杂任务。
| 命令 | 作用 | 常用参数 | 示例 |
|---|---|---|---|
openclaw agents add <name> |
创建新代理 | --model <model>（指定大模型） |
openclaw agents add research --model gpt-4 |
openclaw agents list |
列出所有代理 | - | openclaw agents list |
openclaw agents remove <name> |
删除代理 | - | openclaw agents remove old-agent |
openclaw agents start <name> |
启动代理 | - | openclaw agents start research |
openclaw agents stop <name> |
停止代理 | - | openclaw agents stop research |
六、健康诊断命令（问题排查必备）
快速定位与解决OpenClaw运行中的问题，保障系统稳定。
| 命令 | 作用 | 实用参数 | 示例 |
|---|---|---|---|
openclaw health |
基础体检 | - | openclaw health（检查核心组件、依赖和环境） |
openclaw doctor |
综合诊断+修复建议 | --deep（深度诊断） |
openclaw doctor --deep |
openclaw test <tool> |
测试特定工具/技能 | - | openclaw test web_search（测试网络搜索功能） |
openclaw logs |
查看系统日志 | --tail <n>（显示最后n行） |
openclaw logs --tail 100 |
七、任务执行命令（核心功能）
让AI代理执行具体任务，是OpenClaw的核心价值所在。
| 命令 | 作用 | 实用参数 | 示例 |
|---|---|---|---|
openclaw run |
执行任务命令 | --agent <name>（指定代理）、--command <task> |
openclaw run --agent writer --command "写一篇关于AI Agent的博客" |
openclaw run-file <file> |
执行文件中的任务 | - | openclaw run-file tasks/blog-writing.yaml |
openclaw session new |
创建新会话 | --agent <name> |
openclaw session new --agent research |
openclaw session list |
列出所有会话 | - | openclaw session list |
openclaw session resume <id> |
恢复会话 | - | openclaw session resume 1234-5678-90ab |
八、技能开发命令（进阶）
用于开发自定义技能，扩展OpenClaw能力边界。
| 命令 | 作用 | 示例 |
|---|---|---|
openclaw skill init <name> |
创建新技能模板 | openclaw skill init my-custom-skill |
openclaw skill validate <dir> |
验证技能配置 | openclaw skill validate ./my-skill |
openclaw skill package <dir> |
打包技能 | openclaw skill package ./my-skill |
九、实用组合命令示例
1. 完整初始化流程
# 安装+初始化+配置
npm i -g openclaw
openclaw onboard --install-daemon
openclaw configure
# 安装核心技能
openclaw skills install code-executor terminal file-manager web-search
# 启动网关
openclaw gateway run --bind 0.0.0.0 --port 18789
2. 日常使用快捷命令
# 快速检查系统状态
openclaw doctor
# 让AI帮我搜索并整理信息
openclaw run --command "搜索2026年AI Agent最新发展趋势，并整理成报告"
# 重启网关（解决多数运行问题）
openclaw gateway stop && openclaw gateway run --bind loopback --port 18789
十、关键注意事项
- 权限控制：默认禁用危险操作（如终端执行），需通过
openclaw config set tools.terminal.enabled true开启 - 安全第一：避免给不可信代理高权限，定期使用
openclaw doctor --deep检查安全隐患 - 技能来源：优先从官方ClawHub安装技能，第三方技能需谨慎审查
- 环境变量：可通过环境变量覆盖配置，如
OPENCLAW_MODEL_PROVIDER=anthropic openclaw run ...
总结
OpenClaw的命令体系围绕"配置-管理-执行-诊断"四大核心流程设计，日常使用中最常用的是配置命令（设置模型/API）、技能管理（安装能力扩展）、任务执行（让AI干活）和诊断命令（排查问题）。熟练掌握这些命令，就能让这只"小龙虾"成为你的得力AI助手，真正实现"AI动手，人类省心"。
结束语
Flutter是一个由Google开发的开源UI工具包，它可以让您在不同平台上创建高质量、美观的应用程序，而无需编写大量平台特定的代码。我将学习和深入研究Flutter的方方面面。从基础知识到高级技巧，从UI设计到性能优化，欢饮关注一起讨论学习，共同进入Flutter的精彩世界！
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
15
0- 0
已为社区贡献4条内容
所有评论(0)