ghcr.io/openclaw/openclaw-dockerfile-smoke

ghcr.io/openclaw/openclaw-dockerfile-smoke:eb03d0ee2ba18710cff382a544a0dd3db58214f2

ghcr.iolinux/amd64eb03d0ee2ba18710cff382a544a0dd3db58214f2大小: 226.29 MB更新于 2026年6月21日
让 AI 帮你使用轩辕镜像？

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

🦞 OpenClaw — 个人AI助手

EXFOLIATE! EXFOLIATE!

OpenClaw 是一款可在您自己设备上运行的 个人AI助手。 它通过您已在使用的渠道与您交互。它可在 macOS/iOS/Android 上进行语音交互，并能渲染您可控制的实时画布。网关仅是控制平面 — 核心产品是助手本身。

如果您需要一款个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是您的选择。

支持的渠道包括：、、Slack、、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、、Zalo、Zalo Personal、微信、QQ、WebChat。

首次安装？从这里开始：https://docs.openclaw.ai/start/getting-started

推荐设置：在终端中运行 openclaw onboard。 OpenClaw Onboard 会引导您逐步完成网关、工作区、渠道和技能的设置。这是推荐的 CLI 设置路径，适用于 macOS、Linux 和 Windows。 Windows 桌面用户可通过原生 https://docs.openclaw.ai/platforms/windows companion 应用开始设置，该应用提供托盘状态、聊天、节点模式和本地 MCP 模式功能。

支持 npm、pnpm 或 bun。

赞助商

订阅（OAuth）：

  • **https://openai.com/**%EF%BC%88***/Codex%EF%BC%89

模型说明：虽然支持多种提供商和模型，但建议优先选择您信任且已在使用的提供商的当前旗舰模型。详见 https://docs.openclaw.ai/start/wizard%E3%80%82

安装（推荐）

运行时：Node 24（推荐）或 Node 22.19+。

npm install -g openclaw@latest
# 或：pnpm add -g openclaw@latest

openclaw onboard --install-daemon

OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务）以确保其持续运行。

快速入门（简明版）

运行时：Node 24（推荐）或 Node 22.19+。

完整新手指南（认证、配对、渠道）：https://docs.openclaw.ai/start/getting-started

推荐守护进程模式：

openclaw onboard --install-daemon
openclaw gateway status

前台/调试模式：

openclaw gateway stop
openclaw gateway --port 18789 --verbose

任一启动模式运行后，发送测试消息或向助手提问：

# 发送消息
openclaw message send --target +1234567890 --message "Hello from OpenClaw"

# 与助手对话（可选将回复发送至任何已连接渠道：WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/IRC/Microsoft Teams/Matrix/飞书/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/微信/QQ/WebChat）
openclaw agent --message "发货清单" --thinking high

需要升级？参见 https://docs.openclaw.ai/install/updating%EF%BC%88%E5%B9%B6%E8%BF%90%E8%A1%8C openclaw doctor）。

模型配置 + CLI：https://docs.openclaw.ai/concepts/models%E3%80%82%E8%AE%A4%E8%AF%81%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E8%BD%AE%E6%8D%A2 + 回退：https://docs.openclaw.ai/concepts/model-failover%E3%80%82

安全默认设置（DM访问）

OpenClaw 连接至实际消息界面。请将入站 DM 视为 不可信输入。

完整安全指南：https://docs.openclaw.ai/gateway/security%E3%80%82 远程暴露前，请使用 https://docs.openclaw.ai/gateway/security/exposure-runbook%E3%80%82

//Signal/iMessage/Microsoft Teams/***/Google Chat/Slack 上的默认行为：

  • DM 配对（dmPolicy="pairing" / channels.discord.dmPolicy="pairing" / channels.slack.dmPolicy="pairing"；旧版：channels.discord.dm.policy，channels.slack.dm.policy）：未知发送者会收到简短配对码，机器人不会处理其消息。
  • 批准方法：openclaw pairing approve （发送者将被添加到本地允许列表存储）。
  • 公共入站 DM 需显式选择启用：设置 dmPolicy="open" 并在渠道允许列表中包含 "*"（allowFrom / channels.discord.allowFrom / channels.slack.allowFrom；旧版：channels.discord.dm.allowFrom，channels.slack.dm.allowFrom）。

运行 openclaw doctor 可发现风险/配置错误的 DM 策略。

主要特性

  • https://docs.openclaw.ai/gateway — 用于会话、渠道、工具和事件的单一控制平面。
  • https://docs.openclaw.ai/channels — 、、Slack、、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、、Zalo、Zalo Personal、微信、QQ、WebChat、macOS、iOS/Android。
  • https://docs.openclaw.ai/gateway/configuration — 将入站渠道/账户/对等方路由至隔离代理（工作区 + 每代理会话）。
  • https://docs.openclaw.ai/nodes/voicewake + https://docs.openclaw.ai/nodes/talk — macOS/iOS 上的唤醒词和 Android 上的连续语音（ElevenLabs + 系统 TTS 回退）。
  • https://docs.openclaw.ai/platforms/mac/canvas — 具有 https://docs.openclaw.ai/platforms/mac/canvas#canvas-a2ui 的代理驱动视觉工作区。
  • https://docs.openclaw.ai/tools — 浏览器、画布、节点、定时任务、会话以及 ***/Slack 操作。
  • https://docs.openclaw.ai/platforms — Windows Hub、macOS 菜单栏应用以及 iOS/Android https://docs.openclaw.ai/nodes%E3%80%82
  • https://docs.openclaw.ai/start/wizard + https://docs.openclaw.ai/tools/skills — 基于引导设置的配置，包含捆绑/托管/工作区技能。

安全模型（重要）

[!IMPORTANT]

  • 默认：工具在 main 会话的主机上运行，因此当仅您使用时，代理拥有完全访问权限。
  • 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非 main 会话。Docker 是默认沙箱后端；也支持 SSH 和 OpenShell 后端。
  • 典型沙箱默认值：允许 bash、process、read、write、edit、sessions_list、sessions_history、sessions_send、sessions_spawn；拒绝 browser、canvas、nodes、cron、discord、gateway。

操作员快速参考

  • 聊天命令：/status、/new、/reset、/compact、/think 、/verbose on|off、/trace on|off、/usage off|tokens|full、/restart、/activation mention|always
  • 会话工具：sessions_list、sessions_history、sessions_send
  • 技能注册表：ClawHub
  • 架构概览：https://docs.openclaw.ai/concepts/architecture

按目标分类的文档

应用程序（可选）

仅网关即可提供出色体验。所有应用程序均为可选，用于添加额外功能。

如果计划构建/运行 companion 应用，请遵循以下平台运行手册。

macOS（OpenClaw.app）（可选）

  • 菜单栏控制网关和健康状态。
  • 语音唤醒 + 按键通话覆盖层。
  • WebChat + 调试工具。
  • 通过 SSH 远程控制网关。

注意：macOS 权限需签名构建才能在重建后保持（参见 https://docs.openclaw.ai/platforms/mac/permissions%EF%BC%89%E3%80%82

iOS 节点（可选）

  • 通过网关 WebSocket 配对为节点（设备配对）。
  • 语音触发转发 + 画布界面。
  • 通过 openclaw nodes … 控制。

运行手册：https://docs.openclaw.ai/platforms/ios%E3%80%82

Android 节点（可选）

  • 通过设备配对作为 WS 节点（openclaw devices ...）。
  • 提供连接/聊天/语音选项卡，以及画布、相机、屏幕捕获和 Android 设备命令系列。
  • 运行手册：https://docs.openclaw.ai/platforms/android%E3%80%82

从源码构建（开发）

源码检出使用 pnpm。仓库是 pnpm 工作区，开发期间捆绑插件从 extensions/* 加载，因此会直接使用其包本地依赖和您的编辑。在仓库根目录执行普通 npm install 不是受支持的源码设置。

开发循环：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install

# 仅首次运行（或重置本地 OpenClaw 配置/工作区后）
pnpm openclaw setup

# 可选：首次启动前预构建 Control UI
pnpm ui:build

# 开发循环（源码/配置更改时自动重载）
pnpm gateway:watch

如果需要从检出构建 dist/（用于 Node、打包或发布验证），运行：

pnpm build
pnpm ui:build

pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代 Control UI 时使用 pnpm ui:dev。如果希望此检出直接运行引导设置，使用 pnpm openclaw onboard --install-daemon。

注意：pnpm openclaw ... 直接运行 TypeScript（通过 tsx）。pnpm build 生成 dist/ 用于通过 Node / 打包的 openclaw 二进制运行，而 pnpm gateway:watch 在开发循环期间按需重建运行时。

开发渠道

  • stable：标记发布（vYYYY.M.D 或 vYYYY.M.D- ），npm 分发标签 latest。
  • beta：预发布标签（vYYYY.M.D-beta.N），npm 分发标签 beta（可能缺少 macOS 应用）。
  • dev：main 分支的移动 HEAD，npm 分发标签 dev（发布时）。

切换渠道（git + npm）：openclaw update --channel stable|beta|dev。 详情：https://docs.openclaw.ai/install/development-channels%E3%80%82

代理工作区 + 技能

  • 工作区根目录：~/.openclaw/workspace（可通过 agents.defaults.workspace 配置）。
  • 注入的提示文件：AGENTS.md、SOUL.md、TOOLS.md。
  • 技能：~/.openclaw/workspace/skills/ /SKILL.md。

配置

最小化 ~/.openclaw/openclaw.json（模型 + 默认值）：

{
agent: {
model: " / ",
},
}

https://docs.openclaw.ai/gateway/configuration

星级历史

Molty

OpenClaw 是为 Molty（一款太空龙虾 AI 助手）构建的。🦞 由 Peter Steinberger 和社区开发。

  • https://openclaw.ai
  • soul.md
  • steipete.me
  • @openclaw

社区

参见 CONTRIBUTING.md 了解指南、维护者信息以及提交 PR 的方法。 欢迎 AI/氛围编码 PR！🤖

特别感谢 Mario Zechner 的支持以及 https://github.com/earendil-works/pi-mono%E3%80%82 特别感谢 Adam Doppelt 提供 lobster.bot 域名。

感谢所有 clawtributors：

轩辕镜像配置手册

按平台快速找到配置文档

一键安装

一键安装 Docker

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

用户头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

专业版 · 高速稳定拉取镜像
50GB 仅 ¥7/年
高速镜像下载在线技术支持99.95% SLA 保障付费会员免广告