WARNING

当前文档由 AI 翻译生成，若发现术语或表述不准确，请查看英文原文。

将 OpenClaw 作为你的自托管个人 AI 助手运行

OpenClaw 是一款专为本地设备设计的个人 AI 助手。它可以直接接入 Discord、Slack 等消息应用，让你在这些应用中与其交互。

它相当于一位"始终在线"的助手，能够执行搜索和发送文档、管理日历、浏览网页等实际任务。

学习目标

在本指南中，你将学习如何：

• 安装并初始化 OpenClaw 环境。
• 将 OpenClaw 与 Discord 等频道集成。
• 可选：启用网页搜索功能。
• 管理技能和插件。
• 使用 OpenClaw 助手管理 Olares。
• 可选：启用沙箱以实现安全代码执行。

前提条件

开始前，你需要准备：

• Discord 账号：用于创建机器人应用。

• Discord 服务器：确保你在这个服务器上有添加机器人的权限。

• 以下模型：

  模型类型	模型	获取方式
  聊天	Gemma 4 26B (Ollama)	从 Market 安装

  模型提供方

  本教程通过 Ollama API 使用 Gemma 4 26B。如使用其他提供方或本地代理，请参阅 OpenClaw 关于自定义模型提供方的文档。

升级说明

如果你正在升级现有的 OpenClaw 安装，请在继续之前查看版本特定的更改和故障排除步骤。更多信息，请参阅升级 OpenClaw。

安装 OpenClaw

1. 在 Olares Market 中搜索 "OpenClaw"。

   

2. 点击获取，然后点击安装。安装完成后，启动台会出现两个快捷方式：

   • OpenClaw CLI：命令行界面
   • Control UI：图形化管理面板

   

运行多个 OpenClaw 实例

Olares 支持应用克隆。如果你希望同时运行多个独立的 AI 助手处理不同任务，可以克隆 OpenClaw 应用。更多信息，请参阅克隆应用。

初始化 OpenClaw

快速完成助手的初始化配置。

步骤 1：获取模型连接信息

本教程使用 Gemma 4 26B (Ollama)，这是一款可从 Market 获取的支持工具调用的模型。

TIP

OpenClaw 需要较大的"上下文窗口"（即 AI 的短期记忆）来处理复杂任务而不会忘记之前的指令。如使用本地模型，建议选择原生支持至少 64K token 上下文窗口的模型。

模型连接的工作原理

Olares 上的独立模型作为与客户端应用分开的服务运行。要连接两者，客户端需要准确的 Model name，以及与其所需 API 格式相匹配的 Base URL。

你可以从模型控制台获取这两个值。有关更多信息，可参阅连接 AI 应用。

1. 从启动台打开模型应用。其模型控制台会自动打开。

2. 等待模型显示就绪，且引擎显示运行中。

   

3. 在模型部分，按显示内容原样复制模型名称。

4. 在引擎部分：

   a. 连接来源：选择 Olares 内应用。

   b. API 格式：选择 Ollama。

   c.按显示内容原样复制 Base URL 地址。

步骤 2：验证模型的可访问性

在配置 OpenClaw 之前，先验证模型是否可通过 API 正常访问和响应。

1. 从启动台打开 OpenClaw CLI 应用。

2. 运行以下命令验证 API 地址是否可达。确保已将 {Your-Model-API} 替换为步骤 1中复制的 Base URL。

   curl {Your-Model-API}/api/tags

   终端返回可用模型列表，即表示 API 可达。

3. 运行以下命令，将模型加载到内存并测试响应速度。确保已将 {Your-Model-API} 和 {Your-Model-Name} 替换为步骤 1中复制的 Base URL 和 Model name。

   curl {Your-Model-API}/api/generate -d '{
   "model": "{Your-Model-Name}",
   "prompt": "say hello world",
   "stream": false
   }'

   返回的响应中包含 Hello World!，即表示模型已就绪。

步骤 3：运行安装向导

使用交互式向导逐步配置 OpenClaw。

1. 从启动台打开 OpenClaw CLI 应用。

2. 输入以下命令启动交互式安装向导：

   openclaw onboard --classic

   不要单独运行 openclaw onboard

   不要单独运行 openclaw onboard —— 它会启动一个对话式 TUI，需要在环境变量中配置 API 密钥。由于当前没有配置 API 密钥，这条路走不通。对于交互式向导，请改用 openclaw onboard --classic。

   如果不小心进入了 TUI，输入 /quit 并按 Enter 退出。

3. 向导会引导你完成一系列步骤。使用方向键移动，按 Enter 确认。

   关于配置的说明

   为便于快速上手，本教程会跳过向导中的部分高级设置。你可以稍后配置或修改它们。

   配置	选项
   I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?	选择 Yes。
   Setup mode	选择 QuickStart。
   Model/auth provider	选择 More，然后选择 Ollama。
   Ollama auth method	选择 Ollama。
   Ollama mode	选择 Local only。
   Ollama base URL	删除默认占位文本，然后输入步骤 1中复制的 Base URL。
   Default model	选择 Browse all models，然后选择已安装的模型 ollama/gemma4:26b。
   Select channel	选择 Skip for now。 （可稍后配置频道）
   Search provider	选择 Skip for now。 （可稍后配置搜索提供方）

   完成安装向导后，OpenClaw 会自动开始安装技能依赖。根据网络情况，这可能需要一些时间。

   安装错误可忽略

   在此过程中你可能会看到 Install failed 或类似错误。这些错误不会阻塞安装，等待安装完成即可。

4. 等待安装完成。OpenClaw 会自动打开终端用户界面（TUI）。

   

5. 输入 /quit 并按 Enter 退出。

6. 保持 OpenClaw CLI 窗口打开。下一步还需要使用它。

步骤 4：配对设备

将 Control UI 与 OpenClaw CLI 配对，以使用图形化管理面板。

步骤 5：配置上下文窗口

OpenClaw 需要较大的"上下文窗口"（即 AI 的短期记忆）来处理复杂任务而不会忘记之前的指令。

1. 打开 Files 应用，然后进入 Data > clawdbot > config。

2. 双击打开 openclaw.json 文件。

3. 点击右上角的 edit_square 进入编辑模式。

4. 找到 models 部分，并定位你的模型配置块。

5. 将 contextWindow 值更新为至少 65536（64K）。如果硬件显存允许，强烈建议将其增加到 204800（200K）。

   

6. 点击右上角的 save。

7. 重启 OpenClaw 使更改生效。

步骤 6：个性化 OpenClaw

为使 OpenClaw 机器人更具个性化，强烈建议完成人设设置流程。

该流程通过人设文件确立助手的身份、行为边界和长期记忆。这些文件可确保助手在所有平台和频道上的行为保持一致。

1. 在 Control UI 中，从左侧边栏的 SESSIONS 下选择 agent:main:dashboard。

2. 在聊天区域，确保已选中你的模型。

   右下角的指示器（例如 gemma4:26b · Off）显示当前模型和推理状态。Off 表示推理已禁用，而不是模型不可用。

3. （可选）启用推理。

   默认情况下，推理处于关闭状态以获得更快的响应。要启用或调整推理，请点击模型指示器打开模型面板，将 REASONING 滑块拖动到 Faster 和 Smarter 之间的合适位置，然后点击 Save。

   

4. 输入并发送一条简单的消息开始。例如：

   Wake up please!

5. 助手会响应并开始与你对话。你可以在此过程中建立规则、个性特征和偏好。例如：

   - Call me Bella. I like simple language without technical jargon and 
   concise bulleted answers.
   - You are John, a witty assistant who uses emojis.
   - Never access my calendar without asking first, and never execute any 
   financial operations.

6. 与助手对话时，你可以看到它正在将你的偏好写入核心人设文件，例如 IDENTITY.md、USER.md 和 SOUL.md。

   

   TIP

   如果你没有看到中间的人设文件操作，请点击右上角的 right_panel_close，然后点击 refresh，或按 F5 刷新页面。

7. （可选）如果助手未能更新人设文件，请在聊天中明确要求它执行。

   如果问题仍然存在，请使用以下方法之一解决：

   • 增加上下文窗口：打开 Files 应用，进入 Data > clawdbot > config > openclaw.json，然后将 contextWindow 值增加到至少 64K（建议 200K）。

     TIP

     请注意，较大的上下文窗口会消耗更多显存，因此请选择硬件可支持的值。

   • 更换模型：切换到具有更好工具调用和指令遵循能力的模型。

8. 继续对话，直到助手收集到足够的信息。

9. 验证人设文件是否已成功更新：

   a. 从启动台打开 Files 应用。

   b. 进入 Application > Data > clawdbot > config > workspace。

   c. 检查 .md 文件的修改时间，以确定哪些文件最近更新过，例如 USER.md、IDENTITY.md 和 SOUL.md。

   

   d. （可选）下载文件，在支持的文本编辑器中查看，并验证其中包含你新建的规则，例如你的名字、语言风格和限制。

   e. 如果存在临时的 BOOTSTRAP.md 文件，请删除它。

   修改人设设置

   如需将来更改这些设置，请使用以下方法之一：

   • 在聊天中要求助手更新其规则。
   • 从此文件夹下载 .md 文件，在文本编辑器中编辑后重新上传，以覆盖旧文件。

后续步骤

1. 与 Discord 集成，实现与助手的远程对话。
2. 启用网页搜索，使助手能够访问实时互联网信息。
3. 安装技能和插件，进一步扩展助手的能力。

故障排除和常见问题

如需常见错误和行为问题的解决方案，请参阅常见问题。

了解更多

• 如何在 Discord 中创建服务器