OpenClaw登顶GitHub榜首 超详细低成本部署教程指南

ClawdBot 正式更名为 OpenClaw，完成了从 ClawdBot 到 Mlotbot 再到 OpenClaw 的品牌升级。新名称更具产品感，其配套服务与命令行工具也已全面更新。目前，该项目在 GitHub 上的 Star 数量已突破 12.7 万，正迅速逼近 13 万大关，并强势登顶 GitHub Trending 的日榜、周榜和月榜。尽管热度已持续一周有余，但每天仍有大量关于如何在各类服务器和应用中部署 OpenClaw（原 ClawdBot）的教程涌现。

在众多部署方案中，性价比最高的当属利用 GitHub Codespaces。这个方法几乎可以让你零成本体验 OpenClaw 的核心功能。

你仅需一个 GitHub 账号即可开始，注册过程非常简单。

GitHub Codespaces 是 GitHub 提供的云端集成开发环境，每个账户都享有免费配额，且配置相当可观。以往我们租用轻量云服务器或 VPS，通常选择 2 核 2G 内存的配置。而 Codespaces 免费提供了 2 核 8G 内存、32G 硬盘的云端服务器。接下来，我们将一步步指导你如何在 GitHub Codespaces 上，从零开始搭建一个完全免费的 OpenClaw AI 智能体服务。

本次演示，我们将选用近期备受关注的国产模型 Kimi K2.5 作为主模型，并集成 Discord 作为即时聊天应用。

创建 GitHub Codespaces 云端环境

第一步：新建 GitHub 项目仓库

首先，登录你的 GitHub 账户。在主页右上角点击“+”号，选择“New repository”创建新仓库。为仓库命名，例如“openclaw-space”，其他设置保持默认，点击“Create repository”完成创建。

第二步：启动 Codespace 实例

仓库创建成功后，页面会自动跳转。点击左侧导航栏的“Code”按钮，在下拉面板中找到“Codespaces”选项卡，点击“Create codespace on main”。系统将自动配置并启动一个云端开发环境。稍等片刻，浏览器会加载出一个类似 VS Code 的 Web 界面，这表明你的 Codespace 云端主机已成功启动并运行。

一键安装 OpenClaw（原 ClawdBot）

云端环境准备就绪后，即可开始安装 OpenClaw。

将 Codespaces 界面视为在线的 VSCode IDE，打开底部的终端（Terminal），直接粘贴官方提供的一键安装命令：

curl -fsSL https://openclaw.ai/install.sh | bash

安装过程会显示全新的 OpenClaw 字符 Logo。整个安装流程非常迅速，通常在两到三分钟内即可完成。

准备 Kimi K2.5 模型 API

为了获得最佳演示效果，我们选择近期热度很高的 Kimi K2.5 模型。获取该模型 API 有多种途径，例如英伟达官方提供的免费试用（可能存在延迟），或通过 Kimi 官方平台获取。

为了获得更稳定、低延迟的体验，建议通过 Kimi 官网的“kimi-code”页面购买短期体验卡。订阅 Kimi Code 服务后，即可使用 K2.5 模型。接着，在 Kimi 平台生成一个 API Key 并妥善保存。完成模型准备后，返回 Codespaces 终端，继续运行配置向导。

配置 AI 模型提供商

在终端启动的配置向导中，首先同意用户协议（输入 Yes），然后选择快速开始模式（Quick Start）。在模型提供商列表中选择“Moonshot AI”（月之暗面），接着选择对应“Kimi Code（K2.5）”的 API 选项，最后将之前保存的 Kimi API Key 粘贴到输入框中。

配置 Discord 聊天通道

继续配置 Channel 应用，我们选择 Discord。向导会提示需要 Discord Bot Token。如果你还没有 Discord 账号，请先前往 Discord 官网注册。

账号准备完毕后，访问 Discord 开发者门户，点击“New Application”创建一个新应用，输入 Bot 名称并创建。

应用创建成功后，进入“Bot”设置页面。向下滚动，点击“Reset Token”生成一个新的 Token，这就是 OpenClaw 连接 Discord 所需的密钥（请务必保密）。接着，开启关键权限：在“Privileged Gateway Intents”部分，确保开启“MESSAGE CONTENT INTENT”（用于读取消息）和“SERVER MEMBERS INTENT”（用于服务器成员管理，可选）。然后，切换到“OAuth2” -> “URL Generator”页面。在 Scopes 部分勾选“bot”和“applications.commands”；在 Bot Permissions 部分勾选以下权限：Send Messages、Read Message History、Embed Links、Use Slash Commands。最后，复制页面底部生成的邀请链接，在浏览器中打开并按照指引将 Bot 邀请到你的 Discord 服务器（需要服务器管理员权限）。授权成功后，Bot（默认名称为 OpenClawBot）将加入你的服务器，但此时显示为离线状态。现在，回到 OpenClaw 的配置向导中，将之前生成的 Discord Bot Token 粘贴到相应输入框。至此，Discord 通道配置完成。

剩余的配置步骤，请遵循向导提示逐一完成。请注意：配置向导最后会输出一个包含重要 Token 信息的链接地址，建议立即保存此信息，以备后续使用。

启动并验证 OpenClaw 服务

现在，我们可以在 GitHub Codespaces 云端服务器上启动 OpenClaw 网关服务了。在终端中输入启动命令：

openclaw gateway --verbose

启动成功后，从日志中可以看到主模型已成功连接 Kimi-Code，Channel 应用也已连接到 Discord。

切换回 Discord 界面，你会发现之前离线的 Bot 现已显示为在线。首先，你需要与 OpenClawBot 发起一次私聊对话。对话后，Bot 会提供一个配对码（Pairing code）。记下这个配对码，然后返回 Codespaces 终端。按 `Ctrl+C` 中断当前的 Gateway 服务。接着，运行以下配对命令（将 `` 替换为实际获得的配对码）：

openclaw pairing approve discord 

配对成功后，再次启动 OpenClaw Gateway 服务。最后，回到 Discord 与 Bot 进行对话测试，如果它能正常理解并回复你的消息，同时终端日志中有相应的交互记录，则表明部署已完全成功。

常见问题与解决方案

成功连接 Discord 后，我们可能还需要访问 OpenClaw 的 Web 控制台。在本地部署时，我们通过 `http://localhost:18789/?token=xxx` 访问。在 GitHub Codespaces 中如何访问呢？

方法很简单。GitHub Codespaces 具备自动端口转发功能。你只需关注终端标签页旁边的“Ports”标签页。

在端口列表中找到 18789 端口，将鼠标悬停在“Forwarded Address”下的公网地址上，点击出现的“地球”图标即可在浏览器中打开 Web 控制台（如果列表中没有，可以手动添加该端口）。打开后，你可能会遇到两类 1008 错误：一是缺少 Token（认证失败），二是需要设备配对（未授权）。首先解决第一个认证错误，这是因为 Web 控制台默认启用了 Token 验证。

请找到配置向导结束时记录的那个包含 Token 的地址信息，将 Token 填入 Web 控制台页面上的“Overview -> Gateway Token”输入框，点击“Connect”。连接后，可能会遇到新的 1008 报错：“disconnected (1008): pairing required”。这表明 OpenClaw 检测到新设备（你的浏览器）尝试接入，需要管理员批准。

解决此配对请求，通常有两种方法：命令行批准或修改配置文件。

解决方案一：通过命令行批准设备

在 GitHub Codespaces 中打开一个新的终端窗口，输入以下命令查看待批准的设备请求列表：

openclaw devices list

列表中会显示一个状态为“Pending (1)”的请求，记下其 Request ID。然后运行批准命令（请替换为你的实际 ID）：

openclaw devices approve 0a22644c-205d-4912-a127-cbd71a4c74b8

解决方案二：修改配置文件自动批准

同样在终端中，使用文本编辑器打开待批准设备配置文件：

vim ~/.openclaw/devices/pending.json

在文件中找到 `"silent": false` 这一行，将 `false` 修改为 `true`，然后保存并退出。最后，刷新 OpenClaw 的 Web 控制台页面。此时，错误信息应已消失，监控状态恢复正常，并且之前通过 Discord 进行的对话记录也能在控制台中查看。至此，你的 OpenClaw 智能体已完全配置就绪，可以开始使用了。

OpenClaw 智能体任务实战演示

全部配置完成后，你就可以通过 Discord（支持网页版、桌面客户端和手机 APP）随时向你的专属 AI 智能体下发任务了，例如撰写邮件、整理工作日报、自动开发脚本等，实现 7x24 小时智能待命。你还可以为其设置定时任务。

当你长时间不使用时，可以在 Codespaces 管理页面暂停或停止该实例，以节省云端资源配额。

总结与展望

本次部署选用的 Kimi K2.5 模型，其强大的推理与生成能力在实际任务测试中得到了充分验证，表现卓越。即使用于高频测试，其七天体验卡的额度也绰绰有余。OpenClaw 代表了 AI Agent（智能体）技术走向平民化与实用化的重要一步。通过它，任何人都可以拥有一个完全自主可控、可按需定制和修改的个性化 AI 助手。

人工智能的未来，必然是智能体（Agent）的天下。它们需要具备环境感知、工具调用以及自主规划并执行复杂多步骤任务的能力，而 OpenClaw 正是迈向这一未来的一个坚实台阶。