使用 Nix 运行 OpenClaw 的推荐方式是通过 nix-openclaw — 一个开箱即用的 Home Manager 模块。 快速开始 将此粘贴给你的 AI 智能体（Claude、Cursor 等）： I want to set up nix-openclaw on my Mac. Repository: github:openclaw/nix-openclaw What I need you to do: 1. Check if Determinate Nix is installed (if not, install it) 2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix 3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot) 4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine 5. Fill in the template placeholders and run home-manager switch 6. Verify: launchd running, bot responds to messages Reference the nix-openclaw README for module options. 📦 完整指南：github.com/openclaw/nix-openclaw ...

状态：通过插件支持（webhook 机器人）。支持私信、房间、表情回应和 Markdown 消息。 需要插件 Nextcloud Talk 以插件形式提供，不包含在核心安装包中。 通过 CLI 安装（npm 仓库）： openclaw plugins install @openclaw/nextcloud-talk 本地检出安装（从 git 仓库运行时）： openclaw plugins install ./extensions/nextcloud-talk 如果你在配置/新手引导过程中选择了 Nextcloud Talk，并且检测到 git 检出， OpenClaw 将自动提供本地安装路径。 详情：插件 快速设置（新手） 安装 Nextcloud Talk 插件。 在你的 Nextcloud 服务器上创建机器人： ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature reaction 在目标房间设置中启用机器人。 配置 OpenClaw： 配置项：channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret 或环境变量：NEXTCLOUD_TALK_BOT_SECRET（仅默认账户） 重启 Gateway 网关（或完成新手引导）。 最小配置： { channels: { "nextcloud-talk": { enabled: true, baseUrl: "https://cloud.example.com", botSecret: "shared-secret", dmPolicy: "pairing", }, }, } 注意事项 机器人无法主动发起私信。用户必须先向机器人发送消息。 Webhook URL 必须可被 Gateway 网关访问；如果在代理后面，请设置 webhookPublicUrl。 机器人 API 不支持媒体上传；媒体以 URL 形式发送。 Webhook 载荷无法区分私信和房间；设置 apiUser + apiPassword 以启用房间类型查询（否则私信将被视为房间）。 访问控制（私信） 默认：channels.nextcloud-talk.dmPolicy = "pairing"。未知发送者将收到配对码。 批准方式： openclaw pairing list nextcloud-talk openclaw pairing approve nextcloud-talk <CODE> 公开私信：channels.nextcloud-talk.dmPolicy="open" 加上 channels.nextcloud-talk.allowFrom=["*"]。 房间（群组） 默认：channels.nextcloud-talk.groupPolicy = "allowlist"（需要提及触发）。 使用 channels.nextcloud-talk.rooms 设置房间白名单： { channels: { "nextcloud-talk": { rooms: { "room-token": { requireMention: true }, }, }, }, } 如需禁止所有房间，保持白名单为空或设置 channels.nextcloud-talk.groupPolicy="disabled"。 功能支持 功能 状态 私信 支持 房间 支持 话题 不支持 媒体 仅 URL 表情回应 支持 原生命令 不支持 配置参考（Nextcloud Talk） 完整配置：配置 ...

Moonshot 提供兼容 OpenAI 端点的 Kimi API。配置提供商并将默认模型设置为 moonshot/kimi-k2.5，或使用 Kimi Coding 的 kimi-coding/k2p5。 当前 Kimi K2 模型 ID： {/_ moonshot-kimi-k2-ids:start _/} kimi-k2.5 kimi-k2-0905-preview kimi-k2-turbo-preview kimi-k2-thinking kimi-k2-thinking-turbo {/_ moonshot-kimi-k2-ids:end _/} openclaw onboard --auth-choice moonshot-api-key Kimi Coding： openclaw onboard --auth-choice kimi-code-api-key 注意：Moonshot 和 Kimi Coding 是独立的提供商。密钥不可互换，端点不同，模型引用也不同（Moonshot 使用 moonshot/...，Kimi Coding 使用 kimi-coding/...）。 配置片段（Moonshot API） { env: { MOONSHOT_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "moonshot/kimi-k2.5" }, models: { // moonshot-kimi-k2-aliases:start "moonshot/kimi-k2.5": { alias: "Kimi K2.5" }, "moonshot/kimi-k2-0905-preview": { alias: "Kimi K2" }, "moonshot/kimi-k2-turbo-preview": { alias: "Kimi K2 Turbo" }, "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" }, "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" }, // moonshot-kimi-k2-aliases:end }, }, }, models: { mode: "merge", providers: { moonshot: { baseUrl: "https://api.moonshot.ai/v1", apiKey: "${MOONSHOT_API_KEY}", api: "openai-completions", models: [ // moonshot-kimi-k2-models:start { id: "kimi-k2.5", name: "Kimi K2.5", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, { id: "kimi-k2-0905-preview", name: "Kimi K2 0905 Preview", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, { id: "kimi-k2-turbo-preview", name: "Kimi K2 Turbo", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, { id: "kimi-k2-thinking", name: "Kimi K2 Thinking", reasoning: true, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, { id: "kimi-k2-thinking-turbo", name: "Kimi K2 Thinking Turbo", reasoning: true, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, // moonshot-kimi-k2-models:end ], }, }, }, } Kimi Coding { env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi-coding/k2p5" }, models: { "kimi-coding/k2p5": { alias: "Kimi K2.5" }, }, }, }, } 注意事项 Moonshot 模型引用使用 moonshot/<modelId>。Kimi Coding 模型引用使用 kimi-coding/<modelId>。 如有需要，可在 models.providers 中覆盖定价和上下文元数据。 如果 Moonshot 发布了某个模型的不同上下文限制，请相应调整 contextWindow。 如需使用中国端点，请使用 https://api.moonshot.cn/v1。

MiniMax 是一家构建 M2/M2.1 模型系列的 AI 公司。当前面向编程的版本是 MiniMax M2.1（2025 年 12 月 23 日），专为现实世界的复杂任务而构建。 来源：MiniMax M2.1 发布说明 模型概述（M2.1） MiniMax 强调 M2.1 的以下改进： 更强的多语言编程能力（Rust、Java、Go、C++、Kotlin、Objective-C、TS/JS）。 更好的 Web/应用开发和美观输出质量（包括原生移动端）。 改进的复合指令处理，适用于办公风格的工作流程，基于交错思考和集成约束执行。 更简洁的响应，更低的 token 使用量和更快的迭代循环。 更强的工具/智能体框架兼容性和上下文管理（Claude Code、Droid/Factory AI、Cline、Kilo Code、Roo Code、BlackBox）。 更高质量的对话和技术写作输出。 MiniMax M2.1 vs MiniMax M2.1 Lightning 速度： Lightning 是 MiniMax 定价文档中的"快速"变体。 成本： 定价显示相同的输入成本，但 Lightning 的输出成本更高。 编程计划路由： Lightning 后端在 MiniMax 编程计划中不能直接使用。MiniMax 自动将大多数请求路由到 Lightning，但在流量高峰期会回退到常规 M2.1 后端。 选择设置方式 MiniMax OAuth（编程计划）— 推荐 适用于： 通过 OAuth 快速设置 MiniMax 编程计划，无需 API 密钥。 ...

“进入此地者，放弃一切希望。” 更新时间：2026-01-21 状态：支持文本 + 私信附件；频道/群组文件发送需要 sharePointSiteId + Graph 权限（参见在群聊中发送文件）。投票通过 Adaptive Cards 发送。 需要插件 Microsoft Teams 作为插件提供，不包含在核心安装中。 破坏性变更（2026.1.15）： MS Teams 已从核心移出。如果你使用它，必须安装插件。 原因说明：保持核心安装更轻量，并让 MS Teams 依赖项可以独立更新。 通过 CLI 安装（npm 注册表）： openclaw plugins install @openclaw/msteams 本地检出（从 git 仓库运行时）： openclaw plugins install ./extensions/msteams 如果你在配置/新手引导过程中选择 Teams 并检测到 git 检出， OpenClaw 将自动提供本地安装路径。 详情：插件 快速设置（初学者） 安装 Microsoft Teams 插件。 创建一个 Azure Bot（App ID + 客户端密钥 + 租户 ID）。 使用这些凭证配置 OpenClaw。 通过公共 URL 或隧道暴露 /api/messages（默认端口 3978）。 安装 Teams 应用包并启动 Gateway 网关。 最小配置： ...

状态：通过插件支持（bot token + WebSocket 事件）。支持频道、群组和私信。 Mattermost 是一个可自托管的团队消息平台；有关产品详情和下载，请访问官方网站 mattermost.com。 需要插件 Mattermost 以插件形式提供，不包含在核心安装中。 通过 CLI 安装（npm 注册表）： openclaw plugins install @openclaw/mattermost 本地检出（从 git 仓库运行时）： openclaw plugins install ./extensions/mattermost 如果你在配置/新手引导期间选择 Mattermost 并检测到 git 检出，OpenClaw 会自动提供本地安装路径。 详情：插件 快速设置 安装 Mattermost 插件。 创建 Mattermost bot 账户并复制 bot token。 复制 Mattermost 基础 URL（例如 https://chat.example.com）。 配置 OpenClaw 并启动 Gateway 网关。 最小配置： { channels: { mattermost: { enabled: true, botToken: "mm-token", baseUrl: "https://chat.example.com", dmPolicy: "pairing", }, }, } 环境变量（默认账户） 如果你偏好使用环境变量，请在 Gateway 网关主机上设置： ...

Matrix 是一个开放的去中心化消息协议。OpenClaw 以 Matrix 用户身份连接到任意主服务器，因此你需要为机器人创建一个 Matrix 账户。登录后，你可以直接私信机器人或邀请它加入房间（Matrix"群组"）。Beeper 也是一个有效的客户端选项，但它需要启用 E2EE。 状态：通过插件（@vector-im/matrix-bot-sdk）支持。支持私信、房间、话题、媒体、表情回应、投票（发送 + poll-start 作为文本）、位置和 E2EE（需要加密支持）。 需要插件 Matrix 作为插件提供，不包含在核心安装中。 通过 CLI 安装（npm 仓库）： openclaw plugins install @openclaw/matrix 本地检出（从 git 仓库运行时）： openclaw plugins install ./extensions/matrix 如果你在配置/新手引导期间选择 Matrix 并检测到 git 检出，OpenClaw 将自动提供本地安装路径。 详情：插件 设置 安装 Matrix 插件： 从 npm：openclaw plugins install @openclaw/matrix 从本地检出：openclaw plugins install ./extensions/matrix 在主服务器上创建 Matrix 账户： 在 https://matrix.org/ecosystem/hosting/ 浏览托管选项 或自行托管。 获取机器人账户的访问令牌： 在你的主服务器上使用 curl 调用 Matrix 登录 API： curl --request POST \ --url https://matrix.example.org/_matrix/client/v3/login \ --header 'Content-Type: application/json' \ --data '{ "type": "m.login.password", "identifier": { "type": "m.id.user", "user": "your-user-name" }, "password": "your-password" }' 将 matrix.example.org 替换为你的主服务器 URL。 或设置 channels.matrix.userId + channels.matrix.password：OpenClaw 会调用相同的登录端点，将访问令牌存储在 ~/.openclaw/credentials/matrix/credentials.json，并在下次启动时重用。 配置凭证： ...

OpenClaw 通过将出站 Markdown 转换为共享的中间表示（IR），然后再渲染为特定渠道的输出来进行格式化。IR 保留源文本不变，同时携带样式/链接跨度信息，使分块和渲染在各渠道间保持一致。 目标 **一致性：**一次解析，多个渲染器。 **安全分块：**在渲染前拆分文本，确保行内格式不会跨块断裂。 **渠道适配：**将同一 IR 映射到 Slack mrkdwn、Telegram HTML 和 Signal 样式范围，无需重新解析 Markdown。 管道 解析 Markdown -> IR IR 是纯文本加上样式跨度（粗体/斜体/删除线/代码/剧透）和链接跨度。 偏移量使用 UTF-16 代码单元，以便 Signal 样式范围与其 API 对齐。 仅当渠道启用了表格转换时才会解析表格。 分块 IR（格式优先） 分块在渲染前对 IR 文本进行操作。 行内格式不会跨块拆分；跨度按块进行切片。 按渠道渲染 Slack： mrkdwn 标记（粗体/斜体/删除线/代码），链接格式为 <url|label>。 Telegram： HTML 标签（<b>、<i>、<s>、<code>、<pre><code>、<a href>）。 Signal： 纯文本 + text-style 范围；当标签与 URL 不同时，链接变为 label (url)。 IR 示例 输入 Markdown： Hello **world** — see [docs](https://docs.openclaw.ai). IR（示意）： { "text": "Hello world — see docs.", "styles": [{ "start": 6, "end": 11, "style": "bold" }], "links": [{ "start": 19, "end": 23, "href": "https://docs.openclaw.ai" }] } 使用场景 Slack、Telegram 和 Signal 的出站适配器从 IR 进行渲染。 其他渠道（WhatsApp、iMessage、Microsoft Teams、Discord）仍使用纯文本或各自的格式化规则，启用时会在分块前应用 Markdown 表格转换。 表格处理 Markdown 表格在各聊天客户端中的支持并不一致。使用 markdown.tables 按渠道（和按账户）控制转换方式。 ...

macOS 权限授予是脆弱的。TCC 将权限授予与应用的代码签名、Bundle 标识符和磁盘路径关联。如果其中任何一项发生变化，macOS 会将该应用视为新应用，可能会丢弃或隐藏权限提示。 稳定权限的要求 相同路径：从固定位置运行应用（对于 OpenClaw，为 dist/OpenClaw.app）。 相同 Bundle 标识符：更改 Bundle ID 会创建新的权限身份。 已签名的应用：未签名或临时签名的构建不会持久化权限。 一致的签名：使用真实的 Apple Development 或 Developer ID 证书，以确保签名在多次构建之间保持稳定。 临时签名每次构建都会生成新的身份。macOS 会忘记之前的授权，提示可能完全消失，直到清除过期条目为止。 权限提示消失时的恢复清单 退出应用。 在系统设置 -> 隐私与安全性中移除该应用条目。 从相同路径重新启动应用并重新授予权限。 如果提示仍未出现，使用 tccutil 重置 TCC 条目后重试。 某些权限仅在完全重启 macOS 后才会重新出现。 重置示例（根据需要替换 Bundle ID）： sudo tccutil reset Accessibility bot.molt.mac sudo tccutil reset ScreenCapture bot.molt.mac sudo tccutil reset AppleEvents 如果你正在测试权限，请始终使用真实证书签名。临时签名的构建仅适用于不需要权限的快速本地运行。

本指南涵盖从源代码构建和运行 OpenClaw macOS 应用程序的必要步骤。 前置条件 在构建应用之前，确保你已安装以下内容： Xcode 26.2+：Swift 开发所需。 Node.js 22+ & pnpm：Gateway 网关、CLI 和打包脚本所需。 1. 安装依赖 安装项目范围的依赖： pnpm install 2. 构建和打包应用 要构建 macOS 应用并将其打包到 dist/OpenClaw.app，运行： ./scripts/package-mac-app.sh 如果你没有 Apple Developer ID 证书，脚本将自动使用 ad-hoc 签名（-）。 有关开发运行模式、签名标志和 Team ID 故障排除，请参阅 macOS 应用 README： https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md 注意：Ad-hoc 签名的应用可能会触发安全提示。如果应用立即崩溃并显示"Abort trap 6"，请参阅故障排除部分。 3. 安装 CLI macOS 应用期望全局安装 openclaw CLI 来管理后台任务。 安装方法（推荐）： 打开 OpenClaw 应用。 转到 General 设置标签页。 点击 “Install CLI”。 或者，手动安装： npm install -g openclaw@<version> 故障排除 构建失败：工具链或 SDK 不匹配 macOS 应用构建期望最新的 macOS SDK 和 Swift 6.2 工具链。 ...