GitHub Codespaces 部署 OpenClaw 个人智能体实战指南
OpenClaw（原名 Clawdbot/Moltbot）是一款运行在本地环境的高权限 AI 智能体。它的核心特性包括本地部署、多平台支持（飞书、WhatsApp、Telegram 等）、浏览器控制以及系统访问能力。通过持久化记忆和插件扩展，它可以成为你的邮件管理、日程安排或代码编写的得力助手。
环境准备与安装
使用 GitHub Codespaces 可以快速构建隔离的开发环境，无需在本地配置复杂的依赖。
- 创建仓库：进入 OpenClaw 官方仓库，点击 Fork 创建一个新仓库。
- 启动 Codespace：在仓库页面选择
Code->Codespaces->New codespace。 - 初始化环境：打开终端后，首先确认操作系统和 Node.js 版本。
# 查看版本信息
node -v
uname -a
- 执行安装脚本：使用官方提供的脚本进行一键安装。
curl -fsSL https://openclaw.bot/install.sh | bash
# 备用方案
pnpm add -g openclaw@latest
安装完成后，根据提示选择 Quick Start。如果在模型授权环节遇到 Qwen OAuth timed out 错误，建议直接选择 Skip 跳过，稍后手动配置。
常见问题处理
在安装过程中可能会遇到服务无法访问的情况，这通常与端口转发或配置有关。
- 端口转发：确保将
18789端口添加到 Codespaces 的端口转发列表中。 - 重启服务：如果网关未启动，尝试以下命令重置状态。
openclaw onboard --install-daemon
openclaw gateway --port 18789 --verbose
openclaw dashboard --no-open
若上述操作无效，建议清理缓存并重新运行 onboard 流程。
模型配置
接入国产大模型可以显著降低延迟并提升中文理解能力。以深度求索（DeepSeek）为例：
- 获取 API Key：前往 DeepSeek 官网申请密钥。
- 配置 Provider：在终端中设置模型参数。
openclaw config set 'models.providers.deepseek' --json '{
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "YOUR_DEEPSEEK_API_KEY",
"api": "openai-completions",
"models": [
{ "id": "deepseek-chat", "name": "DeepSeek Chat" },
{ "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
]
}'
- 设置默认模式：将模型模式设为
merge以支持多模型切换。
openclaw config models.mode merge
openclaw models deepseek/deepseek-chat
