常见问题 (FAQ) #

A: 源码部署不仅是最透明的方式，也是目前 AI Agent 领域的最佳实践。

虽然“一键安装包”看起来方便，但在 AI Agent（智能体）开发和使用场景下，源码安装具有无可比拟的优势：

1. 环境的通用性与适配性： AI 项目通常依赖复杂的环境（如 PyTorch、CUDA、npm 版本等）。源码安装允许 OpenClaw CN 完美融入您现有的开发环境（无论是 Conda、Venv 还是 Docker），避免了封装包可能带来的底层库冲突问题。无论您是 Windows、macOS 还是 Linux 用户，源码运行都能提供最原生的性能表现。

2. 代码透明与安全： 作为一款能够执行操作系统的智能体，安全性至关重要。源码安装意味着每一行代码对您都是可见的。您可以清楚地知道程序在执行什么指令，没有任何“黑盒”操作，这对于企业级应用和极客用户来说是安全的底线。

3. 便于二次开发与调试： OpenClaw CN 的核心价值在于“可扩展性”。通过源码部署，您可以直接修改配置文件、调整 Prompt 甚至修改核心逻辑来适配您的具体业务场景。您离开发者只有一步之遥，这是预编译软件无法做到的。

4. 即时获取最新特性： AI 技术迭代极快。源码部署让您可以通过简单的 git pull 命令，瞬间同步我们最新的功能修复和模型适配（如最新的 DeepSeek 优化），无需等待漫长的发版周期。

A: 这是因为构建脚本依赖 Linux 环境命令，请使用 Git Bash 运行。

OpenClaw CN 的构建流程中包含了一些 Shell 脚本（如 .sh 文件），Windows 默认的 CMD 或 PowerShell 终端无法直接执行这些脚本。

解决方法：

1. 推荐方式：使用 Git Bash 在项目根目录点击右键，选择 Git Bash Here。在弹出的 Git Bash 窗口中再次运行构建命令（如 pnpm build）即可。Git Bash 自带了模拟 Linux 环境，可以完美兼容这些脚本。

2. 替代方式：配置环境变量 如果您坚持使用 PowerShell，需要将 Git 安装目录下的 bin 文件夹（包含 bash.exe）添加到系统的 Path 环境变量中，但这通常比第一种方法更繁琐。

A: 我们是 OpenClaw 的本地化增强版本，保持与其核心同步，但更懂中文环境。

我们与上游（原版 OpenClaw）保持着紧密的“软分叉（Soft Fork）”关系：

1. 同步策略（Keep Upstream）： 我们制定了严格的代码合并机制。原则上，我们会每周进行 1-2 次与原版 release 分支的合并操作。这意味着，原版 OpenClaw 所有的底层能力提升、Bug 修复和新特性（如新的沙箱机制、新的工具接口），CN 版本都会第一时间同步拥有。

2. 差异化功能（Unique Features）： 在保持内核同步的基础上，我们维护了一套独立的“本地化补丁集”。这些功能是原版不具备，但对国内用户至关重要的：

   • 模型支持：原生集成 DeepSeek等国内主流大模型，无需繁琐配置。
   • 生态集成：未来将深度集成飞书、钉钉、企业微信等国内特有平台的工具集。
   • 网络适配：优化了对国内网络环境的支持。

简单来说，使用 OpenClaw CN，您既能享受到全球开源社区的智慧，又能拥有开箱即用的本地化体验。