跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

国内环境部署 OpenClaw 个人 AI 助手搭建指南

在国内环境部署 OpenClaw：从零到跑通的个人 AI 助手搭建指南 > OpenClaw 是一个开源的个人 AI 助手框架，可以连接 WhatsApp、Telegram、Slack、Discord、飞书等 20+ 消息渠道。记录了在国内网络环境下部署 OpenClaw 的完整流程，包括网络适配、模型配置、渠道接入等实战经验。 什么是 OpenClaw？ OpenClaw 是一个 local…

BackendPro发布于 2026/4/6更新于 2026/7/2224K 浏览

在国内环境部署 OpenClaw：从零到跑通的个人 AI 助手搭建指南

OpenClaw 是一个开源的个人 AI 助手框架，可以连接 WhatsApp、Telegram、Slack、Discord、飞书等 20+ 消息渠道。本文记录了在国内网络环境下部署 OpenClaw 的完整流程，包括网络适配、模型配置、渠道接入等实战经验。

什么是 OpenClaw？

OpenClaw 是一个 local-first 的个人 AI 助手平台。它的核心是一个 Gateway 服务，运行在你自己的设备上，通过 WebSocket 管理会话、消息路由和工具调用。

核心特性：

  • 🏠 本地运行，数据不经过第三方
  • 📱 支持 20+ 消息渠道（飞书、Telegram、Discord、Slack、微信等）
  • 🔧 内置工具系统（浏览器、文件、Shell、定时任务等）
  • 🧠 可扩展的 Skill 系统
  • 🦞 开源（MIT 协议）

GitHub: https://github.com/openclaw/openclaw

一、环境准备

1.1 系统要求
项目要求
操作系统macOS / Linux / Windows（WSL2）
Node.js≥ 22
磁盘空间≥ 2GB
网络需要访问 npm registry 和 GitHub
1.2 安装 Node.js 22

推荐使用 nvm 或 fnm 管理 Node.js 版本：

# 使用 fnm
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.zshrc
fnm install 22
fnm use 22

# 验证
node --version
# 应显示 v22.x.x

国内加速：如果 Node.js 下载慢，可以设置镜像。

二、安装 OpenClaw

2.1 方式一：npm 安装（推荐）
npm install -g openclaw@latest

国内加速：设置 npm 镜像源： 安装完成后恢复。

2.2 方式二：安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

如果 openclaw.ai 无法访问，可以用 npm 方式安装。

2.3 方式三：从源码安装
git clone https://github.com/openclaw/openclaw.git
 openclaw


pnpm install
pnpm build
pnpm openclaw onboard --install-daemon
cd
# 国内加速 clone
# git clone https://ghproxy.cn/https://github.com/openclaw/openclaw.git
2.4 方式四：macOS App（AutoClaw）

如果你使用 macOS，可以直接下载 AutoClaw 应用，这是 OpenClaw 的桌面客户端封装，开箱即用。

三、初始配置（Onboarding）

3.1 运行配置向导
openclaw onboard --install-daemon

向导会引导你完成：

  1. 认证配置 — 选择 AI 模型提供商和 API Key
  2. Gateway 设置 — 端口、绑定地址等
  3. 消息渠道 — 可选配置 Telegram、飞书等
  4. 守护进程 — 安装系统服务保持后台运行
3.2 启动 Gateway
# 检查状态
openclaw gateway status
# 前台运行（调试用）
openclaw gateway --port 18789 --verbose
# 打开控制台
openclaw dashboard

访问 http://127.0.0.1:18789/ 即可打开 Web 控制台。

四、国内网络适配（重点）

这是国内部署最关键的部分。OpenClaw 本身不需要科学上网，但部分依赖需要处理。

4.1 npm 依赖安装
# 临时使用镜像
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
4.2 GitHub 访问

如果需要从源码构建或更新：

# 方案 1：使用代理
git config --global http.proxy http://127.0.0.1:7890
# 方案 2：使用 GitHub 镜像
# ghproxy.cn 或 gitclone.com
git clone https://ghproxy.cn/https://github.com/openclaw/openclaw.git
4.3 AI 模型 API 访问

OpenClaw 支持多种模型提供商。在国内环境下，推荐以下方案：

方案 A：使用国内模型（推荐）

OpenClaw 支持 OpenAI 兼容的 API 格式，大部分国内厂商都支持：

# 配置示例 - 使用 DeepSeek
models:
  default: deepseek
providers:
  deepseek:
    type: openai-compatible
    baseURL: https://api.deepseek.com/v1
    apiKey: sk-your-deepseek-key
    model: deepseek-chat

支持的国内模型提供商：

  • DeepSeek — 性价比极高，推荐
  • 通义千问（阿里云） — 企业级稳定
  • 智谱 AI（GLM） — 国产大模型代表
  • Moonshot（月之暗面） — 长上下文优势
  • 百川智能 — 多模态能力
方案 B：使用 OpenAI 官方 API（需代理）

如果你有 OpenAI API Key：

models:
  default: openai
providers:
  openai:
    type: openai
    apiKey: sk-your-openai-key
    # 通过代理访问
    baseURL: https://your-proxy.example.com/v1
方案 C：使用 Azure OpenAI

微软 Azure 在国内有合规节点：

models:
  default: azure
providers:
  azure:
    type: azure-openai
    endpoint: https://your-resource.openai.azure.com/
    apiKey: your-azure-key
    deployment: gpt-4o
4.4 消息渠道的网络适配

不同消息渠道在国内的可达性不同：

渠道国内可用性备注
飞书✅ 原生支持国内首选，延迟低
Telegram⚠️ 需代理需要科学上网
Discord⚠️ 需代理需要科学上网
Slack⚠️ 需代理需要科学上网
WebChat✅ 本地访问无网络限制
微信⚠️ 非官方通过第三方桥接
钉钉⚠️ 需适配可通过 webhook

国内推荐组合：飞书 + WebChat

五、飞书渠道配置（实战）

飞书是国内使用 OpenClaw 的最佳消息渠道。

5.1 创建飞书应用
  1. 访问 飞书开放平台
  2. 点击「创建企业自建应用」
  3. 记录 App ID 和 App Secret
  4. 在「事件订阅」中配置请求地址：https://your-server/feishu/webhook
  5. 在「权限管理」中开通必要权限
5.2 配置 OpenClaw

在 OpenClaw 配置文件中添加飞书渠道：

channels:
  feishu:
    appId: your-app-id
    appSecret: your-app-secret
    verificationToken: your-verification-token
    encryptKey: your-encrypt-key # 可选
5.3 本地开发调试

使用内网穿透工具暴露本地端口：

# 方案 1：ngrok（海外）
ngrok http 18789
# 方案 2：cpolar（国内友好）
cpolar http 18789
# 方案 3：frp（自建）
# 配置 frp 客户端将本地 18789 端口暴露到公网

将生成的公网 URL 填入飞书事件订阅的请求地址。

六、Docker 部署（服务器场景）

如果你想在云服务器上部署 OpenClaw：

6.1 快速部署
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh
6.2 Docker Compose 配置
# docker-compose.yml
version: '3.8'
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    ports:
      - "18789:18789"
    environment:
      - OPENCLAW_HOME=/home/node
    volumes:
      - openclaw-data:/home/node
    restart: unless-stopped
volumes:
  openclaw-data:
6.3 国内拉取镜像加速
# 配置 Docker 镜像加速
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xuanyuan.me"
  ]
}
EOF
sudo systemctl restart docker

七、常用命令速查

# 服务管理
openclaw gateway status # 查看状态
openclaw gateway start  # 启动
openclaw gateway stop   # 停止
openclaw gateway restart # 重启

# 调试
openclaw doctor         # 诊断问题
openclaw dashboard      # 打开控制台

# 消息
openclaw message send --to user --message "你好"

# 更新
openclaw update         # 更新到最新版

# 技能管理
openclaw skill list     # 列出已安装技能
openclaw skill install xxx # 安装技能

八、常见问题

Q1: npm install 超时怎么办？
# 使用镜像源
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
# 或设置全局镜像
npm config set registry https://registry.npmmirror.com
Q2: Gateway 启动失败？
# 检查端口占用
lsof -i :18789
# 查看日志
openclaw gateway --verbose
# 运行诊断
openclaw doctor
Q3: 模型 API 连接失败？
  • 检查 API Key 是否正确
  • 确认 API 地址在国内可达
  • 检查代理配置（如使用 OpenAI）
  • 查看网络连通性：curl -v https://api.deepseek.com/v1/models
Q4: 飞书消息收不到？
  • 确认飞书应用的事件订阅 URL 配置正确
  • 检查内网穿透是否正常
  • 查看飞书开放平台的「事件推送」日志
  • 确认应用权限已审批通过
Q5: 如何切换模型？
# 命令行临时切换
openclaw agent --message "测试" --model deepseek-chat
# 持久化修改在配置文件中修改 default model

九、进阶配置

9.1 技能系统

OpenClaw 的 Skill 系统允许你扩展助手能力：

# 浏览可用技能
openclaw skill list
# 安装技能
openclaw skill install feishu-doc
openclaw skill install autoglm-websearch
9.2 定时任务
# 创建定时任务（比如每天早上 9 点发送天气）
openclaw cron create --schedule "0 9 * * *" --message "今天天气怎么样？"
9.3 多 Agent 路由

可以为不同的渠道配置不同的 Agent：

channels:
  feishu:
    agentId: work-agent
  telegram:
    agentId: personal-agent

十、总结

在国内环境部署 OpenClaw 的关键要点：

  1. Node.js 和 npm 镜像加速是第一步
  2. 选择国内可达的模型 API（DeepSeek、通义千问等）
  3. 飞书是最好的国内消息渠道
  4. 内网穿透工具用于本地开发的 webhook 调试
  5. Docker 部署适合云服务器场景

OpenClaw 的 local-first 设计理念让数据完全留在本地，这对注重隐私的用户来说是一个很大的优势。搭配国内模型服务，整个方案可以在完全合规的环境下运行。

目录

  1. 在国内环境部署 OpenClaw：从零到跑通的个人 AI 助手搭建指南
  2. 什么是 OpenClaw？
  3. 一、环境准备
  4. 1.1 系统要求
  5. 1.2 安装 Node.js 22
  6. 使用 fnm
  7. 验证
  8. 应显示 v22.x.x
  9. 二、安装 OpenClaw
  10. 2.1 方式一：npm 安装（推荐）
  11. 2.2 方式二：安装脚本
  12. 2.3 方式三：从源码安装
  13. 国内加速 clone
  14. git clone https://ghproxy.cn/https://github.com/openclaw/openclaw.git
  15. 2.4 方式四：macOS App（AutoClaw）
  16. 三、初始配置（Onboarding）
  17. 3.1 运行配置向导
  18. 3.2 启动 Gateway
  19. 检查状态
  20. 前台运行（调试用）
  21. 打开控制台
  22. 四、国内网络适配（重点）
  23. 4.1 npm 依赖安装
  24. 临时使用镜像
  25. 4.2 GitHub 访问
  26. 方案 1：使用代理
  27. 方案 2：使用 GitHub 镜像
  28. ghproxy.cn 或 gitclone.com
  29. 4.3 AI 模型 API 访问
  30. 方案 A：使用国内模型（推荐）
  31. 配置示例 - 使用 DeepSeek
  32. 方案 B：使用 OpenAI 官方 API（需代理）
  33. 方案 C：使用 Azure OpenAI
  34. 4.4 消息渠道的网络适配
  35. 五、飞书渠道配置（实战）
  36. 5.1 创建飞书应用
  37. 5.2 配置 OpenClaw
  38. 5.3 本地开发调试
  39. 方案 1：ngrok（海外）
  40. 方案 2：cpolar（国内友好）
  41. 方案 3：frp（自建）
  42. 配置 frp 客户端将本地 18789 端口暴露到公网
  43. 六、Docker 部署（服务器场景）
  44. 6.1 快速部署
  45. 6.2 Docker Compose 配置
  46. docker-compose.yml
  47. 6.3 国内拉取镜像加速
  48. 配置 Docker 镜像加速
  49. 七、常用命令速查
  50. 服务管理
  51. 调试
  52. 消息
  53. 更新
  54. 技能管理
  55. 八、常见问题
  56. Q1: npm install 超时怎么办？
  57. 使用镜像源
  58. 或设置全局镜像
  59. Q2: Gateway 启动失败？
  60. 检查端口占用
  61. 查看日志
  62. 运行诊断
  63. Q3: 模型 API 连接失败？
  64. Q4: 飞书消息收不到？
  65. Q5: 如何切换模型？
  66. 命令行临时切换
  67. 持久化修改在配置文件中修改 default model
  68. 九、进阶配置
  69. 9.1 技能系统
  70. 浏览可用技能
  71. 安装技能
  72. 9.2 定时任务
  73. 创建定时任务（比如每天早上 9 点发送天气）
  74. 9.3 多 Agent 路由
  75. 十、总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒，将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • 微软Copilot+企业版：为什么AI智能体才是企业数字化的终极答案
  • 平台、记忆、评测——AI 竞赛正在换挡
  • FPGA 开发板 6 层 PCB 设计与绘制流程
  • PyCharm 详细安装与配置指南
  • Python 调用 ChatGPT、通义千问与讯飞星火文本总结实测对比
  • 模拟算法实战：替换问号、提莫攻击、Z 字形变换等五题详解
  • 轻量级推荐引擎：Redis ZUNIONSTORE 实现加权排序
  • 无人机“黑飞”正式入法：2026 年 1 月 1 日起违规飞行将面临拘留
  • Wave Terminal 跨平台终端工具安装与使用指南
  • Qwen2.5-72B-GPTQ-Int4 实战：vLLM 推理与 Chainlit 可视化集成
  • 微信视频号视频加密逆向：WebAssembly 解密记录
  • NTC 热敏电阻温度测量算法与 STM32 实现
  • Web 开发常见 HTTP 错误码解决方案：502/503/504/400/401/403
  • 基于 Dify 与 LangBot 搭建飞书智能体对话机器人
  • Java AES 加密算法实现与模式详解
  • VSCode 配置 OpenAI 兼容模型接入 GitHub Copilot Chat
  • ComfyUI-Easy-Use完整指南：快速提升AI绘画效率的终极解决方案
  • C++ 继承：面向对象代码复用的核心机制
  • 智能家居插件管理工具技术指南：突破网络限制的本地化优化方案
  • 7 天用 Electron 开发跨平台桌面应用实战指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online