OpenClaw 全平台部署指南：本地化 AI 智能体安装与配置

*提示：若遇路径报错，请确保安装目录无中文或特殊字符；无法访问面板时检查防火墙是否放行 18789 端口。

2.2 macOS/Linux 平台

方式 1：一键脚本

1. 打开终端。
2. 执行安装命令：

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

3. 初始化并启动：

   openclaw onboard && openclaw gateway start
   

4. 访问 http://localhost:18789 验证。

方式 2：Docker 部署

适合服务器或需要隔离环境的场景。

1. 创建配置目录：

   mkdir -p ~/openclaw && cd ~/openclaw
   

2. 拉取镜像并运行（映射端口并挂载数据）：

   docker run -d --name openclaw-core -p 18789:18789 -v $(pwd):/data openclaw/openclaw
   

3. 查看容器状态：docker ps，服务器用户需将 localhost 替换为公网 IP。

2.3 手机端部署

方式 1：APK 直装

1. 从官方开源仓库下载对应版本的安装包，避免第三方商店盗版。
2. 安装时授权'未知来源'，完成后立即关闭该权限。
3. 初始化时选择'本地运行模式'，务必关闭'公网访问'，仅开启悬浮窗、后台运行等基础权限。
4. 在电池设置中关闭针对本应用的优化，防止锁屏后进程被杀。

方式 2：Termux 进阶

适用于高配机型，可自定义插件。

1. 安装 Termux 并更新环境：

   apt update && apt upgrade -y
   

2. 执行移动端安装脚本：

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

3. 启动服务：openclaw start，手机浏览器访问 http://127.0.0.1:18789。

三、Ollama 本地模型对接

无需联网即可实现离线运行，保障数据隐私。

1. 安装并启动 Ollama（默认端口 11434）。
2. 拉取轻量级模型（适配低配设备）：

   ollama pull qwen2:7b
   # 或高性能版
   ollama pull llama3:8b
   

3. 配置 OpenClaw 对接 Ollama：

   # 绑定服务地址
   openclaw config set models.providers.ollama.baseUrl http://localhost:11434
   # 设置默认模型
   openclaw config set agents.defaults.model.primary ollama/qwen2:7b
   

4. 重启服务生效：

   openclaw gateway restart
   

四、常见问题排查

• 无法访问面板：检查防火墙/安全组是否放行 18789 端口；Windows 需确保以管理员权限运行。
• Node.js 版本过低：卸载旧版，安装 v18 及以上；国内用户可切换镜像源。
• 手机端闪退：检查剩余内存，关闭多余后台应用；重新安装并确保开启后台保活。
• Ollama 连接失败：确认 Ollama 服务已启动且端口正确；模型名称需严格匹配（区分大小写）。
• 广告或捆绑软件：卸载当前版本，仅从官方渠道获取安装包。

五、基础使用

1. 登录面板后，在指令框输入需求，如'整理今天的微信工作消息'或'明天 9 点提醒开会'。
2. 插件安装仅限官方认证市场，避免第三方插件风险。
3. 定期通过 openclaw update 检查更新。

六、总结

部署的核心在于选对方式与安全配置。新手优先使用一键脚本，Windows 用户注意路径规范，手机端务必关闭公网访问。进阶用户可通过 Docker 或 Ollama 实现更灵活的本地化控制。遵循上述步骤，即可安全、稳定地启用这款自动化 AI 助手。