mac 通过docker 本地安装openclaw 教程
OpenClaw 不仅仅是一个聊天机器人，而是一个功能强大的 AI 智能体执行框架。你可以把它想象成一个能自主思考、调用工具、并替你完成复杂任务的数字员工。
1.环境准备
1.1安装Docker Desktop for mac
官网 下载安装即可
docker 中设置加速地址
"registry-mirrors": [
"https://docker.m.daocloud.io",
"http://hub-mirror.c.163.com",
"https://mirror.baidubce.com",
"https://docker.mirrors.sjtug.sjtu.edu.cn"
]
1.2 拉取openclaw 镜像
这里会使用腾讯托管的镜像服务器 拉取最新版本
docker pull sgccr.ccs.tencentyun.com/openclaw/openclaw:latest
2.启动容器
docker run -d \\
–name openclaw \\
-p 18789:18789 \\
-v openclaw-data:/data \\
sgccr.ccs.tencentyun.com/openclaw/openclaw:latest \\
openclaw gateway run –bind lan –port 18789 –allow-unconfigured
参数解释：
- -d：后台运行容器。
- –name openclaw：给容器命名，方便后续操作。
- -p 18789:18789：将容器的 18789 端口映射到本机，用于访问 Web 控制台。
- -v openclaw-data:/data：创建一个 Docker 卷 openclaw-data，挂载到容器内的 /data 目录，用于持久化配置和状态。
- openclaw gateway run …：容器启动后执行的命令，以网关模式运行，监听所有网络接口（–bind lan），端口 18789，允许未完全配置的状态下启动（–allow-unconfigured）。
3.首次访问并获取token
在浏览器中访问 http://localhost:18789，你会看到 OpenClaw 的仪表板页面，但状态显示为“Disconnected”，并提示需要 Token
docker exec openclaw openclaw config get gateway.auth.token
3.1 获取token
使用默认token 会打印出一长串数字
例如 ed0904424aca*******0562a93847c142684339138a7），复制保存，后续需要用到。
在浏览器内输入上面的token，然后点击connect
此时可能会遇到两种错误：
- pairing required：表示设备需要配对，见下一节。
- control ui requires device identity：确保你使用的是 http://localhost:18789 而非 IP 地址，否则浏览器会因安全策略阻止连接。
3.2 解决配对问题
进入容器，确保docker 内openclaw 运行中
docker exec -it openclaw sh
然后输入
openclaw devices list
会出现一个等待配对请求，其中包含一个本地ip请求 类似下面
Pending (2)
┌──────────────────────────────────────┬───────────────────────────────────┬──────────┬──────────────┐
│ Request │ Device │ Role │ IP │
├──────────────────────────────────────┼───────────────────────────────────┼──────────┼──────────────┤
│ a66fb94c-***-***2c4c21241c72 │ d53730f4722d2f9867ff6f0bbb70d2f8… │ operator │ 192.168.65.1 │
使用
openclaw devices approve 请求id（上面的第一列）或设备id（上面的第二列）
后容器自动停止，需要手动启动
3.3 添加ai 模型提供商
desktop 内启动openclaw
然后终端中运行 下面命令进入openclaw
docker exec -it openclaw sh
openlaw 常用命令
openclaw # 启动 OpenClaw
openclaw onboard # 初始化向导
openclaw dashboard # 打开网页控制台
openclaw config # 查看/修改配置
openclaw skills # 管理技能
openclaw –help # 查看帮助
然后使用
openclaw onboard
配置选择模型即可，
成功后即可聊天玩耍起来了
参考
https://libin9ioak.blog.csdn.net/article/details/157876493
https://blog.csdn.net/weixin_41905135/article/details/158346643
https://github.com/MaoTouHU/OpenClawChinese/blob/main/docs/INSTALL_GUIDE.md
