环境要求： Python ≥ 3.11，支持 macOS、Linux、Windows。下文命令均在终端中执行（Windows：PowerShell / 命令提示符；macOS：终端；Linux：Terminal）。
python3 --version版本应为 3.11.x 或更高。
- macOS：
brew install python@3.11或从官网下载安装包；在终端执行python3 --version确认。 - Linux：
sudo apt install python3.11 python3.11-venv python3-pip（发行版不同时包名可能略有差异）。 - Windows： 从 python.org/downloads 安装，勾选 Add python.exe to PATH，安装完成后重新打开终端。
python3 -m pip install xsafeclaw
xsafeclaw start首次运行一般会自动打开浏览器进入引导页；若未打开，请在浏览器访问：**http://127.0.0.1:6874**。
未检测到 OpenClaw 时，请按页面提示操作，顺序一般为：
打开 http://127.0.0.1:6874/setup ，按页面提示安装 OpenClaw。
打开 http://127.0.0.1:6874/configure ，在安全须知处勾选确认。
选择 「快速开始」（或按需选择手动模式）。
选择模型提供方（例如 Qwen Cloud）→ 点击 「获取密钥」 申请 API Key，并粘贴到页面中。
在配置总览中核对无误后，点击应用。
初始化成功后，点击蓝色的 「进入智能体小镇」 按钮，即可进入像素风工作台界面，Agent 已在此待命。
在远程服务器（如 Linux）上使用，或需要自定义监听地址与端口时，可使用命令行参数：
# 监听所有网卡（便于远程访问），指定端口
xsafeclaw start --host 0.0.0.0 --port 6874
# 不自动打开浏览器（适合无图形界面环境）
xsafeclaw start --no-browser
# 开发模式：代码变更后自动重载
xsafeclaw start --reload常用参数说明：
| 参数 | 简写 | 说明 |
|---|---|---|
--port |
-p |
服务端口，默认 6874 |
--host |
-h |
绑定地址，默认 127.0.0.1 |
--no-browser |
启动后不自动打开浏览器 | |
--reload |
开启自动重载（开发用） |