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

优质文章学习记录

— 7 min read

在国内环境部署 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 版本：

# 使用 fnmcurl-fsSL https://fnm.vercel.app/install |bashsource ~/.zshrc fnm install22 fnm use 22# 验证node--version# 应显示 v22.x.x
国内加速：如果 Node.js 下载慢，可以设置镜像：

二、安装 OpenClaw

2.1 方式一：npm 安装（推荐）

npminstall-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 cd openclaw # 国内加速 clone# git clone https://ghproxy.cn/https://github.com/openclaw/openclaw.gitpnpminstallpnpm build pnpm openclaw onboard --install-daemon

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 --port18789--verbose# 打开控制台 openclaw dashboard

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

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

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

4.1 npm 依赖安装

# 临时使用镜像npminstall-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.comgit clone https://ghproxy.cn/https://github.com/openclaw/openclaw.git

4.3 AI 模型 API 访问

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

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

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

# 配置示例 - 使用 DeepSeekmodels: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.ymlversion:'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 镜像加速sudomkdir-p /etc/docker sudotee /etc/docker/daemon.json <<EOF { "registry-mirrors": [ "https://docker.1ms.run", "https://docker.xuanyuan.me" ] } EOFsudo 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 超时怎么办？

# 使用镜像源npminstall-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

访问 ClawHub 发现更多技能。

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

参考资料：

  • OpenClaw GitHub: https://github.com/openclaw/openclaw
  • OpenClaw 文档: https://docs.openclaw.ai
  • OpenClaw Discord: https://discord.gg/clawd
  • ClawHub 技能市场: https://clawhub.com

本文基于 OpenClaw 最新版本编写，具体配置可能随版本更新而变化。建议部署前查阅官方文档获取最新信息。

Read more

2025 WAIC探展合合信息展台：AI鉴伪技术洞察“看不见”的伪造痕迹

2025 WAIC探展合合信息展台：AI鉴伪技术洞察“看不见”的伪造痕迹

2025 WAIC探展合合信息展台：AI鉴伪技术洞察“看不见”的伪造痕迹 七月迎来了一年一度的WAIC世界人工智能大会，猫头虎有幸受邀参会，首次踏上魔都上海，亲身感受到前沿AI科技带来的震撼。在展会现场，各类炫酷的AI应用令人目不暇接，其中合合信息的展位格外亮眼。他们展示的“AI鉴伪”黑科技，为观众奉上了一场视觉安全领域的精彩科技秀。 背景：从传统PS到AI伪造的新时代 过去两年，随着AI大模型技术的爆发式发展，图像和视频的生成及篡改技术变得愈发简单和隐秘，传统的图像处理软件如PS已难以满足新时代的安全鉴伪需求。合合信息早在2022年便领先行业推出了PS篡改检测技术，并迅速更新迭代，跨越了从单一静态图像到复杂多模态数据的鉴伪技术瓶颈。 本次展会探访分为上午的展位参观和下午的技术交流会两个部分，猫头虎带大家一起来深入体验。 文章目录 * 2025 WAIC探展合合信息展台：AI鉴伪技术洞察“看不见”的伪造痕迹 * 背景：从传统PS到AI伪造的新时代 * 展位体验篇 * 人脸视频篡改检测：毫秒级识破逼真的“数字假面” * AIGC图像鉴别
PentAGI-（AI自动化渗透）Docker环境部署

PentAGI-（AI自动化渗透）Docker环境部署

一、 深度解构：什么是 PentAGI？ PentAGI 是由 VXControl 团队开发的一款革命性开源安全项目。它代表了 AI 与网络安全 深度融合的最高水准，旨在打造一个能够自主执行任务的“数字黑客助手”。 1. 为什么它如此强大？ 不同于传统的扫描器（如 Nessus 或 OpenVAS），PentAGI 的核心是一个基于 LLM（大语言模型） 的决策引擎。它不仅能发现漏洞，更重要的是它能“理解”漏洞。 * • 自主推理：它能像人类渗透测试专家一样，根据上一步的扫描结果（如端口开放情况）动态推导下一步的攻击路径。 * • 工具编排：它能自主驱动并联动数百个安全工具（如 Nmap、Sqlmap、Nuclei、Metasploit 等），实现真正的自动化闭环。 * • 长效记忆：集成 pgvector 向量数据库，让 AI
用 AI 设计力打造专业 UI_UX：在 Trea、Qoder 等 AI IDE 中集成 ui-ux-pro-max-skill

用 AI 设计力打造专业 UI_UX：在 Trea、Qoder 等 AI IDE 中集成 ui-ux-pro-max-skill

在 AI 编程工具爆发的 2025–2026 年，开发者不再满足于“能跑就行”的界面——我们渴望一键生成媲美 Figma 原型的专业 UI。GitHub 上的开源项目 ui-ux-pro-max-skill 正是为此而生：它将 57 种设计风格、95 套行业配色、56 组字体搭配和 98 条 UX 准则打包成一个结构化知识库，让任何支持上下文引用的 AI 编码助手都能输出高质量前端代码。 本文将手把手教你如何在 Trea 和 Qoder 这类国产主流 AI IDE 中高效使用该项目——即使它们尚未被官方原生支持。 🌟 项目核心能力 ui-ux-pro-max-skill 不是一个普通插件，而是一个AI 可读的设计系统数据库，包含： * 57 种 UI 风格：
多台Macmini利用EXO搭建分布式AI集群提高deepseek -r1:14b推理能力方案分享（实测可用）

多台Macmini利用EXO搭建分布式AI集群提高deepseek -r1:14b推理能力方案分享（实测可用）

为什么用MacMini而不是Nvidia系列的卡？ 统一内存：CPU和GPU的“共享充电宝” 传统显卡（比如NVIDIA RTX 4090）的显存最高只有24GB，而一台顶配Mac Mini能塞下64GB的统一内存——CPU和GPU共用同一块内存池，不用来回搬运数据。这就好比把厨房和餐厅打通，厨师（GPU）和传菜员（CPU）再也不用跑来跑去，上菜速度直接翻倍！ MLX框架 苹果在2023年推出了专为自家芯片优化的机器学习框架MLX，号称能榨干M系列芯片的每一滴性能。实测中，MLX跑Llama 3模型的生成速度比PyTorch快30%，甚至让Mac Mini单挑高端显卡也不虚！ 功耗超级低：五台机器才用28瓦？ 油管一博主实测发现，五台Mac Mini待机时总功耗仅28瓦，全速运行也才200瓦出头。对比之下，一块RTX 4090显卡满载就要450瓦——这电费差距，长期运行成本得高多少！！！ EXO基本原理 关键组件 1. 分片管理：EXO 将 AI 模型划分为可管理的块。 2. 智能分区：系统根据每个设备的能力找出分配任务的最佳方式。