AI创想

标题: OpenClaw 本地安装 [打印本页]
作者: 米落枫    时间: 13 小时前
标题: OpenClaw 本地安装
作者：CSDN博客
说明        

        技术迭代的太快了，今天是2026.3.14 ，记录下日期，因为你在过两个月，这个教程可能就和你的界面版本对不上了。
安装

        首先针对小白，因为我也是小白，硬件是M1 8G 512G的配置。参照了https://blog.csdn.net/Axela30W/article/details/158838007这个博主的
  1. #一键安装(号称推新手首选其实坑也很多,新手大概率是成功不了的)
  2. curl -fsSL https://openclaw.ai/install.sh | bash
复制代码
在终端执行这个命令，对于小白来说大概率会是安装失败的，会报homebrew没有安装，按道理会自动安装的，可以试了几次都安装失败，那么接下来先手动安装 homebrew
  1. # 手动执行 Homebrew 官方安装命令（交互式，会提示输入密码）
  2. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
复制代码
别以为执行就好了，其中会和Xcode‌有关联，会访问 github网络不好的时候 又是经常失败，万幸的是重试了好几次homebrew 安装好了，接下来，一定要把终端关闭，否则执行 brew --version会说不存在的命令，重新开个窗口在执行brew --version  就能看到版本号了，我的是Homebrew 5.1.0 版本，接下来在执行上面的一键安装命令，会自动安装nodejs  npm都成功了，结果该安装openclaw@latest 的时候又报错了，我是问的豆包，豆包给了个命令直接安装成功了
  1. #手动安装 openclaw 最新版
  2. env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
复制代码
openclaw -v 查看安装的版本  这是截止到今天最新的版本  OpenClaw 2026.3.12 (6472949) 写的有点乱其中也没有贴图，因为我虽然成功了,过程只作为你的参考，要理解过程才有可能安装成功，按步骤照着作，很可能不成功。
配置

        教程上说使用openclaw init 来初始化，结果今天这个版本就用不了，提示error: unknown command 'init'，这变化的多快，我将直接基于官方发布的2026.3.12版本为你提供最准确的配置指引。下面水平线是coze给的我就直接放过来了
OpenClaw 2026.3.12官方标准配置流程
一、环境验证（官方要求）
  1. # 检查Node.js版本（必须≥22.0.0）
  2. node --version
  4. # 检查Git版本
  5. git --version
  7. # 验证安装完整性
  8. openclaw doctor
复制代码
二、官方初始化流程
  1. # 官方推荐初始化命令
  2. openclaw onboard --install-daemon
复制代码
交互式配置步骤：
三、官方推荐配置优化
  1. # 编辑官方配置文件
  2. nano ~/.openclaw/openclaw.json
复制代码
官方标准配置模板：
  1. {
  2.   "gateway": {
  3.     "bind": "loopback",
  4.     "port": 18789,
  5.     "auth": {
  6.       "mode": "password"
  7.     }
  8.   },
  9.   "agent": {
  10.     "model": "anthropic/claude-opus-4-6",
  11.     "thinkingLevel": "high"
  12.   },
  13.   "dmPolicy": "pairing",
  14.   "agents": {
  15.     "defaults": {
  16.       "sandbox": {
  17.         "mode": "non-main",
  18.         "allowlist": ["bash", "read", "write", "edit"],
  19.         "denylist": ["浏览器", "cron", "system.run:elevated"]
  20.       }
  21.     }
  22.   }
  23. }
复制代码
四、官方启动与验证
  1. # 启动服务
  2. openclaw gateway start
  4. # 验证服务状态
  5. openclaw gateway status
  7. # 功能测试
  8. openclaw message send --target main --message "Hello from OpenClaw"
复制代码
五、官方故障排查工具
  1. # 诊断环境问题
  2. openclaw doctor
  4. # 查看日志
  5. openclaw logs --tail 50
  7. # 修复配置问题
  8. openclaw doctor --fix
复制代码
六、官方推荐的M系列芯片优化
  1. # 启用MPS加速
  2. export PYTORCH_ENABLE_MPS_FALLBACK=1
  4. # 配置硬件加速
  5. openclaw config set hardware.device mps
复制代码
按上面的配置，结果还是出错，重置后，在重新来过
  1. # 官方标准重置命令
  2. openclaw onboard --reset
  4. # 强制重置所有配置（彻底清理）
  5. openclaw onboard --reset --force
复制代码
访问

http://127.0.0.1:18789/#token=1f551a939210217ba5ef9847e83a884bd1e6675b
只能本机MAC上访问 ，其它电脑不能访问
  1. # 查看当前绑定地址
  2. openclaw config get gateway.bind
复制代码
(, 下载次数: 0)


当前配置是loopback，这确实只允许本地访问。
  1. # 修改为允许所有地址访问
  2. openclaw config set gateway.bind lan
  3. # 重启服务生效
  4. openclaw gateway restart
复制代码
(, 下载次数: 0)


结果其它机器还是不能访问
  1. # 允许所有来源访问Control UI（数组格式）
  2. openclaw config set gateway.controlUi.allowedOrigins '["*"]'
  3. # 重启服务生效
  4. openclaw gateway restart
复制代码
(, 下载次数: 0)


结果还是不能访问 ，要求用HTTPS，好多命令都不支持了，因为是最新的版本
openclaw config get gateway #这个是查看目前的配置
(, 下载次数: 0)

  1. # 生成自签名证书(根据提示随便填写信息就可以了)
  2. openssl req -x509 -newkey rsa:4096 -keyout ~/.openclaw/key.pem -out ~/.openclaw/cert.pem -days 365 -nodes
  3. # 配置使用证书
  4. openclaw config set gateway.tls.enabled true
  5. openclaw config set gateway.tls.certPath ~/.openclaw/cert.pem
  6. openclaw config set gateway.tls.keyPath ~/.openclaw/key.pem
  7. # 重启服务生效
  8. openclaw gateway restart
复制代码
配置了ssl证书才最可以访问 ，真不容易，主要是版本更新太快，找到的命令都是不能用的

原文地址：https://blog.csdn.net/w13511069150/article/details/159044269



欢迎光临 AI创想 (http://llms-ai.com/) Powered by Discuz! X3.4