Back to Details

openclaw-china-docker

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OpenClaw China Docker Skill

OpenClaw China Docker 技能

Skill by ara.so — Hermes Skills collection.
This skill helps you deploy and configure OpenClaw-China-Docker, a pre-configured Docker image that integrates OpenClaw AI bot gateway with mainstream Chinese IM platforms including Feishu (Lark), DingTalk, QQ Bot, and WeChat Work (WeCom).
由 ara.so 提供的技能 — Hermes 技能合集。
本技能可帮助您部署并配置OpenClaw-China-Docker，这是一个预配置的Docker镜像，集成了OpenClaw AI机器人网关与国内主流即时通讯平台，包括飞书（Lark）、钉钉、QQ Bot和企业微信（WeCom）。

What is OpenClaw-China-Docker?

什么是OpenClaw-China-Docker？

OpenClaw-China-Docker is a production-ready Docker image that packages OpenClaw with pre-installed plugins for Chinese IM platforms. It provides:
  • Multi-platform support: Feishu (official/legacy), DingTalk, QQ Bot, WeChat Work
  • Extended capabilities: Agent Reach integration (Twitter, Xiaohongshu, Weibo, Douyin)
  • Configuration-driven: Environment variable based setup with 
    .env
    files
  • Enhanced tooling: FFmpeg, Playwright, Chinese TTS, OpenCode AI
  • Security: Docker-in-Docker sandbox mode for code execution
  • Production features: Data persistence, isolated utility containers
OpenClaw-China-Docker是一款可用于生产环境的Docker镜像，打包了OpenClaw及预安装的国内IM平台插件。它提供以下功能：
  • 多平台支持：飞书（官方/旧版）、钉钉、QQ Bot、企业微信
  • 扩展能力：Agent Reach集成（Twitter、小红书、微博、抖音）
  • 配置驱动：基于环境变量的
    .env
    文件配置
  • 增强工具集：FFmpeg、Playwright、中文TTS、OpenCode AI
  • 安全性：用于代码执行的Docker-in-Docker沙箱模式
  • 生产级特性：数据持久化、隔离的实用容器

Installation

安装

Prerequisites

前置条件

  • Docker and Docker Compose installed
  • API keys for AI models (OpenAI, Claude, etc.)
  • Bot credentials for desired IM platforms
  • 已安装Docker和Docker Compose
  • AI模型的API密钥（OpenAI、Claude等）
  • 目标IM平台的机器人凭证

Quick Start

快速开始

bash
undefined
bash
undefined

Clone the repository

克隆仓库

git clone https://github.com/justlovemaki/openclaw-china-docker.git cd openclaw-china-docker
git clone https://github.com/justlovemaki/openclaw-china-docker.git cd openclaw-china-docker

Copy environment template

复制环境变量模板

cp .env.example .env
cp .env.example .env

OR use minimal version for quick setup

或使用极简版本快速搭建

cp .env.minimal .env
cp .env.minimal .env

Edit environment variables

编辑环境变量

nano .env
nano .env

Start services

启动服务

docker compose up -d
docker compose up -d

View logs

查看日志

docker compose logs -f openclaw
docker compose logs -f openclaw

Stop services

停止服务

docker compose down
undefined
docker compose down
undefined

Pull Docker Image Directly

直接拉取Docker镜像

bash
docker pull justlikemaki/openclaw-docker-cn-im:latest
bash
docker pull justlikemaki/openclaw-docker-cn-im:latest

Core Configuration

核心配置

Environment Variables (.env)

环境变量（.env）

The project uses environment variables for configuration. Key sections:
本项目使用环境变量进行配置。关键配置项如下：

AI Model Configuration

AI模型配置

bash
undefined
bash
undefined

OpenAI compatible API

OpenAI兼容API

OPENCLAW_AI_PROVIDER=openai OPENCLAW_OPENAI_API_KEY=${OPENAI_API_KEY} OPENCLAW_OPENAI_BASE_URL=https://api.openai.com/v1 OPENCLAW_OPENAI_MODEL=gpt-4o
OPENCLAW_AI_PROVIDER=openai OPENCLAW_OPENAI_API_KEY=${OPENAI_API_KEY} OPENCLAW_OPENAI_BASE_URL=https://api.openai.com/v1 OPENCLAW_OPENAI_MODEL=gpt-4o

Claude API

Claude API

OPENCLAW_AI_PROVIDER=anthropic OPENCLAW_ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY} OPENCLAW_ANTHROPIC_MODEL=claude-3-5-sonnet-20241022
OPENCLAW_AI_PROVIDER=anthropic OPENCLAW_ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY} OPENCLAW_ANTHROPIC_MODEL=claude-3-5-sonnet-20241022

Use AIClient-2-API (recommended for unlimited tokens)

使用AIClient-2-API（推荐用于无限令牌）

OPENCLAW_OPENAI_BASE_URL=http://your-aiclient-api:8000/v1
undefined
OPENCLAW_OPENAI_BASE_URL=http://your-aiclient-api:8000/v1
undefined

Feishu (Lark) Configuration

飞书（Lark）配置

bash
undefined
bash
undefined

Official plugin (recommended)

官方插件（推荐）

OPENCLAW_FEISHU_ENABLED=true OPENCLAW_FEISHU_APP_ID=cli_xxx OPENCLAW_FEISHU_APP_SECRET=xxx OPENCLAW_FEISHU_VERIFICATION_TOKEN=xxx OPENCLAW_FEISHU_ENCRYPT_KEY=xxx
OPENCLAW_FEISHU_ENABLED=true OPENCLAW_FEISHU_APP_ID=cli_xxx OPENCLAW_FEISHU_APP_SECRET=xxx OPENCLAW_FEISHU_VERIFICATION_TOKEN=xxx OPENCLAW_FEISHU_ENCRYPT_KEY=xxx

Legacy built-in version

旧版内置版本

OPENCLAW_FEISHU_OLD_ENABLED=true OPENCLAW_FEISHU_OLD_APP_ID=cli_xxx
OPENCLAW_FEISHU_OLD_ENABLED=true OPENCLAW_FEISHU_OLD_APP_ID=cli_xxx

... (similar structure)

...（类似结构）

undefined
undefined

DingTalk Configuration

钉钉配置

bash
OPENCLAW_DINGTALK_ENABLED=true
OPENCLAW_DINGTALK_CLIENT_ID=dingxxx
OPENCLAW_DINGTALK_CLIENT_SECRET=xxx
OPENCLAW_DINGTALK_ROBOT_CODE=xxx
bash
OPENCLAW_DINGTALK_ENABLED=true
OPENCLAW_DINGTALK_CLIENT_ID=dingxxx
OPENCLAW_DINGTALK_CLIENT_SECRET=xxx
OPENCLAW_DINGTALK_ROBOT_CODE=xxx

QQ Bot Configuration

QQ Bot配置

bash
OPENCLAW_QQBOT_ENABLED=true
OPENCLAW_QQBOT_APPID=xxx
OPENCLAW_QQBOT_SECRET=xxx
OPENCLAW_QQBOT_INTENT=1  # Public messages
bash
OPENCLAW_QQBOT_ENABLED=true
OPENCLAW_QQBOT_APPID=xxx
OPENCLAW_QQBOT_SECRET=xxx
OPENCLAW_QQBOT_INTENT=1  # 公开消息

WeChat Work (WeCom) Configuration

企业微信（WeCom）配置

bash
OPENCLAW_WECOM_ENABLED=true
OPENCLAW_WECOM_CORP_ID=wwxxx
OPENCLAW_WECOM_AGENT_ID=1000xxx
OPENCLAW_WECOM_SECRET=xxx
OPENCLAW_WECOM_TOKEN=xxx
OPENCLAW_WECOM_ENCODING_AES_KEY=xxx
bash
OPENCLAW_WECOM_ENABLED=true
OPENCLAW_WECOM_CORP_ID=wwxxx
OPENCLAW_WECOM_AGENT_ID=1000xxx
OPENCLAW_WECOM_SECRET=xxx
OPENCLAW_WECOM_TOKEN=xxx
OPENCLAW_WECOM_ENCODING_AES_KEY=xxx

Sandbox Configuration

沙箱配置

bash
undefined
bash
undefined

Enable Docker-in-Docker sandbox for code execution

启用Docker-in-Docker沙箱以执行代码

OPENCLAW_SANDBOX_MODE=all # or 'non-main' or 'none'
undefined
OPENCLAW_SANDBOX_MODE=all # 或 'non-main' 或 'none'
undefined

Docker Compose Setup

Docker Compose配置

Minimal 
docker-compose.yml
:
yaml
version: '3.8'

services:
  openclaw:
    image: justlikemaki/openclaw-docker-cn-im:latest
    container_name: openclaw-cn-im
    restart: unless-stopped
    env_file:
      - .env
    ports:
      - "3000:3000"
    volumes:
      - ./workspace:/openclaw/workspace
      - ./data:/openclaw/data
      # Uncomment for Docker sandbox mode
      # - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
极简版
docker-compose.yml
：
yaml
version: '3.8'

services:
  openclaw:
    image: justlikemaki/openclaw-docker-cn-im:latest
    container_name: openclaw-cn-im
    restart: unless-stopped
    env_file:
      - .env
    ports:
      - "3000:3000"
    volumes:
      - ./workspace:/openclaw/workspace
      - ./data:/openclaw/data
      # 如需Docker沙箱模式请取消注释
      # - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai

Key Commands

关键命令

Container Management

容器管理

bash
undefined
bash
undefined

Start services

启动服务

docker compose up -d
docker compose up -d

View logs (all services)

查看日志（所有服务）

docker compose logs -f
docker compose logs -f

View logs (specific service)

查看日志（指定服务）

docker compose logs -f openclaw
docker compose logs -f openclaw

Restart service

重启服务

docker compose restart openclaw
docker compose restart openclaw

Stop services

停止服务

docker compose down
docker compose down

Stop and remove volumes

停止并移除卷

docker compose down -v
undefined
docker compose down -v
undefined

Enter Container

进入容器

bash
undefined
bash
undefined

Interactive shell

交互式shell

docker compose exec openclaw bash
docker compose exec openclaw bash

Execute single command

执行单个命令

docker compose exec openclaw openclaw --version
undefined
docker compose exec openclaw openclaw --version
undefined

Upgrade

升级

bash
undefined
bash
undefined

Pull latest changes

拉取最新变更

git pull origin main
git pull origin main

Pull latest image

拉取最新镜像

docker compose pull
docker compose pull

Recreate containers

重新创建容器

docker compose up -d --force-recreate
docker compose up -d --force-recreate

Clean old images

清理旧镜像

docker image prune -f
undefined
docker image prune -f
undefined

Plugin Installation (Feishu Example)

插件安装（飞书示例）

bash
undefined
bash
undefined

Use utility container for one-time operations

使用实用容器执行一次性操作

docker compose run --rm openclaw-utils bash
docker compose run --rm openclaw-utils bash

Inside container:

在容器内：

cd /openclaw npx openclaw plugin:install larksuite/openclaw-lark
undefined
cd /openclaw npx openclaw plugin:install larksuite/openclaw-lark
undefined

Common Patterns

常见配置模式

Pattern 1: Full Setup with Multiple Platforms

模式1：多平台完整搭建

bash
undefined
bash
undefined

.env configuration

.env配置

OPENCLAW_AI_PROVIDER=openai OPENCLAW_OPENAI_API_KEY=${OPENAI_API_KEY} OPENCLAW_OPENAI_MODEL=gpt-4o
OPENCLAW_AI_PROVIDER=openai OPENCLAW_OPENAI_API_KEY=${OPENAI_API_KEY} OPENCLAW_OPENAI_MODEL=gpt-4o

Enable multiple IM platforms

启用多个IM平台

OPENCLAW_FEISHU_ENABLED=true OPENCLAW_DINGTALK_ENABLED=true OPENCLAW_QQBOT_ENABLED=true OPENCLAW_WECOM_ENABLED=true
OPENCLAW_FEISHU_ENABLED=true OPENCLAW_DINGTALK_ENABLED=true OPENCLAW_QQBOT_ENABLED=true OPENCLAW_WECOM_ENABLED=true

Configure each platform's credentials...

配置各平台凭证...

OPENCLAW_FEISHU_APP_ID=cli_xxx OPENCLAW_DINGTALK_CLIENT_ID=dingxxx OPENCLAW_QQBOT_APPID=xxx OPENCLAW_WECOM_CORP_ID=wwxxx

```bash
OPENCLAW_FEISHU_APP_ID=cli_xxx OPENCLAW_DINGTALK_CLIENT_ID=dingxxx OPENCLAW_QQBOT_APPID=xxx OPENCLAW_WECOM_CORP_ID=wwxxx

```bash

Deploy

部署

docker compose up -d
docker compose up -d

Monitor all platforms

监控所有平台

docker compose logs -f | grep -E 'feishu|dingtalk|qqbot|wecom'
undefined
docker compose logs -f | grep -E 'feishu|dingtalk|qqbot|wecom'
undefined

Pattern 2: Integration with AIClient-2-API

模式2：与AIClient-2-API集成

bash
undefined
bash
undefined

.env - Use AIClient for unlimited tokens

.env - 使用AIClient实现无限令牌

OPENCLAW_AI_PROVIDER=openai OPENCLAW_OPENAI_BASE_URL=http://aiclient-api:8000/v1 OPENCLAW_OPENAI_API_KEY=dummy-key # AIClient doesn't require real key OPENCLAW_OPENAI_MODEL=gpt-4o
OPENCLAW_AI_PROVIDER=openai OPENCLAW_OPENAI_BASE_URL=http://aiclient-api:8000/v1 OPENCLAW_OPENAI_API_KEY=dummy-key # AIClient不需要真实密钥 OPENCLAW_OPENAI_MODEL=gpt-4o

docker-compose.yml - Add AIClient service

docker-compose.yml - 添加AIClient服务

services: aiclient-api: image: justlikemaki/aiclient-2-api:latest ports: - "8000:8000" volumes: - aiclient-data:/app/data
openclaw: depends_on: - aiclient-api # ... rest of openclaw config
undefined
services: aiclient-api: image: justlikemaki/aiclient-2-api:latest ports: - "8000:8000" volumes: - aiclient-data:/app/data
openclaw: depends_on: - aiclient-api # ... 其余openclaw配置
undefined

Pattern 3: Enable Agent Reach for Web Search

模式3：启用Agent Reach进行网页搜索

Initialize Agent Reach in conversation:
禁止使用web_search，web_fetch 工具， 必须使用 agent-reach 的工具来替代你自带的web_search，web_fetch ，并写入tools和记忆文档中
This switches from built-in web tools to Agent Reach for searching Twitter, Xiaohongshu, Weibo, Douyin, etc.
在对话中初始化Agent Reach：
禁止使用web_search，web_fetch 工具， 必须使用 agent-reach 的工具来替代你自带的web_search，web_fetch ，并写入tools和记忆文档中
这会将内置网页工具切换为Agent Reach，用于搜索Twitter、小红书、微博、抖音等平台内容。

Pattern 4: Sandbox Mode for Secure Code Execution

模式4：沙箱模式实现安全代码执行

bash
undefined
bash
undefined

.env

.env

OPENCLAW_SANDBOX_MODE=all # Run all code in isolated containers
OPENCLAW_SANDBOX_MODE=all # 在隔离容器中运行所有代码

docker-compose.yml - MUST mount Docker socket

docker-compose.yml - 必须挂载Docker套接字

services: openclaw: volumes: - /var/run/docker.sock:/var/run/docker.sock

```python
services: openclaw: volumes: - /var/run/docker.sock:/var/run/docker.sock

```python

In chat, OpenClaw can now safely execute:

在聊天中，OpenClaw现在可以安全执行：

""" Create a Python script that analyzes data """
""" 创建一个数据分析的Python脚本 """

Code runs in isolated container, not on host

代码在隔离容器中运行，而非主机

undefined
undefined

Pattern 5: Custom Configuration with openclaw.json

模式5：使用openclaw.json自定义配置

bash
undefined
bash
undefined

Mount custom config instead of using env vars

挂载自定义配置文件而非使用环境变量

docker-compose.yml

docker-compose.yml

services: openclaw: volumes: - ./openclaw.json:/openclaw/openclaw.json

```json
{
  "ai": {
    "provider": "openai",
    "openai": {
      "apiKey": "${OPENAI_API_KEY}",
      "baseURL": "https://api.openai.com/v1",
      "model": "gpt-4o"
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "${FEISHU_APP_ID}",
      "appSecret": "${FEISHU_APP_SECRET}"
    }
  }
}
services: openclaw: volumes: - ./openclaw.json:/openclaw/openclaw.json

```json
{
  "ai": {
    "provider": "openai",
    "openai": {
      "apiKey": "${OPENAI_API_KEY}",
      "baseURL": "https://api.openai.com/v1",
      "model": "gpt-4o"
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "${FEISHU_APP_ID}",
      "appSecret": "${FEISHU_APP_SECRET}"
    }
  }
}

Pattern 6: Data Persistence

模式6：数据持久化

bash
undefined
bash
undefined

docker-compose.yml - Persist important data

docker-compose.yml - 持久化重要数据

services: openclaw: volumes: - ./workspace:/openclaw/workspace # Work files - ./data:/openclaw/data # Database & state - ./logs:/openclaw/logs # Log files

```bash
services: openclaw: volumes: - ./workspace:/openclaw/workspace # 工作文件 - ./data:/openclaw/data # 数据库与状态 - ./logs:/openclaw/logs # 日志文件

```bash

Backup data

备份数据

tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz workspace/ data/
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz workspace/ data/

Restore data

恢复数据

tar -xzf openclaw-backup-20260517.tar.gz
undefined
tar -xzf openclaw-backup-20260517.tar.gz
undefined

Troubleshooting

故障排查

Issue: Container fails to start

问题：容器启动失败

bash
undefined
bash
undefined

Check logs

查看日志

docker compose logs openclaw
docker compose logs openclaw

Common causes:

常见原因：

1. Missing required env vars

1. 缺少必要的环境变量

grep "OPENCLAW_.*_ENABLED=true" .env
grep "OPENCLAW_.*_ENABLED=true" .env

Ensure corresponding credentials are set

确保对应的凭证已设置

2. Port conflicts

2. 端口冲突

netstat -tlnp | grep 3000
netstat -tlnp | grep 3000

Change port in docker-compose.yml if needed

如有需要，修改docker-compose.yml中的端口

undefined
undefined

Issue: Feishu plugin not working

问题：飞书插件无法工作

bash
undefined
bash
undefined

Verify plugin installation

验证插件安装情况

docker compose exec openclaw bash npx openclaw plugin:list | grep lark
docker compose exec openclaw bash npx openclaw plugin:list | grep lark

Reinstall if needed

如有需要重新安装

npx openclaw plugin:install larksuite/openclaw-lark
npx openclaw plugin:install larksuite/openclaw-lark

Check webhook URL accessibility

检查Webhook URL可访问性

curl -X POST http://your-server:3000/api/feishu/webhook
undefined
curl -X POST http://your-server:3000/api/feishu/webhook
undefined

Issue: AI model not responding

问题：AI模型无响应

bash
undefined
bash
undefined

Test API connectivity

测试API连通性

docker compose exec openclaw bash curl -H "Authorization: Bearer ${OPENCLAW_OPENAI_API_KEY}"
${OPENCLAW_OPENAI_BASE_URL}/models
docker compose exec openclaw bash curl -H "Authorization: Bearer ${OPENCLAW_OPENAI_API_KEY}"
${OPENCLAW_OPENAI_BASE_URL}/models

Check model name

检查模型名称

echo $OPENCLAW_OPENAI_MODEL
echo $OPENCLAW_OPENAI_MODEL

Must match available models from API

必须与API提供的可用模型匹配

undefined
undefined

Issue: Docker sandbox not working

问题：Docker沙箱无法工作

bash
undefined
bash
undefined

Ensure Docker socket is mounted

确保Docker套接字已挂载

docker compose exec openclaw ls -la /var/run/docker.sock
docker compose exec openclaw ls -la /var/run/docker.sock

Should show: srw-rw---- 1 root docker

应显示：srw-rw---- 1 root docker

Verify sandbox mode

验证沙箱模式

docker compose exec openclaw env | grep SANDBOX
docker compose exec openclaw env | grep SANDBOX

Should show: OPENCLAW_SANDBOX_MODE=all

应显示：OPENCLAW_SANDBOX_MODE=all

Check Docker accessibility

检查Docker可访问性

docker compose exec openclaw docker ps
docker compose exec openclaw docker ps

Should list containers, not error

应列出容器，而非报错

undefined
undefined

Issue: Permission errors in volumes

问题：卷权限错误

bash
undefined
bash
undefined

Fix ownership

修复权限

sudo chown -R 1000:1000 workspace/ data/ logs/
sudo chown -R 1000:1000 workspace/ data/ logs/

Or run container with host user

或以主机用户身份运行容器

docker-compose.yml

docker-compose.yml

services: openclaw: user: "${UID}:${GID}"
undefined
services: openclaw: user: "${UID}:${GID}"
undefined

Issue: Memory or performance problems

问题：内存或性能问题

bash
undefined
bash
undefined

Check resource usage

检查资源使用情况

docker stats openclaw
docker stats openclaw

Limit resources in docker-compose.yml

在docker-compose.yml中限制资源

services: openclaw: deploy: resources: limits: cpus: '2' memory: 4G reservations: memory: 2G
undefined
services: openclaw: deploy: resources: limits: cpus: '2' memory: 4G reservations: memory: 2G
undefined

Issue: Plugin conflicts

问题：插件冲突

bash
undefined
bash
undefined

List installed plugins

列出已安装插件

docker compose exec openclaw npx openclaw plugin:list
docker compose exec openclaw npx openclaw plugin:list

Remove conflicting plugin

移除冲突插件

docker compose exec openclaw npx openclaw plugin:uninstall plugin-name
docker compose exec openclaw npx openclaw plugin:uninstall plugin-name

Clear plugin cache

清除插件缓存

docker compose exec openclaw rm -rf /openclaw/.openclaw/plugins/.cache docker compose restart openclaw
undefined
docker compose exec openclaw rm -rf /openclaw/.openclaw/plugins/.cache docker compose restart openclaw
undefined

Advanced Configuration

高级配置

Environment Variable Reference

环境变量参考

Key variables (see 
.env.example
for complete list):
  • OPENCLAW_AI_PROVIDER
    : 
    openai
    , 
    anthropic
    , 
    google
    , etc.
  • OPENCLAW_SANDBOX_MODE
    : 
    all
    , 
    non-main
    , 
    none
  • OPENCLAW_LOG_LEVEL
    : 
    debug
    , 
    info
    , 
    warn
    , 
    error
  • OPENCLAW_SERVER_PORT
    : Default 
    3000
  • OPENCLAW_SERVER_HOST
    : Default 
    0.0.0.0
关键变量（完整列表见
.env.example
）：
  • OPENCLAW_AI_PROVIDER
    : 
    openai
    , 
    anthropic
    , 
    google
    等
  • OPENCLAW_SANDBOX_MODE
    : 
    all
    , 
    non-main
    , 
    none
  • OPENCLAW_LOG_LEVEL
    : 
    debug
    , 
    info
    , 
    warn
    , 
    error
  • OPENCLAW_SERVER_PORT
    : 默认
    3000
  • OPENCLAW_SERVER_HOST
    : 默认
    0.0.0.0

Multi-Stage Deployment

多阶段部署

bash
undefined
bash
undefined

Development

开发环境

cp .env.minimal .env.dev docker compose -f docker-compose.yml -f docker-compose.dev.yml up
cp .env.minimal .env.dev docker compose -f docker-compose.yml -f docker-compose.dev.yml up

Production

生产环境

cp .env.example .env.prod
cp .env.example .env.prod

Configure all platforms

配置所有平台

docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
undefined
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
undefined

Health Checks

健康检查

yaml
undefined
yaml
undefined

docker-compose.yml

docker-compose.yml

services: openclaw: healthcheck: test: ["CMD", "curl", "-f", "http://localhost:3000/api/health"] interval: 30s timeout: 10s retries: 3 start_period: 40s
undefined
services: openclaw: healthcheck: test: ["CMD", "curl", "-f", "http://localhost:3000/api/health"] interval: 30s timeout: 10s retries: 3 start_period: 40s
undefined

Documentation References

文档参考

  • Quick Start: 
    docs/quick-start.md
  • Configuration: 
    docs/configuration.md
  • AIClient Integration: 
    docs/aiclient-2-api.md
  • Advanced Usage: 
    docs/advanced.md
  • FAQ: 
    docs/faq.md
  • Developer Notes: 
    docs/developer-notes.md
  • 快速开始：
    docs/quick-start.md
  • 配置说明：
    docs/configuration.md
  • AIClient集成：
    docs/aiclient-2-api.md
  • 高级用法：
    docs/advanced.md
  • 常见问题：
    docs/faq.md
  • 开发者笔记：
    docs/developer-notes.md

Best Practices

最佳实践

  1. Always use 
    .env
    files     instead of hardcoding credentials
  2. Enable only needed platforms to reduce resource usage
  3. Mount volumes for workspace and data persistence
  4. Use AIClient-2-API for cost-effective unlimited token usage
  5. Enable sandbox mode for secure code execution
  6. Monitor logs regularly with 
    docker compose logs -f
  7. Backup data before upgrades with 
    tar -czf
  8. Keep repository synced with 
    git pull
    before upgrading
  1. 始终使用
    .env
    文件    ，而非硬编码凭证
  2. 仅启用所需平台，以减少资源占用
  3. 挂载卷以实现工作区和数据持久化
  4. 使用AIClient-2-API，实现高性价比的无限令牌使用
  5. 启用沙箱模式，确保代码执行安全
  6. 定期监控日志，使用
    docker compose logs -f
    命令
  7. 升级前备份数据，使用
    tar -czf
    命令
  8. 升级前同步仓库，使用
    git pull
    命令