📜 准备工作
在开始之前,请确保你具备以下条件:
一台运行Linux的电脑:主流发行版如 Ubuntu (20.04+), Debian, CentOS 等均可。
稳定的网络连接:因为需要与Anthropic的API服务进行通信。
一个Anthropic API密钥:
⚙️ 第一步:安装核心依赖:Node.js
OpenClaw 需要 Node.js 22 或更高版本。打开你的终端,执行以下命令来安装:
# 1. 添加 NodeSource 官方源(以获取最新版 Node.js 22)curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -# 2. 安装 Node.jssudo apt install -y nodejs# 3. 验证安装node --version # 应该显示 v22.x.x 或更高npm --version # 应该显示 10.x.x 或更高
🚀 第二步:一键安装 OpenClaw
OpenClaw 提供了官方的Linux安装脚本,可以自动完成安装
# 使用 curl 执行官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash# 安装完成后,验证是否成功openclaw --version
🧠 第三步:配置 Claude API 作为“大脑”
这是最关键的一步,需要将你的Anthropic API密钥告诉OpenClaw。OpenClaw提供了一个交互式的配置向导onboard,可以帮你轻松完成。
1.风险提示:阅读后输入 Yes 并回车。
2.初始化模式:选择 QuickStart(快速开始)并回车。
3.选择模型提供商:这时你需要选择 Anthropic (for Claude Code)。
4.输入API密钥:系统会提示你输入API Key。将你在第一步准备好的、以 sk-ant- 开头的密钥粘贴进来并回车。
5.其他配置:后续关于配置聊天平台(如Telegram)和安装基础技能的提示,你可以根据个人情况选择。对于新手,可以先选择 Skip for now 跳过,专注于核心功能的测试。
配置完成后,这些信息会被保存在 ~/.openclaw/openclaw.json 文件中。
🛠️ 第四步:启动 OpenClaw 服务并验证
配置好“大脑”后,我们就可以启动OpenClaw这个“执行者”了。
1.启动网关服务:
# 启动 OpenClaw 服务openclaw gateway start
2.生成访问令牌:为了安全地访问OpenClaw的网页控制台,你需要一个访问令牌。# 生成一个新的令牌openclaw token generate
记下生成的令牌字符串,稍后登录时需要用到。
3.打开控制台验证:OpenClaw提供了一个本地的网页控制台。在浏览器中访问以下地址(将你的令牌替换为你刚才生成的令牌):http://localhost:18789/?token=你的令牌
如果一切顺利,你应该能看到OpenClaw的聊天界面。
4.发送一条消息测试:在聊天框里输入一条简单的指令,例如:“你好,请介绍一下你自己。” 如果OpenClaw调用了Claude并给出了回复,那么恭喜你,大功告成!
✨ 第五步(可选):安装常用技能,解锁真正实力
OpenClaw真正的强大之处在于它的“技能(Skills)”。技能可以让它执行具体操作,比如浏览网页、读写文件等。
# 安装网页浏览技能(可以让AI帮你查看网页内容)openclaw plugins install @openclaw/agent-browser# 安装文件系统技能(可以让AI读写你电脑上的文件,请谨慎使用)openclaw plugins install @openclaw/agent-fs
安装后,你就可以在对话中让Claude使用这些技能了,例如:“用agent-browser技能帮我总结一下今天的新闻头条。”
🔧 故障排查小贴士
恭喜!你现在已经在Linux上搭建了一个由Claude驱动的、强大的本地AI智能体。你可以开始探索更多技能,甚至根据官方技能开发规范来开发你自己的专属技能了。