Deutschland · Deutsch · OpenClaw-compatible
生产部署
环境变量、域名、缓存、安全边界和回滚流程。
当前路径 /de/deploy/production · Qiepai Claw Getting Started
你需要什么
开始之前，先确认本机和工作区具备以下条件。企鹅派 Claw 的功能按 OpenClaw 兼容路径设计，因此 Gateway、Dashboard、应用、模型和工具都应能在同一套流程里完成验证。
- 一台可访问互联网的 macOS、Linux 或 Windows 开发机。
- Node.js 20+ 或 Bun / pnpm 运行环境，用于运行本地控制台与示例应用。
- 一个企鹅派 Claw 工作区，以及可用于模型调用的 API Key。
- 可选：Docker，用于在本机启动 Gateway、数据库和向量存储等组件。
快速设置
按顺序执行下面步骤。每一步都对应一个可验证结果：CLI 安装成功、项目初始化完成、Gateway 在线、Dashboard 可打开、第一条消息可追踪。
安装企鹅派 Claw CLI
CLI 负责初始化工作区、拉起本地服务、管理 Gateway 连接和打开 Dashboard。若你的组织完全复刻 OpenClaw 包名，可把命令中的 qiepai-claw 替换为内部镜像。
npm create qiepai-claw@latest运行交互式新手引导
引导会询问应用名称、运行端口、模型供应商、默认模型、Gateway 地址和是否启用示例数据。完成后会生成本地配置、环境变量模板和第一个智能应用。
qiepai-claw init my-claw-app验证 Gateway 是否可用
Gateway 是应用、工具、模型和外部服务之间的统一入口。先检查健康状态，再确认模型路由、工具注册表和鉴权配置已经加载。
qiepai-claw gateway status打开 Dashboard
Dashboard 用来查看应用、会话、工具调用、模型配置、运行日志和工作区状态。它也是第一次调试企鹅派 Claw 最直观的入口。
qiepai-claw dashboard发送第一条消息
选择默认应用，向本地 Gateway 发送一条消息。你应该能在 Dashboard 中看到请求、模型响应、工具调用轨迹和耗时信息。
qiepai-claw chat "帮我生成一个园区招商跟进计划"查看运行日志
如果第一条消息失败，先看运行日志。常见问题包括 API Key 未配置、模型名称不匹配、Gateway 端口被占用或工具权限未开启。
qiepai-claw logs --tail接下来做什么
文档页面索引
下面这些路径已经可以访问。当前先复用完整指南页作为承接内容，后续可以逐页拆成独立文档，并保持与 OpenClaw 类似的目录层级。
/de/start/getting-started快速开始：安装 CLI、初始化项目、验证 Gateway 和 Dashboard。/de/start/installation安装与系统要求：Node.js、包管理器、Docker、工作区和密钥准备。/de/gateway/configurationGateway 配置：模型路由、工具路由、鉴权路由和健康检查。/de/dashboard/overviewDashboard 使用：应用、会话、日志、模型、工具和工作区管理。/de/apps/agents应用与智能体：智能体模板、提示词、工具绑定和发布环境。/de/models/providers模型供应商：公开 API、企业网关、私有模型和备用模型策略。/de/tools/permissions工具与权限：工具协议、输入结构、人工确认、审计日志。/de/deploy/production生产部署：环境变量、域名、缓存、安全边界和回滚流程。推荐项目结构
完成入门流程后，把应用、工具、工作流和环境配置拆清楚。这样团队在复刻 OpenClaw 能力时，可以逐项迁移、逐项验证，而不是把所有逻辑堆在单个入口文件里。
app/agents放置智能体定义、系统提示词、模型偏好和可调用工具列表。app/tools声明可被 Gateway 调用的业务工具，例如知识库检索、表单写入、CRM 同步。app/workflows组织多步骤流程，适合招商跟进、客服分流、内容生成和审批任务。app/prompts沉淀可复用提示词模板，按场景区分招商、客服、内容、运营和内部知识库。app/evals保存评测用例，验证模型输出、工具调用、权限策略和回归表现。claw.config.ts集中配置 Gateway、Dashboard、模型路由、日志和权限策略。.env.local存放本地 API Key、模型端点、数据库地址和私有部署参数。核心配置
企鹅派 Claw 的关键配置集中在环境变量、模型路由和工具权限。建议本地、测试、生产三套环境分开管理，并为每次工具调用保留可审计记录。
环境变量
至少准备 QIEPAI_CLAW_API_KEY、QIEPAI_CLAW_GATEWAY_URL 和默认模型配置。生产环境应通过托管平台密钥管理，不要写入源码。
cp .env.example .env.local模型路由
企鹅派 Claw 兼容 OpenAI 风格模型端点，也可以接入私有化推理网关。建议配置主模型、备用模型和超时策略。
qiepai-claw models list工具权限
工具必须先注册再授权。对写入型工具启用人工确认或环境隔离，对只读工具保留审计日志即可。
qiepai-claw tools inspect常见问题排查
如果你正在逐项照 OpenClaw 功能复刻，优先从 Gateway、Dashboard、模型和工具权限四个方向定位问题。
Gateway 连接失败
检查端口、QIEPAI_CLAW_GATEWAY_URL、Docker 容器状态和本机防火墙。
Dashboard 空白
确认开发服务仍在运行，并查看浏览器控制台是否有资源加载或鉴权错误。
模型无响应
检查 API Key、模型名称、供应商额度、代理网络和超时配置。
工具调用被拒绝
确认工具已注册、当前应用拥有权限，并检查工作区策略是否限制了写操作。
多语言路径异常
检查 locale 参数是否在支持列表内，确认默认路径仍然指向 /zh-CN/start/getting-started。
生产环境日志缺失
确认日志级别、采样率、部署环境变量和工作区审计开关已经启用。
Dashboard 使用指南
Dashboard 是企鹅派 Claw 的运维入口。第一次调试时，不要只看最终回答，重点看请求是否经过正确的应用、模型、工具和 Gateway 路由。
应用查看所有智能应用、默认模型、入口路径、发布状态和最近一次运行结果。会话回放用户消息、模型响应、工具调用、错误栈和延迟，用于定位真实问题。Gateway检查模型路由、工具注册表、鉴权策略、健康检查和上游连接状态。日志按环境、应用、会话、工具和错误级别过滤日志，并导出排查记录。应用与智能体模板
企鹅派 Claw 可以照 OpenClaw 的应用模型组织多个智能体。建议先从三个高频业务模板开始，再逐步扩展到更多工具和工作流。
生产部署清单
上线前按清单检查。文档站、Dashboard、Gateway 和业务工具通常不是同一个安全边界，生产环境要分别确认访问权限。
- 确认 QIEPAI_CLAW_GATEWAY_URL 指向生产 Gateway。
- 确认 API Key、模型额度、备用模型和超时策略已经配置。
- 确认 Dashboard 生产访问权限只开放给内部成员。
- 确认写入型工具启用权限策略、人工确认或环境隔离。
- 确认 docs.qiepai.ai 的 DNS、HTTPS、缓存和多语言路径都可访问。
OpenClaw 复刻映射
如果企鹅派 Claw 的能力完全照 OpenClaw 设计，建议用下面的映射表做迁移验收：名称可以替换，功能边界、调试入口和运维检查项要保持一致。
OpenClaw CLI企鹅派 Claw CLI：命令结构保持一致，包名、工作区名和默认品牌文案替换为企鹅派。Gateway企鹅派 Gateway：保留模型路由、工具注册、鉴权、健康检查和请求追踪能力。Dashboard企鹅派 Dashboard：保留应用、会话、日志、模型、工具、工作区等运维入口。Apps应用：应用仍是对外服务入口，可绑定智能体、模型、工具和发布环境。Tools工具：工具协议保持兼容，重点补充企鹅派业务工具和权限模板。Gateway 深入配置
Gateway 是企鹅派 Claw 的核心边界。模型调用、工具调用和访问鉴权都应该先进入 Gateway，再由 Gateway 统一记录和分发。
模型路由
按应用、环境和优先级选择模型。生产建议配置主模型、备用模型、超时、重试和最大上下文限制。
qiepai-claw gateway routes models工具路由
工具路由决定某个应用可以调用哪些工具，以及调用前是否需要用户确认、管理员授权或环境隔离。
qiepai-claw gateway routes tools鉴权路由
为 Dashboard、API、Gateway 和工具调用分开设置访问策略，避免公开文档站影响内部运维入口。
qiepai-claw gateway auth inspect安全与权限策略
文档站可以公开，但内部控制面不能公开。上线前把文档、Dashboard、Gateway、工具和数据源拆成不同安全边界。
最小权限
应用只能访问完成任务所需的模型、工具和数据源。
写入确认
涉及 CRM、工单、邮件、数据库写入的工具默认启用确认步骤。
环境隔离
本地、测试、生产使用不同密钥、不同 Gateway 和不同工具权限。
审计留痕
记录会话、调用者、工具参数、模型输出、错误栈和管理员操作。
日志与可观测性
企鹅派 Claw 的排查体验应围绕 trace id 展开：从用户消息一路追到应用、模型、工具、Gateway 和外部服务。
请求追踪每次消息生成一个 trace id，用来串联应用、模型、工具和 Gateway 日志。指标监控关注请求数、错误率、首 token 延迟、工具耗时、模型成本和重试次数。日志采样生产环境建议保留错误全量日志，对成功请求做采样，避免日志成本失控。评测回归重要提示词、工具和模型变更后，用 app/evals 中的用例做回归验证。CLI 与 API 参考
入门阶段先记住这些命令和接口。后续可以把它们拆成独立参考页，并为每个 API 补充请求体、响应体和错误码。
qiepai-claw init创建项目、写入配置、生成 .env.example，并按向导启用示例应用。qiepai-claw gateway status检查 Gateway 健康状态、端口、路由、工具注册表和鉴权配置。qiepai-claw chat从 CLI 发送测试消息，适合验证模型、工具和日志链路。qiepai-claw deploy执行生产构建前检查，并输出部署清单。POST /v1/messages应用消息入口，兼容聊天、工具调用和多轮会话。GET /v1/runs/:id查询一次运行的状态、模型响应、工具调用和错误详情。模型供应商矩阵
企鹅派 Claw 可以同时管理多类模型。迁移或复刻 OpenClaw 能力时，先按用途确认模型类型，再决定是否走公开 API、企业网关或私有部署。
对话模型客服、招商顾问、多轮咨询：要求稳定、低延迟、可追踪上下文。推理模型复杂方案、合同摘要、长链路规划：要求更高准确性，可接受更长响应时间。嵌入模型知识库检索、相似案例匹配：要求维度稳定，迁移时注意重新构建索引。视觉模型图片资料识别、空间图解读：生产前要限制上传类型和文件大小。私有模型企业内网、合规场景：通过 Gateway 接入，统一鉴权、日志和调用预算。工具协议参考
工具描述越清晰，模型越容易在正确时机调用。建议每个工具都写清楚输入结构、权限等级、失败处理和审计字段。
name工具唯一名称，例如 crm.createLead 或 park.searchPolicy。description告诉模型什么时候应该调用该工具，避免过宽泛的描述。input_schema声明参数类型、必填项、枚举值和格式限制。permission定义只读、写入、人工确认、管理员授权或生产禁用。audit记录调用者、参数摘要、结果、耗时和错误信息。工作流示例
工作流适合把多个工具、模型调用和人工确认串起来。企鹅派 Claw 的首批工作流可以优先覆盖招商、客服、运营和内部知识四类场景。
环境变量参考
环境变量要按环境拆分。本地可以用 .env.local，生产应放在托管平台或密钥管理系统里。
QIEPAI_CLAW_API_KEY企鹅派 Claw 工作区 API Key，生产环境必须用密钥管理。QIEPAI_CLAW_GATEWAY_URLGateway 地址，本地通常是 localhost，生产应使用内网或受保护域名。QIEPAI_CLAW_DEFAULT_MODEL默认对话模型名称，用于未显式指定模型的应用。QIEPAI_CLAW_LOG_LEVEL日志级别，开发可用 debug，生产建议 info 或 warn。QIEPAI_CLAW_DASHBOARD_ORIGINDashboard 允许访问的来源，用于防止误开放。QIEPAI_CLAW_TOOL_CONFIRM写入型工具是否默认需要确认，建议生产开启。版本升级与发布流程
生产发布不要只看构建是否成功，还要验证智能体行为、工具权限、模型额度、日志和回滚路径。
开发在本地完成应用、工具和提示词改动，并用 qiepai-claw chat 做冒烟测试。评测运行 app/evals 中的关键用例，确认模型输出、工具调用和权限策略没有回归。预发连接预发 Gateway，验证 Dashboard、日志、模型额度和外部工具。发布执行构建和部署，确认 docs.qiepai.ai、多语言路径和客服入口可访问。回滚保留上一版本配置和构建产物，发现严重问题时先回滚再排查。FAQ
能否完全复刻 OpenClaw？
可以按功能路径复刻，但品牌、包名、默认文案、官网入口和业务模板应使用企鹅派 Claw。
文档为什么默认简体中文？
docs.qiepai.ai 面向企鹅派中文用户，默认 /zh-CN，同时保留多地区路径用于后续翻译。
公开文档站会不会暴露 Dashboard？
不会。文档站可以公开，但 Dashboard、Gateway 和生产工具应单独设置访问权限。
联系客服按钮放哪里？
顶部右侧保留联系客服按钮，方便从文档直接进入企业微信客服。
多地区语言路径
默认文档入口为 /zh-CN/start/getting-started。语言路径参考 OpenClaw 的多地区文档入口，后续可逐页补齐真实翻译、搜索索引和 SEO hreflang。