夜雨聆风在 AI Agent 的世界里，图形界面（GUI）虽然友好，但命令行（CLI）才是真正的“灵魂所在”。对于刚接触 OpenClaw（小虾） 的开发者来说，掌握一套精准的常用命令，不仅能让你在环境报错时从容应对，更能极大提升“养虾”的效率。
今天，我们将这套经过数千次实战检验的命令手册公开。建议收藏并打印，贴在你的显示器旁边，这是你从新手迈向 Agent 架构师的第一步。
一、 环境护航：创建稳健的运行土壤
OpenClaw 对 Python 环境极其挑剔。为了避免不同项目之间的依赖库“打架”，我们必须学会使用虚拟环境。
1. 使用 Conda 创建专属环境（推荐）
Conda 是目前管理 Python 版本最稳定的工具，尤其在处理 C++ 编译依赖时表现卓越。
• 创建环境（指定 Python 3.10）：Bashconda create -n openclaw_env python=3.10 -y • 激活环境：Bashconda activate openclaw_env • 检查 Python 版本（确保输出为 3.10.x）：Bashpython --version
2. 使用原生 venv（备选）
如果你不想安装 Conda，可以使用 Python 自带的虚拟环境工具：
• 创建： python -m venv venv • 激活（Windows）： .\venv\Scripts\activate • 激活（Linux/Mac）： source venv/bin/activate
二、 下载与安装：告别“红字”报错
拿到 OpenClaw 的源码后，安装依赖是最高频率的报错环节。
1. 获取最新代码
• 克隆项目（确保安装了 Git）：Bashgit clone https://github.com/OpenClaw/OpenClaw.gitcd OpenClaw
2. 暴力安装依赖（新手必杀技）
直接运行 pip install 有时会因为网络或镜像问题卡住，建议使用国内镜像源：
• 使用清华源安装：Bashpip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple • 升级 pip（解决很多莫名报错的前提）：Bashpython -m pip install --upgrade pip
3. 针对 Windows 的 C++ 构建工具报错
如果你看到 error: Microsoft Visual C++ 14.0 or greater is required，不要慌，这通常是因为某些底层库需要编译。
• 应急命令（安装预编译版）：Bashpip install --only-binary :all: [报错的库名]
三、 运行与调试：掌控智能体的动态
环境配好后，如何让“小虾”跑起来，并实时监控它的思考逻辑？
1. 启动核心主程序
• 默认启动：Bashpython main.py • 指定配置文件启动（多项目管理必备）：Bashpython main.py --config config_custom.yaml
2. 实时日志追踪
当 Agent 陷入死循环或不说话时，看日志是唯一的排查手段。
• Linux 用户实时查看最后 100 行日志：Bashtail -f logs/openclaw.log -n 100 • Windows 用户使用 PowerShell 查看：BashGet-Content logs/openclaw.log -Wait -Tail 100
3. 清理缓存（Agent 逻辑混乱时必做）
有时候 Agent 表现得像断了片，可能是旧的记忆缓存干扰了它。
• 清理本地持久化缓存：Bashrm -rf ./cache/*
四、 API 连通性测试：打通“大脑”连接
OpenClaw 无法运行，80% 的情况是 API 配置出了问题，尤其是使用 NewAPI 或 Sub2API 等中继平台时。
1. 测试 API Key 是否有效
在启动 OpenClaw 前，先用这一条命令测试你的 Key 到底能不能用（以 OpenAI 格式为例）：
Bash
curl https://你的API网关地址/v1/chat/completions \-H “Content-Type: application/json” \-H “Authorization: Bearer 你的API密钥” \-d ‘{“model”: “gpt-4o-mini”,“messages”: [{“role”: “user”, “content”: “你好”}]}’
• 注意： 如果返回了 JSON 结果，说明 Key 没问题；如果返回 404 或 401，请检查 Base URL 是否带了 /v1。
五、 高阶进阶：自动化与部署指令
当你准备让 OpenClaw 24 小时待命时，这些命令将成为你的护身符。
1. 后台静默运行（防断开）
如果你在远程服务器上运行，关闭终端会导致程序停止。
• 使用 nohup（Linux）：Bashnohup python main.py > output.log 2>&1 & • 查看后台进程 ID：Bashps -ef | grep python
2. Docker 一键部署（极简主义者首选）
如果你讨厌配环境，直接上 Docker：
• 构建镜像：Bashdocker build -t my-openclaw . • 运行容器：Bashdocker run -d --name claw-worker -v ./config:/app/config my-openclaw
六、 实战小贴士：新手最常问的三个 Q&A
Q1：为什么我运行 pip install 提示权限不足？
A： Windows 下请用管理员模式打开命令行；Linux 下请在命令前加 sudo，或者（更推荐）使用虚拟环境避免权限问题。
Q2：运行中提示 ModuleNotFoundError: No module named ‘xxx’ 怎么办？
A： 这说明某个依赖没装上。直接复制报错的库名，运行 pip install xxx。如果是 OpenClaw 的核心依赖，请重新运行 pip install -r requirements.txt。
Q3：我的 Agent 反应特别慢，命令台一直卡住？
A： 检查你的网络连接。可以使用 ping api.openai.com（或你的中继地址）查看延迟。如果延迟超过 2000ms，建议更换 API 节点。
结语
命令行不是障碍，而是力量。
当你熟练掌握了上述命令，你会发现自己从一个“软件使用者”进化为了“流程掌控者”。你可以通过脚本自动备份数据，可以通过一条指令切换数百个 Agent 的配置。
OpenClaw 的强大，不在于界面的华丽，而在于它能通过这些简短的指令，在你的服务器里构建出一个不知疲倦的智能帝国。
如果你在操作中遇到了手册之外的报错，欢迎在评论区贴出你的错误代码，我们一起“在线捉虫”！
