当前位置:首页>Linux>��Linux 本地部署 OpenClaw(适配 Claude API OpenClaw模型)最稳教程

��Linux 本地部署 OpenClaw(适配 Claude API OpenClaw模型)最稳教程

  • 2026-08-22 05:59:13
��Linux 本地部署 OpenClaw(适配 Claude API OpenClaw模型)最稳教程

📜 准备工作

在开始之前,请确保你具备以下条件:

  1. 一台运行Linux的电脑:主流发行版如 Ubuntu (20.04+), Debian, CentOS 等均可。

  2. 稳定的网络连接:因为需要与Anthropic的API服务进行通信。

  3. 一个Anthropic API密钥:

    • 访问 Anthropic 开发者控制台 并登录/注册。

    • 在 API Keys 菜单中,点击 Create Key,生成一串以 sk-ant- 开头的密钥。请务必妥善保管好这个密钥。

    • 确保你的账户有足够的余额或有效的订阅计划,否则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
安装成功后,你会看到OpenClaw的版本号。

🧠 第三步:配置 Claude API 作为“大脑”

这是最关键的一步,需要将你的Anthropic API密钥告诉OpenClaw。OpenClaw提供了一个交互式的配置向导onboard,可以帮你轻松完成。

# 启动配置向导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技能帮我总结一下今天的新闻头条。”

🔧 故障排查小贴士

  • OpenClaw 命令找不到? 尝试重新打开终端,或者检查Node.js的bin目录是否在系统的PATH环境变量中。

  • 连接Claude失败? 首先确认你的API密钥是否正确,以及Anthropic账户是否有足够余额。

  • 可以尝试重启OpenClaw服务:openclaw gateway restart。

  • 服务启动但浏览器无法访问? 检查一下 http://localhost:18789 这个地址和端口是否正确。也可以查看OpenClaw的实时日志来定位问题:openclaw logs follow。

恭喜!你现在已经在Linux上搭建了一个由Claude驱动的、强大的本地AI智能体。你可以开始探索更多技能,甚至根据官方技能开发规范来开发你自己的专属技能了。

最新文章

随机文章