xmlns="http://www.w3.org/2000/svg"

style="display:

2026.2.15，完整记录了实际配置过程、遇到的问题及解决方案。

本文采用实测优先原则，明确标注哪些内容已验证、哪些来自官方文档但未亲测。

文档说明：✅

已验证

/>测试环境：WSL2

Ubuntu

安装（实测）curl-fsSL

https://openclaw.ai/install.sh|bash#

验证openclaw

--version

安装脚本会自动检测系统环境、安装依赖、配置

PATH，并启动配置向导。

📖

install

openclaw（未验证）

1.2

配置向导

wizard，或手动运行openclaw

onboard。

向导会引导你选择模型提供商、配置

API

Key、设置工作区等。

Skills

skills

不影响核心对话功能。

后续需要时可通过openclaw

skills

<name>单独启用。

Hooks

/>

2.

onboard，选择添加自定义模型提供商，输入以下信息：

• Provider

  URL:https://open.bigmodel.cn/api/paas/v4/

• API

  Key:

  https://open.bigmodel.cn/usercenter/apikeys

  获取

⚠️注意：使用通用

API

URL，否则容易被封号。

配置完成后会生成custom-open-bigmodel-cn/glm-5模型。

2.2

Context

4096，会导致错误：Model

context

16000.

编辑~/.openclaw/openclaw.json，找到models.providers配置并修改：

{"models":{"mode":"merge","providers":{"custom-open-bigmodel-cn":{"baseUrl":"https://open.bigmodel.cn/api/paas/v4/","apiKey":"your-api-key-here","api":"openai-completions","models":[{"id":"glm-5","name":"glm-5
(Custom
Provider)","reasoning":false,"input":["text"],"cost":{"input":4,"output":18,"cacheRead":0,"cacheWrite":0},"contextWindow":200000,"maxTokens":128000}]}}}}

重要说明：GLM-5

实际规格为

tokens（参考智谱AI官方文档）。

不要直接修改agents/main/agent/models.json，它会被openclaw.json中的

provider

restartsleep15openclaw

models

--probe

确认输出显示ok而非

context

bootstrapping）。

2.4

Memory

unavailable，这是正常的。

OpenClaw

Transcript（已启用，基于

JSONL

足够日常使用。

对话保存在~/.openclaw/agents/main/sessions/*.jsonl，每次加载整个

session

context。

如果想消除警告，可在配置中添加agents.defaults.memorySearch.enabled:

/>

3.

https://api.slack.com/apps，点击Create

New

“OpenClaw”），选择工作区，点击Create

Socket

Token（Scope:connections:write），复制

Token（格式：xapp-...）。

此

token

关键步骤

这是最容易出错的部分，权限不全会导致missing_scope错误。

左侧菜单

→OAuth

Permissions→Bot

Token

Scopes，添加以下所有权限：

Scope	Scope	Scope
app_mentions:read	chat:write	chat:write.public
channels:history	groups:history	im:history
mpim:history	im:write	im:read
groups:write	groups:read	users:read
assistant:write

权限说明：

• app_mentions:read：接收

  @mention

  事件

• chat:write：在公开频道发送消息
• chat:write.public：在未加入的频道发送消息
• channels:history,groups:history,im:history,mpim:history：读取各类频道的消息历史
• im:write,im:read：DM（私信）场景必需，缺少会导致

  missing_scope

• groups:write,groups:read：私密频道场景必需
• users:read：读取用户信息
• assistant:write：App

  Agent

  功能

⚠️常见坑点：chat:write只能在频道使用，DM

必须要im:write；私密频道必须要groups:write。

这是

missing_scope

错误的主要来源。

3.4

Event

Events→Subscribe

bot

events添加：

message.channels,message.groups,message.im,message.mpim,app_mention

⚠️重要：修改

Event

app，否则不生效！实测表明只修改不

Reinstall

会导致日志完全无记录。

3.5

App

Workspace（首次）或Reinstall

Workspace（修改配置后），授权所有权限，复制

Bot

Token（格式：xoxb-...）。

⚠️

每次修改

Workspace！

3.6

OpenClaw

✅

编辑~/.openclaw/openclaw.json，添加或修改channels部分：

{"channels":{"slack":{"mode":"socket","enabled":true,"botToken":"xoxb-your-bot-token-here","appToken":"xapp-your-app-token-here","groupPolicy":"open","dmPolicy":"pairing"}}}

配置说明：mode:

Socket

@mention；dmPolicy:

gateway

--probe

确认输出显示Slack

logs

发消息，应该能看到日志输出。

如果日志无反应，检查

Event

bootstrapping），Channels

Slack

slack查看请求，openclaw

pairing

<code>批准配对。

频道方式：在频道中运行/invite

bot，然后@YourBotName

消息内容与

--follow查看实时日志。

调试时建议开两个终端，一个运行日志，一个在

Slack

发消息，观察是否有消息接收记录、是否有错误（如

调用了哪些工具。

日志文件位置：/tmp/openclaw/openclaw-$(date

/>Systemd

⚠️

现象：openclaw

tui显示⠇

connected，长时间无响应。

排查：运行openclaw

status查看

--probe查看模型状态。

根本原因（实测）：Custom

Provider

16000。

解决：修改~/.openclaw/openclaw.json中

provider

节），重启并验证openclaw

gateway

status。

教训：不要直接改agents/main/agent/models.json，它会被

openclaw.json

无响应：日志显示slack

final

missing_scope。

原因是缺少im:writescope，chat:write只能在频道用。

解决方案：添加im:write和im:read→

Reinstall

restart。

场景

Slack

events（message.channels,

message.groups,

app_mention），Reinstall

OpenClaw。

教训：不同场景需要不同

scope（公开频道:

失败

现象：日志显示web_fetch

failed:

或继续执行。

影响：不影响最终响应，agent

fetch

失败是正常的。

可能原因：网络波动、WSL2

DNS

问题、网站限制或需要认证。

解决（如频繁出现）：测试网络curl

https://www.google.com，检查

DNScat

/etc/resolv.conf，如需要设置为

Google

agents.main.skills.web_fetch.enabled

false

“bootstrapping”

openclaw

bootstrapping长时间不变。

可能原因：Context

window

--probe检查），模型

API

bootstrapping。

诊断步骤：openclaw

models

错误

症状：Model

context

16000.

解决：编辑~/.openclaw/openclaw.json（不是

provider

节），重启并验证openclaw

gateway

missing_scope

根据使用场景添加对应

scope，修改后必须

不回复：添加im:write,im:read

/>私密频道不回复：添加groups:write,groups:read

/>完全没日志：检查

events，Reinstall

6.4

配对（Pairing）

DM

bot

时收到配对码请求是正常安全机制。

运行openclaw

pairing

slack查看请求，openclaw

pairing

<code>批准。

如想禁用配对（不推荐），运行openclaw

config

到~/.openclaw/.env），智谱AI

Embedding（理论可行但需验证，可能需要代码级修改），或本地

Embedding

https://docs.openclaw.ai/memory/local-embeddings）。

7.2

Skills

skills：web_search（需

Brave

Playwright）、code_execution（需沙箱）。

7.3

Agent

agent，适用于不同任务使用不同模型、隔离配置、测试新配置等场景。

命令：openclaw

agents

<name>、openclaw

tui

<name>。

7.4

其他方向

🔬

自定义工具（https://docs.openclaw.ai/tools/custom）、其他

LLM

Provider（Claude、Qwen、DeepSeek）、WhatsApp/Telegram

/>

8.

配置检查清单

安装验证：openclaw

--version显示版本

active

Slack

Mode

Workspace|openclaw

channels

已被邀请到测试频道

功能验证：TUI

能正常对话

环境的实际配置经验整理。

关键要点：使用官方安装脚本；GLM-5

配置需在

不影响核心功能。

本文档的局限性：已验证

WSL2

系统；部分命令和配置选项来自官方文档。