OpenHands CLI 命令速查表 - 开源自主编码代理全参数
OpenHands 自主编码代理命令都在这里了，从交互启动到无头批处理、从批准模式到 MCP 接入，按场景分类整理，复制即用。
启动与任务 5
openhands启动交互式 TUI / Web（默认 3000 端口）
openhands -t "实现用户认证"带任务直接运行（--task）
openhands -f task.txt从文件读取任务说明
openhands --always-approve自动批准所有操作（--yolo 同义）
openhands --llm-approve仅自动批准 LLM 发起的操作
恢复与无头 5
openhands --resume恢复上一个会话
openhands --resume --last恢复最近一个会话
openhands --resume <id>按 ID 恢复指定会话
openhands --headless -t "任务"无头模式运行任务
openhands --headless --json无头输出 JSON（脚本用）
运行模式（Web/ACP/Cloud） 5
openhands web启动 Web UI
openhands serve作为服务常驻
openhands acp以 ACP 协议接入
openhands login登录 OpenHands Cloud
openhands cloud -t "任务"提交任务到云端运行
MCP 管理 5
openhands mcp list列出 MCP 服务器
openhands mcp add tavily添加 tavily 等 MCP 服务器
openhands mcp enable <name>启用某 MCP 服务器
openhands mcp disable <name>禁用某 MCP 服务器
openhands --from-issue <url>从 Issue URL 拉取任务
配置与安装 5
uv tool install openhands --python 3.12V1 CLI 安装（推荐）
pip install openhands-ai==0.45.0pip 安装指定版本
docker pull openhands/runtime:0.45-cpu拉取运行时镜像
openhands --override-with-envs用环境变量覆盖配置
cat ~/.openhands/config.toml查看用户级配置（core/llm/sandbox/planner）
交互快捷键 5
Ctrl+P打开命令面板
Esc暂停当前任务
Ctrl+Q退出
/exit退出会话
openhands --max-iterations 50限制最大迭代轮次
提示
- OpenHands 定位"自主写整个 repo"，比结对编程更激进；首次跑大任务先用 `--resume` 保留断点，崩了能续。
- 无头批处理用 `--headless --json` 接流水线，配合 `--max-iterations` 防止 Agent 无限循环。
- 敏感/生产任务别裸开 `--always-approve`，至少用 `--llm-approve` 或先 `--headless` 跑小范围验证。
- 配置集中在 `~/.openhands/config.toml`（llm/sandbox/planner），改模型与沙箱策略一次到位，不用每次传参。
由 巧匠 维护
公开更新于 2026年8月21日，内容持续校对官方文档。