
项目名称又变了:从 Clawdbot 到 Mlotbot,再到如今的 OpenClaw。这次的名字听起来更具产品化意味,相应的服务和命令行工具也都更新了。
如今,这个项目在 GitHub 上收获了近 13 万颗星(撰写本文时已达127K),并且同时登上了 GitHub Trending 的日榜、周榜、月榜第一名。

即使热潮已持续一周,我每天依然能看到各式各样的 OpenClaw(原 Clawdbot)部署教程,搭配着各种服务器和应用方案。
在浏览了众多方案后,我发现 GitHub Codespaces 是性价比最高的选择。可以说,你几乎不用花费一分钱,就能体验到 OpenClaw 的乐趣。
你只需要一个 GitHub 账号即可,注册起来也非常简单。GitHub Codespaces 是 GitHub 提供的云端开发环境,每个账号都可用,配置还不低。以往我们选择轻量云服务器或 VPS 时,常常选配 2核2G 内存,而 Codespaces 直接提供了 2核8G 内存、32G 硬盘的云端环境。

接下来,我将一步步带你通过 GitHub Codespaces 搭建一个完全零成本的 OpenClaw 服务。本次部署将使用最新的国产模型 Kimi K2.5,并选择 Discord 作为即时聊天应用。
创建 GitHub Codespaces
新建项目仓库
首先,我们需要在 GitHub 上新建一个项目仓库。打开 GitHub 主页,点击右上角的“+”号,选择“New repository”。

为仓库起一个名称,可以任意设定,我这里使用的是 openclaw-space。其他参数保持默认,直接点击“Create repository”。

创建 Codespace
仓库创建成功后,会跳转到仓库的空页面。我们直接点击页面左侧的 “Create a codespace”。

随后会跳转到创建 Codespace 的页面,点击 “Create new codespace”。

等待新页面加载完成,你会看到一个类似 VS Code 的 Web 界面。这说明 Codespace 云端主机已经成功启动了。

一键安装 OpenClaw
云端环境准备就绪,接下来就是安装主角 OpenClaw。将 Codespace 视作 VSCode IDE,打开下方的终端(Terminal),直接粘贴官方的一键安装命令。
curl -fsSL https://openclaw.ai/install.sh | bash
你会发现原有的 clawdbot 字符画已更新为 openclaw,并且这次安装过程非常迅速,大约只需两三分钟即可完成。

Kimi K2.5 模型API准备
为了验证效果,模型选择了近期较热门的 Kimi K2.5。虽然英伟达官方提供免费使用,但延迟较高。因此,我花费了一个“包子钱”购买了一个七天体验卡。你可以在 Kimi 官网的 kimi-code 页面找到。
kimi-code 地址:https://www.kimi.com/code

订阅后即可使用 K2.5 模型。接着,创建一个 API Key 并妥善保存。

模型准备就绪后,我们回到 Codespace 中,继续配置向导。
模型配置
继续安装向导,选择同意协议(Yes),模式选择快速开始(Quick Start)。模型提供方选择月之暗面(Moonshot AI),接着选择 Kimi Code(K2.5)的 API 验证方式,将刚刚创建的 API Key 复制粘贴进去。

Discord 配置
继续选择 Channel 应用,这里我们直接选择 Discord。根据提示,需要提供一个 Discord Bot Token 才能继续。

如果你没有 Discord 账号,需要先注册一个(discord.com)。
注册完成后,打开 Discord 开发者平台,点击 New Application,输入 Bot 名称,同意条款后点击创建。
Discord 开发者平台地址:https://discord.com/developers/applications


创建完成后会跳转到应用详情页,点击左侧的 Bot 标签。

向下滚动,点击 Reset Token 生成一个新的 Token。这个 Token 就是 OpenClaw 连接 Discord 所需的凭证。(务必妥善保存,泄露可能导致 Bot 被滥用)

接下来开启关键权限(必须操作,否则 OpenClaw 无法读取消息/发送回复)。下滑到 Privileged Gateway Intents 区域,开启 MESSAGE CONTENT INTENT(用于读取消息内容),SERVER MEMBERS INTENT 可选(用于服务器成员权限控制)。

再点击左侧 OAuth2 → OAuth2 URL Generator,在 Scopes 部分勾选:bot、applications.commands。

继续下滑到 Bot Permissions 部分,勾选以下权限:Send Messages、Read Message History、Embed Links、Use Slash Commands。

下滑到页面最底部,复制生成的 URL 链接。

将该链接在浏览器中打开,将 Bot 邀请到你的 Discord 服务器(需要你拥有该服务器的管理员权限)。

点击继续并授权,即可成功邀请 Bot(OpenClawBot)加入。

打开你自己的 Discord 服务器主对话框,你会发现刚刚添加的 OpenClawBot 已经显示在成员列表中,但目前是离线状态。

然后,回到 Codespace 的安装配置向导中,将之前复制的 Discord Bot Token 粘贴到输入区域。

至此,Discord 相关的配置已全部完成。
后续的配置只需按照向导提示一步步完成即可,例如技能依赖安装、钩子配置等。

在配置向导最后输出的信息中,请务必保存好包含 Token 的仪表盘访问链接,以备后续使用。

启动 OpenClaw
现在,我们可以在 GitHub 云端服务器(Codespaces)上启动 OpenClaw 服务了。
openclaw gateway --verbose

启动成功后,从日志中可以看到主模型使用的是 Kimi-Code,频道应用连接的是 Discord。
回到 Discord,你会发现之前离线的 Bot 现在已经变为在线状态。

接下来,需要与 Bot 进行配对。切记一定要与 OpenClawBot 发起私聊! 在私聊中发送消息后,Bot 会回复一个配对码(Pairing code)。

获取配对码后,我们回到 Codespace 的终端。首先按 Ctrl+C 停止 Gateway 服务,然后运行以下命令进行配对(将 <code> 替换为上图中获取的“Pairing code”):
openclaw pairing approve discord <code>
执行成功后,再次启动 OpenClaw Gateway 服务。
openclaw gateway --verbose

最后,回到 Discord 与 Bot 对话,如果能收到正常回复,则说明部署完全成功。

终端日志中也能实时看到对话的输出流。

常见问题答疑
Discord 连接成功后,我们可能还想访问 OpenClaw 的 Web 控制台。本地部署时我们通过 http://localhost:18789/?token=xxx 访问,那么在 GitHub Codespaces 中如何访问呢?
实际上非常简单。GitHub Codespaces 会自动识别运行的服务,并将内网端口映射到公网。入口就在“终端”标签旁边的 “端口” 标签页。
在端口列表中找到 18789 端口,将鼠标悬停在“转发地址”的公网 URL 上,点击旁边的“地球”图标即可在浏览器中打开。(如果你的列表中没有 18789 端口,可以点击“添加端口”手动添加)

打开后,你可能会遇到两类 1008 错误:一个是 缺Token,另一个是 缺配对。

我们先解决第一个“缺令牌”的错误。这是因为 Web 控制台默认开启了 Token 验证以保障安全。
还记得配置向导结束时让你保存的地址+Token吗?找到那个 Token,填入控制台的 Overview -> Gateway Token 字段,然后点击 Connect。

连接后,可能会出现新的 1008 错误:disconnected (1008): pairing required。

这是因为 OpenClaw 检测到新设备(你的浏览器)试图接入,出于安全考虑需要你手动批准。有两种解决方法:命令行方式或修改配置文件。
解决方式一:命令行方式
回到 GitHub Codespaces,新开一个终端窗口,输入以下命令查看待处理的设备请求:
openclaw devices list
你会看到一个 Pending (1) 的请求,记下其长长的 Request ID。

输入批准命令(将下面的 ID 替换为你查到的 Request ID):
openclaw devices approve 0a22644c-205d-4912-a127-cbd71a4c74b8
解决方式二:改配置文件
在终端中,使用 vim 或 code 命令打开待处理设备配置文件:
vim ~/.openclaw/devices/pending.json
找到 "silent": false 这一行,将其中的 false 修改为 true,然后保存文件。

最后,刷新 OpenClaw Web 控制台页面(或点击 Connect),一切都会恢复正常。错误信息消失,状态指示变绿,你甚至可以在控制台中看到之前通过 Discord 进行的对话记录。至此,Web 控制台也可以正式使用了。

完全体 OpenClaw 任务演示
一切就绪后,你就可以通过 Discord(支持网页、电脑客户端和手机APP)随时向你的 AI助手 下达任务了,例如写邮件、梳理工作日报、自动开发脚本等,实现 7x24 小时待命。它同样支持定时任务。
任务示例:最近有哪些 GitHub 开源项目很火?整理一个本周最火的开源项目清单给我。

等待片刻后,它会输出一份相当详细的结果,包括项目类型、名称、Star 数、开发语言和简介等。虽然在 Discord 中对 Markdown 格式支持不完美,但我们可以在 Web 控制台中查看,效果非常清晰。

既然身处 GitHub 环境,让它帮我们「开发代码并自动部署」再合适不过了。
任务示例:用Three.js帮我开发一个实时活动地球效果的站点。

Bot 生成代码后,可能会建议你在本地部署。我们当然不需要,直接让它帮我们部署到 GitHub Pages 上。


它提供了多种部署方案,包括 GitHub Pages、Netlify、Vercel 等主流平台。由于 GitHub Pages 的自动部署需要一定的仓库权限,我们可以创建一个低权限、短时效的 Personal Access Token,然后交给 OpenClaw 让它自动化执行部署脚本。


最终的部署效果如下,一个酷炫的实时活动地球可视化站点:

效果非常不错,既酷炫又美观。我们回到这个由 OpenClaw 自动创建的代码仓库页面,可以看到最新的部署状态。

不过,这个项目好像还缺点什么?是的,一个醒目的 README 文档。我们继续让 OpenClaw 帮我们自动生成并推送到仓库。

文档推送后,仓库页面焕然一新:

期间,README 中的图片链接曾显示异常,我让 OpenClaw 处理了一下,它甚至直接优化成了动态示意图,非常给力!

至此,你就真正掌握了一个 零成本 运行 OpenClaw 的完整方案。这无疑是当前性价比极高的玩法。
提示:GitHub Codespaces 是云端开发环境,长时间不操作会自动休眠以节省资源。
当然,如果你长时间不使用,也可以主动在 GitHub Codespaces 页面将当前环境停止。

写在最后
本次部署选用的 Kimi K2.5 模型,其能力毋庸置疑。通过实际任务测试,表现确实出色。虽然测试使用频率不低,但从 Kimi 的使用额度来看,7天的体验期可能都用不完。

OpenClaw 是 AI Agent 走向平民化、实用化的一个现实产物。通过它,你可以拥有一个完全受自己掌控、甚至可以进行自主修改的 AI 管家。未来的 AI 形态,必将是智能体(Agent)的天下。它们需要能感知环境、使用工具、并自动规划多步复杂任务。这种利用免费云资源部署强大 AI Agent 的思路,也为广大开发者探索 AI 应用提供了极大的便利和想象空间。你可以在 云栈社区 与更多开发者交流此类前沿技术的实践经验。
相关链接