常见问题

安装问题

Q: 安装时提示权限不足？

A: 尝试以下方法：

# macOS/Linux
sudo npm i -g openclaw

# 或使用 npx
npx openclaw

Q: Windows 上安装失败？

A: 确保已安装：

• Node.js 18+
• Visual Studio Build Tools（用于编译原生模块）

以管理员身份运行 PowerShell，然后重试。

Q: 如何更新 OpenClaw？

A:

# npm 安装的版本
npm update -g openclaw

# Homebrew 安装的版本
brew upgrade openclaw

配置问题

Q: 如何获取 API Key？

A:

• Anthropic: https://console.anthropic.com/
• OpenAI: https://platform.openai.com/api-keys
• Google: https://aistudio.google.com/
• Kimi: https://platform.moonshot.cn/

Q: 配置文件在哪里？

A:

• macOS/Linux: ~/.openclaw/config.json
• Windows: %USERPROFILE%\.openclaw\config.json

Q: 如何重置配置？

A:

openclaw config reset

运行问题

Q: OpenClaw 启动失败？

A: 检查以下几点：

1. 端口是否被占用：

# 查看 3000 端口占用
lsof -i :3000  # macOS/Linux
netstat -ano | findstr :3000  # Windows

2. 查看错误日志：

openclaw logs --level error

3. 运行诊断：

openclaw doctor

Q: 内存占用过高？

A: 尝试优化：

{
  "memory": {
    "maxEntries": 500,
    "retention": 86400
  },
  "model": {
    "maxTokens": 2048
  }
}

Q: 响应速度慢？

A: 可能原因和解决方案：

1. 模型选择：使用更快的模型
2. 网络延迟：检查网络连接，或使用本地模型
3. 内存过多：减少记忆条目数量
4. 技能过多：禁用不需要的技能

IM 集成问题

Q: Telegram Bot 如何创建？

A:

1. 在 Telegram 中找到 @BotFather
2. 发送 /newbot 命令
3. 按提示设置名称和用户名
4. 获取 Token

Q: 企业微信配置失败？

A: 确保：

1. 企业微信后台已配置可信域名
2. IP 白名单已设置
3. 应用权限已正确配置

Q: Discord Bot 无响应？

A: 检查：

1. Bot Token 是否正确
2. Bot 是否有足够的权限
3. Intents 是否正确配置

安全问题

Q: 沙盒模式和完全访问模式的区别？

A:

特性	沙盒模式	完全访问模式
文件访问	仅允许指定目录	完全访问
命令执行	仅允许指定命令	允许所有命令
安全性	高	低
功能性	受限	完整

Q: 如何保护 API Key？

A:

1. 不要将 API Key 提交到代码仓库
2. 使用环境变量存储
3. 定期轮换 API Key
4. 设置 API 使用限额

Q: 数据存储在哪里？

A: OpenClaw 默认将数据存储在本地：

• 对话历史：~/.openclaw/history/
• 记忆数据：~/.openclaw/memory/
• 技能文件：~/.openclaw/skills/

技能问题

Q: 如何安装社区技能？

A:

# 搜索技能
openclaw skills search <keyword>

# 安装技能
openclaw skills install <skill-name>

Q: 如何创建自定义技能？

A: 参考 自定义技能指南。

Q: 技能加载失败？

A: 检查：

1. 技能文件格式是否正确
2. 依赖是否已安装
3. 权限是否足够

云端部署问题

Q: 云端部署如何配置域名？

A:

# 设置域名
openclaw config set server.host your-domain.com

# 申请 SSL 证书
openclaw ssl apply

Q: 云端部署如何持久化数据？

A: 使用对象存储（如腾讯云 COS）：

1. 配置存储桶
2. 挂载到 OpenClaw 数据目录
3. 配置自动备份

Q: 如何监控云端实例？

A:

1. 使用云平台监控服务
2. 配置日志收集
3. 设置告警规则

其他问题

Q: OpenClaw 支持哪些语言？

A: OpenClaw 支持多种语言，取决于所使用的 AI 模型。主流模型支持：

• 中文
• 英文
• 日文
• 韩文
• 其他多种语言

Q: 如何备份数据？

A:

# 导出配置
openclaw config export > config-backup.json

# 导出记忆
openclaw memory export > memory-backup.json

Q: 如何贡献代码？

A:

1. Fork 项目仓库
2. 创建功能分支
3. 提交 Pull Request

详见 GitHub 贡献指南。

获取帮助

如果以上内容没有解决你的问题，可以通过以下方式获取帮助：

• GitHub Issues
• Discord 社区
• 官方文档