启动OpenClaw后第一件事是完成基础配置闭环:验证Node.js≥v22、Git与Python可执行、路径无中文/空格;启动Gateway服务;通过TUI执行/status确认模型、工具、API全部就绪;再运行/config set tools.profile full启用完整工具权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

启动OpenClaw后,第一件事不是发指令,而是完成基础配置闭环——确保模型可调用、通信链路已打通、本地权限已就绪。跳过这步,所有后续操作都会卡在“无响应”或“工具不可用”状态。
确认运行环境是否真正就绪
即使一键安装包已运行成功,仍需验证三项核心依赖是否被正确识别:
-
Node.js 必须为 v22.0.0 或更高版本:在 PowerShell 中执行
node -v,若低于 v22 或报错,需用 nvm(Windows)或 Homebrew(macOS)升级; -
Git 和 Python 需可执行:分别运行
git --version和python --version,任一缺失会导致浏览器自动化、文件读写等技能失效; -
路径不能含中文、空格或特殊字符:如
D:\OpenClaw合规,D:\我的AI工具或C:\Program Files\OpenClaw会引发权限拒绝或模块加载失败。
启动 Gateway 并保持后台运行
Gateway 是 OpenClaw 的通信中枢,所有指令都经它路由。未启动则 TUI 界面无法加载模型,工具卡片显示为空。
- 进入 OpenClaw 根目录(如
D:\OpenClaw),在 PowerShell 中执行:openclaw gateway; - 等待终端输出
Gateway listening on http://127.0.0.1:18789,出现即表示服务就绪; - 该窗口必须保持打开——关闭即断连,TUI 将持续提示“连接失败”。
通过 TUI 运行 /status 完成首次验证
TUI 是官方推荐的首用交互界面,轻量、稳定、反馈明确。用它执行第一条指令,是判断初始化是否成功的最简方式。
- 新开一个 PowerShell 窗口,同样进入 OpenClaw 根目录;
- 执行:
openclaw tui,等待欢迎横幅和>提示符出现; - 直接输入:
/status并回车——无需任何参数或上下文; - 成功响应应包含三类状态:✅ Model connected、✅ Tools enabled、✅ API ready;若任一为 ❌,需返回上一步检查 API Key 或通信配置。
启用完整工具权限并保存配置
默认状态下,OpenClaw 仅开放基础问答能力。要让它真正“动手”,必须显式开启工具集权限。
- 仍在 TUI 界面中,输入:
/config set tools.profile full; - 系统将自动重载技能模块,浏览器控制、文件管理、键鼠模拟等功能随即激活;
- 建议紧接着执行一次
/status再次确认,看到全部 ✅ 后,即可开始发送自然语言指令,例如:“把桌面上所有 Excel 文件按日期整理进‘月度报表’文件夹”。


















