1 Openclaw目录及核心配置文件理解

• openclaw 相关目录：

• /home/ubuntu/.openclaw/⁠  - 配置根目录
• ⁠/home/ubuntu/.openclaw/extensions/⁠  - 系统插件（企业微信、微信等）
• /home/ubuntu/.openclaw/workspace/skills/⁠ - 用户技能（天气、PDF、PPT等）

加载优先级：

• 插件skills（extensions/）优先加载
• 用户skills（workspace/skills/）随后加载
• 同名技能：插件版覆盖用户版

• 系统级配置文件⁠/home/ubuntu/.openclaw/

• openclaw.json⁠  - 核心配置文件（模型、通道、插件等所有配置）
• openclaw.json.backup*⁠  - 多个备份文件

• 身份与配置类：路径⁠/home/ubuntu/.openclaw/workspace/

• AGENTS.md - 工作空间主配置文件（你的数字伙伴手册）
• SOUL.md - 虾仔的灵魂文件（我的性格和核心原则）
• USER.md - 关于你的信息（彤哥的个人档案）
• IDENTITY.md - 虾仔的身份卡片（名称、形象、特点）
• TOOLS.md - 本地工具笔记（摄像头、SSH、TTS等配置）
• HEARTBEAT.md - 心跳检查配置（周期性任务）

2 选择哪个操作系统部署

• OpenClaw官方建议：

• 开发环境：macOS或Ubuntu Desktop
• 测试环境：Ubuntu Server 22.04+
• 生产环境：Ubuntu Server LTS 或 Debian Stable

云服务器部署openclaw后，

1. 建议ssh22端口，不要暴露公网、修改22端口

vim /etc/ssh/sshd_config

#Port22去掉注释，修改22为其他端口

1. 禁用root账号登陆ssh

vim /etc/ssh/sshd_config

PermitRootLogin yes改为no

1. 重启服务生效：sudo systemctl restart sshd或者sudo service ssh restar

3 具体部署建议

• 个人使用/学习
• 选择1：本地macOS
• 选择2：Ubuntu Desktop 24.04
• 选择3：WSL2 (Windows用户)团队/生产部署
• 团队/生产部署

• 首选：Ubuntu Server 22.04/24.04 LTS
• 备选：Debian 12
• 容器化：Docker + Alpine云服务器选择

• 最佳操作系统选择

• GitHub上的中文使用案例
• 🏆 第一名：Ubuntu Server 24.04 LTS
• 理由：文档最全、社区最大、问题解决最快
• 适合：95%的使用场景🥈
• 理由：极致稳定，适合对稳定性要求极高的环境

• 如何避坑？

• 避免Windows Server：Node.js在Windows上问题较多
• 避免CentOS：已停止维护，转向Rocky/Alma Linux
• 避免太新的发行版：等社区踩完坑再升级
• 一定要用LTS版本：长期支持，安全更新有保障

4 操作系统选额对比

特性	Ubuntu	macOS
文档完善度	✅✅✅ 最佳	✅✅ 良好
社区支持	✅✅✅ 最大	✅✅ 较大
稳定性	✅✅✅ 优秀	✅✅ 良好
资源占用	✅✅ 中等	❌ 较高
Docker支持	✅✅✅ 完美	✅✅ 良好
Node.js支持	✅✅✅ 最佳	✅✅ 良好
学习曲线	✅✅ 平缓	✅✅ 平缓
生产适用性	✅✅✅ 首选	❌ 不适合

5 Ubuntu安装openclaw

• 安装完成后，如果无法执行openclaw命令，需要手动配置 PATH：

# 检查 openclaw 是否在 PATH 中

which openclaw

# 如果找不到，查看 npm 全局安装目录

npm prefix -g

# 查看当前 shell

echo $SHELL

# 如果输出 /bin/bash，使用 ~/.bashrc

# 如果输出 /bin/zsh，使用 ~/.zshrc

# 将 npm 全局 bin 目录添加到 PATH

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc

# 重新加载配置文件

source ~/.bashrc

# 验证添加是否成功

echo $PATH | grep npm

✓刚部署 完OpenClaw，发现Agent无法执行基本操作：

❌ 无法读取/修改本地文件

❌ 无法访问终端执行命令

❌ Gateway Dashboard的Tools页面显示大量权限被关闭

❌ 尝试在Dashboard中手动开启权限，开关无法点击或保存后失效

在：openclaw 3.31、4.1、4.2版本中，如果在对话中遇到approve 需要操作系统授权操作，或者总是提示gateway无法启动的、不想频繁提示的，这样修改：

1. openclaw config set tools.exec.security full

2. openclaw config set tools.exec.ask off

3. openclaw gateway restart

解决每次对话需要approve验证的方法

修复完成后

6 企业微信接入OpenClaw

以长连接方式接入OpenClaw-帮助中心-企业微信

https://open.work.weixin.qq.com/help2/pc/21658

7 在聊天框可以输入的命令

/status

🦞 OpenClaw 2026.3.13 (61d171a)

🧠 Model: custom-api-l/deepseek-v3.2 · 🔑 api-key 

🧮 Tokens: 212k in / 1.3k out · 💵 Cost: $0.0000

📚 Context: 42k/32k (133%) · 🧹 Compactions: 32

🧵 Session: agent:main:wecom:direct:zhao• updated just now

⚙️ Runtime: direct · Think: off

🪢 Queue: collect (depth 0)

/reset

✅New session started · model: custom-api/deepseek-v3.2

仅清空当前会话的短期上下文‌（即本次对话的历史记录）。

‌保留长期记忆‌，如保存在/MEMORY.md中的个人信息、使用偏好、配置的 Skills 等。

‌不生成新 Session ID‌，会话标识保持不变。

适用于在同一任务中切换子话题，希望保留已有知识但重置当前对话场景

/new

彻底清空所有上下文‌，包括短期记忆和长期记忆（但不影响已配置的 Skills 或全局身份信息）。

‌生成全新的 Session ID‌，并创建一个新的 .jsonl 会话文件。

‌可同时切换模型‌，例如输入 /new kimi 或 /new claude-opus。

适用于开启完全独立的新任务，避免历史对话干扰，尤其适合跨领域或高 Token 消耗场景

/compact

压缩当前上下文，节省 Token ‌：⚙️ Compaction failed: Compaction cancelled • Context ?/32k

Openclaw每次根据上下文context提交给模型，采用哪种压缩方式：

Openclaw config set agents.defaults.compaction.mode safeguard

如果你想调整压缩行为，可以修改这个设置：

1.  ⁠safeguard⁠ （默认）：智能安全压缩

2.  ⁠aggressive⁠ ：更激进的压缩，保留更少历史

3.  ⁠none⁠ ：禁用压缩（可能超出 context window）

1. ⁠summarize⁠ ：自动生成摘要代替原始消息

升级2026.3.24 及后续版本

1、default= 不再需要手动触发 /compact，系统会在适当时候自动执行压缩

2、aggressive⁠=压缩阈值更低、触发更早，压缩更彻底地删除冗余细节，优先保留核心意图和关键信息

/stop‌

中止当前正在生成的回复 ‌：⚙️ Agent was aborted.

‌/models‌

列出所有可用模型，并可切换（如 /models/models list ）‌

‌/model <模型名>‌

切换指定模型（如 /model gpt-4）‌

‌/tts on/off‌

开启或关闭语音回复 ‌

‌/think‌

切换推理模式（如启用/禁用深度思考）‌

off → “关闭”

minimal → “认为”

low → “认真思考”

medium → “更努力地思考”

high → “最大预算”

xhigh → “仅 GPT-5.2 + Codex 模型”

/commands for full list

8 会话健康分析

指令：让对话变得可靠的用法，执行下面话术发送：

在每次和我对话回复我的内容的最后面，加入会话健康分析

格式为：第一行：分隔符用一条横线。

第二行：会话状态、会话文件大小、会话token消耗

要求：会话状态：实时更新，监测状态是否正常、

会话文件：本次发送和回复，占用文件大小

会话token消耗：本次发送和回复，token消耗

9 IM和openclaw对话时，经常现实如下报错

解决办法，升级wecom插件

1. 企业微信对话IM框，输入指令升级：更新wecom 所有的插件
2. clawhub update wecom-openclaw-plugin

10 移动端管理工具：PocketClaw

推荐一个手机app管理工具：PocketClaw支持 管理openclaw