一、什么是 OpenClawOpenClaw 是一个面向 AI Agent 的运行框架支持通过 CLI 管理 Agent、Gateway、设备以及权限控制。你可以把它理解为一个类似 “AI版 Docker tmux CLI 管理器” 的工具它的核心能力包括多 Agent 管理远程设备接入安全控制权限 / Token / 白名单Web 控制台Control UI插件 / 自动化能力二、基础命令总览openclaw[command][subcommand][options]你最常用的命令主要集中在以下几个模块模块说明gateway网关服务核心agentAI Agent 管理devices设备管理tokens认证与授权status当前状态doctor问题修复三、核心命令详解1️⃣ 查看状态openclaw status作用查看当前 OpenClaw 运行状态Agent 是否正常Gateway 是否在线示例输出 OpenClaw 2026.x.x Agent: running Gateway: active排查问题第一步一定是它2️⃣ Gateway网关管理启动网关openclaw gateway start停止网关openclaw gateway stop重启网关openclaw gateway restart常见场景修改配置后必须 restartControl UI 打不开 → 重启生成 Token设备接入用openclaw gateway tokens generate用途新设备接入手机 / 服务器 / 本地类似 “邀请码”3️⃣ Agent 管理启动 Agentnpx openclaw agent# 或openclaw agent start查看 Agent 状态openclaw agent status查看 Agent 日志openclaw agent logs常见问题❌ No API key found → 没配置模型❌ Agent 启动失败 → 看 logs4️⃣ Devices设备管理查看设备列表openclaw devices list删除设备openclaw devices removedevice_id使用场景移除异常设备控制哪些设备可以连接5️⃣ Token 管理权限核心查看 Tokenopenclaw devices token list⚠️注意有些版本没有 token list会报unknown command token正确做法使用 gateway tokens或升级版本6️⃣ 配置修复非常重要openclaw doctor--fix作用自动修复配置问题清理无效字段常见错误Unrecognized keys: workDir一键修复openclaw doctor--fix7️⃣ Control UIWeb 控制台默认访问地址http://localhost:18789常见打不开原因❌ 问题 1端口未监听解决openclaw gateway restart❌ 问题 2跨域限制报错信息origin not allowed修改配置{gateway:{controlUi:{allowedOrigins:[*]}}}然后执行openclaw gateway restart8️⃣ 权限与安全配置重点限制 Agent 执行危险命令在配置文件中添加{agent:{allowExternalCommand:false}}防止删除服务器文件执行 rm -rf远程命令注入限制工作目录{agent:{workDir:/safe/path}}让 AI 只能操作指定目录四、常见问题总结❓1. 为什么命令不存在原因版本不一致CLI 变化较快解决npx openclawlatest❓2. Agent 启动报 401原因API Key 未配置解决编辑配置文件~/.openclaw/agents/main/agent/auth-profiles.json❓3. UI 打不开排查顺序gateway 是否启动端口是否被占用是否跨域限制❓4. 如何防止被滥用必做三件事✅ 关闭 allowExternalCommand✅ 限制 workDir✅ 控制 Token 发放五、进阶技巧 1. Docker 部署dockercompose up-d优势隔离环境易迁移更安全 2. 自动化脚本结合工具crontabGit hooks飞书 / Telegram Bot可实现自动周报自动运维自动代码分析 3. 多 Agent 架构你可以同时运行多个 Agent配置文件目录.openclaw/agents/每个 Agent独立能力独立权限独立模型六、总结OpenClaw 的核心可以记住一句话“Gateway 管入口Agent 干活Token 控权限”如果你刚入门优先掌握statusgateway restartagent logsdoctor --fix基本可以解决 80% 问题。七、推荐学习路径本地跑通 OpenClaw接入一个 LLMClaude / OpenAI配置安全策略尝试自动化任务周报 / 运维搭建自己的 AI Agent 系统
OpenClaw 常用命令详解（从入门到进阶）
一、什么是 OpenClawOpenClaw 是一个面向 AI Agent 的运行框架支持通过 CLI 管理 Agent、Gateway、设备以及权限控制。你可以把它理解为一个类似 “AI版 Docker tmux CLI 管理器” 的工具它的核心能力包括多 Agent 管理远程设备接入安全控制权限 / Token / 白名单Web 控制台Control UI插件 / 自动化能力二、基础命令总览openclaw[command][subcommand][options]你最常用的命令主要集中在以下几个模块模块说明gateway网关服务核心agentAI Agent 管理devices设备管理tokens认证与授权status当前状态doctor问题修复三、核心命令详解1️⃣ 查看状态openclaw status作用查看当前 OpenClaw 运行状态Agent 是否正常Gateway 是否在线示例输出 OpenClaw 2026.x.x Agent: running Gateway: active排查问题第一步一定是它2️⃣ Gateway网关管理启动网关openclaw gateway start停止网关openclaw gateway stop重启网关openclaw gateway restart常见场景修改配置后必须 restartControl UI 打不开 → 重启生成 Token设备接入用openclaw gateway tokens generate用途新设备接入手机 / 服务器 / 本地类似 “邀请码”3️⃣ Agent 管理启动 Agentnpx openclaw agent# 或openclaw agent start查看 Agent 状态openclaw agent status查看 Agent 日志openclaw agent logs常见问题❌ No API key found → 没配置模型❌ Agent 启动失败 → 看 logs4️⃣ Devices设备管理查看设备列表openclaw devices list删除设备openclaw devices removedevice_id使用场景移除异常设备控制哪些设备可以连接5️⃣ Token 管理权限核心查看 Tokenopenclaw devices token list⚠️注意有些版本没有 token list会报unknown command token正确做法使用 gateway tokens或升级版本6️⃣ 配置修复非常重要openclaw doctor--fix作用自动修复配置问题清理无效字段常见错误Unrecognized keys: workDir一键修复openclaw doctor--fix7️⃣ Control UIWeb 控制台默认访问地址http://localhost:18789常见打不开原因❌ 问题 1端口未监听解决openclaw gateway restart❌ 问题 2跨域限制报错信息origin not allowed修改配置{gateway:{controlUi:{allowedOrigins:[*]}}}然后执行openclaw gateway restart8️⃣ 权限与安全配置重点限制 Agent 执行危险命令在配置文件中添加{agent:{allowExternalCommand:false}}防止删除服务器文件执行 rm -rf远程命令注入限制工作目录{agent:{workDir:/safe/path}}让 AI 只能操作指定目录四、常见问题总结❓1. 为什么命令不存在原因版本不一致CLI 变化较快解决npx openclawlatest❓2. Agent 启动报 401原因API Key 未配置解决编辑配置文件~/.openclaw/agents/main/agent/auth-profiles.json❓3. UI 打不开排查顺序gateway 是否启动端口是否被占用是否跨域限制❓4. 如何防止被滥用必做三件事✅ 关闭 allowExternalCommand✅ 限制 workDir✅ 控制 Token 发放五、进阶技巧 1. Docker 部署dockercompose up-d优势隔离环境易迁移更安全 2. 自动化脚本结合工具crontabGit hooks飞书 / Telegram Bot可实现自动周报自动运维自动代码分析 3. 多 Agent 架构你可以同时运行多个 Agent配置文件目录.openclaw/agents/每个 Agent独立能力独立权限独立模型六、总结OpenClaw 的核心可以记住一句话“Gateway 管入口Agent 干活Token 控权限”如果你刚入门优先掌握statusgateway restartagent logsdoctor --fix基本可以解决 80% 问题。七、推荐学习路径本地跑通 OpenClaw接入一个 LLMClaude / OpenAI配置安全策略尝试自动化任务周报 / 运维搭建自己的 AI Agent 系统
