OpenClaw 工程化配置手册
约 1 分钟
来源:飞书 Wiki - MarkWave Lab 出品
核心内容
1. 基础设置(5个必做)
| 序号 | 内容 | 小红书 | 公众号 |
|---|---|---|---|
| 1 | 5个必须做的基础设置,少踩坑 | ✅ | ✅ |
| 2 | 0基础保姆级教程,3步搞定部署 | ✅ | - |
| 3 | 5个必做设置教程 | ✅ | - |
| 4 | 5个联动神器 | - | - |
2. 复活甲配置(Systemd/LaunchAgent)
作用:
- 挂了自动重启
- 开机自启动
- 强制走代理
配置步骤:
# 1. 检测路径
NODE_PATH=$(which node)
CLAWD_PATH=$(which clawdbot)
# 2. 生成 plist 配置
cat > ~/Library/LaunchAgents/com.clawdbot.gateway.plist << 'EOF'
<?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.clawdbot.gateway</string>
<key>ProgramArguments</key>
<array>
<string>$NODE_PATH</string>
<string>$CLAWD_PATH</string>
<string>gateway</string>
<string>run</string>
</array>
<key>EnvironmentVariables</key>
<dict>
<key>HTTP_PROXY</key>
<string>http://127.0.0.1:7890</string>
<key>HTTPS_PROXY</key>
<string>http://127.0.0.1:7890</string>
</dict>
<key>KeepAlive</key>
<true/>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>
EOF
# 3. 加载服务
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.clawdbot.gateway.plist3. 懒人管理脚本
# 创建控制脚本
nano ~/clawd_control.sh
# 内容:
#!/bin/bash
case "$1" in
start) launchctl load -w ~/Library/LaunchAgents/com.clawdbot.gateway.plist ;;
stop) launchctl unload -w ~/Library/LaunchAgents/com.clawdbot.gateway.plist ;;
restart) launchctl kickstart -k gui/$(id -u)/com.clawdbot.gateway ;;
status) launchctl list | grep clawdbot ;;
log) tail -f ~/.clawdbot/gateway.log ;;
esac
chmod +x ~/clawd_control.sh4. Git 版本控制
每次改配置前存档:
cd ~/.clawdbot
git add .
git commit -m "Backup before changing xxx"改崩了回滚:
cd ~/.clawdbot
git checkout .5. 网络代理
解决 Gemini/OpenAI 访问超时问题:
# 在 plist 中配置
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890总结
✅达成成就:
- System-Level: 注销或重启电脑依然运行
- Auto-Healing: 崩溃后1秒自动重启
- Proxy-Forced: 彻底解决超时问题
本文档持续更新中,最新变动请关注公众号 MarkWave