AI 部署指南

Appearance

OpenClaw 国内安装与配置 ​

一句话 ​

OpenClaw 是一个开源的 AI Agent 框架（GitHub 315K+ Stars），支持 ChatGPT/Claude/DeepSeek 等多模型接入，可以自动执行代码、调用工具、浏览网页。

🤖 AI Agent 快速入口

以下内容为结构化 Markdown，AI Agent 可直接解析执行。

直接阅读本页即可。如果想获取 Markdown 原始内容（Agent 专用格式），访问：

https://doc.k4b.cn/agents/openclaw-install.md

或在请求头中加入 Accept: text/markdown。

快速部署（AI 版） ​

前置条件 ​

  • [ ] Node.js 18+ 已安装（node --version 确认）
  • [ ] Git 已安装（git --version 确认）
  • [ ] 终端可正常执行命令

安装步骤 ​

bash
# 1. 克隆仓库（使用国内镜像加速）
git clone https://ghproxy.com/https://github.com/openclaw/openclaw.git
cd openclaw

# 2. 安装依赖
npm install

# 3. 复制环境变量模板
cp .env.example .env

# 4. 配置 API Key
# 编辑 .env 文件，填入你的 API Key
# 如果使用国内中转 API，修改 API_BASE_URL

验证 ​

bash
# 启动服务
npm run dev
# 访问 http://localhost:3000 看到 OpenClaw 控制台 → 安装成功

详细教程（人类版） ​

OpenClaw 是什么？ ​

OpenClaw 是一个开源的 AI Agent 框架（GitHub 315K+ Stars），是目前开发者社区非常活跃的 AI Agent 项目之一。它帮开发者省去了"从零造轮子"的麻烦，可以直接在上面搭建自动化工作流。

核心能力：

  • 多模型接入（Claude、GPT、DeepSeek、文心等）
  • 工具调用框架（浏览器控制、代码执行、文件操作）
  • 可编程工作流引擎
  • 插件生态

第一步：安装 Node.js ​

国内推荐从华为云镜像站下载 Node.js，速度远快于官网。

bash
# 验证安装
node --version
# 预期输出：v18.x.x 或更高

第二步：克隆代码（带镜像） ​

直接 clone GitHub 在国内经常超时，这里用 ghproxy.com 代理加速：

bash
# 方式一（推荐）：通过 ghproxy 镜像
git clone https://ghproxy.com/https://github.com/openclaw/openclaw.git

# 方式二：如果 git 没装，也可以下载 ZIP
# wget https://ghproxy.com/https://github.com/openclaw/openclaw/archive/refs/heads/main.zip

第三步：安装依赖 ​

bash
cd openclaw
npm install

如果 npm install 卡住（常见于国内网络环境），建议先配置 npm 镜像：

bash
# 配置淘宝镜像源
npm config set registry https://registry.npmmirror.com

# 然后再 install
npm install

第四步：配置 API ​

bash
cp .env.example .env

编辑 .env 文件：

# 如果你直接用官方 API
OPENAI_API_KEY=sk-你的key

# 如果你用国内中转站（推荐）
OPENAI_API_KEY=sk-你的中转key
OPENAI_BASE_URL=https://你的中转站地址/v1

# DeepSeek 配置（国内直接可用）
DEEPSEEK_API_KEY=你的DeepSeek key

💡 关于中转 API：国内开发者常用中转站接入海外模型，推荐方案参考我们的 API Key 管理指南。

第五步：启动验证 ​

bash
npm run dev

浏览器打开 http://localhost:3000，看到 OpenClaw 控制台即安装成功。

常见问题 ​

Q：npm install 报错 node-gyp 编译失败 A：大多数场景不需要原生模块。尝试 npm install --ignore-scripts 跳过构建脚本。

Q：ghproxy 也访问不了 A：备选镜像源没有一个完全稳定，可以换 gitclone.com 或 hub.fastgit.xyz 试。如果都不可用，参考我们的 GitHub 镜像获取指南 有更多备选方案。

相关教程 ​