# openclaw_config_code

## Summary

This workspace provides configuration code, documentation, and scripts to manage and customize OpenClaw agents, tools, skills, and system automation. It centralizes system settings, scheduled tasks, skill modules, and operational procedures for streamlined deployment and maintenance.

## Included Assets

- **Agent, Tool, and Personality Files**
  - `AGENTS.md` – Workspace usage and memory model
  - `SOUL.md` – Principles and assistant personality definition
  - `TOOLS.md` – Environment-specific notes for local setup

- **Configuration**
  - `config/api-keys.sh` – API keys and sensitive configuration (bash script)
  - `config/system-config-v1.0.md` – Stable, manually updated system configuration
  - `config/system-config-v1.1.md` – Daily ops and temporary configuration (auto/manual updates)
  - `config/task-config.json` – Scheduled tasks and automation settings

- **Scripts & Skills**
  - `scripts/README.md` – Overview of automation scripts (batch conversion, reporting, monitoring)
  - `skills/tencent-docs/doc/doc_format/README.md` – Tencent Docs skill: text formatting automation
  - `skills/wps-skill/README.md` – WPS Office skill: document automation/conversion setup

- **Documentation**
  - `docs/conversion-strategy.md` – System document conversion policy and toolchain
  - `docs/git-ssh-setup.md` – Guide for configuring SSH keys for GitHub access

- **Memory / Logs**
  - `memory/2026-03-16-cron-tasks-full-update.md` – System scheduled task update log
  - `memory/2026-03-16-daily-ai-news-fix.md` – Issue/troubleshooting log for scheduled tasks
  - `memory/2026-03-16-email-attachment-fix.md` – Email attachment MIME type fix log
  - `memory/2026-03-16-full-test-report.md` – End-to-end testing log
  - `memory/2026-03-16-github-sync-summary.md` – GitHub sync record
  - `memory/2026-03-16-self-adjustment-report.md` – Self-diagnosis and adjustment report

## How to Use

1. **Review Initial Setup**
   - Read `AGENTS.md`, `SOUL.md`, and `TOOLS.md` to understand workspace best practices and operational culture.
   - Configure your API keys in `config/api-keys.sh`. Use `source config/api-keys.sh` to load environment variables.

2. **System Configuration**
   - Reference `config/system-config-v1.0.md` for core, stable system settings.
   - Use `config/system-config-v1.1.md` for operational adjustments or temporary overrides.
   - Scheduled tasks and automations are defined in `config/task-config.json`.

3. **Automation Scripts and Tools**
   - Check `scripts/README.md` for available utilities and usage instructions, including batch document conversion and email.
   - To process and convert documents, follow the conversion strategies in `docs/conversion-strategy.md`.
   - Use skills modules documented in their respective READMEs under `skills/`.

4. **Maintenance and Logging**
   - Review daily memory logs under `memory/` for context and operational history.
   - Follow troubleshooting guides (`docs/`, `memory/`) if issues arise with cron tasks or integrations.

5. **SSH & GitHub Integration**
   - See `docs/git-ssh-setup.md` to configure Git SSH keys for repository access.

## Notes

- Manual edits for system settings should be made in `system-config-v1.0.md`; day-to-day changes can be reflected in `system-config-v1.1.md`.
- Keys and sensitive data in `api-keys.sh` must be protected; do not commit live secrets.
- Prefer `wps-skill` for all office document format conversions; fall back to `batch_md_to_pdf.py` for markdown-to-PDF if needed.
- The workspace maintains operational context via markdown memory logs; regularly update `MEMORY.md` for long-term reference.
- Scripts and configuration files prioritize clarity, step-by-step output, and explicit error handling.
- Each skill module (WPS, Tencent Docs, etc.) includes standalone instructions and dependencies in its respective README. 

For detailed usage of scripts or skills, always refer to the specific `README.md` files in each subdirectory.