{"slug": "show-hn-emailclaw-email-lovers-ai-agent-that-creates-scheduled-task-in-5-steps", "title": "Show HN: Emailclaw–Email lovers' AI agent that creates scheduled task in 5 steps", "summary": "Emailclaw, a local-first AI agent that uses email as its interactive entry point, has been released on Hacker News, enabling users to create tasks and scheduled automation in five steps by sending emails to a dedicated agent address. The tool treats email subjects as project boundaries, creating isolated task sessions and directories for each new subject, and supports controlled agent actions, long-running headless service mode, and extensibility via Java SPI plugins, powered by AgentScope Java 2.0.", "body_md": "**Email in. Work out. The Ultimate AI Agent for Email Lovers!**\n\n  A local-first AI Agent that uses email as its default interactive entry point and subjects as project boundaries.\n\nCreate tasks and scheduled automation in 5 simple steps:\n\n1. **Get OTP:** Send an email to`otp@emailclaw.email` to get a one-time password.\n2. **Configure:** Enter your registration email and OTP in Emailclaw settings. You'll receive your Agent Email (e.g.,`YOUR-AGENT@emailclaw.email` ).\n3. **Send Task:** Send your task to the Agent Email (e.g., \"Please tell me the latest global AI technology news\").\n4. **Confirm:** Reply to the confirmation email with the TaskId to start the work. You will receive the task results.\n5. **Schedule:** Reply to the thread to convert it (e.g., \"Please convert this task into a scheduled task, with the runtime hours set to 7, 12, 17 and 23\"). Emailclaw will automatically run it for\n\nWhen an email is received, a `projectId` is explicitly passed to the Agent, forcing its sandbox and file tools to bind to a dedicated\n`projects/<projectId>` directory.\n\n1. **Task Submission:** User sends an email with a new subject and 3 markdown attachments, requesting an analysis.\n2. **Initialization:** Emailclaw creates a new project based on the \"New subject, new project\" rule. User confirms.\n3. **Agent Execution:** The Agent analyzes the materials, generates the result, and replies with the new markdown file attached.\n4. **Physical Isolation:** On the file system, all 3 user files and the 1 generated file are securely stored in the project's exclusive directory,\ncompletely isolated from other projects.\n\nEmailclaw puts AI Agents into an inbox everyone is familiar with. It doesn't treat email as just another chat channel, but rather treats the email subject as a clear boundary for a specific task:\n\n**New Subject, New Project.**\n\nA new subject email without a valid TaskId will create an independent task session, a project record, and a project directory. The system replies with an email attaching a TaskId; once the user replies directly to this email, subsequent messages, attachments, and Agent work will stay within the same task. To start a different piece of work, simply write a new subject.\n\nThis makes Emailclaw especially suitable for email lovers and those who need to maintain clear contextual boundaries between research, writing, code review, reporting, customer replies, and automated tasks.\n\n- **Email-first** : Uses IMAP to receive tasks and SMTP to return results. No need to learn or migrate to new instant chat apps.\n- **Subject-level Project Isolation** : New Subject, New Project; TaskId binds email threads, session history, and project directories.\n- **Local-first** : Configurations, projects, sessions, attachments, workspaces, logs, and plugins are saved on machines you control.\n- **Controlled Agent Actions** : Models, tools, Skills, MCP, cron jobs, and plugins can be composed; high-risk tool calls can be approved via a 4-digit confirmation code in email.\n- **Suitable for Long-running** : Supports Linux headless service mode, boot startup, Cron automation, and log troubleshooting.\n- **Extensible** : Based on Java SPI and external JAR plugins; extensible for tools, Providers, hooks, MCP, UI, and channels.\n- **Powered by AgentScope Java** : Utilizes AgentScope Java 2.0's Agent, model, event, tool, permission, and Harness capabilities.\n\n```\nYour Inbox\n  │  Send a new subject email\n  ▼\nEmailclaw Channel\n  │  Creates session + project, replies with TaskId\n  ▼\nReply to the same email (keeping TaskId)\n  │\n  ▼\nAgent reasons in an isolated workspace, calls controlled tools, generates results\n  │\n  ▼\nResults, attachments, or approval requests return to the original email thread\n```\n\nThe first new subject email is used to establish a stable task boundary; it will not immediately trigger a model call. Please reply to Emailclaw's response email and keep the complete TaskId at the end of the subject.\n\nThe release process builds desktop installation packages for the following platforms. Please visit [https://github.com/emailclaw/emailclaw/releases/](https://github.com/emailclaw/emailclaw/releases/) to download the latest version installation package:\n\n| Platform | Asset Type | Installation Method | \n|---|---|---|\n| Windows | `.exe` | Double-click to install after downloading, and follow the setup wizard | \n| macOS | `.dmg` | Open the disk image and drag the application to the \"Applications\" folder | \n| Linux Portable Deployment | `.tar.gz` | Execute `mkdir -p ~/.local/ && cd ~/.local/ && wget https://github.com/emailclaw/emailclaw/releases/latest/download/emailclaw-linux-latest.tar.gz && tar -xzf emailclaw-linux-latest.tar.gz -C ~/.local/ --no-same-owner` . Launch**Emailclaw** by running`~/.local/emailclaw/bin/emailclaw` | \n| Debian/Ubuntu Linux | `.deb` | Execute `wget https://github.com/emailclaw/emailclaw/releases/latest/download/emailclaw-linux-latest.deb && sudo apt install ./emailclaw-linux-latest.deb` . Launch**Emailclaw** from the application menu or by running`/opt/emailclaw/bin/emailclaw` | \n\nAfter launching the desktop application:\n\n1. In **Providers** , add the Base URL, API Key, and model ID of the model service.\n2. In **Agents** , create or select a default Agent, and choose the model and system prompt.\n3. It is recommended to send a simple message in local chat first to verify the model credentials and network availability.\n\nClick **Emailclaw Settings** to open the configuration page. You can use your own email, or follow the interface instructions to register if the system-provided email function is available and you are authorized.\n\nFill in the following items:\n\n- **Email Address** : The email address used by Emailclaw to send and receive tasks.\n- **Email Password** : App-specific password, authorization code, or the credentials required by the email service.\n- **IMAP Host / Port / SSL / STARTTLS** : Incoming mail server parameters.\n- **SMTP Host / Port / SSL / STARTTLS** : Outgoing mail server parameters.\n- **Poll Interval** : Inbox polling interval, minimum 5 seconds, default 30 seconds.\n- **Allowed Senders** : Email addresses allowed to send tasks to the Agent, one per line.\n\nCommon addresses like Gmail, Outlook, iCloud, 163, 126, QQ, Foxmail, Yahoo, etc., will automatically match preset parameters. If your service provider is not among the presets, please query your service provider for IMAP/SMTP parameters and fill them in manually.\n\nAfter saving the configuration, enable Emailclaw on the channels page. The system will start polling the mailbox in the background. It is strongly recommended to only add addresses you trust to the allowed senders list.\n\nThe prerequisite is that you have sent an email to [otp@emailclaw.email](mailto:otp@emailclaw.email) to obtain a one-time password, and you fully agree to the Emailclaw Channel Service Agreement:\n\n1. The Service Provider reserves all rights, and may suspend or change the terms of this agreement at any time without prior notice.\n2. The Service Provider provides no quality guarantee for the services provided. The Service Provider shall not be held liable for any direct or indirect damages arising from the use of this service.\n3. The Emailclaw Channel only provides email channel services, and does not provide email storage services. All sent or received emails will be completely and irrecoverably deleted from the server after 15 minutes.\n4. If a user registers for the Emailclaw Channel service provided by the system but does not use the service for more than 100 consecutive days, the Service Provider will delete the user's service.\n5. By using this service, you agree to comply with all applicable local and international laws and regulations.\n\nJust fill in the following items:\n\n- **Registration Email** : The email address used to register for the service.\n- **One-time Password** : The obtained one-time password credential.\n\nAfter saving the configuration, enable Emailclaw on the channels page. The system will start polling the mailbox in the background. The allowed sender is simply your own email.\n\nSend a new subject email to the Agent's email address, for example:\n\n```\nSubject: Organize competitor abstract for August product review\n\nPlease read the three materials in the attachment and output a one-page abstract in Chinese:\n1. Three common trends;\n2. Differences of each product;\n3. Two suggestions for the product team.\n```\n\nEmailclaw will reply and append a TaskId at the end of the subject. Reply directly to this email to start execution; always reply to this thread when continuing the same task. When you need to start a different job, write a new subject email.\n\nEmailclaw's goal is not to give the Agent unrestricted machine access.\n\n- The Agent works within project and workspace boundaries.\n- `emailAllowlistSenders` restricts which email addresses can initiate tasks.\n- High-risk tool calls can enter a manual approval process via email confirmation codes; timeouts, wrong codes, or replies across sessions will be rejected.\n- Permission modes cover `explore` (read-only),`default` (routine confirmation),`accept_edits` ,`dont_ask` , and`bypass` . In production environments, please start with`explore` or`default` .\n- Third-party plugins, MCP services, and Skills may have file, network, or code execution capabilities. They should only be installed from trusted sources and verified in a low-privilege environment first.\n\nThe Linux `.tar.gz` package can be extracted and run directly in your home directory without root privileges. A user-level systemd service (`~/.config/systemd/user/emailclaw.service`) runs the daemon under your own user, sharing the **same `~/emailclaw` data directory** as the desktop app. No config migration is needed.\n\nThe `.deb` package installs to `/opt/emailclaw/` (requires `sudo apt install`); the installer creates a symlink at `~/.local/bin/emailclaw` and registers the same user-level service for you.\n\nAfter installation, enable the background service (no sudo required):\n\n```\nloginctl enable-linger \"$USER\"   # keep the daemon running after logout\nsystemctl --user enable --now emailclaw\nsystemctl --user status emailclaw\njournalctl --user -u emailclaw -f\n```\n\nEach Linux user can enable their own independent instance; every instance keeps its own `~/emailclaw` data and configuration. For a complete step-by-step tutorial, see the [User Manual](/emailclaw/emailclaw/blob/main/docs/Emailclaw-User-Manual.md).\n\nPrerequisites: JDK 25, Maven, and the `jpackage` capabilities of the target operating system.\n\n```\ncd emailclaw\nmvn -B package -DskipTests\n```\n\nThe build will generate a shaded JAR and platform installation packages. GitHub Actions will build `.exe`, `.dmg`, and `.deb` on Windows, macOS, and Linux respectively when pushing `v*` tags, and additionally generate a Linux `.tar.gz`.\n\nRun tests:\n\n```\ncd emailclaw\nmvn -B test\nemailclaw/                 Java application source code and Maven build\nplugin-samples/            Plugin development guide & InvokeAntigravityCli tool sample\ndocs/                      Product features, architecture, and user manual\n.github/workflows/         GitHub Release build workflows\n```\n\nThe default runtime data root directory is `~/emailclaw`, which can be modified via the Java system property `emailclaw.home` or the environment variable `EMAILCLAW_HOME`. Common subdirectories include:\n\n| Path | Purpose | \n|---|---|\n| `.config/` | JSON configurations for Providers, Agents, channels, projects, Cron, etc. | \n| `.chat-history/` | Session and message history | \n| `projects/` | Project directories created per task | \n| `agent-workspace/` | Agent workspaces | \n| `skill-pool/` | Skills | \n| `plugins/` | External plugins | \n| `logs/` | Application logs | \n\nPlugins can provide tools, model Providers, startup/shutdown hooks, MCP, UI, or channel capabilities. Please start with the [Plugin Developer Guide](/emailclaw/emailclaw/blob/main/plugin-samples/PLUGIN-DEVELOPER-GUIDE.md) and [`plugin-samples/invokeAntigravityCli`](/emailclaw/emailclaw/blob/main/plugin-samples/invokeAntigravityCli). Channel plugins are responsible for external session mapping, message forwarding, and (if needed) the secure delivery of approval requests.\n\nWe welcome improvements to Emailclaw through clear Issues and reviewable Pull Requests. Before submitting:\n\n1. Do not commit API Keys, email passwords, app authorization codes, or personal data.\n2. Add or update tests and documentation for behavioral changes.\n3. Run relevant Maven checks using JDK 25.\n4. Maintain plugin compatibility: external plugins should generally depend on the Emailclaw core API using `provided` scope.\n\nEmailclaw is licensed under the [MIT License](/emailclaw/emailclaw/blob/main/LICENSE).", "url": "https://wpnews.pro/news/show-hn-emailclaw-email-lovers-ai-agent-that-creates-scheduled-task-in-5-steps", "canonical_source": "https://github.com/emailclaw/emailclaw", "published_at": "2026-09-09 14:31:09+00:00", "updated_at": "2026-09-09 14:44:01.841099+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "ai-products"], "entities": ["Emailclaw", "AgentScope Java"], "alternates": {"html": "https://wpnews.pro/news/show-hn-emailclaw-email-lovers-ai-agent-that-creates-scheduled-task-in-5-steps", "markdown": "https://wpnews.pro/news/show-hn-emailclaw-email-lovers-ai-agent-that-creates-scheduled-task-in-5-steps.md", "text": "https://wpnews.pro/news/show-hn-emailclaw-email-lovers-ai-agent-that-creates-scheduled-task-in-5-steps.txt", "jsonld": "https://wpnews.pro/news/show-hn-emailclaw-email-lovers-ai-agent-that-creates-scheduled-task-in-5-steps.jsonld"}}