openclaw本地部署教程

一、部署前准备

1. 系统要求（最低配置）

特别提醒：Windows用户建议使用WSL2运行，原生PowerShell兼容性较差。

2. 必备密钥

• 阿里云Qwen3 API密钥（核心，需提前获取）；

• 聊天渠道账号（Telegram/WhatsApp/Discord等，可选）；

• Brave Search API密钥（用于网页搜索，可选）。

二、全平台一键安装

OpenClaw官方一键脚本可自动检测依赖、安装CLI工具，无需手动配置环境：

1. macOS/Linux/WSL（推荐）

打开终端执行：

curl -fsSL https://openclaw.ai/install.sh | bash

权限不足时添加sudo：

curl -fsSL https://openclaw.ai/install.sh | sudo bash

2. Windows（PowerShell）

以管理员身份打开PowerShell，执行：

iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动完成Node.js安装/升级、OpenClaw全局部署，并启动配置向导。

三、配置向导：接入Qwen3核心步骤

安装完成后自动启动配置向导，按以下步骤完成初始化：

1. 选择配置模式

• QuickStart（推荐）：新手首选，自动配置基础参数；

• Custom（自定义）：进阶用户可精细调整设置。

2. 接入阿里云Qwen3（关键步骤）

前置：获取Qwen3 API密钥

1. 访问 阿里云官网完成账号注册与实名认证；

2. 进入「API-KEY管理」页面，点击「创建API-KEY」，复制生成的api-key（格式：sk-xxxxxx）。

OpenClaw中配置Qwen3

1. 在配置向导中选择「Custom Provider（自定义提供商）」；

2. 填写核心参数

3. 点击「Test Connection」测试连接，提示「Success」即配置成功。

3. 设置聊天渠道（可选）

选择常用聊天应用（如Telegram）：

1. 通过@BotFather创建Bot获取token；

2. 输入token并设置允许的用户ID（保障安全性）；

3. 可选启用WebChat（浏览器直接访问的聊天界面）。

四、启动与验证

1. 启动网关服务

安装完成后服务自动启动，可通过以下命令检查状态：

openclaw gateway status

2. 访问控制面板

执行命令启动Web管理界面：

openclaw dashboard

默认自动打开浏览器访问http://localhost:8080，输入安装时生成的初始密码即可登录。

3. 测试Qwen3执行能力

在聊天窗口发送测试指令：

帮我在桌面创建名为"qwen3_test"的文件夹，里面新建README.md文件，写入"Hello Qwen3 + OpenClaw!"

若AI成功执行并返回结果，说明Qwen3已成功接入。

五、安全注意事项

1. 启用沙箱模式：在config.json中设置sandbox_mode: true，限制AI访问敏感目录；

2. 严格访问控制：在渠道配置中明确allowed_users，仅允许信任用户使用；

3. 禁用高危技能：默认关闭「系统命令执行」，仅必要时启用；

4. 定期更新：执行openclaw update保持版本最新，修复安全漏洞。

六、常见问题排查

1. Qwen3连接失败：检查API-KEY是否正确、账号是否实名认证，或更换API Base URL为https://dashscope.aliyuncs.com/api/v1重试；

2. Command Not Found错误：重启终端或执行source ~/.bashrc重新加载环境变量；

3. macOS未验证开发者警告：系统设置→隐私与安全→点击「仍要打开」；

4. 端口占用：修改config.json中的port参数，使用空闲端口。