1. Ubuntu系统初始化与OpenClaw安装准备
在开始安装OpenClaw之前,我们需要对Ubuntu 24系统进行一些基础配置。这些步骤看似简单,但往往决定了后续安装过程的顺利程度。作为一个长期使用Ubuntu进行AI开发的用户,我总结了一套最稳妥的初始化流程。
1.1 系统换源与基础配置
国内用户建议首先更换软件源,这将显著提升后续软件安装速度。我推荐使用清华源,它不仅稳定而且同步及时。编辑/etc/apt/sources.list文件时,建议先备份原文件:
bash复制sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
然后使用vim或nano编辑器进行修改。这里有个小技巧:使用lsb_release -cs命令可以自动获取当前系统的代号,避免手动输入错误。对于Ubuntu 24,代号是"noble"。
系统初始化时,我特别建议安装以下额外工具包,它们虽然不在必须列表里,但会极大方便后续开发:
bash复制sudo apt install -y jq tree htop net-tools zip unzip
这些工具在排查问题时会非常有用。比如htop可以监控系统资源,jq能处理JSON数据(OpenClaw的很多配置都是JSON格式)。
1.2 Node.js环境配置细节
Node.js是OpenClaw的核心依赖,安装时需要注意几个关键点:
- 版本必须≥22.x,低版本会导致兼容性问题
- 建议同时安装yarn作为备用包管理器
- 配置npm全局安装路径,避免权限问题
我推荐使用以下命令设置npm全局目录:
bash复制mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
然后把这个路径加入PATH环境变量。这样安装的全局包都会存放在用户目录下,不需要sudo权限,也更安全。
验证Node.js环境是否正常时,不要只看版本号,还应该实际运行一个简单脚本:
bash复制node -e "console.log(process.versions)"
这会输出更详细的版本信息,包括V8引擎版本等,确保所有组件都正常。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. OpenClaw核心安装与配置
OpenClaw的安装过程看似简单,但其中的每个选项都关系到后续使用体验。根据我的经验,90%的问题都源于初始配置不当。
2.1 安装过程关键选择
执行安装脚本时,网络稳定性至关重要。如果遇到下载中断,可以尝试:
bash复制curl -fsSL https://openclaw.ai/install.sh | bash -s -- --retry 3
--retry 3参数会让脚本在失败时自动重试3次。
模型选择方面,MiniMax确实是个不错的平衡选择,但要注意:
- M2.5模型适合大多数场景
- VL-01是多模态模型,需要更多计算资源
- 高速版响应快但精度略低
API Key的存储方式也值得考虑。虽然安装时可以直接粘贴,但从安全角度,我建议使用环境变量:
bash复制export MINIMAX_API_KEY='your_key_here'
这样Key不会保存在配置文件中,更安全。
2.2 飞书插件深度配置
官方文档提供的安装命令确实简单,但实际使用中可能会遇到几个常见问题:
- 权限不足:确保运行命令的用户有权限写入全局node_modules目录
- 扫码失败:检查系统时间是否准确,时差超过2分钟会导致认证失败
- 机器人无响应:在飞书开放平台检查"事件订阅"是否配置正确
安装完成后,建议立即测试基础功能:
bash复制openclaw feishu test
这个命令会发送测试消息到飞书,验证连接是否正常。
3. 浏览器自动化实战配置
Agent Browser技能是OpenClaw最强大的功能之一,但它的配置有几个隐藏技巧:
3.1 无头模式与可视化模式切换
默认安装后是无头模式(headless),要启用可视化界面,除了用自然语言指令,还可以直接修改配置:
json复制// ~/.openclaw/config.json
{
"agent-browser": {
"headless": false,
"windowSize": "1280x720"
}
}
重启OpenClaw后生效。可视化模式会实际打开Chromium窗口,适合调试复杂的网页操作。
3.2 常用浏览器操作指令
掌握这些核心指令能极大提升效率:
code复制# 打开网页
访问 https://example.com
# 提取元素
获取页面中所有h1标签的文本
# 表单操作
在id为sear
